From owner-cvs-all@FreeBSD.ORG  Sat May 27 19:11:52 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 BC1F316ACBA;
	Sat, 27 May 2006 19:11:52 +0000 (UTC)
	(envelope-from rwatson@FreeBSD.org)
Received: from cyrus.watson.org (cyrus.watson.org [209.31.154.42])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 3EACC43D92;
	Sat, 27 May 2006 19:11:46 +0000 (GMT)
	(envelope-from rwatson@FreeBSD.org)
Received: from fledge.watson.org (fledge.watson.org [209.31.154.41])
	by cyrus.watson.org (Postfix) with ESMTP id E851446C0D;
	Sat, 27 May 2006 15:11:45 -0400 (EDT)
Date: Sat, 27 May 2006 20:11:45 +0100 (BST)
From: Robert Watson <rwatson@FreeBSD.org>
X-X-Sender: robert@fledge.watson.org
To: Alexander Leidinger <netchild@FreeBSD.org>
In-Reply-To: <20060527113743.03b5a263@Magellan.Leidinger.net>
Message-ID: <20060527201049.R79162@fledge.watson.org>
References: <20060527104539.1f4c0738@Magellan.Leidinger.net>
	<13817.1148720224@critter.freebsd.dk>
	<20060527113743.03b5a263@Magellan.Leidinger.net>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
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 ...
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: Sat, 27 May 2006 19:12:13 -0000


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