GNU autoconf, document options using doxygen?

Question

hi

Is it possible to document configure.ac such that doxygen can pick up embedded comments and produce documentation for options, variables, etc. in generated manuals?

Thanks

Answer 1

There are contributed Autoconf macros for Doxygen at the Autoconf Archive. Include the DX_INIT_DOXYGEN macro in configure.ac and then automake will create targets such as doxygen-doc for generating various subsets of the documentation.

Answer 2

You should comment using Doxygen using comments like ##!, right? I don't think that Doxygen supports comments like that, but you could try to modify Doxygen to accept comments like that, then you can document using usual Doxygen commands @var, @cond, etc.

The modification could be hard, but you can try to modify this file commentcnv.l (starting from @line 319). Maybe you can mail with project developer mailing list.