Hi, On 2 April 2013 02:08, Peter Hutterer <[email protected]> wrote: > Create client-side and server-side man pages from doxygen. The doxygen > config options are virtually the same as for the XML output, but we do pass > in the specific options via stdin. > > WL_EXPORT is predefined to the empty string, it makes the man page look > confusing and provides no value here anyway. This applies for both xml and > man output. > > JAVADOC_AUTOBRIEF is disabled for man pages, the formatting in the resulting > man page is IMO hard to read. > > Most of the server man pages are virtually empty, there's just not enough > documentation in the source files. > > Interesting issue: the usage of @code in the protocol to reference the > parameter breaks the expansion of WL_EXPORT, thus leaving us with WL_EXPORT > in all the man pages. > Presumably this is an issue with doxygen interpreting this as a @code > command, but I already wasted enough time narrowing this down.
Oooh, this is great - thankyou for doing this! Is there any chance we can generate the list of manpages (e.g. by shelling out to doxygen) rather than having a static list though? Cheers, Daniel _______________________________________________ wayland-devel mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/wayland-devel
