From owner-cvs-src@FreeBSD.ORG Sun May 28 02:16:53 2006 Return-Path: X-Original-To: cvs-src@freebsd.org Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 718C716ABCA; Sun, 28 May 2006 02:12:57 +0000 (UTC) (envelope-from gnn@neville-neil.com) Received: from mrout1-b.corp.dcn.yahoo.com (mrout1-b.corp.dcn.yahoo.com [216.109.112.27]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0212643D46; Sun, 28 May 2006 02:12:56 +0000 (GMT) (envelope-from gnn@neville-neil.com) Received: from traveling-laptop-140.corp.yahoo.com.neville-neil.com (proxy7.corp.yahoo.com [216.145.48.98]) by mrout1-b.corp.dcn.yahoo.com (8.13.6/8.13.4/y.out) with ESMTP id k4S2CPoe023035; Sat, 27 May 2006 19:12:26 -0700 (PDT) Date: Sun, 28 May 2006 11:12:19 +0900 Message-ID: From: gnn@freebsd.org To: Robert Watson 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> User-Agent: Wanderlust/2.14.0 (Africa) SEMI/1.14.6 (Maruoka) FLIM/1.14.8 (=?ISO-8859-4?Q?Shij=F2?=) APEL/10.6 Emacs/22.0.50 (i386-apple-darwin8.5.1) MULE/5.0 (SAKAKI) MIME-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: text/plain; charset=US-ASCII Cc: cvs-src@freebsd.org, Poul-Henning Kamp , src-committers@freebsd.org, Alexander Leidinger , 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 ... X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 28 May 2006 02:17:04 -0000 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