[ANN] building ODK documentation now requires doxygen 1.8.4
Michael Stahl
mstahl at redhat.com
Fri Jun 7 03:29:00 PDT 2013
forgot to add something about the comment syntax:
some people may be familiar with the autodoc comment syntax to get
hyperlinks, which is handled differently (and much simpler) in doxygen.
autodoc required types etc. to be annotated by XML tags like these,
which are not understood by doxygen and would lead to warnings and the
XML tags being copied literally to the output when used:
- <type>, <member>, <const>:
stuff like that can simply be converted to a :: separated identifier,
basically just like in the IDL syntax:
* <type scope="bar">Foo</type> becomes
bar::Foo
(it's not a problem to have a single "." or ":" following that
without a space between if needed for proper grammar)
* members that are methods <member>method</member> need to have "()"
suffix:
method()
* special case <member>Foo</member> (without any scope) needs to be
prefixed with "#" to get recognized as a link:
#Foo
- <TRUE/> <FALSE/> <VOID/> <NULL/> <true/> <false/> <void/> <null/>
don't exist in doxygen, just use something like `TRUE` etc.
- <atom>42</atom> can be replaced with 42
- <arg>foo</arg> can be replaced with foo
- <method> and <module> were used in the IDL files but actually autodoc
didn't understand them at all
More information about the LibreOffice
mailing list