Date: Sun, 28 May 2006 11:12:19 +0900 From: gnn@freebsd.org To: Robert Watson <rwatson@freebsd.org> Cc: cvs-src@freebsd.org, Poul-Henning Kamp <phk@phk.freebsd.dk>, src-committers@freebsd.org, Alexander Leidinger <netchild@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: <m24pza28zg.wl%gnn@neville-neil.com> In-Reply-To: <20060527200440.G79162@fledge.watson.org> References: <20060526204457.3e545e4f@Magellan.Leidinger.net> <11534.1148678206@critter.freebsd.dk> <20060527104539.1f4c0738@Magellan.Leidinger.net> <20060527200440.G79162@fledge.watson.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Am I allowed to call this a tempest in a teacup? There, I just have. While I think that there have been some very good points made both ways, I believe that since the documentation will be generated only by people who are using the system, and will not appear on line, or in a manual, that we do not need to worry about this. It is, IMHO, easier to go through and mark things up AFTER we have them visible and so visibility should be the first goal. Since there is, as far as I know, no other or better tool for this job I suggest we go with what we have and begin to mark things correctly now. Having everything by default internal, IMHO, leaves us just where we were before, lots of twisty little APIs all undocumented. My $0.02. Later, George
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?m24pza28zg.wl%gnn>