aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVenugopal Shivashankar <Venugopal.Shivashankar@qt.io>2024-02-13 15:48:11 +0100
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2024-03-07 17:24:53 +0000
commitc901e6fc951cb1046fa4c8d726409fbd6ff138a2 (patch)
tree8c66b14b26380495cf33cd9c64ecd0d9df58e14f
parent6176a68951992d9b31fbf982dfd036fa4c9b361b (diff)
Doc: Fix broken link
Fixed the following qdoc warnings: - src/quick/items/qquickitem.cpp:[7966,7974]: (qdoc) warning: Can't link to 'QQuickControl' - src/quick/items/context2d/qquickcontext2d.cpp:3412: (qdoc) warning: Undocumented parameter 'imageData' in Context2D::createImageData() - src/quick/items/qquicktableview.cpp:1230: (qdoc) warning: Undocumented parameter 'cell' in TableView::modelIndex() - examples/quick/quickshapes/weatherforecast/doc/src/weatherforecast.qdoc:[13,21,27,45,78,83,93,102,105]: (qdoc) warning: Can't link to 'Qt Quick Shapes' Fixes: QTBUG-122230 Change-Id: I4f533ed95c13a99d649568d7b773437712b5b2d1 Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io> (cherry picked from commit cb714b1f749389f9fd4dcf2ad53056f99dd3c3a1) Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io> (cherry picked from commit 7ed4fa0a5fd79afafab3ced20545e384595cee73) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r--examples/quick/quickshapes/weatherforecast/doc/src/weatherforecast.qdoc18
-rw-r--r--src/quick/items/context2d/qquickcontext2d.cpp2
-rw-r--r--src/quick/items/qquickitem.cpp3
-rw-r--r--src/quick/items/qquicktableview.cpp2
4 files changed, 12 insertions, 13 deletions
diff --git a/examples/quick/quickshapes/weatherforecast/doc/src/weatherforecast.qdoc b/examples/quick/quickshapes/weatherforecast/doc/src/weatherforecast.qdoc
index 9a8ee63e37..acc625ece1 100644
--- a/examples/quick/quickshapes/weatherforecast/doc/src/weatherforecast.qdoc
+++ b/examples/quick/quickshapes/weatherforecast/doc/src/weatherforecast.qdoc
@@ -9,7 +9,7 @@
\examplecategory {Graphics}
This example is designed to look like a weather forecast app for Europe. It demonstrates
- a few different ways the \l{Qt Quick Shapes} API might be useful in an application, and how
+ a few different ways the \l{QtQuick.Shapes} API might be useful in an application, and how
different properties can affect the quality and performance of the rendering.
All graphics in the example originated as \c .svg files which were converted to QML
@@ -17,13 +17,13 @@
\section1 Different Types of Shapes
- The \l{Qt Quick Shapes} module provides APIs to render vector graphics in a Qt Quick
+ The \l{QtQuick.Shapes} module provides APIs to render vector graphics in a Qt Quick
application. This is an alternative to using a raster \l{Image} for 2D graphics and is useful
if the target size of the image is not known up front. With an \l{Image}, the rasterized pixmap
is precreated at a specific size and scaling the image will either add or subtract information.
This will result in pixelation or blurring, depending on whether its \c smooth property is set.
- With \l{Qt Quick Shapes} the shapes are described mathematically, as a set of curves and line
+ With \l{QtQuick.Shapes} the shapes are described mathematically, as a set of curves and line
segments, and thus they can be scaled arbitrarily without introducing artifacts.
\image qml-weatherforecast-example.png
@@ -41,7 +41,7 @@
While using appropriately sized raster images for icons is usually preferred for performance
reasons, it may be inconvenient if the same application is targeting many different screen
sizes. In order for the icons to look crisp on all screens, you have to pregenerate a large
- set of different sizes. \l{Qt Quick Shapes} makes it possible for the application to do this
+ set of different sizes. \l{QtQuick.Shapes} makes it possible for the application to do this
adaptation at runtime, by including the icons as shapes and rendering them at a size appropriate
for the current screen size.
@@ -74,12 +74,12 @@
\section2 Country Name Labels
When zooming on a country, its name appears across the country shape. This label is also created
- with \l{Qt Quick Shapes}, by using the \l{PathText} component type which converts a string into
+ with \l{QtQuick.Shapes}, by using the \l{PathText} component type which converts a string into
renderable shape.
This is not the typical way to create text labels in Qt Quick. For most purposes, using the
\l{Text} element is the most efficient and convenient approach. However, there are certain
- visualization effects supported by \l{Qt Quick Shapes} which is not supported by the regular
+ visualization effects supported by \l{QtQuick.Shapes} which is not supported by the regular
\l{Text} element. Fill gradients is one such effect.
\snippet quickshapes/weatherforecast/main.qml textShape
@@ -89,7 +89,7 @@
\section1 Different Types of Renderers
- The Weather Forecast example illustrates multiple different use cases for \l{Qt Quick Shapes}.
+ The Weather Forecast example illustrates multiple different use cases for \l{QtQuick.Shapes}.
In addition, it can be used to see the upsides and downsides of the different renderers the
module supports.
@@ -98,10 +98,10 @@
\image settings.png
- \l{Qt Quick Shapes} supports two different renderers, selectable using the
+ \l{QtQuick.Shapes} supports two different renderers, selectable using the
\l{ QtQuick.Shapes::Shape::preferredRendererType}{preferredRendererType} property. The preferred
renderer in the example is \c CurveRenderer. This supports hardware-accelerated curves and
- built-in antialiasing. It is not the default renderer in \l{Qt Quick Shapes}, but in the example
+ built-in antialiasing. It is not the default renderer in \l{QtQuick.Shapes}, but in the example
it is automatically selected on startup.
The default renderer in Qt Quick Shapes is the \c GeometryRenderer. This flattens the curves of
diff --git a/src/quick/items/context2d/qquickcontext2d.cpp b/src/quick/items/context2d/qquickcontext2d.cpp
index 14ff7fcdc6..bc22410ac1 100644
--- a/src/quick/items/context2d/qquickcontext2d.cpp
+++ b/src/quick/items/context2d/qquickcontext2d.cpp
@@ -3412,7 +3412,7 @@ bool QQuickJSContext2DPixelData::virtualPut(QV4::Managed *m, QV4::PropertyKey id
/*!
\qmlmethod CanvasImageData QtQuick::Context2D::createImageData(CanvasImageData imageData)
- Creates a CanvasImageData object with the same dimensions as the argument.
+ Creates a CanvasImageData object with the same dimensions as the \a imageData argument.
*/
/*!
\qmlmethod CanvasImageData QtQuick::Context2D::createImageData(Url imageUrl)
diff --git a/src/quick/items/qquickitem.cpp b/src/quick/items/qquickitem.cpp
index 6a6a4ca4ad..e66bea04d8 100644
--- a/src/quick/items/qquickitem.cpp
+++ b/src/quick/items/qquickitem.cpp
@@ -7963,7 +7963,7 @@ QQuickItem *QQuickItem::scopedFocusItem() const
\value Qt.WheelFocus The item accepts focus by tabbing, clicking, and using the mouse wheel.
\value Qt.NoFocus The item does not accept focus.
- \note This property was a member of \l {QQuickControl} {Control} until Qt 6.7.
+ \note This property was a member of the \l[QML]{Control} QML type in Qt 6.6 and earlier.
*/
/*!
\property QQuickItem::focusPolicy
@@ -7971,7 +7971,6 @@ QQuickItem *QQuickItem::scopedFocusItem() const
This property determines the way the item accepts focus.
- \note This property was a member of \l {QQuickControl} {Control} until Qt 6.7.
*/
Qt::FocusPolicy QQuickItem::focusPolicy() const
{
diff --git a/src/quick/items/qquicktableview.cpp b/src/quick/items/qquicktableview.cpp
index 0c218704c5..93b6a42a6d 100644
--- a/src/quick/items/qquicktableview.cpp
+++ b/src/quick/items/qquicktableview.cpp
@@ -1236,7 +1236,7 @@
modelIndex(cell.y, cell.x)
\endcode
- A cell is simply a \l point that combines row and column into
+ A \a cell is simply a \l point that combines row and column into
a single type.
\note \c {point.x} will map to the column, and \c {point.y} will map to the row.