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 <m2ejyrl0gd.wl%gnn at 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.

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