From owner-freebsd-arch@FreeBSD.ORG  Wed May 24 06:14:12 2006
Return-Path: <owner-freebsd-arch@FreeBSD.ORG>
X-Original-To: freebsd-arch@freebsd.org
Delivered-To: freebsd-arch@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3978516A424
	for <freebsd-arch@freebsd.org>; Wed, 24 May 2006 06:14:12 +0000 (UTC)
	(envelope-from gnn@neville-neil.com)
Received: from mrout2-b.corp.dcn.yahoo.com (mrout2-b.corp.dcn.yahoo.com
	[216.109.112.28])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 3548943D49
	for <freebsd-arch@freebsd.org>; Wed, 24 May 2006 06:14:11 +0000 (GMT)
	(envelope-from gnn@neville-neil.com)
Received: from unknown-10-72-12-208.yahoo.com.neville-neil.com
	(proxy7.corp.yahoo.com [216.145.48.98])
	by mrout2-b.corp.dcn.yahoo.com (8.13.6/8.13.4/y.out) with ESMTP id
	k4O6DeHe058108; Tue, 23 May 2006 23:13:41 -0700 (PDT)
Date: Tue, 23 May 2006 16:30:36 -0700
Message-ID: <m2bqtotj37.wl%gnn@neville-neil.com>
From: "George V. Neville-Neil" <gnn@neville-neil.com>
To: Alexander Leidinger <Alexander@Leidinger.net>
In-Reply-To: <20060523082115.v4832wbvhcgccwwk@netchild.homeip.net>
References: <200605181516.15541.hm@kts.org>
	<39318.1147960050@critter.freebsd.dk>
	<m2ejyrl0gd.wl%gnn@neville-neil.com>
	<20060519143116.9iuvd81es0g0owkc@netchild.homeip.net>
	<m2fyj3f3re.wl%gnn@neville-neil.com>
	<20060522101825.adfzv59y1eogwocs@netchild.homeip.net>
	<m2bqtpk4b0.wl%gnn@neville-neil.com>
	<20060523082115.v4832wbvhcgccwwk@netchild.homeip.net>
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: Poul-Henning Kamp <phk@phk.freebsd.dk>, freebsd-arch@freebsd.org,
	Julian Elischer <julian@elischer.org>, hellmuth.michaelis@t-online.de
Subject: Re: doxygen target (was: Re: cvs commit: src
	Makefile.inc1	ObsoleteFiles.inc src/etc/defaults rc.conf
	src/etc/mtree BSD.usr.dist	src/etc/rc.d Makefile isdnd pcvt
	syscons src/release/picobsd/build	picobsd	src/share/man/man4
	Makefile atkbd.4 kbdmux.4 pcvt.4 splash.4 vkbd.4	...)
X-BeenThere: freebsd-arch@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Discussion related to FreeBSD architecture <freebsd-arch.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
	<mailto:freebsd-arch-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-arch>
List-Post: <mailto:freebsd-arch@freebsd.org>
List-Help: <mailto:freebsd-arch-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
	<mailto:freebsd-arch-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 24 May 2006 06:14:12 -0000

At Tue, 23 May 2006 08:21:15 +0200,
Alexander Leidinger wrote:
> I'm not sure the subdirectory builds are that simple to implement in
> a generic fashion (I have to play around with some ideas here...).
> Adding a target by hand to each interesting subdirectory is easy.

OK, so probably only the set you've already done would be first.
> 
> > THe other thing we need guidance on is, if people want to, how to most
> > easily add clear annotations to soiurce that make Doxygen happy.  A
> > one page cheat sheet would go a long way towards making this usable by
> > people who don't like to write documentation :-)
> 
> I think http://www.stack.nl/~dimitri/doxygen/docblocks.html provides a  
> good start (until someone writes doxygen_style(9) :-) ).

I'll look at that.

> A FAQ is available at http://www.stack.nl/~dimitri/doxygen/faq.html
> and http://www.stack.nl/~dimitri/doxygen/commands.html contains a
> list of all doxygen recognized documentation-commands.

Thanks,
George