diff options
author | Luca Di Sera <luca.disera@qt.io> | 2023-05-24 16:37:34 +0200 |
---|---|---|
committer | Luca Di Sera <luca.disera@qt.io> | 2023-06-14 16:18:55 +0200 |
commit | eb92d52dc7190efefae0fae89c7c6eb9e16cdd9d (patch) | |
tree | 950a1233a04c74069c9b51267f0744ac3d6453d5 /doc | |
parent | 5e7106ecd36c3a4e8c0725223f67fd91cf20ef82 (diff) |
Doc: Correct the expansion of the raisedaster macro for DocBook
QDoc allows code-expanding macros to be defined so that the user can
abstract away common code in a simple to use command.
Furthermore, macros allows for a different expansion based on the
currently generated format so that format-specific requirements can be
satisfied when required.
When format specific expansions are provided, QDoc considers the
resulting text as if it should be generated verbatim.
The "\raisedaster" macro is used to generate an superscript asterisk.
The macro is provided for both HTML and DocBook.
As the macro has format-specific expansions, the expanded code will be
read verbatim.
Nonetheless, while the HTML expansion expands to actual HTML, the
DocBook expansion expands to an equivalent QDoc code, which will not be
generated correctly.
To avoid the issue, the DocBook version of "\raisedaster" is modified so
that it produces the correct DocBook code.
Change-Id: I3a37838bda885af42f8d93b86ec08126d7146ff9
Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/global/macros.qdocconf | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/doc/global/macros.qdocconf b/doc/global/macros.qdocconf index 01dbd49ab2..529682c514 100644 --- a/doc/global/macros.qdocconf +++ b/doc/global/macros.qdocconf @@ -36,7 +36,7 @@ macro.QtVersion = "$QT_VERSION" macro.QtVer = "$QT_VER" macro.param = "\\e" macro.raisedaster.HTML = "<sup>*</sup>" -macro.raisedaster.DocBook = "\\sup{*}" +macro.raisedaster.DocBook = "<db:superscript>*</db:superscript>" macro.rarrow.HTML = "→" macro.rarrow.DocBook = "→" macro.reg.HTML = "<sup>®</sup>" |