Doc: Fix documentation warnings for Qt Quick

- Remove links to modules and examples that are not part of Qt 6.
- Remove links to entities marked as \internal
- Add missing enum value and QML property docs where it's trivial
  to do so.

Task-number: QTBUG-88156
Change-Id: I10a1c7bcc5fe0e2354ea69eaf24930362edb7415
Reviewed-by: Paul Wicking <paul.wicking@qt.io>

34 files changed, 118 insertions, 135 deletions

diff --git a/examples/quick/scenegraph/metaltextureimport/doc/src/metaltextureimport.qdoc b/examples/quick/scenegraph/metaltextureimport/doc/src/metaltextureimport.qdoc
index 1d6e0ab5c0..3fb2cd357e 100644
--- a/examples/quick/scenegraph/metaltextureimport/doc/src/metaltextureimport.qdoc
+++ b/examples/quick/scenegraph/metaltextureimport/doc/src/metaltextureimport.qdoc
@@ -37,8 +37,7 @@
     use a
     \l{https://developer.apple.com/documentation/metal/mtltexture}{MTLTexture}
     in the Qt Quick scene. This provides an alternative to the \l{Scene Graph -
-    Metal Under QML}{underlay}, overlay, or \l{Scene Graph - Custom Rendering
-    with QSGRenderNode}{render node} approaches when it comes to integrating
+    Metal Under QML}{underlay} or overlay approaches when it comes to integrating
     native Metal rendering. In many cases going through a texture, and
     therefore "flattening" the 3D contents first, is the best option to
     integrate and mix custom 3D contents with the 2D UI elements provided by Qt
diff --git a/examples/quick/scenegraph/vulkantextureimport/doc/src/vulkantextureimport.qdoc b/examples/quick/scenegraph/vulkantextureimport/doc/src/vulkantextureimport.qdoc
index 334291f990..6da6b7ab6d 100644
--- a/examples/quick/scenegraph/vulkantextureimport/doc/src/vulkantextureimport.qdoc
+++ b/examples/quick/scenegraph/vulkantextureimport/doc/src/vulkantextureimport.qdoc
@@ -38,8 +38,7 @@
     use a
     \l{https://www.khronos.org/registry/vulkan/specs/1.1-extensions/man/html/VkImage.html}
     {VkImage} in the Qt Quick scene. This provides an alternative to the \l{Scene Graph -
-    Vulkan Under QML}{underlay}, overlay, or \l{Scene Graph - Custom Rendering
-    with QSGRenderNode}{render node} approaches when it comes to integrating
+    Vulkan Under QML}{underlay} or overlay approaches when it comes to integrating
     native Vulkan rendering.
 
     This example is equivalent in most ways to the \l{Scene Graph - Metal Texture Import}{Metal Texture Import}
diff --git a/src/quick/doc/src/concepts/input/topic.qdoc b/src/quick/doc/src/concepts/input/topic.qdoc
index 95f4732f46..dd919c157e 100644
--- a/src/quick/doc/src/concepts/input/topic.qdoc
+++ b/src/quick/doc/src/concepts/input/topic.qdoc
@@ -67,7 +67,7 @@ events and key-presses, and displays the appropriate text.  See the
 documentation about \l{qtquick-input-textinput.html}{text input} for
 in-depth information on the topic.
 
-
+\omit //! QtSensors
 \section1 Device Motion Gestures
 
 Detecting device gestures with an accelerometer, or through camera-based gesture
@@ -78,6 +78,7 @@ and engaging experience.
 Qt Quick itself does not offer first-class support for physical device motion gestures;
 however, the \l{Qt Sensors} module provides QML types with support for such gestures.
 See the \l{Qt Sensors} module documentation for more information on the topic.
+\endomit //! QtSensors
 
 */
 
diff --git a/src/quick/doc/src/concepts/modelviewsdata/cppmodels.qdoc b/src/quick/doc/src/concepts/modelviewsdata/cppmodels.qdoc
index 7695bb57db..73f5318921 100644
--- a/src/quick/doc/src/concepts/modelviewsdata/cppmodels.qdoc
+++ b/src/quick/doc/src/concepts/modelviewsdata/cppmodels.qdoc
@@ -36,7 +36,7 @@
 Models can be defined in C++ and then made available to QML. This is useful
 for exposing existing C++ data models or otherwise complex datasets to QML.
 
-A C++ model class can be defined as a \l QStringList, a \l QVariantList, a
+A C++ model class can be defined as a \l QStringList, a \l {QVariant::}{QVariantList}, a
 QObjectList or a \l QAbstractItemModel. The first three are useful for exposing
 simpler datasets, while QAbstractItemModel provides a more flexible solution for
 more complex models.
@@ -71,8 +71,8 @@ the model by calling QQmlContext::setContextProperty() again.
 
 \section2 QVariantList-based Model
 
-A model may be a single \l QVariantList, which provides the contents of the list
-via the \e modelData role.
+A model may be a single \l {QVariant::}{QVariantList}, which provides the contents
+of the list via the \e modelData role.
 
 The API works just like with \l QStringList, as shown in the previous section.
 
diff --git a/src/quick/doc/src/concepts/modelviewsdata/modelview.qdoc b/src/quick/doc/src/concepts/modelviewsdata/modelview.qdoc
index 4736dc7ddd..607479a03d 100644
--- a/src/quick/doc/src/concepts/modelviewsdata/modelview.qdoc
+++ b/src/quick/doc/src/concepts/modelviewsdata/modelview.qdoc
@@ -236,7 +236,7 @@ To visualize data, bind the view's \c model property to a model and the
     Even if subsequent roles are added, only the first two will be handled by views
     using the model. To reset the roles available in the model, call ListModel::clear().
 
-
+\omit //! XmlListModel
     \section2 XML Model
 
     XmlListModel allows construction of a model from an XML data source. The roles
@@ -264,7 +264,7 @@ To visualize data, bind the view's \c model property to a model and the
 
     The \l{Qt Quick Demo - RSS News}{RSS News demo} shows how XmlListModel can
     be used to display an RSS feed.
-
+\endomit
 
     \section2 Object Model
 
@@ -431,7 +431,7 @@ ListView {
 \note The \c edit role is equal to \l Qt::EditRole. See \l{QAbstractItemModel::}{roleNames}()
 for the built-in role names. However, real life models would usually register custom roles.
 
-\note If a model role is bound to a \l{Required Property}{required property}, assigning to
+\note If a model role is bound to a \l{Required Properties}{required property}, assigning to
 that property will not modify the model. It will instead break the binding to the model (just
 like assigning to any other property breaks existing bindings). If you want to use
 required properties and change the model data, make model also a required property and assign to
diff --git a/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc b/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc
index e330806c85..9d5c4aaf09 100644
--- a/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc
+++ b/src/quick/doc/src/concepts/visualcanvas/adaptations.qdoc
@@ -136,12 +136,6 @@ updates can significantly improve performance for many applications.
 
 ShaderEffect components in QtQuick 2 cannot be rendered by the Software adaptation.
 
-\section2 Qt Graphical Effects Module
-
-\l {Qt Graphical Effects} uses ShaderEffect items to render effects. If you use graphical effects
-from this module, then you should not hide the source item so that the original item can still be
-rendered.
-
 \section2 Particle Effects
 
 It is not possible to render particle effects with the Software adaptation. Whenever possible,
@@ -209,12 +203,6 @@ to take advantage of Image Filter operations in the OpenVG API to get effects th
 what ShaderEffects provides in custom items. To integrate custom OpenVG rendering, use
 QSGRenderNode in combination with QSGRendererInterface.
 
-\section2 Qt Graphical Effects Module
-
-\l {Qt Graphical Effects} uses ShaderEffect items to render effects. If you use graphical effects
-from this module, then you shouldn't hide the source item so that the original item can still be
-rendered.
-
 \section2 Particle Effects
 
 It's not possible to render particle effects with the OpenVG adaptation. Whenever possible, remove
diff --git a/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc b/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc
index 691988999b..faec8df7e4 100644
--- a/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc
+++ b/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc
@@ -145,9 +145,6 @@ type.
 Below is a complete list of material classes:
 \annotatedlist{qtquick-scenegraph-materials}
 
-For more details, see the \l {Scene Graph - Simple Material}
-
-
 \section2 Convenience Nodes
 
 The scene graph API is low-level and focuses on performance rather than
@@ -196,7 +193,7 @@ the CPU at 100%. If a system is known to be unable to provide vsync-based
 throttling, use the \c basic render loop instead by setting \c
 {QSG_RENDER_LOOP=basic} in the environment.
 
-\section2 Threaded Render Loop ("threaded")
+\section2 Threaded Render Loop ('threaded')
 
 On many configurations, the scene graph rendering will happen on a
 dedicated render thread. This is done to increase parallelism of
@@ -279,7 +276,7 @@ change in future releases.  It is always possible to force use of the
 threaded renderer by setting \c {QSG_RENDER_LOOP=threaded} in the
 environment.
 
-\section2 Non-threaded Render Loop ("basic")
+\section2 Non-threaded Render Loop ('basic')
 
 The non-threaded render loop is currently used by default on Windows with
 OpenGL when not using the system's standard opengl32.dll, \macos with OpenGL,
@@ -346,10 +343,7 @@ how to use these signals using Vulkan.
 The other alternative, only available for OpenGL currently, is to create a
 QQuickFramebufferObject, render into it, and let it be displayed in the scene
 graph as a texture. The \l {Scene Graph - Rendering FBOs} example shows how
-this can be done. It is also possible to combine multiple rendering contexts
-and multiple threads to create content to be displayed in the scene graph. The
-\l {Scene Graph - Rendering FBOs in a thread} examples show how this can be
-done.
+this can be done.
 
 Graphics APIs other than OpenGL can also follow this approach, even though
 QQuickFramebufferObject does not currently support them. Creating and rendering
diff --git a/src/quick/doc/src/examples.qdoc b/src/quick/doc/src/examples.qdoc
index d24964f8b1..6ba7d701fc 100644
--- a/src/quick/doc/src/examples.qdoc
+++ b/src/quick/doc/src/examples.qdoc
@@ -123,7 +123,6 @@ Creator.
         \b{QML Types and Controls}
         \list
         \li \l{Qt Quick Controls - Gallery}{Controls Gallery}
-        \li \l{Qt Quick System Dialog Examples}{Dialog Examples}
         \li \l{Calendar Example}
         \li \l{tableview/gameoflife}{TableView}
         \li \l{Qt Quick Examples - Text}{Text and Fonts}
diff --git a/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc b/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc
index e3353ef077..07934ad232 100644
--- a/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc
+++ b/src/quick/doc/src/guidelines/qtquick-toolsnutilities.qdoc
@@ -111,7 +111,7 @@ integrating 3rd party tools such as QmlLive and GammaRay.
 \endlist
 
 \section1 qmllint
-qmllint is a tool shipped with Qt, that verifies the syntatic validity of QML files.
+\e qmllint is a tool shipped with Qt, that verifies the syntatic validity of QML files.
 It also warns about some QML anti-patterns. If you want to disable a specific
 warning type, you can find the appropriate flag for doing so by passing \c{--help} on the command line.
 
@@ -130,12 +130,12 @@ via the -I flag.
 
 \section2 Related Information
 \list
-  \li \l{qmltypes}
+  \li \l{Writing a qmltypes File}{qmltypes}
 \endlist
 
 \section1 qmlformat
 
-qmlformat is a tool that automatically formats QML files in accordance
+\e qmlformat is a tool that automatically formats QML files in accordance
 with the \l{QML Coding Conventions}.
 
 The tool groups all properties, functions, and signals together, instead of
@@ -148,5 +148,5 @@ By default, qmlformat writes the formatted version of the file to stdout.
 If you wish to have your file updated in-place specify the \c{-i} flag.
 
 \section2 Related Information
-\sa \l{QML Coding Conventions}
+\sa {QML Coding Conventions}
 */
diff --git a/src/quick/doc/src/qmltypereference.qdoc b/src/quick/doc/src/qmltypereference.qdoc
index 528444cad3..af46c5dcc3 100644
--- a/src/quick/doc/src/qmltypereference.qdoc
+++ b/src/quick/doc/src/qmltypereference.qdoc
@@ -49,16 +49,10 @@ information about the concepts which are central to \c QtQuick.
     Qt Quick includes several submodules which contain additional types.
 
     \list
-    \li \l{Qt Quick XmlListModel QML Types}{Xml List Model} - contains types
-    for creating models from XML data
     \li \l{Qt Quick Local Storage QML Types}{Local Storage} - a submodule
     containing a JavaScript interface for an SQLite database
     \li \l{Qt Quick Particles QML Types}{Particles} - provides a particle
     system for QML applications
-    \li \l{Qt Quick Window QML Types}{Window} - contains types for creating
-    top-level windows and accessing screen information
-    \li \l{Qt Quick Dialogs QML Types}{Dialogs} - contains types for creating and
-    interacting with system dialogs
     \li \l{Qt Quick Controls QML Types}{Controls} - provides a set of reusable
     UI components
     \li \l{Qt Quick Layouts QML Types}{Layouts} - contains types that are used
diff --git a/src/quick/doc/src/qtquick.qdoc b/src/quick/doc/src/qtquick.qdoc
index 4b843f366b..da370d7828 100644
--- a/src/quick/doc/src/qtquick.qdoc
+++ b/src/quick/doc/src/qtquick.qdoc
@@ -104,17 +104,11 @@ Additional Qt Quick information:
 \li \l{Qt Quick QML Types} - a list of QML types provided by the
     \c{QtQuick} import
     \list
-    \li \l{Qt Quick XmlListModel QML Types}{XML List Model} - contains types
-    for creating models from XML data
     \li \l{Qt Quick Local Storage QML Types}{Local Storage} - a submodule
     containing a JavaScript interface for an SQLite database
     \li \l{Qt Quick Particles QML Types}{Particles} - provides a particle
     system for Qt Quick
     \li \l{Qt Quick Layouts}{Layouts} - provides layouts for arranging Qt Quick items
-    \li \l{Qt Quick Window QML Types}{Window} - contains types for creating
-    top-level windows and accessing screen information
-    \li \l{Qt Quick Dialogs}{Dialogs} - contains types for creating and
-    interacting with system dialogs
     \li \l{Qt Quick Test QML Types}{Tests} - contains types for writing unit test for a QML application
     \endlist
 \li \l{Qt Quick Examples and Tutorials}
diff --git a/src/quick/doc/src/tutorial.qdoc b/src/quick/doc/src/tutorial.qdoc
index 7cb5f655e8..e84753d895 100644
--- a/src/quick/doc/src/tutorial.qdoc
+++ b/src/quick/doc/src/tutorial.qdoc
@@ -220,5 +220,6 @@ This is equivalent to writing the two transitions separately.
 The \l ParallelAnimation type makes sure that the two types of animations (number and color) start at the same time.
 We could also run them one after the other by using \l SequentialAnimation instead.
 
-For more details on states and transitions, see \l {Qt Quick States} and the \l{animation/states}{states and transitions example}.
+For more details on states and transitions, see \l {Qt Quick States} and the
+\l{Qt Quick Examples - Animation#States}{states and transitions example}.
 */
diff --git a/src/quick/handlers/qquickhandlerpoint.cpp b/src/quick/handlers/qquickhandlerpoint.cpp
index 58123630ac..35c3bb1b3f 100644
--- a/src/quick/handlers/qquickhandlerpoint.cpp
+++ b/src/quick/handlers/qquickhandlerpoint.cpp
@@ -218,7 +218,7 @@ void QQuickHandlerPoint::reset(const QVector<QQuickHandlerPoint> &points)
     Interpreting the contents of this ID requires knowledge of the hardware and
     drivers in use.
 
-    \sa QTabletEvent::uniqueId, QtQuick::TouchPoint::uniqueId, QtQuick::EventTouchPoint::uniqueId
+    \sa QTabletEvent::uniqueId, QtQuick::TouchPoint::uniqueId
 */
 
 /*!
@@ -295,7 +295,7 @@ void QQuickHandlerPoint::reset(const QVector<QQuickHandlerPoint> &points)
     nonzero when this point is in motion. It holds the average recent velocity:
     how fast and in which direction the event point has been moving recently.
 
-    \sa QtQuick::EventPoint::velocity, QtQuick::TouchPoint::velocity, QEventPoint::velocity
+    \sa QtQuick::TouchPoint::velocity, QEventPoint::velocity
 */
 
 /*!
@@ -345,7 +345,7 @@ void QQuickHandlerPoint::reset(const QVector<QQuickHandlerPoint> &points)
     If the contact patch is unknown, or the device is not a touchscreen,
     these values will be zero.
 
-    \sa QtQuick::EventTouchPoint::ellipseDiameters, QtQuick::TouchPoint::ellipseDiameters, QEventPoint::ellipseDiameters
+    \sa QtQuick::TouchPoint::ellipseDiameters, QEventPoint::ellipseDiameters
 */
 
 QT_END_NAMESPACE
diff --git a/src/quick/handlers/qquickhoverhandler.cpp b/src/quick/handlers/qquickhoverhandler.cpp
index cdb9b2578c..c105bf6537 100644
--- a/src/quick/handlers/qquickhoverhandler.cpp
+++ b/src/quick/handlers/qquickhoverhandler.cpp
@@ -176,14 +176,14 @@ void QQuickHoverHandler::setHovered(bool hovered)
     \endlist
 
     The default value of this property is not set, which allows any active
-    handler on the same \l parentItem to determine the cursor shape.
+    handler on the same \e parent item to determine the cursor shape.
     This property can be reset to the initial condition by setting it to
     \c undefined.
 
     If any handler with defined \c cursorShape is
     \l {PointerHandler::active}{active}, that cursor will appear.
     Else if the HoverHandler has a defined \c cursorShape, that cursor will appear.
-    Otherwise, the \l {QQuickItem::cursor()}{cursor} of \l parentItem will appear.
+    Otherwise, the \l {QQuickItem::cursor()}{cursor} of \e parent item will appear.
 
     \note When this property has not been set, or has been set to \c undefined,
     if you read the value it will return \c Qt.ArrowCursor.
diff --git a/src/quick/handlers/qquickpointerdevicehandler.cpp b/src/quick/handlers/qquickpointerdevicehandler.cpp
index a27aec7d56..a838f46d83 100644
--- a/src/quick/handlers/qquickpointerdevicehandler.cpp
+++ b/src/quick/handlers/qquickpointerdevicehandler.cpp
@@ -136,7 +136,7 @@ Qt::KeyboardModifiers QQuickPointerDeviceHandler::acceptedModifiers() const
     The types of pointing devices that can activate this Pointer Handler.
 
     By default, this property is set to
-    \l{QtQuick::PointerDevice::type} {PointerDevice.AllDevices}.
+    \l{QInputDevice::DeviceType}{PointerDevice.AllDevices}.
     If you set it to an OR combination of device types, it will ignore events
     from non-matching devices.
 
@@ -173,7 +173,7 @@ void QQuickPointerDeviceHandler::setAcceptedDevices(QPointingDevice::DeviceTypes
     that can activate this Pointer Handler.
 
     By default, this property is set to
-    \l {QtQuick::PointerDevice::pointerType} {PointerDevice.AllPointerTypes}.
+    \l {QPointingDevice::PointerType} {PointerDevice.AllPointerTypes}.
     If you set it to an OR combination of device types, it will ignore events
     from non-matching events.
 
diff --git a/src/quick/handlers/qquickpointerhandler.cpp b/src/quick/handlers/qquickpointerhandler.cpp
index a9cf294e2b..cae700b1c8 100644
--- a/src/quick/handlers/qquickpointerhandler.cpp
+++ b/src/quick/handlers/qquickpointerhandler.cpp
@@ -157,7 +157,7 @@ void QQuickPointerHandler::resetDragThreshold()
     \since 5.15
     \qmlproperty Qt::CursorShape PointerHandler::cursorShape
     This property holds the cursor shape that will appear whenever the mouse is
-    hovering over the \l parentItem while \l active is \c true.
+    hovering over the \l parent item while \l active is \c true.
 
     The available cursor shapes are:
     \list
@@ -186,7 +186,7 @@ void QQuickPointerHandler::resetDragThreshold()
     \endlist
 
     The default value is not set, which allows the \l {QQuickItem::cursor()}{cursor}
-    of \l parentItem to appear. This property can be reset to the same initial
+    of \l parent item to appear. This property can be reset to the same initial
     condition by setting it to undefined.
 
     \note When this property has not been set, or has been set to \c undefined,
diff --git a/src/quick/handlers/qquickwheelhandler.cpp b/src/quick/handlers/qquickwheelhandler.cpp
index b9c112a0d2..563bf16b49 100644
--- a/src/quick/handlers/qquickwheelhandler.cpp
+++ b/src/quick/handlers/qquickwheelhandler.cpp
@@ -163,10 +163,12 @@ void QQuickWheelHandler::setInvertible(bool invertible)
     \l {Qt::ScrollPhase}{scroll phase} information, such as events from some
     touchpads, the \l active property will become \c false as soon as an event
     with phase \l Qt::ScrollEnd is received; in that case the timeout is not
-    necessary. But a conventional mouse with a wheel does not provide the
-    \l {QQuickPointerScrollEvent::phase}{scroll phase}: the mouse cannot detect
-    when the user has decided to stop scrolling, so the \l active property
-    transitions to \c false after this much time has elapsed.
+    necessary. But a conventional mouse with a wheel does not provide a scroll
+    phase: the mouse cannot detect when the user has decided to stop
+    scrolling, so the \l active property transitions to \c false after this
+    much time has elapsed.
+
+    \sa QWheelEvent::phase()
 */
 qreal QQuickWheelHandler::activeTimeout() const
 {
@@ -506,8 +508,9 @@ void QQuickWheelHandler::timerEvent(QTimerEvent *event)
 /*!
     \qmlsignal QtQuick::WheelHandler::wheel(PointerScrollEvent event)
 
-    This signal is emitted every time this handler receives a \l QWheelEvent:
-    that is, every time the wheel is moved or the scrolling gesture is updated.
+    This signal is emitted every time this handler receives an \a event
+    of type \l QWheelEvent: that is, every time the wheel is moved or the
+    scrolling gesture is updated.
 */
 
 QQuickWheelHandlerPrivate::QQuickWheelHandlerPrivate()
diff --git a/src/quick/items/context2d/qquickcontext2d.cpp b/src/quick/items/context2d/qquickcontext2d.cpp
index 87d308d243..cbc4105ea4 100644
--- a/src/quick/items/context2d/qquickcontext2d.cpp
+++ b/src/quick/items/context2d/qquickcontext2d.cpp
@@ -3011,7 +3011,8 @@ QV4::ReturnedValue QQuickJSContext2DPrototype::method_strokeText(const QV4::Func
   \qmlmethod object QtQuick::Context2D::measureText(text)
 
   Returns an object with a \c width property, whose value is equivalent to
-  calling \l {QFontMetrics::width()} with the given \a text in the current font.
+  calling QFontMetrics::horizontalAdvance() with the given \a text in the
+  current font.
   */
 QV4::ReturnedValue QQuickJSContext2DPrototype::method_measureText(const QV4::FunctionObject *b, const QV4::Value *thisObject, const QV4::Value *argv, int argc)
 {
diff --git a/src/quick/items/qquickcolorgroup.cpp b/src/quick/items/qquickcolorgroup.cpp
index 5eedefea83..e2227e3197 100644
--- a/src/quick/items/qquickcolorgroup.cpp
+++ b/src/quick/items/qquickcolorgroup.cpp
@@ -54,7 +54,8 @@ QT_BEGIN_NAMESPACE
 
     Used by QQuickPalette to provide different groups of colors by roles.
 
-    \sa QQuickPalette, QQuickAbstractPaletteProvider, QPalette::ColorRole
+    \sa QPalette::ColorRole
+    //! internal \sa QQuickPalette, QQuickAbstractPaletteProvider
  */
 
 /*!
@@ -207,7 +208,7 @@ QT_BEGIN_NAMESPACE
     Additional signal indicates that the current state of this color group
     has been changed. Usually it means that one of the colors is changed.
 
-    \sa QtQuick::Palette::changed
+    \sa Palette
 */
 
 /*!
diff --git a/src/quick/items/qquickgridview.cpp b/src/quick/items/qquickgridview.cpp
index 32cc5edf40..90fa05f492 100644
--- a/src/quick/items/qquickgridview.cpp
+++ b/src/quick/items/qquickgridview.cpp
@@ -1315,8 +1315,8 @@ void QQuickGridView::setHighlightFollowsCurrentItem(bool autoHighlight)
 
     The model provides the set of data that is used to create the items
     in the view. Models can be created directly in QML using \l ListModel,
-    \l XmlListModel, \l DelegateModel, or \l ObjectModel, or provided by C++
-    model classes. If a C++ model class is used, it must be a subclass of
+    \l DelegateModel, \l ObjectModel, or provided by C++ model classes.
+    If a C++ model class is used, it must be a subclass of
     \l QAbstractItemModel or a simple list.
 
   \sa {qml-data-models}{Data Models}
@@ -1758,7 +1758,8 @@ void QQuickGridView::setSnapMode(SnapMode mode)
     \list
     \li The view is first created
     \li The view's \l model changes in such a way that the visible delegates are completely replaced
-    \li The view's \l model is \l {QAbstractItemModel::reset()}{reset}, if the model is a QAbstractItemModel subclass
+    \li The view's \l model is \l {QAbstractItemModel::beginResetModel()}{reset},
+        if the model is a QAbstractItemModel subclass
     \endlist
 
     For example, here is a view that specifies such a transition:
diff --git a/src/quick/items/qquickitem.cpp b/src/quick/items/qquickitem.cpp
index d0a3b45047..493b3e1590 100644
--- a/src/quick/items/qquickitem.cpp
+++ b/src/quick/items/qquickitem.cpp
@@ -1991,10 +1991,6 @@ void QQuickItemPrivate::updateSubFocusItem(QQuickItem *scope, bool focus)
     }
     \endqml
 
-    In this example, we implement the shader effect manually. The \l
-    {Qt Graphical Effects} module contains a suite of ready-made
-    effects for use with Qt Quick.
-
     See ShaderEffect for more information about using effects.
 
     \note \l layer.enabled is actually just a more convenient way of using
@@ -7576,7 +7572,7 @@ void QQuickItem::unsetCursor()
 /*!
     \internal
     Returns the cursor that should actually be shown, allowing the given
-    \handler to override the Item cursor if it is active or hovered.
+    \a handler to override the Item cursor if it is active or hovered.
 
     \sa cursor(), setCursor(), QtQuick::PointerHandler::cursor
 */
@@ -8339,7 +8335,7 @@ QSGTextureProvider *QQuickItem::textureProvider() const
     }
     \endcode
 
-    \sa Window::palette, Popup::palette, QQuickAbstractPaletteProvider, ColorGroup, Palette
+    \sa Window::palette, Popup::palette, ColorGroup, Palette
 */
 
 /*!
diff --git a/src/quick/items/qquicklistview.cpp b/src/quick/items/qquicklistview.cpp
index 420ab620ab..d55b543efc 100644
--- a/src/quick/items/qquicklistview.cpp
+++ b/src/quick/items/qquicklistview.cpp
@@ -1975,7 +1975,7 @@ QQuickItemViewAttached *QQuickListViewPrivate::getAttachedObject(const QObject *
     Delegates are instantiated as needed and may be destroyed at any time.
     As such, state should \e never be stored in a delegate.
     Delegates are usually parented to ListView's \l {Flickable::contentItem}{contentItem}, but
-    typically depending on whether it's visible in the view or not, the \l parent
+    typically depending on whether it's visible in the view or not, the \e parent
     can change, and sometimes be \c null. Because of that, binding to
     the parent's properties from within the delegate is \e not recommended. If you
     want the delegate to fill out the width of the ListView, consider
@@ -2221,8 +2221,8 @@ QQuickListView::~QQuickListView()
     This property holds the model providing data for the list.
 
     The model provides the set of data that is used to create the items
-    in the view. Models can be created directly in QML using \l ListModel, \l XmlListModel
-    or \l ObjectModel, or provided by C++ model classes. If a C++ model class is
+    in the view. Models can be created directly in QML using \l ListModel,
+    \l ObjectModel, or provided by C++ model classes. If a C++ model class is
     used, it must be a subclass of \l QAbstractItemModel or a simple list.
 
     \sa {qml-data-models}{Data Models}
@@ -2971,7 +2971,8 @@ void QQuickListView::setFooterPositioning(QQuickListView::FooterPositioning posi
     \list
     \li The view is first created
     \li The view's \l model changes in such a way that the visible delegates are completely replaced
-    \li The view's \l model is \l {QAbstractItemModel::reset()}{reset}, if the model is a QAbstractItemModel subclass
+    \li The view's \l model is \l {QAbstractItemModel::beginResetModel()}{reset}, if the model is a
+        QAbstractItemModel subclass
     \endlist
 
     For example, here is a view that specifies such a transition:
diff --git a/src/quick/items/qquickpalette.cpp b/src/quick/items/qquickpalette.cpp
index f5c0aa8b04..a64b309426 100644
--- a/src/quick/items/qquickpalette.cpp
+++ b/src/quick/items/qquickpalette.cpp
@@ -119,7 +119,15 @@ QT_BEGIN_NAMESPACE
 */
 
 /*!
-    \qmlproperty QQuickColorGroup QtQuick::QQuickPalette::inactive
+    \qmlproperty QQuickColorGroup QtQuick::Palette::active
+
+    The Active group is used for windows that are in focus.
+
+    \sa QPalette::Active
+*/
+
+/*!
+    \qmlproperty QQuickColorGroup QtQuick::Palette::inactive
 
     The Inactive group is used for windows that have no keyboard focus.
 
@@ -127,7 +135,7 @@ QT_BEGIN_NAMESPACE
 */
 
 /*!
-    \qmlproperty QQuickColorGroup QtQuick::QQuickPalette::disabled
+    \qmlproperty QQuickColorGroup QtQuick::Palette::disabled
 
     The Disabled group is used for elements that are disabled for some reason.
 
diff --git a/src/quick/items/qquickpincharea.cpp b/src/quick/items/qquickpincharea.cpp
index 8ed92de051..abb24dd6ca 100644
--- a/src/quick/items/qquickpincharea.cpp
+++ b/src/quick/items/qquickpincharea.cpp
@@ -200,7 +200,7 @@ QQuickPinchAreaPrivate::~QQuickPinchAreaPrivate()
     started: two touch points (fingers) have been detected, and they have moved
     beyond the \l {QStyleHints}{startDragDistance} threshold for the gesture to begin.
 
-    The \l {PinchEvent}{pinch} parameter (not the same as the \l {PinchArea}{pinch}
+    The \a pinch parameter (not the same as the \l {PinchArea}{pinch}
     property) provides information about the pinch gesture, including the scale,
     center and angle of the pinch. At the time of the \c pinchStarted signal,
     these values are reset to the default values, regardless of the results
@@ -217,7 +217,7 @@ QQuickPinchAreaPrivate::~QQuickPinchAreaPrivate()
 
     This signal is emitted when the pinch area detects that a pinch gesture has changed.
 
-    The \l {PinchEvent}{pinch} parameter provides information about the pinch
+    The \a pinch parameter provides information about the pinch
     gesture, including the scale, center and angle of the pinch. These values
     reflect changes only since the beginning of the current gesture, and
     therefore are not limited by the minimum and maximum limits in the
@@ -229,7 +229,7 @@ QQuickPinchAreaPrivate::~QQuickPinchAreaPrivate()
 
     This signal is emitted when the pinch area detects that a pinch gesture has finished.
 
-    The \l {PinchEvent}{pinch} parameter (not the same as the \l {PinchArea}{pinch}
+    The \a pinch parameter (not the same as the \l {PinchArea}{pinch}
     property) provides information about the pinch gesture, including the
     scale, center and angle of the pinch.
 */
@@ -238,10 +238,10 @@ QQuickPinchAreaPrivate::~QQuickPinchAreaPrivate()
     \qmlsignal QtQuick::PinchArea::smartZoom(PinchEvent pinch)
     \since 5.5
 
-    This signal is emitted when the pinch area detects the smart zoom gesture.
+    This signal is emitted when the pinch area detects a smart zoom gesture.
     This gesture occurs only on certain operating systems such as \macos.
 
-    The \l {PinchEvent}{pinch} parameter provides information about the pinch
+    The \a pinch parameter provides information about the pinch
     gesture, including the location where the gesture occurred.  \c pinch.scale
     will be greater than zero when the gesture indicates that the user wishes to
     enter smart zoom, and zero when exiting (even though typically the same gesture
diff --git a/src/quick/items/qquickrendercontrol.cpp b/src/quick/items/qquickrendercontrol.cpp
index 7d1ee373b2..c7a1ad973d 100644
--- a/src/quick/items/qquickrendercontrol.cpp
+++ b/src/quick/items/qquickrendercontrol.cpp
@@ -278,6 +278,8 @@ int QQuickRenderControl::samples() const
     responsibility to create a suitable QVulkanInstance and
     \l{QWindow::setVulkanInstance()}{associate it} with the QQuickWindow.
 
+    Returns \c true on success, \c false otherwise.
+
     \note This function does not need to be, and must not be, called when using
     the \c software adaptation of Qt Quick.
 
diff --git a/src/quick/items/qquickscreen.cpp b/src/quick/items/qquickscreen.cpp
index 10701efbfa..ffe8169381 100644
--- a/src/quick/items/qquickscreen.cpp
+++ b/src/quick/items/qquickscreen.cpp
@@ -216,12 +216,11 @@ QT_BEGIN_NAMESPACE
     window system perspective.
 
     Most mobile devices and tablet computers contain accelerometer sensors.
-    The Qt Sensors module provides the ability to read this sensor directly.
-    However, the windowing system may rotate the entire screen automatically
+    The windowing system may rotate the entire screen automatically
     based on how it is being held, or manually via settings to rotate a desktop
     monitor; in that case, this \c orientation property will change.
 
-    \sa primaryOrientation(), QWindow::contentOrientation(), QOrientationSensor
+    \sa primaryOrientation, QWindow::contentOrientation()
 */
 /*!
     \qmlattachedmethod int Screen::angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)
diff --git a/src/quick/items/qquickshadereffect.cpp b/src/quick/items/qquickshadereffect.cpp
index 3ae342b475..c2cf30a30e 100644
--- a/src/quick/items/qquickshadereffect.cpp
+++ b/src/quick/items/qquickshadereffect.cpp
@@ -354,9 +354,6 @@ QT_BEGIN_NAMESPACE
     corner. For non-linear vertex transformations, like page curl, you can
     specify a fine grid of vertices by specifying a \l mesh resolution.
 
-    The \l {Qt Graphical Effects} module contains several ready-made effects
-    for using with Qt Quick applications.
-
     \sa {Item Layers}
 */
 
diff --git a/src/quick/items/qquicktableview.cpp b/src/quick/items/qquicktableview.cpp
index 6f16562455..571ac90008 100644
--- a/src/quick/items/qquicktableview.cpp
+++ b/src/quick/items/qquicktableview.cpp
@@ -267,7 +267,7 @@
 
     The model provides the set of data that is used to create the items
     in the view. Models can be created directly in QML using \l TableModel,
-    \l ListModel, \l XmlListModel, or \l ObjectModel, or provided by a custom
+    \l ListModel, \l ObjectModel, or provided by a custom
     C++ model class. The C++ model must be a subclass of \l QAbstractItemModel
     or a simple list.
 
@@ -389,23 +389,22 @@
 /*!
     \qmlmethod QtQuick::TableView::positionViewAtCell(point cell, Qt.Alignment alignment, point offset)
 
-    Positions \l contentX and \l contentY such that \a cell is at the position specified by
-    \a alignment. \a alignment can be an or-ed combination of the following:
+    Positions \l {Flickable::}{contentX} and \l {Flickable::}{contentY} such
+    that \a cell is at the position specified by \a alignment. \a alignment
+    can be an or-ed combination of the following:
 
-    \list
-    \li Qt.AlignLeft - position the cell at the left of the view.
-    \li Qt.AlignHCenter - position the cell at the horizontal center of the view.
-    \li Qt.AlignRight - position the cell at the right of the view.
-    \li Qt.AlignTop - position the cell at the top of the view.
-    \li Qt.AlignVCenter - position the cell at the vertical center of the view.
-    \li Qt.AlignBottom - position the cell at the bottom of the view.
-    \li Qt.AlignCenter - the same as (Qt.AlignHCenter | Qt.AlignVCenter)
-    \endlist
+    \value Qt.AlignLeft Position the cell at the left of the view.
+    \value Qt.AlignHCenter Position the cell at the horizontal center of the view.
+    \value Qt.AlignRight Position the cell at the right of the view.
+    \value Qt.AlignTop Position the cell at the top of the view.
+    \value Qt.AlignVCenter Position the cell at the vertical center of the view.
+    \value Qt.AlignBottom Position the cell at the bottom of the view.
+    \value Qt.AlignCenter The same as (Qt.AlignHCenter | Qt.AlignVCenter)
 
     If no vertical alignment is specified, vertical positioning will be ignored.
     The same is true for horizontal alignment.
 
-    Optionally, you can specify \a offset to move \l contentX and \l contentY an extra number of
+    Optionally, you can specify \a offset to move \e contentX and \e contentY an extra number of
     pixels beyond the target alignment. E.g if you want to position the view so
     that cell [10, 10] ends up at the top-left corner with a 5px margin, you could do:
 
@@ -413,7 +412,7 @@
     positionViewAtCell(Qt.point(10, 10), Qt.AlignLeft | Qt.AlignTop, Qt.point(-5, -5))
     \endcode
 
-    \note it is not recommended to use \l {Flickable::}{contentX} or \l {Flickable::}{contentY}
+    \note It is not recommended to use \e contentX or \e contentY
     to position the view at a particular cell. This is unreliable since removing items from
     the start of the table does not cause all other items to be repositioned.
     TableView can also sometimes place rows and columns at approximate positions to
@@ -441,19 +440,17 @@
 /*!
     \qmlmethod QtQuick::TableView::positionViewAtRow(int row, Qt.Alignment alignment, real offset)
 
-    Convenience for calling
-    \code
-    positionViewAtCell(Qt.point(0, row), alignment & Qt.AlignVertical_Mask, Qt.point(0, offset))
-    \endcode
+    Convenience method for calling
+
+    \c {positionViewAtCell(Qt.point(0, }\a{row}\c{), }\a{alignment}\c{ & Qt.AlignVertical_Mask, Qt.point(0, }\a{offset}\c{))}
 */
 
 /*!
     \qmlmethod QtQuick::TableView::positionViewAtColumn(int column, Qt.Alignment alignment, real offset)
 
-    Convenience for calling
-    \code
-    positionViewAtCell(Qt.point(column, 0), alignment & Qt.AlignHorizontal_Mask, Qt.point(offset, 0))
-    \endcode
+    Convenience method for calling
+
+    \c {positionViewAtCell(Qt.point(}\a{column}\c{, 0), }\a{alignment}\c{ & Qt.AlignHorizontal_Mask, Qt.point(}\a{offset}\c{, 0))}
 */
 
 /*!
@@ -3152,13 +3149,13 @@ void QQuickTableView::setContentHeight(qreal height)
     tables will synchronize with regard to flicking, column widths/row heights,
     and spacing according to \l syncDirection.
 
-    If \l syncDirection contains \l Qt.Horizontal, current tableView's column
-    widths, column spacing, and horizontal flicking movement synchronizes with
-    syncView's.
+    If \l syncDirection contains \l {Qt::Horizontal}{Qt.Horizontal}, current
+    tableView's column widths, column spacing, and horizontal flicking movement
+    synchronizes with syncView's.
 
-    If \l syncDirection contains \l Qt.Vertical, current tableView's row
-    heights, row spacing, and vertical flicking movement synchronizes with
-    syncView's.
+    If \l syncDirection contains \l {Qt::Vertical}{Qt.Vertical}, current
+    tableView's row heights, row spacing, and vertical flicking movement
+    synchronizes with syncView's.
 
     \sa syncDirection
 */
@@ -3195,7 +3192,7 @@ void QQuickTableView::setSyncView(QQuickTableView *view)
 
     A typical use case is to make several headers flick along with the table.
 
-    \sa syncView, headerView
+    \sa syncView
 */
 Qt::Orientations QQuickTableView::syncDirection() const
 {
diff --git a/src/quick/items/qquicktext.cpp b/src/quick/items/qquicktext.cpp
index e89bb49e83..384b395f70 100644
--- a/src/quick/items/qquicktext.cpp
+++ b/src/quick/items/qquicktext.cpp
@@ -1400,11 +1400,11 @@ QQuickText::~QQuickText()
     \row
         \li implicitWidth (read-only)
         \li The width that the line would naturally occupy based on its contents,
-            not taking into account any modifications made to \a width.
+            not taking into account any modifications made to \e width.
     \row
         \li isLast (read-only)
         \li Whether the line is the last. This property can change if you
-            set the \a width property to a different value.
+            set the \e width property to a different value.
     \endtable
 
     For example, this will move the first 5 lines of a Text item by 100 pixels to the right:
@@ -2650,8 +2650,8 @@ void QQuickText::setLineHeightMode(LineHeightMode mode)
     If the text does not fit within the item bounds with the minimum font size
     the text will be elided as per the \l elide property.
 
-    If the \l textFormat property is set to \l Text.RichText, this will have no effect at all as the
-    property will be ignored completely. If \l textFormat is set to \l Text.StyledText, then the
+    If the \l textFormat property is set to \c Text.RichText, this will have no effect at all as the
+    property will be ignored completely. If \l textFormat is set to \c Text.StyledText, then the
     property will be respected provided there is no font size tags inside the text. If there are
     font size tags, the property will still respect those. This can cause it to not fully comply with
     the fontSizeMode setting.
diff --git a/src/quick/items/qquicktextedit.cpp b/src/quick/items/qquicktextedit.cpp
index 5b44a68c14..0e62898d57 100644
--- a/src/quick/items/qquicktextedit.cpp
+++ b/src/quick/items/qquicktextedit.cpp
@@ -3143,7 +3143,7 @@ void QQuickTextEdit::resetBottomPadding()
 
     The default distance, in device units, between tab stops.
 
-    \sa QTextOption::setTabStop()
+    \sa QTextOption::setTabStopDistance()
 */
 int QQuickTextEdit::tabStopDistance() const
 {
diff --git a/src/quick/items/qquickwindow.cpp b/src/quick/items/qquickwindow.cpp
index 533e698e22..0b17920d0b 100644
--- a/src/quick/items/qquickwindow.cpp
+++ b/src/quick/items/qquickwindow.cpp
@@ -5691,7 +5691,8 @@ void QQuickWindow::setTextRenderType(QQuickWindow::TextRenderType renderType)
     property on the window's palette, that property propagates to all child controls in the window,
     overriding any system defaults for that property.
 
-    \sa Item::palette, Popup::palette, QQuickAbstractPaletteProvider, QQuickColorGroup, QQuickPalette
+    \sa Item::palette, Popup::palette, QQuickColorGroup
+    //! internal \sa QQuickAbstractPaletteProvider, QQuickPalette
 */
 
 #ifndef QT_NO_DEBUG_STREAM
diff --git a/src/quick/scenegraph/coreapi/qsgmaterialshader.cpp b/src/quick/scenegraph/coreapi/qsgmaterialshader.cpp
index 150e54db6d..45e7a6fb4e 100644
--- a/src/quick/scenegraph/coreapi/qsgmaterialshader.cpp
+++ b/src/quick/scenegraph/coreapi/qsgmaterialshader.cpp
@@ -539,6 +539,9 @@ bool QSGMaterialShader::updateGraphicsPipelineState(RenderState &state, Graphics
     \value DirtyOpacity Used to indicate that the opacity has changed and must
     be updated.
 
+    \value DirtyCachedMaterialData Used to indicate that the cached material
+    state has changed and must be updated.
+
     \value DirtyAll Used to indicate that everything needs to be updated.
  */
 
diff --git a/src/quick/scenegraph/coreapi/qsgtexture.cpp b/src/quick/scenegraph/coreapi/qsgtexture.cpp
index 4bf1e020fd..94c25a5fc7 100644
--- a/src/quick/scenegraph/coreapi/qsgtexture.cpp
+++ b/src/quick/scenegraph/coreapi/qsgtexture.cpp
@@ -276,7 +276,7 @@ static void qt_debug_remove_texture(QSGTexture* texture)
     \note All classes with QSG prefix should be used solely on the scene graph's
     rendering thread. See \l {Scene Graph and Rendering} for more information.
 
-    \sa {Scene Graph - Rendering FBOs}, {Scene Graph - Rendering FBOs in a thread}
+    \sa {Scene Graph - Rendering FBOs}
  */
 
 /*!
@@ -724,7 +724,8 @@ namespace QNativeInterface {
 QT_DEFINE_NATIVE_INTERFACE(QSGOpenGLTexture);
 
 /*!
-    Creates a new QSGTexture wrapping an existing OpenGL texture object.
+    Creates a new QSGTexture wrapping an existing OpenGL texture object for
+    \a window.
 
     The native object specified in \a textureId is wrapped, but not owned, by
     the resulting QSGTexture. The caller of the function is responsible for
@@ -791,7 +792,8 @@ namespace QNativeInterface {
 QT_DEFINE_NATIVE_INTERFACE(QSGD3D11Texture);
 
 /*!
-    Creates a new QSGTexture wrapping an existing Direct 3D 11 \a texture object.
+    Creates a new QSGTexture wrapping an existing Direct 3D 11 \a texture object
+    for \a window.
 
     The native object is wrapped, but not owned, by the resulting QSGTexture.
     The caller of the function is responsible for deleting the returned
@@ -857,7 +859,8 @@ namespace QNativeInterface {
 /*!
     \fn QSGTexture *QNativeInterface::QSGMetalTexture::fromNative(id<MTLTexture> texture, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options)
 
-    Creates a new QSGTexture wrapping an existing Metal \a texture object.
+    Creates a new QSGTexture wrapping an existing Metal \a texture object for
+    \a window.
 
     The native object is wrapped, but not owned, by the resulting QSGTexture.
     The caller of the function is responsible for deleting the returned
@@ -915,7 +918,8 @@ namespace QNativeInterface {
 QT_DEFINE_NATIVE_INTERFACE(QSGVulkanTexture);
 
 /*!
-    Creates a new QSGTexture wrapping an existing Vulkan \a image object.
+    Creates a new QSGTexture wrapping an existing Vulkan \a image object for
+    \a window.
 
     The native object is wrapped, but not owned, by the resulting QSGTexture.
     The caller of the function is responsible for deleting the returned
diff --git a/src/quick/util/qquickanimator.cpp b/src/quick/util/qquickanimator.cpp
index f53f7e2f39..fee0802881 100644
--- a/src/quick/util/qquickanimator.cpp
+++ b/src/quick/util/qquickanimator.cpp
@@ -57,7 +57,7 @@ QT_BEGIN_NAMESPACE
     directly on Qt Quick's scene graph, rather than the QML objects and their
     properties like regular Animation types do. This has the benefit that
     Animator based animations can animate on the \l
-    {Threaded Render Loop ("threaded")}{scene graph's rendering thread} even when the
+    {Threaded Render Loop ('threaded')}{scene graph's rendering thread} even when the
     UI thread is blocked.
 
     The value of the QML property will be updated after the animation has