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 _______________________________________________ Dri-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/dri-devel