In message <[EMAIL PROTECTED]>, "George V. Neville-Neil" write s: >At Thu, 18 May 2006 15:47:30 +0200, >Poul-Henning Kamp wrote: >> Part of the problem is that there will never be a "definitive kernel >> API manual" for FreeBSD, it will always be in flux and therefore >> drivers will need to be updated to keep abreast. > >I so hate to chime in on this thread, but I really think we need to >start putting things into the code and using Doxygen, or a moral >equivalent, to at least have a chance of keeping such things up to >date. Someone a while back set up a proper Doxygen file for use with >FreeBSD and we might simply pursue that tack.
I've not been very impressed with what I've seen from sources using this approach, but I guess having the prototypes with one line comments is better than nothing. -- Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 [EMAIL PROTECTED] | TCP/IP since RFC 956 FreeBSD committer | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence. _______________________________________________ [email protected] mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "[EMAIL PROTECTED]"
