From be6cd144d33e4159759f59ba7dab3deb22b10515 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kai=20K=C3=B6hne?= Date: Wed, 21 Dec 2022 15:39:15 +0100 Subject: [PATCH] Doc: Reorder QFile overview Move the paragraphs dealing with encodeName()/decodeName() and Unix special files to 'Platform Specific Issues'. Change-Id: I076191e041ef238556aab28b5ad5d51974f8f7ff Reviewed-by: Thiago Macieira (cherry picked from commit 8b0818235d512c9085ce0fd0ea2490f1653a6c36) Reviewed-by: Qt Cherry-pick Bot --- src/corelib/io/qfile.cpp | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/corelib/io/qfile.cpp b/src/corelib/io/qfile.cpp index 585b5c8a1b9..c260e98202d 100644 --- a/src/corelib/io/qfile.cpp +++ b/src/corelib/io/qfile.cpp @@ -150,6 +150,15 @@ QAbstractFileEngine *QFilePrivate::engine() const data and operator>>() to read it back. See the class documentation for details. + \section1 Signals + + Unlike other QIODevice implementations, such as QTcpSocket, QFile does not + emit the aboutToClose(), bytesWritten(), or readyRead() signals. This + implementation detail means that QFile is not suitable for reading and + writing certain types of files, such as device files on Unix platforms. + + \section1 Platform Specific Issues + \l{Input/Output and Networking}{Qt APIs related to I/O} use UTF-16 based QStrings to represent file paths. Standard C++ APIs (\c or \c ) or platform-specific APIs however often need a 8-bit encoded @@ -167,15 +176,6 @@ QAbstractFileEngine *QFilePrivate::engine() const \snippet file/file.cpp 3 - \section1 Signals - - Unlike other QIODevice implementations, such as QTcpSocket, QFile does not - emit the aboutToClose(), bytesWritten(), or readyRead() signals. This - implementation detail means that QFile is not suitable for reading and - writing certain types of files, such as device files on Unix platforms. - - \section1 Platform Specific Issues - File permissions are handled differently on Unix-like systems and Windows. In a non \l{QIODevice::isWritable()}{writable} directory on Unix-like systems, files cannot be created. This is not always