Date: Thu, 18 May 2006 19:39:49 +0200 From: "Poul-Henning Kamp" <phk@phk.freebsd.dk> To: "George V. Neville-Neil" <gnn@neville-neil.com> Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org, Julian Elischer <julian@elischer.org>, cvs-all@FreeBSD.org, hellmuth.michaelis@t-online.de Subject: Re: cvs commit: src Makefile.inc1 ObsoleteFiles.inc src/etc/defaults rc.conf src/etc/mtree BSD.usr.dist src/etc/rc.d Makefile isdnd pcvt syscons src/release/picobsd/build picobsd src/share/man/man4 Makefile atkbd.4 kbdmux.4 pcvt.4 splash.4 vkbd.4 ... Message-ID: <39977.1147973989@critter.freebsd.dk> In-Reply-To: Your message of "Thu, 18 May 2006 10:14:26 PDT." <m2ejyrl0gd.wl%gnn@neville-neil.com>
next in thread | previous in thread | raw e-mail | index | archive | help
In message <m2ejyrl0gd.wl%gnn@neville-neil.com>, "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 phk@FreeBSD.ORG | TCP/IP since RFC 956 FreeBSD committer | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?39977.1147973989>