From b70e61788fd14f5bc8810cea34b24980bc6db79e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kai=20K=C3=B6hne?= Date: Thu, 5 Dec 2024 16:13:34 +0100 Subject: [PATCH] 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 (cherry picked from commit 4e85a4f401118f2f7330b673e45b4a0399825ef3) Reviewed-by: Qt Cherry-pick Bot --- src/corelib/io/qprocess.cpp | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/corelib/io/qprocess.cpp b/src/corelib/io/qprocess.cpp index 4187c6a7d8e..86b2333beec 100644 --- a/src/corelib/io/qprocess.cpp +++ b/src/corelib/io/qprocess.cpp @@ -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