Date: Thu, 18 May 2006 17:35:35 -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.173535.70130518.imp@bsdimp.com> In-Reply-To: <40194.1147976664@critter.freebsd.dk> References: <20060518.122122.71180479.imp@bsdimp.com> <40194.1147976664@critter.freebsd.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
> In message <20060518.122122.71180479.imp@bsdimp.com>, Warner Losh writes: > > >> 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. > > That was sort of what I hinted at: most places I've seen don't seem > to have the follow-through to actually get more than the prototypes > out. Yes. It takes everyone pulling together to make it work. Warner
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060518.173535.70130518.imp>