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

[Poul-Henning Kamp]

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.

-- 
Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
phk at 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.