summaryrefslogtreecommitdiffstats
path: root/tools
diff options
context:
space:
mode:
authorJuha Vuolle <juha.vuolle@insta.fi>2021-02-04 13:22:16 +0200
committerJuha Vuolle <juha.vuolle@insta.fi>2021-02-11 09:10:48 +0200
commit84c7967a6c9fc13b2e588b029030546fa6f8b92e (patch)
tree0aced5e1a961550af1461e33f5b3925c048ed584 /tools
parent72841fe10402148de78c218d06bf1a1f3d3857d0 (diff)
Qt6 related documentation changes for scxml module
Some perhaps less-obvious changes are: -Remove nonexistent imagedirs reference in qdocconf -Address some qdoc warnings (“/“ usage in an example and also std::function handling) -Fix ftpclient example filename references -Mark an escaped Q_OBJECT usage as badcode to suppress qdoc warning The Q_OBJECT itself cannot be unescaped as automoc will then fail. It shouldn't but that is the case. -Change the examples’ CMakeLists.txt to use single-line find_packages to ensure packages are not mixed and matched. Probability for problems is low but perhaps since these are examples that is appropriate Pick-to: 6.1 Task-number: QTBUG-89833 Change-Id: Ibf518aa71971e8e9d0af1b49c7de86fd28089e96 Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Diffstat (limited to 'tools')
-rw-r--r--tools/qscxmlc/doc/qscxmlc.qdoc25
1 files changed, 15 insertions, 10 deletions
diff --git a/tools/qscxmlc/doc/qscxmlc.qdoc b/tools/qscxmlc/doc/qscxmlc.qdoc
index bf38a63..20c9c6b 100644
--- a/tools/qscxmlc/doc/qscxmlc.qdoc
+++ b/tools/qscxmlc/doc/qscxmlc.qdoc
@@ -39,18 +39,23 @@
\section1 Usage
- The \c qscxml tool is invoked automatically if the QT variable in the
- project file includes \c scxml, and the .scxml file to use is specified
- using the \c STATECHARTS variable.
+ The \c qscxmlc tool is invoked automatically if the project is linked against
+ the \c scxml library in the project file, and the \c .scxml file to use is specified
+ using the special build directives \c STATECHARTS or qt6_add_statecharts.
- \badcode
- QT += scxml
- STATECHARTS = MyStatemachine.scxml
- \endcode
+ When using cmake:
- With above definitions, \c qmake invokes \c qscxmlc to generate
- MyStatemachine.h and MyStatemachine.cpp, and adds them to \l [QMake]
- HEADERS and \l [QMAKE] SOURCES variables.
+ \include qtscxml-module-use.qdocinc cmakebuild
+ \include qtscxml-module-use.qdocinc cmakestatecharts
+
+ When using qmake:
+
+ \include qtscxml-module-use.qdocinc qmakebuild
+ \include qtscxml-module-use.qdocinc qmakestatecharts
+
+ With above definitions, \c qmake or \c cmake invokes \c qscxmlc to generate
+ MyStatemachine.h and MyStatemachine.cpp, and adds them appropriately
+ to the project as headers and sources.
By default, the name of the generated class that implements the state
machine corresponds with the \e name attribute of the \c <scxml> root