Doc: Improve QProcess setStandardOutputFile description

Fix links to OpenMode flags. While at it, make links explicit so
that future changes breaking implicit linking will cause errors.

Pick-to: 6.8
Task-number: QTBUG-131484
Change-Id: I20b80014eadcbcba6ebebab1ff4db4c345dd434a
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
(cherry picked from commit 4e85a4f401118f2f7330b673e45b4a0399825ef3)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Kai Köhne 2024-12-05 16:13:34 +01:00 committed by Qt Cherry-pick Bot
parent 5d2f40a14b
commit b70e61788f

View File

@ -1492,22 +1492,22 @@ void QProcess::setStandardInputFile(const QString &fileName)
Redirects the process' standard output to the file \a
fileName. When the redirection is in place, the standard output
read channel is closed: reading from it using read() will always
fail, as will readAllStandardOutput().
read channel is closed: reading from it using \l read() will always
fail, as will \l readAllStandardOutput().
To discard all standard output from the process, pass nullDevice()
To discard all standard output from the process, pass \l nullDevice()
here. This is more efficient than simply never reading the standard
output, as no QProcess buffers are filled.
If the file \a fileName doesn't exist at the moment start() is
If the file \a fileName doesn't exist at the moment \l start() is
called, it will be created. If it cannot be created, the starting
will fail.
If the file exists and \a mode is QIODevice::Truncate, the file
will be truncated. Otherwise (if \a mode is QIODevice::Append),
If the file exists and \a mode is \ QIODeviceBase::Truncate, the file
will be truncated. Otherwise (if \a mode is \l QIODeviceBase::Append),
the file will be appended to.
Calling setStandardOutputFile() after the process has started has
Calling \l setStandardOutputFile() after the process has started has
no effect.
If \a fileName is an empty string, it stops redirecting the standard