From owner-cvs-src@FreeBSD.ORG Mon May 22 08:18:47 2006 Return-Path: X-Original-To: cvs-src@freebsd.org Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E178416A420; Mon, 22 May 2006 08:18:46 +0000 (UTC) (envelope-from Alexander@Leidinger.net) Received: from www.ebusiness-leidinger.de (jojo.ms-net.de [84.16.236.246]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4682843D45; Mon, 22 May 2006 08:18:45 +0000 (GMT) (envelope-from Alexander@Leidinger.net) Received: from Andro-Beta.Leidinger.net (p54A5EC0D.dip.t-dialin.net [84.165.236.13]) (authenticated bits=0) by www.ebusiness-leidinger.de (8.13.4/8.13.1) with ESMTP id k4M875qS008244; Mon, 22 May 2006 10:07:06 +0200 (CEST) (envelope-from Alexander@Leidinger.net) Received: from localhost (localhost [127.0.0.1]) by Andro-Beta.Leidinger.net (8.13.4/8.13.3) with ESMTP id k4M8IP7a031798; Mon, 22 May 2006 10:18:25 +0200 (CEST) (envelope-from Alexander@Leidinger.net) Received: from pslux.cec.eu.int (pslux.cec.eu.int [158.169.9.14]) by webmail.leidinger.net (Horde MIME library) with HTTP; Mon, 22 May 2006 10:18:25 +0200 Message-ID: <20060522101825.adfzv59y1eogwocs@netchild.homeip.net> X-Priority: 3 (Normal) Date: Mon, 22 May 2006 10:18:25 +0200 From: Alexander Leidinger To: gnn@neville-neil.com References: <200605181516.15541.hm@kts.org> <39318.1147960050@critter.freebsd.dk> <20060519143116.9iuvd81es0g0owkc@netchild.homeip.net> In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; DelSp="Yes"; format="flowed" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable User-Agent: Internet Messaging Program (IMP) H3 (4.1) / FreeBSD-4.11 X-Virus-Scanned: by amavisd-new Cc: src-committers@freebsd.org, cvs-src@freebsd.org, cvs-all@freebsd.org, Poul-Henning Kamp , Julian Elischer , hellmuth.michaelis@t-online.de Subject: 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: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 May 2006 08:18:47 -0000 Quoting gnn@neville-neil.com (from Sun, 21 May 2006 14:48:37 -0700): > At Fri, 19 May 2006 14:31:16 +0200, > Alexander Leidinger wrote: >> >> Quoting "George V. Neville-Neil" (from Thu, 18 >> May 2006 10:14:26 -0700): >> >> > I so hate to chime in on this thread, but I really think we need to >> > start putting things into the code and using Doxygen, or a moral >> > equivalent, to at least have a chance of keeping such things up to >> > date. Someone a while back set up a proper Doxygen file for use with >> > FreeBSD and we might simply pursue that tack. >> >> http://www.leidinger.net/FreeBSD/src_docs/ >> http://www.leidinger.net/FreeBSD/FreeBSD-Dox.tar.bz2 >> >> Feel free to send/suggest further subsystems/improvements. > > The one thing I'd like to suggest is that this be made part of the > tree with an optional make target. How should we go about doing that? We already have a doxygen config file in the tree, it covers the =20 entire kernel. But I think my approach of generating docs for =20 subsystems instead of the entire kernel may be more easy to understand =20 for people which want to understand a part of the kernel. Regarding the make target, do you think about "cd /usr/src; make =20 doxygen" or about "cd /usr/src/; make doxygen"? The targets in the .tar.bz2 generate a HTML version too. Currently the =20 HTML version is around 300 MB, and it only covers a small part of the =20 kernel. Shall the HTML version also be generated (not available =20 online)? What about the destination, where do you want the HTML =20 version and/or the PDF version (needs pdflatex as a build tool) to be =20 placed (I can't come up with a good destination)? The HTML version is =20 generated by doxygen directly, the PDF needs to be generated from the =20 latex version, so in case of the PDF version it would make sense to =20 have a "doxygen" and "doxygeninstall" target, but not for the HTML =20 version (except you want to generate everything in OBJDIR and then do =20 a copy to the destination). Yes, I'm asking bikeshed questions... but only because I can't think =20 of a good answer myself ATM. Bye, Alexander. --=20 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 =3D B0063FE7 http://www.FreeBSD.org netchild @ FreeBSD.org : PGP ID =3D 72077137