diff options
| -rw-r--r-- | modules/ECMAddQch.cmake | 6 | ||||
| -rw-r--r-- | modules/ECMQchDoxygen.config.in | 3 |
2 files changed, 9 insertions, 0 deletions
diff --git a/modules/ECMAddQch.cmake b/modules/ECMAddQch.cmake index cae829f1..bd72a9c8 100644 --- a/modules/ECMAddQch.cmake +++ b/modules/ECMAddQch.cmake @@ -145,6 +145,12 @@ # VERBOSE tells the API dox generation tool to be more verbose about its # activity. # +# The default config file for the API dox generation tool, so the one when not +# using CONFIG_TEMPLATE, allows code to handle the case of being processed by +# the tool by defining the C/C++ preprocessor macro ``K_DOXYGEN`` when run +# (since v5.67.0). For backward-compatibility also the definition +# ``DOXYGEN_SHOULD_SKIP_THIS`` is set, but its usage is deprecated. +# # Example usage: # # .. code-block:: cmake diff --git a/modules/ECMQchDoxygen.config.in b/modules/ECMQchDoxygen.config.in index 7964a547..88d51606 100644 --- a/modules/ECMQchDoxygen.config.in +++ b/modules/ECMQchDoxygen.config.in @@ -204,7 +204,10 @@ ALIASES = "intern=\par<b>Internal use only.</b>" \ "mit=<a href=\"https://www.opensource.org/licenses/mit-license.php\">MIT</a>" \ "qpl=<a href=\"https://opensource.org/licenses/QPL-1.0\">QPL</a>" +# K_DOXYGEN set to have preprocessor macros know that kapidox/doxygen processes them +# DOXYGEN_SHOULD_SKIP_THIS is the deprecated variant (remove for KF6) PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS \ + K_DOXYGEN \ \ Q_WS_X11= \ Q_WS_WIN= \ |