Doc: Fixed qdoc warnings.

Change-Id: I7b4e9ef513b82a82d2365c9256d09520a44ad10d
Reviewed-on: http://codereview.qt.nokia.com/324
Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com>
Reviewed-by: Eskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@nokia.com>

src/corelib/io/qdatastream.cpp

@@ -562,6 +562,8 @@ void QDataStream::setByteOrder(ByteOrder bo)
     \value Qt_4_6 Version 12 (Qt 4.6, Qt 4.7, Qt 4.8)
     \value Qt_4_7 Same as Qt_4_6.
     \value Qt_4_8 Same as Qt_4_6.
+    \value Qt_4_9 Same as Qt_4_6.
+    \value Qt_5_0 Same as Qt_4_6.
 
     \sa setVersion(), version()
 */

src/corelib/io/qfile.cpp

@@ -364,10 +364,12 @@ QFilePrivate::setError(QFile::FileError err, int errNum)
     QIODevice.
 
     \value AutoCloseHandle The file handle passed into open() should be
-    closed by close(), the default behaviour is that close just flushes
+    closed by close(), the default behavior is that close just flushes
-    the file and the app is responsible for closing the file handle. When
+    the file and the application is responsible for closing the file handle.
-    opening a file by name, this flag is ignored as Qt always "owns" the
+    When opening a file by name, this flag is ignored as Qt always owns the
     file handle and must close it.
+    \value DontCloseHandle If not explicitly closed, the underlying file
+    handle is left open when the QFile object is destroyed.
  */
 
 #ifdef QT_NO_QOBJECT

src/corelib/io/qnoncontiguousbytedevice.cpp

@@ -479,7 +479,7 @@ qint64 QByteDeviceWrappingIoDevice::writeData( const char* data, qint64 maxSize)
 */
 
 /*!
-    \fn static QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QIODevice *device);
+    \fn static QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QIODevice *device)
 
     Create a QNonContiguousByteDevice out of a QIODevice.
     For QFile, QBuffer and all other QIoDevice, sequential or not.
@@ -501,7 +501,7 @@ QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QIODevice *dev
 }
 
 /*!
-    \fn static QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QRingBuffer *ringBuffer);
+    \fn static QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QSharedPointer<QRingBuffer> ringBuffer)
 
     Create a QNonContiguousByteDevice out of a QRingBuffer.
 
@@ -513,7 +513,7 @@ QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QSharedPointer
 }
 
 /*!
-    \fn static QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QByteArray *byteArray);
+    \fn static QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QByteArray *byteArray)
 
     Create a QNonContiguousByteDevice out of a QByteArray.
 
@@ -525,7 +525,7 @@ QNonContiguousByteDevice* QNonContiguousByteDeviceFactory::create(QByteArray *by
 }
 
 /*!
-    \fn static QIODevice* QNonContiguousByteDeviceFactory::wrap(QNonContiguousByteDevice* byteDevice);
+    \fn static QIODevice* QNonContiguousByteDeviceFactory::wrap(QNonContiguousByteDevice* byteDevice)
 
     Wrap the \a byteDevice (possibly again) into a QIODevice.
 

src/gui/painting/qpainter.cpp

@@ -5773,6 +5773,8 @@ void QPainter::drawImage(const QRectF &targetRect, const QImage &image, const QR
 }
 
 /*!
+    \fn void QPainter::drawGlyphRun(const QPointF &position, const QGlyphRun &glyphs)
+
     Draws the glyphs represented by \a glyphs at \a position. The \a position gives the
     edge of the baseline for the string of glyphs. The glyphs will be retrieved from the font
     selected on \a glyphs and at offsets given by the positions in \a glyphs.

src/gui/text/qglyphrun.cpp

@@ -175,7 +175,8 @@ QRawFont QGlyphRun::rawFont() const
 }
 
 /*!
-    Sets the font in which to look up the glyph indexes to \a font.
+    Sets the font in which to look up the glyph indexes to the \a rawFont
+    specified.
 
     \sa rawFont(), setGlyphIndexes()
 */

src/gui/text/qplatformfontdatabase_qpa.cpp

@@ -52,7 +52,7 @@ extern void qt_registerFont(const QString &familyname, const QString &foundrynam
                                          const QSupportedWritingSystems &writingSystems, void *hanlde);
 
 /*!
-    \fn void QPlatformFontDatabase::registerQPF2Font(const QByteArray &dataArray, void *)
+    \fn void QPlatformFontDatabase::registerQPF2Font(const QByteArray &dataArray, void *handle)
 
     Registers the pre-rendered QPF2 font contained in the given \a dataArray.
 
@@ -149,17 +149,26 @@ public:
     QVector<bool> vector;
 };
 
+/*!
+    Constructs a new object to handle supported writing systems.
+*/
 QSupportedWritingSystems::QSupportedWritingSystems()
 {
     d = new QWritingSystemsPrivate;
 }
 
+/*!
+    Constructs a copy of the \a other writing systems object.
+*/
 QSupportedWritingSystems::QSupportedWritingSystems(const QSupportedWritingSystems &other)
 {
     d = other.d;
     d->ref.ref();
 }
 
+/*!
+    Constructs a copy of the \a other writing systems object.
+*/
 QSupportedWritingSystems &QSupportedWritingSystems::operator=(const QSupportedWritingSystems &other)
 {
     if (d != other.d) {
@@ -171,12 +180,18 @@ QSupportedWritingSystems &QSupportedWritingSystems::operator=(const QSupportedWr
     return *this;
 }
 
+/*!
+    Destroys the supported writing systems object.
+*/
 QSupportedWritingSystems::~QSupportedWritingSystems()
 {
     if (!d->ref.deref())
         delete d;
 }
 
+/*!
+    \internal
+*/
 void QSupportedWritingSystems::detach()
 {
     if (d->ref != 1) {
@@ -187,12 +202,20 @@ void QSupportedWritingSystems::detach()
     }
 }
 
+/*!
+    Sets or clears support for the specified \a writingSystem based on the
+    value given by \a support.
+*/
 void QSupportedWritingSystems::setSupported(QFontDatabase::WritingSystem writingSystem, bool support)
 {
     detach();
     d->vector[writingSystem] = support;
 }
 
+/*!
+    Returns true if the writing system specified by \a writingSystem is
+    supported; otherwise returns false.
+*/
 bool QSupportedWritingSystems::supported(QFontDatabase::WritingSystem writingSystem) const
 {
     return d->vector.at(writingSystem);
@@ -210,10 +233,12 @@ bool QSupportedWritingSystems::supported(QFontDatabase::WritingSystem writingSys
 */
 
 /*!
-  This function is called once at startup by Qts internal fontdatabase. Reimplement this function
+  This function is called once at startup by Qt's internal font database.
-  in a subclass for a convenient place to initialise the internal fontdatabase.
+  Reimplement this function in a subclass for a convenient place to initialize
+  the internal font database.
 
-  The default implementation looks in the fontDir() location and registers all qpf2 fonts.
+  The default implementation looks in the fontDir() location and registers all
+  QPF2 fonts.
 */
 void QPlatformFontDatabase::populateFontDatabase()
 {
@@ -294,7 +319,7 @@ QStringList QPlatformFontDatabase::addApplicationFont(const QByteArray &fontData
 }
 
 /*!
-
+    Releases the specified font \a handle.
 */
 void QPlatformFontDatabase::releaseHandle(void *handle)
 {
@@ -303,7 +328,7 @@ void QPlatformFontDatabase::releaseHandle(void *handle)
 }
 
 /*!
-
+    Returns the directory containing the fonts used by the database.
 */
 QString QPlatformFontDatabase::fontDir() const
 {

src/network/access/qnetworkrequest.cpp

@@ -77,28 +77,33 @@ QT_BEGIN_NAMESPACE
     List of known header types that QNetworkRequest parses. Each known
     header is also represented in raw form with its full HTTP name.
 
-    \value ContentTypeHeader    corresponds to the HTTP Content-Type
+    \value ContentDispositionHeader  Corresponds to the HTTP
-    header and contains a string containing the media (MIME) type and
+    Content-Disposition header and contains a string containing the
-    any auxiliary data (for instance, charset)
+    disposition type (for instance, attachment) and a parameter (for
+    instance, filename).
 
-    \value ContentLengthHeader  corresponds to the HTTP Content-Length
+    \value ContentTypeHeader    Corresponds to the HTTP Content-Type
+    header and contains a string containing the media (MIME) type and
+    any auxiliary data (for instance, charset).
+
+    \value ContentLengthHeader  Corresponds to the HTTP Content-Length
     header and contains the length in bytes of the data transmitted.
 
-    \value LocationHeader       corresponds to the HTTP Location
+    \value LocationHeader       Corresponds to the HTTP Location
     header and contains a URL representing the actual location of the
     data, including the destination URL in case of redirections.
 
-    \value LastModifiedHeader   corresponds to the HTTP Last-Modified
+    \value LastModifiedHeader   Corresponds to the HTTP Last-Modified
     header and contains a QDateTime representing the last modification
-    date of the contents
+    date of the contents.
 
-    \value CookieHeader         corresponds to the HTTP Cookie header
+    \value CookieHeader         Corresponds to the HTTP Cookie header
     and contains a QList<QNetworkCookie> representing the cookies to
-    be sent back to the server
+    be sent back to the server.
 
-    \value SetCookieHeader      corresponds to the HTTP Set-Cookie
+    \value SetCookieHeader      Corresponds to the HTTP Set-Cookie
     header and contains a QList<QNetworkCookie> representing the
-    cookies sent by the server to be stored locally
+    cookies sent by the server to be stored locally.
 
     \sa header(), setHeader(), rawHeader(), setRawHeader()
 */

src/network/kernel/qnetworkproxy.cpp

@@ -1191,6 +1191,11 @@ void QNetworkProxyQuery::setUrl(const QUrl &url)
 }
 
 #ifndef QT_NO_BEARERMANAGEMENT
+/*!
+    Returns the network configuration component of the query.
+
+    \sa setNetworkConfiguration()
+*/
 QNetworkConfiguration QNetworkProxyQuery::networkConfiguration() const
 {
     return d ? d->config : QNetworkConfiguration();
@@ -1206,7 +1211,7 @@ QNetworkConfiguration QNetworkProxyQuery::networkConfiguration() const
     you should first start the QNetworkSession and obtain the active
     configuration from its properties.
 
-    \sa networkConfiguration
+    \sa networkConfiguration()
 */
 void QNetworkProxyQuery::setNetworkConfiguration(const QNetworkConfiguration &networkConfiguration)
 {