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 ...

[Warner Losh]

> In message <20060518.122122.71180479.imp at 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