From owner-cvs-all@FreeBSD.ORG  Fri May 26 20:54:50 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 75AE216B754;
	Fri, 26 May 2006 20:54:50 +0000 (UTC)
	(envelope-from netchild@FreeBSD.org)
Received: from www.ebusiness-leidinger.de (jojo.ms-net.de [84.16.236.246])
	by mx1.FreeBSD.org (Postfix) with ESMTP id AE5EF43D76;
	Fri, 26 May 2006 20:54:40 +0000 (GMT)
	(envelope-from netchild@FreeBSD.org)
Received: from Andro-Beta.Leidinger.net (p54A5FC6A.dip.t-dialin.net
	[84.165.252.106]) (authenticated bits=0)
	by www.ebusiness-leidinger.de (8.13.4/8.13.4) with ESMTP id
	k4QKg4UC065018; Fri, 26 May 2006 22:42:09 +0200 (CEST)
	(envelope-from netchild@FreeBSD.org)
Received: from Magellan.Leidinger.net (Magellan.Leidinger.net [192.168.1.1])
	by Andro-Beta.Leidinger.net (8.13.4/8.13.3) with ESMTP id
	k4QIiuR6067127; Fri, 26 May 2006 20:44:57 +0200 (CEST)
	(envelope-from netchild@FreeBSD.org)
Date: Fri, 26 May 2006 20:44:57 +0200
From: Alexander Leidinger <netchild@FreeBSD.org>
To: "Poul-Henning Kamp" <phk@phk.freebsd.dk>
Message-ID: <20060526204457.3e545e4f@Magellan.Leidinger.net>
In-Reply-To: <10526.1148667636@critter.freebsd.dk>
References: <200605261806.k4QI67D3007680@repoman.freebsd.org>
	<10526.1148667636@critter.freebsd.dk>
Organization: FreeBSD
X-Mailer: Sylpheed-Claws 2.2.0 (GTK+ 2.8.17; i386-portbld-freebsd7.0)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: by amavisd-new
Cc: cvs-src@FreeBSD.org, 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: Fri, 26 May 2006 20:54:54 -0000

Quoting "Poul-Henning Kamp" <phk@phk.freebsd.dk> (Fri, 26 May 2006 20:20:36 +0200):

> In message <200605261806.k4QI67D3007680@repoman.freebsd.org>, Alexander Leiding
> er writes:
> 
> >  This is the kernel subsystem API documentation generation framework.
> >  
> >  It uses doxygen to generate the API documentation. For each subsystem
> >  a very small (about 20 lines with comments) subsystem specific Doxyfile
> >  has to be written (have a look at the README for more). All common doxygen
> >  options are specified in a separate file.
> 
> Now, this is all well and good, but the most critical question in
> my mind is: how do we prevent (or alternatively: mark up) documentation
> for functions which are not supposed to be public ?

http://www.stack.nl/~dimitri/doxygen/commands.html#cmdinternal

Bye,
Alexander.

-- 
Selling GoodYear Eagle F1 235/40ZR18, 2x 4mm + 2x 5mm, ~150 EUR
you have to pick it up between Germany/Saarland and Luxembourg/Capellen
http://www.Leidinger.net    Alexander @ Leidinger.net: PGP ID = B0063FE7
http://www.FreeBSD.org       netchild @ FreeBSD.org  : PGP ID = 72077137