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: I46762dabc5f718fecc09a3533235eaa911dda5a0
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
This commit is contained in:
Topi Reinio 2023-04-11 12:02:10 +00:00
parent f334a22eae
commit 45ca5c8585
8 changed files with 8 additions and 8 deletions

View File

@ -4,7 +4,7 @@
/*!
\example blockingfortuneclient
\title Blocking Fortune Client
\meta category {Networking}
\examplecategory {Networking}
\meta tags {tcp,network,threading,synchronous-io}
\ingroup examples-network
\brief Demonstrates how to create a client for a network service.

View File

@ -4,7 +4,7 @@
/*!
\example fortuneclient
\title Fortune Client
\meta category {Networking}
\examplecategory {Networking}
\meta tags {tcp,network}
\ingroup examples-network
\brief Demonstrates how to create a client for a network service.

View File

@ -4,7 +4,7 @@
/*!
\example fortuneserver
\title Fortune Server
\meta category {Networking}
\examplecategory {Networking}
\meta tags {tcp,network,server}
\ingroup examples-network
\brief Demonstrates how to create a server for a network service.

View File

@ -3,7 +3,7 @@
/*!
\example http
\meta category {Networking}
\examplecategory {Networking}
\meta tags {http,network,https,proxy}
\title HTTP Client
\ingroup examples-network

View File

@ -4,7 +4,7 @@
/*!
\example multicastreceiver
\title Multicast Receiver
\meta category {Networking}
\examplecategory {Networking}
\meta tags {network,multicast,ipv6,ipv4,udp}
\ingroup examples-network
\brief Demonstrates how to receive information sent to a multicast group.

View File

@ -4,7 +4,7 @@
/*!
\example multicastsender
\title Multicast Sender
\meta category {Networking}
\examplecategory {Networking}
\meta tags {network,multicast,ipv6,ipv4,udp}
\ingroup examples-network
\brief Demonstrates how to send messages to a multicast group.

View File

@ -4,7 +4,7 @@
/*!
\example threadedfortuneserver
\title Threaded Fortune Server
\meta category {Networking}
\examplecategory {Networking}
\meta tags {tcp,network,threading,server,synchronous-io}
\ingroup examples-network

View File

@ -3,7 +3,7 @@
/*!
\example widgets/analogclock
\meta category {Graphics}
\examplecategory {Graphics}
\meta tags {widgets}
\title Analog Clock