From owner-cvs-all@FreeBSD.ORG  Sun May 28 19:16:11 2006
Return-Path: <owner-cvs-all@FreeBSD.ORG>
X-Original-To: cvs-all@freebsd.org
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5F3D816AD42;
	Sun, 28 May 2006 19:16:11 +0000 (UTC)
	(envelope-from phk@critter.freebsd.dk)
Received: from pasmtp.tele.dk (pasmtp.tele.dk [193.162.159.95])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1EAAB43D72;
	Sun, 28 May 2006 19:16:06 +0000 (GMT)
	(envelope-from phk@critter.freebsd.dk)
Received: from critter.freebsd.dk (0x535c0e2a.sgnxx1.adsl-dhcp.tele.dk
	[83.92.14.42]) by pasmtp.tele.dk (Postfix) with ESMTP id 7FD1D1EC322;
	Sun, 28 May 2006 21:15:59 +0200 (CEST)
Received: from critter.freebsd.dk (localhost [127.0.0.1])
	by critter.freebsd.dk (8.13.6/8.13.6) with ESMTP id k4SJFtx8001922;
	Sun, 28 May 2006 21:15:55 +0200 (CEST)
	(envelope-from phk@critter.freebsd.dk)
To: "M. Warner Losh" <imp@bsdimp.com>
From: "Poul-Henning Kamp" <phk@phk.freebsd.dk>
In-Reply-To: Your message of "Sun, 28 May 2006 13:12:12 MDT."
	<20060528.131212.-1037137048.imp@bsdimp.com> 
Date: Sun, 28 May 2006 21:15:55 +0200
Message-ID: <1921.1148843755@critter.freebsd.dk>
Sender: phk@critter.freebsd.dk
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 ... 
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 28 May 2006 19:16:13 -0000

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.