DragonFly kernel List (threaded) for 2009-09
Re: DoxyGen Style Kernel API reference.
Brian Gianforcaro schrieb:
Depending on how nice you want the documentation to be, and how good
the existing documentation is.
I'd be more than willing to put all my effort into modifying the
existing comments to be doxygen compliant, if this what is finally
I wonder, how would the existing man9 manpages fit into the picture?
Maintaining man9 and doxygen in parallel? I think there is even less
chance that developers will care about both man9 & doxygen than taking
care of man9 alone.
Fold the info from the manpages into the code as comments and discard
man9 entirely? That sounds like either a lot of comments would have to
be added or (in case you should decide to take only selected portions of
man9 into the comments) a lot of documentation would have to be discarded.
Note that I'm just trying to realistically picture what would happen if
we decide to use doxygen for kernel documentation.