Clean up the docs of qevent.cpp

- Build the docs for deprecated APIs conditionally, based on
  deprecation version.

- Remove the docs of methods deprecated since 5.0.0, these methods
  are not compiled anymore.

Change-Id: I2c1b038ce125ca737944f4fc4a28e2f6852eaded
Reviewed-by: Tor Arne Vestbø <tor.arne.vestbo@qt.io>

1 files changed, 2 insertions, 50 deletions

diff --git a/src/gui/kernel/qevent.cpp b/src/gui/kernel/qevent.cpp
index ec52791010..d79066adf2 100644
--- a/src/gui/kernel/qevent.cpp
+++ b/src/gui/kernel/qevent.cpp
@@ -535,13 +535,6 @@ Qt::MouseEventFlags QMouseEvent::flags() const
 */
 
 /*!
-    \fn QPointF QMouseEvent::posF() const
-    \obsolete
-
-    Use localPos() instead.
-*/
-
-/*!
     \class QHoverEvent
     \ingroup events
     \inmodule QtGui
@@ -1102,16 +1095,6 @@ QKeyEvent::~QKeyEvent()
 }
 
 /*!
-    \fn QKeyEvent *QKeyEvent::createExtendedKeyEvent(Type type, int key, Qt::KeyboardModifiers modifiers, quint32 nativeScanCode, quint32 nativeVirtualKey, quint32 nativeModifiers, const QString& text, bool autorep, ushort count)
-    \internal
-*/
-
-/*!
-    \fn bool QKeyEvent::hasExtendedInfo() const
-    \internal
-*/
-
-/*!
   \fn quint32 QKeyEvent::nativeScanCode() const
   \since 4.2
 
@@ -2539,7 +2522,7 @@ Qt::MouseButtons QTabletEvent::buttons() const
     globalPos() can differ significantly from the current position
     QCursor::pos().
 
-    \sa globalX(), globalY(), hiResGlobalPos()
+    \sa globalX(), globalY()
 */
 
 /*!
@@ -2584,15 +2567,6 @@ Qt::MouseButtons QTabletEvent::buttons() const
 */
 
 /*!
-    \fn const QPointF &QTabletEvent::hiResGlobalPos() const
-
-    The high precision coordinates delivered from the tablet expressed.
-    Sub pixeling information is in the fractional part of the QPointF.
-
-    \sa globalPos(), hiResGlobalX(), hiResGlobalY()
-*/
-
-/*!
     \fn qreal &QTabletEvent::hiResGlobalX() const
 
     The high precision x position of the tablet device.
@@ -2674,10 +2648,10 @@ Qt::MouseButtons QTabletEvent::buttons() const
     \sa Qt::NativeGestureType, QGestureEvent
 */
 
+#if QT_DEPRECATED_SINCE(5, 10)
 /*!
     \deprecated The QTouchDevice parameter is now required
 */
-#if QT_DEPRECATED_SINCE(5, 10)
 QNativeGestureEvent::QNativeGestureEvent(Qt::NativeGestureType type, const QPointF &localPos, const QPointF &windowPos,
                                          const QPointF &screenPos, qreal realValue, ulong sequenceId, quint64 intValue)
     : QInputEvent(QEvent::NativeGesture), mGestureType(type),
@@ -4290,18 +4264,6 @@ QWindowStateChangeEvent::~QWindowStateChangeEvent()
     QGraphicsItem::acceptTouchEvents()
 */
 
-/*! \enum QTouchEvent::DeviceType
-    \obsolete
-
-    This enum represents the type of device that generated a QTouchEvent.
-
-    This enum has been deprecated. Use QTouchDevice::DeviceType instead.
-    \omitvalue TouchPad
-    \omitvalue TouchScreen
-
-    \sa QTouchDevice::DeviceType, QTouchDevice::type(), QTouchEvent::device()
-*/
-
 /*!
     Constructs a QTouchEvent with the given \a eventType, \a device, and
     \a touchPoints. The \a touchPointStates and \a modifiers
@@ -4341,16 +4303,6 @@ QTouchEvent::~QTouchEvent()
     This is typically a QWidget or a QQuickItem. May be 0 when no specific target is available.
 */
 
-/*! \fn QTouchEvent::DeviceType QTouchEvent::deviceType() const
-    \obsolete
-
-    Returns the touch device Type, which is of type \l {QTouchEvent::DeviceType} {DeviceType}.
-
-    This function has been deprecated. Use QTouchDevice::type() instead.
-
-    \sa QTouchDevice::type(), QTouchEvent::device()
-*/
-
 /*! \fn QTouchEvent::TouchPoint::TouchPoint(TouchPoint &&other)
 
     Move-constructs a TouchPoint instance, making it point to the same