Re: DoxyGen Style Kernel API reference.

["Simon 'corecode' Schubert" <corecode@xxxxxxxxxxxx>]

Sascha Wildner wrote:
> 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.
> 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.

I actually don't think so.  Docs can be copied from the doxygen to the 
man page format.

I worked on the linux source in the last days, and I have to say that 
proper doxygen comments are *really* helpful for navigating in unknown code.

I strongly support Brian's enthusiasm and suggest just going forward and 
doing it.  Let's see how it is working out.  The more documentation the 
better.  I don't think we should turn this into a lengthy discussion.

cheers
  simon