Fix some qdoc-warnings for 5.9

qtbase/src/corelib/global/qoperatingsystemversion.cpp:119: warning: Cannot find 'QOperatingSystemVersion(...)' in '\fn' QOperatingSystemVersion::QOperatingSystemVersion(int maj, int min, int mic)
qtbase/src/corelib/io/qdir.cpp:1852: warning: Unknown command '\p'
qtbase/src/corelib/kernel/qabstracteventdispatcher.cpp:482: warning: Cannot find 'registerEventNotifier(...)' in '\fn' bool QAbstractEventDispatcher::registerEventNotifier(QWinEventNotifier *notifier);
qtbase/src/corelib/kernel/qabstracteventdispatcher.cpp:495: warning: Cannot find 'unregisterEventNotifier(...)' in '\fn' bool QAbstractEventDispatcher::unregisterEventNotifier(QWinEventNotifier *notifier);
qtbase/src/corelib/global/qoperatingsystemversion.cpp:268: warning: Can't link to 'macro()'
qtbase/src/corelib/global/qoperatingsystemversion.cpp:296: warning: Can't link to 'typeName()'
qtbase/src/corelib/io/qdir.cpp:1845: warning: Undocumented parameter 'filters' in QDir::isEmpty()
qtbase/src/corelib/kernel/qobject.cpp:1636: warning: No such parameter 'interval' in QObject::startTimer()
qtbase/src/network/bearer/qnetworkconfiguration.cpp:343: warning: Undocumented parameter 'timeout' in QNetworkConfiguration::setConnectTimeout()
qtbase/src/gui/kernel/qoffscreensurface.cpp:337: warning: Undocumented parameter 'handle' in QOffscreenSurface::setNativeHandle()
qtbase/src/platformheaders/xcbfunctions/qxcbwindowfunctions.qdoc:109: warning: Unknown command '\role'
qtbase/src/widgets/util/qundostack.cpp:727: warning: Command '\li' outside of '\list' and '\table' ...

Change-Id: I57bff895a8e1afd94b582a6a72a06771514ee27e
Reviewed-by: Jake Petroules <jake.petroules@qt.io>

9 files changed, 15 insertions, 12 deletions

diff --git a/src/corelib/global/qoperatingsystemversion.cpp b/src/corelib/global/qoperatingsystemversion.cpp
index 0cfc70a790..e120fdf2ba 100644
--- a/src/corelib/global/qoperatingsystemversion.cpp
+++ b/src/corelib/global/qoperatingsystemversion.cpp
@@ -118,7 +118,7 @@ QT_BEGIN_NAMESPACE
         current >= QOperatingSystemVersion(QOperatingSystemVersion::IOS, 8)) {
         // returns true on macOS >= 10.10 and iOS >= 8.0, but false on macOS < 10.10 and iOS < 8.0
     }
-    \encode
+    \endcode
 
     A more naive comparison algorithm might incorrectly return true on all versions of macOS,
     including Mac OS 9. This behavior is achieved by overloading the comparison operators to return
@@ -144,10 +144,10 @@ QT_BEGIN_NAMESPACE
 */
 
 /*!
-    \fn QOperatingSystemVersion::QOperatingSystemVersion(int maj, int min, int mic)
+    \fn QOperatingSystemVersion::QOperatingSystemVersion(OSType osType, int vmajor, int vminor = -1, int vmicro = -1)
 
-    Constructs a QOperatingSystemVersion consisting of the OS type \a os, and
-    major, minor, and micro version numbers \a maj, \a min and \a mic, respectively.
+    Constructs a QOperatingSystemVersion consisting of the OS type \a osType, and
+    major, minor, and micro version numbers \a vmajor, \a vminor and \a vmicro, respectively.
 */
 
 /*!
@@ -264,7 +264,7 @@ int QOperatingSystemVersion::compare(const QOperatingSystemVersion &v1,
 
     -1 indicates an unknown or absent version number component.
 
-    \sa majorVersion(), macro()
+    \sa majorVersion(), microVersion()
 */
 
 /*!
@@ -286,7 +286,7 @@ int QOperatingSystemVersion::compare(const QOperatingSystemVersion &v1,
 
     Returns the OS type identified by the QOperatingSystemVersion.
 
-    \sa typeName()
+    \sa name()
 */
 
 /*!
diff --git a/src/corelib/io/qdatastream.cpp b/src/corelib/io/qdatastream.cpp
index b4eb98e062..2730fd7f11 100644
--- a/src/corelib/io/qdatastream.cpp
+++ b/src/corelib/io/qdatastream.cpp
@@ -557,6 +557,7 @@ void QDataStream::setByteOrder(ByteOrder bo)
     \value Qt_5_6 Version 17 (Qt 5.6)
     \value Qt_5_7 Same as Qt_5_6
     \value Qt_5_8 Same as Qt_5_6
+    \value Qt_5_9 Same as Qt_5_6
     \omitvalue Qt_DefaultCompiledVersion
 
     \sa setVersion(), version()
diff --git a/src/corelib/io/qdir.cpp b/src/corelib/io/qdir.cpp
index 37795ae5c4..bfb91c131f 100644
--- a/src/corelib/io/qdir.cpp
+++ b/src/corelib/io/qdir.cpp
@@ -1849,7 +1849,7 @@ bool QDir::exists(const QString &name) const
     \c{QDir::AllEntries | QDir::NoDotAndDotDot}, but faster as it just checks
     whether the directory contains at least one entry.
 
-    \note Unless you set the \p filters flags to include \c{QDir::NoDotAndDotDot}
+    \note Unless you set the \a filters flags to include \c{QDir::NoDotAndDotDot}
           (as the default value does), no directory is empty.
 
     \sa count(), entryList(), setFilter()
diff --git a/src/corelib/kernel/qabstracteventdispatcher.h b/src/corelib/kernel/qabstracteventdispatcher.h
index f92e418ebf..68d9bf180f 100644
--- a/src/corelib/kernel/qabstracteventdispatcher.h
+++ b/src/corelib/kernel/qabstracteventdispatcher.h
@@ -95,7 +95,7 @@ public:
 
     virtual int remainingTime(int timerId) = 0;
 
-#ifdef Q_OS_WIN
+#if defined(Q_OS_WIN) || defined(Q_QDOC)
     virtual bool registerEventNotifier(QWinEventNotifier *notifier) = 0;
     virtual void unregisterEventNotifier(QWinEventNotifier *notifier) = 0;
 #endif
diff --git a/src/corelib/kernel/qobject.cpp b/src/corelib/kernel/qobject.cpp
index ac1b2d41bf..5e6c44fb13 100644
--- a/src/corelib/kernel/qobject.cpp
+++ b/src/corelib/kernel/qobject.cpp
@@ -1642,7 +1642,7 @@ int QObject::startTimer(int interval, Qt::TimerType timerType)
     it could not start a timer.
 
     A timer event will occur every \a time interval until killTimer()
-    is called. If \a interval is equal to \c{std::chrono::duration::zero()},
+    is called. If \a time is equal to \c{std::chrono::duration::zero()},
     then the timer event occurs once every time there are no more window
     system events to process.
 
diff --git a/src/gui/kernel/qoffscreensurface.cpp b/src/gui/kernel/qoffscreensurface.cpp
index e8a86590b5..307bc5e62f 100644
--- a/src/gui/kernel/qoffscreensurface.cpp
+++ b/src/gui/kernel/qoffscreensurface.cpp
@@ -335,7 +335,7 @@ void QOffscreenSurface::setScreen(QScreen *newScreen)
 }
 
 /*!
-    Sets the native handle to which the offscreen surface is connected.
+    Sets the native handle to which the offscreen surface is connected to \a handle.
 
     The native handle will be resolved in the create() function. Calling
     this function after create() will not re-create a native surface.
diff --git a/src/network/bearer/qnetworkconfiguration.cpp b/src/network/bearer/qnetworkconfiguration.cpp
index d2feffb316..f1619ab7c0 100644
--- a/src/network/bearer/qnetworkconfiguration.cpp
+++ b/src/network/bearer/qnetworkconfiguration.cpp
@@ -343,7 +343,7 @@ int QNetworkConfiguration::connectTimeout() const
 /*!
     \since 5.9
 
-    Sets the connect timeout of this configuration.
+    Sets the connect timeout of this configuration to \a timeout.
     This allows control of the timeout used by \c QAbstractSocket
     to establish a connection.
 
diff --git a/src/platformheaders/xcbfunctions/qxcbwindowfunctions.qdoc b/src/platformheaders/xcbfunctions/qxcbwindowfunctions.qdoc
index f0ef5ee2a7..fab473b91b 100644
--- a/src/platformheaders/xcbfunctions/qxcbwindowfunctions.qdoc
+++ b/src/platformheaders/xcbfunctions/qxcbwindowfunctions.qdoc
@@ -106,7 +106,7 @@
     \fn void QXcbWindowFunctions::setWmWindowRole(QWindow *window, const QByteArray &role)
     \since 5.6.2
 
-    Sets the WM_WINDOW_ROLE property from \role on the corresponding
+    Sets the WM_WINDOW_ROLE property from \a role on the corresponding
     X11 window.
 
     This is a convenience function that can be used directly instead
diff --git a/src/widgets/util/qundostack.cpp b/src/widgets/util/qundostack.cpp
index cfca5787cb..3d21320655 100644
--- a/src/widgets/util/qundostack.cpp
+++ b/src/widgets/util/qundostack.cpp
@@ -724,10 +724,12 @@ void QUndoStack::setClean()
     This method resets the clean index to -1.
 
     This is typically called in the following cases, when a document has been:
+    \list
     \li created basing on some template and has not been saved,
         so no filename has been associated with the document yet.
     \li restored from a backup file.
     \li changed outside of the editor and the user did not reload it.
+    \endlist
 
     \sa isClean(), setClean(), cleanIndex()
 */