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

[M. Warner Losh]

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.  I agree with your commentary about having full
kernel docs, and approved API subset as well.  However, kernel
functions are by default internal unless we deside otherwise.

: Since we have no API docs, everyone has to have a look at the kernel on
: his own. This only provides a little bit of help here.

We have api docs.  Please don't say that we have none.  There's a
bunch of documentation in the man9 section of the man page.  Sure, it
is incomplete, misleading and obsolete in places, but it is
documentation.

: Since we are Open Source they can have a look and use unofficial parts
: without our docs. But when we clearly say "this is for internal use
: only", they can't moan. And we as developers have a benefit from the
: docs too.

I agree with this.  I guess my only point of disagreement are the
default sense of internal/external.

Warner