Date: Thu, 18 May 2006 12:21:22 -0600 (MDT) From: Warner Losh <imp@bsdimp.com> To: phk@phk.freebsd.dk Cc: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, gnn@neville-neil.com, cvs-all@FreeBSD.org, julian@elischer.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: <20060518.122122.71180479.imp@bsdimp.com> In-Reply-To: <39977.1147973989@critter.freebsd.dk> References: <m2ejyrl0gd.wl%gnn@neville-neil.com> <39977.1147973989@critter.freebsd.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
From: "Poul-Henning Kamp" <phk@phk.freebsd.dk> 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 ... Date: Thu, 18 May 2006 19:39:49 +0200 > 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. Doxygen does more than one line, and you get out of it the effort that you put into it as far as quality goes. It isn't as good as carefully hand-crafted man pages, but it is a lot better than we have now. Warner
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060518.122122.71180479.imp>