Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 18 May 2006 20:24:24 +0200
From:      "Poul-Henning Kamp" <phk@phk.freebsd.dk>
To:        Warner Losh <imp@bsdimp.com>
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:  <40194.1147976664@critter.freebsd.dk>
In-Reply-To: Your message of "Thu, 18 May 2006 12:21:22 MDT." <20060518.122122.71180479.imp@bsdimp.com> 

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.

-- 
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?40194.1147976664>