1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: Improve QSaveFile::open description

Browse Source 
Force the mentioned QIODevice flags to be links.
Use fully qualified name for the first flag mentioned,
but use the short form for the following ones for
better readability.

Mark true and false to be written in code style.

Task-number: QTBUG-131484
Change-Id: I988ba66341b811c815953e5fd6d067204bdaae6c
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
(cherry picked from commit 5a6a9b1d5aa4a9314c09dcbc85dcc9c863ace7f5)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Kai Köhne 2024-11-22 13:20:47 +01:00 committed by Qt Cherry-pick Bot
parent 528c78d3a2
commit 133af018d5
1 changed files with 7 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
src/corelib/io/qsavefile.cpp
View File

@ -143,16 +143,15 @@ void QSaveFile::setFileName(const QString &name)
}
/*!
Opens the file using OpenMode \a mode, returning true if successful;
otherwise false.
Opens the file using \a mode flags. Returns \c true if successful;
otherwise returns \c false.
Important: the \a mode must include QIODevice::WriteOnly.
It may also have additional flags, such as QIODevice::Text and QIODevice::Unbuffered.
Important: The flags for \a mode must include \l QIODeviceBase::WriteOnly. Other
common flags you can use are \l Text and \l Unbuffered. Flags not supported at the
moment are \l ReadOnly (and therefore \l ReadWrite), \l Append, \l NewOnly and \l ExistingOnly;
they will generate a runtime warning.
QIODevice::ReadWrite, QIODevice::Append, QIODevice::NewOnly and
QIODevice::ExistingOnly are not supported at the moment.
\sa QIODevice::OpenMode, setFileName(), QT_USE_NODISCARD_FILE_OPEN
\sa setFileName(), QT_USE_NODISCARD_FILE_OPEN
*/
bool QSaveFile::open(OpenMode mode)
{