From 5728c8a8e7c994b931d340315c241350d646f62a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Samuel=20R=C3=B8dal?= <samuel.rodal@nokia.com>
Date: Thu, 15 Mar 2012 15:55:46 +0100
Subject: [PATCH] Added missing \since 5.0 and tweaked some docs in QtGui.

Change-Id: I91564f7a61962f97b9fb78c96d94d5695a3924db
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
---
 src/gui/kernel/qevent.cpp          | 11 +++++++----
 src/gui/kernel/qguiapplication.cpp |  1 +
 src/gui/kernel/qopenglcontext.cpp  |  2 ++
 src/gui/kernel/qscreen.cpp         |  1 +
 src/gui/kernel/qstylehints.cpp     |  5 +++++
 src/gui/kernel/qsurface.cpp        |  1 +
 src/gui/kernel/qsurfaceformat.cpp  |  1 +
 src/gui/kernel/qwindow.cpp         |  1 +
 8 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/src/gui/kernel/qevent.cpp b/src/gui/kernel/qevent.cpp
index 52cb799b39..57c8bbdfdd 100644
--- a/src/gui/kernel/qevent.cpp
+++ b/src/gui/kernel/qevent.cpp
@@ -1146,12 +1146,13 @@ QMoveEvent::~QMoveEvent()
 
 /*!
     \class QExposeEvent
+    \since 5.0
     \brief The QExposeEvent class contains event parameters for expose events.
 
     \ingroup events
 
-    Expose events are sent to widgets when an area of the widget is invalidated
-    and needs to be flushed from the backing store.
+    Expose events are sent to windows when an area of the window is invalidated
+    or window visibility in the windowing system changes.
 
     The event handler QWindow::exposeEvent() receives expose events.
 */
@@ -1761,9 +1762,11 @@ void QInputMethodEvent::setTentativeCommitString(const QString &tentativeCommitS
     \sa setTentativeCommitString()
 */
 
-/*! \class QInputMethodQueryEvent
+/*!
+    \class QInputMethodQueryEvent
+    \since 5.0
 
-    This event is sent by the input context to input objects.
+    \brief This event is sent by the input context to input objects.
 
     It is used by the
     input method to query a set of properties of the object to be
diff --git a/src/gui/kernel/qguiapplication.cpp b/src/gui/kernel/qguiapplication.cpp
index ca1ecbef2b..d72647091d 100644
--- a/src/gui/kernel/qguiapplication.cpp
+++ b/src/gui/kernel/qguiapplication.cpp
@@ -195,6 +195,7 @@ static inline void clearFontUnlocked()
     flow and main settings.
 
     \inmodule QtGui
+    \since 5.0
 
     QGuiApplication contains the main event loop, where all events from the window
     system and other sources are processed and dispatched. It also handles the
diff --git a/src/gui/kernel/qopenglcontext.cpp b/src/gui/kernel/qopenglcontext.cpp
index f9ebf8820c..eaff417f15 100644
--- a/src/gui/kernel/qopenglcontext.cpp
+++ b/src/gui/kernel/qopenglcontext.cpp
@@ -76,6 +76,7 @@ QMutex QOpenGLContextPrivate::makeCurrentTrackerMutex;
 
 /*!
     \class QOpenGLContext
+    \since 5.0
     \brief The QOpenGLContext represents a native OpenGL context, enabling
            OpenGL rendering on a QSurface.
 
@@ -621,6 +622,7 @@ void QOpenGLContext::deleteQGLContext()
 
 /*!
     \class QOpenGLContextGroup
+    \since 5.0
     \brief The QOpenGLContextGroup represents a group of contexts sharing
     OpenGL resources.
 
diff --git a/src/gui/kernel/qscreen.cpp b/src/gui/kernel/qscreen.cpp
index da0716b7d5..5d7ffdbc2b 100644
--- a/src/gui/kernel/qscreen.cpp
+++ b/src/gui/kernel/qscreen.cpp
@@ -50,6 +50,7 @@ QT_BEGIN_NAMESPACE
 
 /*!
     \class QScreen
+    \since 5.0
     \brief The QScreen class is used to query screen properties.
 
     A note on logical vs physical dots per inch: physical DPI is based on the
diff --git a/src/gui/kernel/qstylehints.cpp b/src/gui/kernel/qstylehints.cpp
index c98158b6b6..15fcec21d8 100644
--- a/src/gui/kernel/qstylehints.cpp
+++ b/src/gui/kernel/qstylehints.cpp
@@ -50,6 +50,11 @@ static inline QVariant hint(QPlatformIntegration::StyleHint h)
     return QGuiApplicationPrivate::platformIntegration()->styleHint(h);
 }
 
+/*!
+    \class QStyleHints
+    \since 5.0
+    \brief The QStyleHints contains platform specific hints and settings.
+ */
 QStyleHints::QStyleHints()
     : QObject()
 {
diff --git a/src/gui/kernel/qsurface.cpp b/src/gui/kernel/qsurface.cpp
index eb2676802b..534135cc2f 100644
--- a/src/gui/kernel/qsurface.cpp
+++ b/src/gui/kernel/qsurface.cpp
@@ -46,6 +46,7 @@ QT_BEGIN_NAMESPACE
 
 /*!
     \class QSurface
+    \since 5.0
     \brief The QSurface class is an abstraction of renderable surfaces in Qt.
 
     The size of the surface is accessible with the size() function. The rendering
diff --git a/src/gui/kernel/qsurfaceformat.cpp b/src/gui/kernel/qsurfaceformat.cpp
index 9021d82e20..cc6b621047 100644
--- a/src/gui/kernel/qsurfaceformat.cpp
+++ b/src/gui/kernel/qsurfaceformat.cpp
@@ -108,6 +108,7 @@ public:
 
 /*!
     \class QSurfaceFormat
+    \since 5.0
     \brief The QSurfaceFormat class represents the format of a QSurface.
 
     The format includes the size of the color buffers, red, green, and blue;
diff --git a/src/gui/kernel/qwindow.cpp b/src/gui/kernel/qwindow.cpp
index 91eb7bdb88..78b6f6f722 100644
--- a/src/gui/kernel/qwindow.cpp
+++ b/src/gui/kernel/qwindow.cpp
@@ -63,6 +63,7 @@ QT_BEGIN_NAMESPACE
 
 /*!
     \class QWindow
+    \since 5.0
     \brief The QWindow class represents a window in the underlying windowing system.
 
     A window that is supplied a parent becomes a native child window of