Re: [Dri-devel] Source -> Documentation using Doxygen

[Jose F. <j_r...@ya...>]

On Fri, 2002-01-25 at 14:22, Jens Owen wrote:
> Jose,
> 
> The example you give looks reasonable, but here is another example, for
> drmAddMap, that I find much harder to read:
> 
> ...

yep. This is too verbose. (Sorry I didn't notice that one.) 

> > In fact a perhaps better alternative would be document only the headers
> > files instead of the implementation so that the code remains lean. (The
> > downside would be bigger include fields and more C preprocessing time
> > but the includes files are just used inside XFree86 tree and the
> > difference in the build time would be almost negligible.)
> 
> That would be a reasonable compromise.
> 

Okay. If nobody else volunteers I'll give it a try when I'm finished
with the FAQ (which by the way was recently updated and can be seen at
http://mefriss1.swan.ac.uk/~jfonseca/dri/faq/ ).

Regards,

Jose Fonseca