diff options
author | Topi Reinio <topi.reinio@qt.io> | 2021-02-26 14:21:48 +0100 |
---|---|---|
committer | Paul Wicking <paul.wicking@qt.io> | 2021-04-16 11:59:45 +0000 |
commit | 2818d7ce3ef75b5a21622dbac56647c5d817e529 (patch) | |
tree | edb21e8f0f36efd62d81b24f52c00b2d6271bf25 /src | |
parent | 19e72a71d24522c2132935162ca3946441d869c0 (diff) |
Doc: Fix various documentation issues
- Document QIODeviceBase
- Document QPointerEvent::points
- Fix linking issues
Task-number: QTBUG-90662
Task-number: QTBUG-92273
Change-Id: Ib123d5708953b22e01f95c82626b39a49fff95b2
Reviewed-by: Nico Vertriest <nico.vertriest@qt.io>
(cherry picked from commit 00e10f62b55626097e94a2d70a9214c0062fbcd5)
Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io>
Diffstat (limited to 'src')
-rw-r--r-- | src/corelib/io/qiodevice.cpp | 12 | ||||
-rw-r--r-- | src/corelib/tools/qmargins.cpp | 3 | ||||
-rw-r--r-- | src/gui/image/qimagereader.cpp | 4 | ||||
-rw-r--r-- | src/gui/kernel/qevent.cpp | 6 | ||||
-rw-r--r-- | src/gui/text/qtextdocumentwriter.cpp | 5 |
5 files changed, 22 insertions, 8 deletions
diff --git a/src/corelib/io/qiodevice.cpp b/src/corelib/io/qiodevice.cpp index 5c8c0e6a27..0bea68acc5 100644 --- a/src/corelib/io/qiodevice.cpp +++ b/src/corelib/io/qiodevice.cpp @@ -290,10 +290,18 @@ QIODevicePrivate::~QIODevicePrivate() */ /*! + \class QIODeviceBase + \inheaderfile QIODevice + \inmodule QtCore + \brief Base class for QIODevice that provides flags describing the mode in + which a device is opened. +*/ + +/*! \enum QIODeviceBase::OpenModeFlag - This enum is used with open() to describe the mode in which a device - is opened. It is also returned by openMode(). + This enum is used with QIODevice::open() to describe the mode in which a + device is opened. It is also returned by QIODevice::openMode(). \value NotOpen The device is not open. \value ReadOnly The device is open for reading. diff --git a/src/corelib/tools/qmargins.cpp b/src/corelib/tools/qmargins.cpp index 5b3c04d11e..8a6e50ca24 100644 --- a/src/corelib/tools/qmargins.cpp +++ b/src/corelib/tools/qmargins.cpp @@ -508,10 +508,9 @@ QDebug operator<<(QDebug dbg, const QMargins &m) Returns \c true if all margins are very close to 0; otherwise returns false. - \sa qFuzzyIsNull + \sa {<QtGlobal>::}{qFuzzyIsNull} */ - /*! \fn qreal QMarginsF::left() const diff --git a/src/gui/image/qimagereader.cpp b/src/gui/image/qimagereader.cpp index 611cbb1df1..fccf67b428 100644 --- a/src/gui/image/qimagereader.cpp +++ b/src/gui/image/qimagereader.cpp @@ -769,7 +769,7 @@ bool QImageReader::decideFormatFromContent() const otherwise left unchanged. If the device is not already open, QImageReader will attempt to - open the device in \l QIODevice::ReadOnly mode by calling + open the device in \l {QIODeviceBase::}{ReadOnly} mode by calling open(). Note that this does not work for certain devices, such as QProcess, QTcpSocket and QUdpSocket, where more logic is required to open the device. @@ -799,7 +799,7 @@ QIODevice *QImageReader::device() const /*! Sets the file name of QImageReader to \a fileName. Internally, QImageReader will create a QFile object and open it in \l - QIODevice::ReadOnly mode, and use this when reading images. + {QIODeviceBase::}{ReadOnly} mode, and use this when reading images. If \a fileName does not include a file extension (e.g., .png or .bmp), QImageReader will cycle through all supported extensions until it finds diff --git a/src/gui/kernel/qevent.cpp b/src/gui/kernel/qevent.cpp index 0caba17ddd..751ef65c8b 100644 --- a/src/gui/kernel/qevent.cpp +++ b/src/gui/kernel/qevent.cpp @@ -253,6 +253,12 @@ QInputEvent::~QInputEvent() */ /*! + \fn const QList<QEventPoint> &QPointerEvent::points() const + + Returns a list of points in this pointer event. +*/ + +/*! \fn QPointingDevice::PointerType QPointerEvent::pointerType() const Returns the type of point that generated the event. diff --git a/src/gui/text/qtextdocumentwriter.cpp b/src/gui/text/qtextdocumentwriter.cpp index 31dfb9436f..74db049aa6 100644 --- a/src/gui/text/qtextdocumentwriter.cpp +++ b/src/gui/text/qtextdocumentwriter.cpp @@ -182,7 +182,7 @@ QByteArray QTextDocumentWriter::format () const unchanged. If the device is not already open, QTextDocumentWriter will attempt to - open the device in \l QIODevice::WriteOnly mode by calling open(). + open the device in \l {QIODeviceBase::}{WriteOnly} mode by calling open(). \note This will not work for certain devices, such as QProcess, QTcpSocket and QUdpSocket, where some configuration is required before @@ -211,7 +211,8 @@ QIODevice *QTextDocumentWriter::device () const /*! Sets the name of the file to be written to \a fileName. Internally, QTextDocumentWriter will create a QFile and open it in \l - QIODevice::WriteOnly mode, and use this file when writing the document. + {QIODeviceBase::}{WriteOnly} mode, and use this file when writing the + document. \sa fileName(), setDevice() */ |