cvs commit: src/sys/doc/subsys Dependencies Doxyfile-cam Doxyfile-crypto Doxyfile-dev_pci Doxyfile-dev_sound Doxyfile-dev_usb Doxyfile-geom Doxyfile-i4b Doxyfile-kern Doxyfile-libkern Doxyfile-linux Doxyfile-net80211 ...

[Poul-Henning Kamp]

In message <20060528.131212.-1037137048.imp at bsdimp.com>, "M. Warner Losh" write
s:
>In message: <20060528123915.7fe8e278 at Magellan.Leidinger.net>
>            Alexander Leidinger <netchild at freebsd.org> writes:
>: But when we have marked the internal functions as such, we can also
>: generate an official version without the internal functions. It's just
>: a switch. But so far I think we need to include everything until a
>: subsystem is fully documented.
>
>I think we should document everything and mark the *EXTERNAL*
>functions as such.

Seconded.

If Doxygen does not currently understand this much more sensible
model, then it would be a worthwhile project to teach it about it.

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