diff --git a/src/corelib/global/qnamespace.qdoc b/src/corelib/global/qnamespace.qdoc
index 169c296bcdd..29b58783d5e 100644
--- a/src/corelib/global/qnamespace.qdoc
+++ b/src/corelib/global/qnamespace.qdoc
@@ -3326,6 +3326,8 @@
 
   This is a dummy type, designed to help users transition from certain deprecated APIs to their replacement APIs.
 
+  \sa QCursor::bitmap()
+  \sa QCursor::mask()
   \sa QLabel::picture()
   \sa QLabel::pixmap()
 */
diff --git a/src/gui/kernel/qcursor.cpp b/src/gui/kernel/qcursor.cpp
index 2018d28d92a..7f6fdafbd0e 100644
--- a/src/gui/kernel/qcursor.cpp
+++ b/src/gui/kernel/qcursor.cpp
@@ -614,8 +614,8 @@ const QBitmap *QCursor::mask() const
     QBitmap bmpVal = cursor->bitmap(Qt::ReturnByValue);
     \endcode
 
-    If you disable the deprecated version, then you can omit \c Qt::ReturnByValue
-    as shown below:
+    If you disable the deprecated version using the QT_DISABLE_DEPRECATED_BEFORE
+    macro, then you can omit \c Qt::ReturnByValue as shown below:
 
     \code
     QBitmap bmpVal = cursor->bitmap();
@@ -646,8 +646,8 @@ QBitmap QCursor::bitmap(Qt::ReturnByValue_t) const
     QBitmap bmpVal = cursor->mask(Qt::ReturnByValue);
     \endcode
 
-    If you disable the deprecated version, then you can omit \c Qt::ReturnByValue
-    as shown below:
+    If you disable the deprecated version using the QT_DISABLE_DEPRECATED_BEFORE
+    macro, then you can omit \c Qt::ReturnByValue as shown below:
 
     \code
     QBitmap bmpVal = cursor->mask();