From 6c7984e6931fa7123c1faee8a8c91d159d293633 Mon Sep 17 00:00:00 2001
From: Topi Reinio <topi.reinio@qt.io>
Date: Tue, 11 Apr 2023 11:04:59 +0000
Subject: Doc: Use the \examplecategory macro to tag examples

The '\meta category' command was used for tagging examples with a
specific category, used in Qt Creators Welcome mode.

As we want to also generate lists of examples belonging to a category
elsewhere in the documentation, replace the command with a macro that
expands to the original \meta command and also adds the example to
a group using the \ingroup command. This way, the category names can
be used as arguments to the \generatelist or \annotatedlist commands.

Pick-to: 6.5
Task-number: QTBUG-112731
Change-Id: Ibfd1179923b898259a5c96417aba8f7711e9c5ee
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
---
 examples/datavisualization/graphgallery/doc/src/graphgallery.qdoc       | 2 +-
 examples/datavisualization/qmlaxishandling/doc/src/qmlaxishandling.qdoc | 2 +-
 examples/datavisualization/qmlbars/doc/src/qmlbars.qdoc                 | 2 +-
 examples/datavisualization/qmlscatter/doc/src/qmlscatter.qdoc           | 2 +-
 .../datavisualization/qmlsurfacegallery/doc/src/qmlsurfacegallery.qdoc  | 2 +-
 examples/datavisualization/volumetric/doc/src/volumetric.qdoc           | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

(limited to 'examples/datavisualization')

diff --git a/examples/datavisualization/graphgallery/doc/src/graphgallery.qdoc b/examples/datavisualization/graphgallery/doc/src/graphgallery.qdoc
index c4fdd854..7acf0482 100644
--- a/examples/datavisualization/graphgallery/doc/src/graphgallery.qdoc
+++ b/examples/datavisualization/graphgallery/doc/src/graphgallery.qdoc
@@ -4,7 +4,7 @@
 /*!
     \example graphgallery
     \meta tags {DataVisualization, Q3DBars, Bar Graph, Custom Proxy, Q3DScatter, Scatter Graph, Custom Input Handler, Q3DSurface, Surface Graph, QCustom3DItem, Textured Surface}
-    \meta category {Graphics}
+    \examplecategory {Graphics}
     \title Graph Gallery
     \ingroup qtdatavisualization_examples
     \brief Gallery of Bar, Scatter, and Surface graphs.
diff --git a/examples/datavisualization/qmlaxishandling/doc/src/qmlaxishandling.qdoc b/examples/datavisualization/qmlaxishandling/doc/src/qmlaxishandling.qdoc
index ae2470cf..ac1c82a0 100644
--- a/examples/datavisualization/qmlaxishandling/doc/src/qmlaxishandling.qdoc
+++ b/examples/datavisualization/qmlaxishandling/doc/src/qmlaxishandling.qdoc
@@ -4,7 +4,7 @@
 /*!
     \example qmlaxishandling
     \meta tags {DataVisualization, Scatter3D, Custom Input Handler, Dynamic Data, Custom Axis Formatter, Scatter Graph}
-    \meta category {Graphics}
+    \examplecategory {Graphics}
     \title Axis Handling
     \ingroup qtdatavisualization_qmlexamples
     \brief Implementing axis dragging with a custom input handler in QML, and creating a custom axis formatter.
diff --git a/examples/datavisualization/qmlbars/doc/src/qmlbars.qdoc b/examples/datavisualization/qmlbars/doc/src/qmlbars.qdoc
index bac85045..e96f0c80 100644
--- a/examples/datavisualization/qmlbars/doc/src/qmlbars.qdoc
+++ b/examples/datavisualization/qmlbars/doc/src/qmlbars.qdoc
@@ -4,7 +4,7 @@
 /*!
     \example qmlbars
     \meta tags {DataVisualization, Barsr3D, Multiple Series}
-    \meta category {Graphics}
+    \examplecategory {Graphics}
     \title Simple Bar Graph
     \ingroup qtdatavisualization_qmlexamples
     \brief Using Bars3D in a QML application.
diff --git a/examples/datavisualization/qmlscatter/doc/src/qmlscatter.qdoc b/examples/datavisualization/qmlscatter/doc/src/qmlscatter.qdoc
index 8d2800e6..27dc4e9e 100644
--- a/examples/datavisualization/qmlscatter/doc/src/qmlscatter.qdoc
+++ b/examples/datavisualization/qmlscatter/doc/src/qmlscatter.qdoc
@@ -4,7 +4,7 @@
 /*!
     \example qmlscatter
     \meta tags {DataVisualization, Scatter3D, Multiple Series}
-    \meta category {Graphics}
+    \examplecategory {Graphics}
     \title Simple Scatter Graph
     \ingroup qtdatavisualization_qmlexamples
     \brief Using Scatter3D in a QML application.
diff --git a/examples/datavisualization/qmlsurfacegallery/doc/src/qmlsurfacegallery.qdoc b/examples/datavisualization/qmlsurfacegallery/doc/src/qmlsurfacegallery.qdoc
index acfdd287..bfc92e87 100644
--- a/examples/datavisualization/qmlsurfacegallery/doc/src/qmlsurfacegallery.qdoc
+++ b/examples/datavisualization/qmlsurfacegallery/doc/src/qmlsurfacegallery.qdoc
@@ -4,7 +4,7 @@
 /*!
     \example qmlsurfacegallery
     \meta tags {DataVisualization, Surface3D, Dynamic Data, Surface Graph, Height Map, Polar Graph}
-    \meta category {Graphics}
+    \examplecategory {Graphics}
     \title Surface Graph Gallery
     \ingroup qtdatavisualization_qmlexamples
     \brief Gallery with three different ways to use a Surface3D graph.
diff --git a/examples/datavisualization/volumetric/doc/src/volumetric.qdoc b/examples/datavisualization/volumetric/doc/src/volumetric.qdoc
index 04aa4bc4..ee9b1467 100644
--- a/examples/datavisualization/volumetric/doc/src/volumetric.qdoc
+++ b/examples/datavisualization/volumetric/doc/src/volumetric.qdoc
@@ -4,7 +4,7 @@
 /*!
     \example volumetric
     \meta tags {DataVisualization, QCustom3DVolume, Custom Item}
-    \meta category {Graphics}
+    \examplecategory {Graphics}
     \title Volumetric Rendering
     \ingroup qtdatavisualization_examples
     \brief Rendering volumetric objects.
-- 
cgit v1.2.3