Date: Sun, 28 May 2006 21:15:55 +0200 From: "Poul-Henning Kamp" <phk@phk.freebsd.dk> To: "M. Warner Losh" <imp@bsdimp.com> Cc: rwatson@freebsd.org, src-committers@freebsd.org, netchild@freebsd.org, cvs-all@freebsd.org, cvs-src@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: <1921.1148843755@critter.freebsd.dk> In-Reply-To: Your message of "Sun, 28 May 2006 13:12:12 MDT." <20060528.131212.-1037137048.imp@bsdimp.com>
next in thread | previous in thread | raw e-mail | index | archive | help
In message <20060528.131212.-1037137048.imp@bsdimp.com>, "M. Warner Losh" write s: >In message: <20060528123915.7fe8e278@Magellan.Leidinger.net> > Alexander Leidinger <netchild@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@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?1921.1148843755>