Home
> e-infrastructure, service-is-documenting, service-is-testing-troubleshooting-debugging > How to define your own conditional content marker “Internal” for Doxygen
How to define your own conditional content marker “Internal” for Doxygen
- Doxygen comes with a built-in conditional content marker \internal the outputting of which can be controlled with the switch INTERNAL_DOCS in Doxygen’s config file.
- However, I could not get this to work as advertised in Doxygen 1.8.8.
- In cases of similar feature breakage, users are commonly advised to fix the error in the Doxygen source. If you, like I did, lack the time for that, here is a simple workaround which uses another built-in feature that an be controlled via Doxygen’s config file:
- Define as one of the:
ALIASES = "myinternal=\if myinternal <HR><kbd><em>" \ "endmyinternal= </em></kbd> \endif" # HTML is optional, intended to make internal information stand out clearly if outputted
- Switch this ALIAS on and off using ENABLED_SECTIONS = # myinternal
- Example usage in a .dox file:
-# A high-low-high-low beep sequence followed by a low-high beep sequence indicates successful pairing and connection to the remote device. @myinternal tested with barcode on lower-end of cradle: gives success beep sequence @endmyinternal -# A long low, long high beep sequence indicates unsuccessful pairing.
Comments (0)
Trackbacks (0)
Leave a comment
Trackback