Re: [Corelinux-develop] Comments and documentation

[Christophe Prud'h. <pru...@an...>]

I was thinking about the inclusion of the source code + headers in the html 
doc.

> What about the syntax of using
> /*!
> */
>
> in the headers?
is it at the very beginning of the file with the \file flag, or for macro 
documentation?
normally the doxygen specific flags appear when there is no javadoc equivalent
if not then I made a mistake

I think that doxygen introduces some interesting features that enables to 
extract relevant and useful informations depending on the context. 
if it happens that javadoc is extended then it is likely that doxygen 
provides a similar feature then it is just a matter of modifying the tag(perl 
script) and I guess that the doxygen team will try to implement the new 
javadoc features.

>
> BTW: It is my intent to open this for discussion, not to abolish. I was
> pointing out the downsides. Is there a happy medium?
that is a good one I think :)



-- 
Christophe Prud'homme
MIT -- 77 Mass Ave
02215 Cambridge MA