From owner-cvs-all@FreeBSD.ORG  Sat May 27 09:12:47 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 7BF9616AE03;
	Sat, 27 May 2006 09:12:47 +0000 (UTC)
	(envelope-from simon@zaphod.nitro.dk)
Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D052643D46;
	Sat, 27 May 2006 09:12:42 +0000 (GMT)
	(envelope-from simon@zaphod.nitro.dk)
Received: from zaphod.nitro.dk (unknown [192.168.3.18])
	by mx.nitro.dk (Postfix) with ESMTP id 862202D48C8;
	Sat, 27 May 2006 09:13:11 +0000 (UTC)
Received: by zaphod.nitro.dk (Postfix, from userid 3000)
	id F19FF1142D; Sat, 27 May 2006 11:12:41 +0200 (CEST)
Date: Sat, 27 May 2006 11:12:41 +0200
From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Poul-Henning Kamp <phk@phk.freebsd.dk>
Message-ID: <20060527091241.GC1065@zaphod.nitro.dk>
References: <20060527104539.1f4c0738@Magellan.Leidinger.net>
	<13817.1148720224@critter.freebsd.dk>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="vGgW1X5XWziG23Ko"
Content-Disposition: inline
In-Reply-To: <13817.1148720224@critter.freebsd.dk>
User-Agent: Mutt/1.5.11
Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org,
	Alexander Leidinger <netchild@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 09:12:51 -0000


--vGgW1X5XWziG23Ko
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On 2006.05.27 10:57:04 +0200, Poul-Henning Kamp wrote:

> Rather than aim to enable this for the entire kernel and create
> showel-ware documentation of no value, why don't you start with one
> subsystem which is currently being worked on and make a usable
> documentation of that subsystem ?

Actually I think one of the points with this work was that you do get
useable things out of doxygen even without any special markup in the
source.  Call-graph's etc. can be very useful for people trying to
under stand some code.

Doxygen isn't just for documenting API's.

--=20
Simon L. Nielsen

--vGgW1X5XWziG23Ko
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (FreeBSD)

iD8DBQFEeBgJh9pcDSc1mlERAkSzAJ9rMVx4dW/yYmV6ZxwoeGz7b+6egACgwFlX
COxCvMMlFnBOEZbgh0ZvmKs=
=xXPN
-----END PGP SIGNATURE-----

--vGgW1X5XWziG23Ko--