From owner-freebsd-current@FreeBSD.ORG Fri Aug 14 20:56:12 2009 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 30E14106568C for ; Fri, 14 Aug 2009 20:56:12 +0000 (UTC) (envelope-from andreast-list@fgznet.ch) Received: from smtp.fgznet.ch (mail.fgznet.ch [81.92.96.47]) by mx1.freebsd.org (Postfix) with ESMTP id C2E0E8FC41 for ; Fri, 14 Aug 2009 20:56:11 +0000 (UTC) Received: from deuterium.andreas.nets ([91.190.8.131]) by smtp.fgznet.ch (8.13.8/8.13.8/Submit_SMTPAUTH) with ESMTP id n7EKu33t089354; Fri, 14 Aug 2009 22:56:07 +0200 (CEST) (envelope-from andreast-list@fgznet.ch) Message-ID: <4A85CF63.7080603@fgznet.ch> Date: Fri, 14 Aug 2009 22:56:03 +0200 From: Andreas Tobler User-Agent: Thunderbird 2.0.0.22 (Macintosh/20090605) MIME-Version: 1.0 To: Alexander Leidinger References: <4A832C70.4030600@fgznet.ch> <20090813081538.5361241c6z2lqcn4@webmail.leidinger.net> <4A8465EF.7030604@fgznet.ch> <20090814080400.20646vxm44n78b8c@webmail.leidinger.net> In-Reply-To: <20090814080400.20646vxm44n78b8c@webmail.leidinger.net> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Scanned-By: MIMEDefang 2.64 on 81.92.96.47 Cc: freebsd-current Subject: Re: tools/kerneldoc X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Aug 2009 20:56:12 -0000 Alexander Leidinger wrote: > Quoting Andreas Tobler (from Thu, 13 Aug > 2009 21:13:51 +0200): > >> Alexander Leidinger wrote: >>> Quoting Andreas Tobler (from Wed, 12 Aug >>> 2009 22:56:16 +0200): >>> >>>> Hi, >>>> >>>> does anybody care about this 'kerneldoc' package? >>> [...] >>> >>>> I then dived into the subsys dir and started a 'make all'. >>>> >>>> Here too, I failed since a few .m files are no more or they are >>>> placed on a different place. Well, this was easy, more or less. >>>> Commenting them made the build work, but this is only half the >>>> truth, what about the new .m files? >>> I have patches for the subsys part. A little bit more than only the >>> .m files fix: >>> http://www.leidinger.net/FreeBSD/current/patches/dox.diff >> Thanks, I tried it and I was surprised how long such a build took. >> Well, html and latex more than 5 hours on a p4 2.8GHz. And the >> amount of data is also huge, nearly 2GB of data. > > Normally you need only one of them. How do I say to only build one of them? Is it only possible via the doxygen build options, there I have html and latex equal to true. I guess I need to figure doxygen options, right? a few minutes later.... Bah, here we are: in common-Doxyfile: GENERATE_LATEX = NO >> Could you enlight me with the meaning of the toplevel kerneldoc, is >> this kerneldoc package meant as a whole or is the benefit only in >> the subsys part? > > When I was looking at creating the doxygen stuff, I noticed the > kerneldoc part. For my taste it was too huge. Most people are > interested in specific subsystems, not about everything (those who > really need everything are the minority). For this reason I created > the subsys part. Not every subsystem is available there, but if > someone submits the files for a missing one, I will have a look at them. For me the toplevel kerneldoc part does not work at all. But I did not investigate more. I took the opportunity to try to understand the subsys and I think I got it ;) I tried to build some stuff which is not there yet and I think I got the mechanics. I copied an existing Doxyfile to Doxyfile-dev_firewire and I 'received' what I wanted, well, I need to check the content. Btw, on -CURRENT (RELENG_8/8_STABLE) doxygen is at version 1.5.9. [tc:tools/kerneldoc/subsys] andreast% uname -r 8.0-BETA2 [tc:tools/kerneldoc/subsys] andreast% doxygen --version 1.5.9 Thank you Alexander for the insight! Regards, Andreas