Hello list!

I am using Doxygen for the API documentation of libelektra.org
and it is working really great, thanks to the authors.

I am asking myself if it is useful to extend the usage of
doxygen to also document the commandline tools. Basically
I need some man pages with synopsis, description and so
on.

The man page generation works quite fine, and the html
description list with 
, 
 and 
 seems to provide
a nice way for the DESCRIPTION section.

Is anybody using doxygen to generate man pages for their
commandline tools?

Are there any considerable drawbacks I should be aware of?

best regards,
Markus