DoxyGen Style Kernel API reference.

[Sascha Wildner]

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
decided.
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.

Sascha

--
http://yoyodyne.ath.cx