Date: Sat, 27 May 2006 20:11:45 +0100 (BST) From: Robert Watson <rwatson@FreeBSD.org> To: Alexander Leidinger <netchild@FreeBSD.org> Cc: cvs-src@FreeBSD.org, Poul-Henning Kamp <phk@phk.freebsd.dk>, src-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: 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 ... Message-ID: <20060527201049.R79162@fledge.watson.org> In-Reply-To: <20060527113743.03b5a263@Magellan.Leidinger.net> References: <20060527104539.1f4c0738@Magellan.Leidinger.net> <13817.1148720224@critter.freebsd.dk> <20060527113743.03b5a263@Magellan.Leidinger.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, 27 May 2006, Alexander Leidinger wrote: >> There is no automatic way to make this determination, you need somebody to >> look at each and every function to decide it. > > That's the same way I think about @internal. @internal is exactly backwards from the way API documentation should work. Things should be explicitly marked @external, and otherwise either be undocumented, or be heavily marked "NOT FOR EXTERNAL USE". Robert N M Watson
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060527201049.R79162>