From owner-freebsd-current@FreeBSD.ORG Fri Aug 14 06:04:21 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 28C901065692 for ; Fri, 14 Aug 2009 06:04:21 +0000 (UTC) (envelope-from alexander@leidinger.net) Received: from mail.ebusiness-leidinger.de (mail.ebusiness-leidinger.de [217.11.53.44]) by mx1.freebsd.org (Postfix) with ESMTP id ABA398FC48 for ; Fri, 14 Aug 2009 06:04:20 +0000 (UTC) Received: from outgoing.leidinger.net (pD9E2D4AE.dip.t-dialin.net [217.226.212.174]) by mail.ebusiness-leidinger.de (Postfix) with ESMTPSA id 39AF08440A6; Fri, 14 Aug 2009 08:04:05 +0200 (CEST) Received: from webmail.leidinger.net (webmail.leidinger.net [192.168.1.102]) by outgoing.leidinger.net (Postfix) with ESMTP id BC0B711F7BB; Fri, 14 Aug 2009 08:04:01 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=Leidinger.net; s=outgoing-alex; t=1250229841; bh=RgjhvV4ZPkUk37BC7JLRpnrCgeGkMdztCGo0Las90ng=; h=Message-ID:Date:From:To:Cc:Subject:References:In-Reply-To: MIME-Version:Content-Type:Content-Transfer-Encoding; b=thp1VZ7jqk+7mzyynsOpXRKqY38mrgS/SdrGqrYShbD0ncyU5EXpwpUb0PMsJfIy3 UITbviuDAvjxkVObYJvQceWd0E2dlmscqlpp0PQHRqktujLtBCFnU8UAU18Ak7RlR1 MAhxIgpC1zTvzEIKTVMdhaw3DVOu5Pmv94YeB+RVARzBXE311gqDcq9hsHDcqkxGB7 AdtLw1BkP+wvfWYstM5/WWSIY5df28hAXyYm2iWsEcK0pe1rnJ3ixIPHrmw7c2YXGG V6Xno/6S3OcCF8TZBZVrsReRfqBjaT/MvMjj3q0ND4oUJvKKgFAaZGNeyVc3YPDuKR IZBm/iPCzjFNg== Received: (from www@localhost) by webmail.leidinger.net (8.14.3/8.13.8/Submit) id n7E641sA045853; Fri, 14 Aug 2009 08:04:01 +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 Framework) with HTTP; Fri, 14 Aug 2009 08:04:00 +0200 Message-ID: <20090814080400.20646vxm44n78b8c@webmail.leidinger.net> X-Priority: 3 (Normal) Date: Fri, 14 Aug 2009 08:04:00 +0200 From: Alexander Leidinger To: Andreas Tobler References: <4A832C70.4030600@fgznet.ch> <20090813081538.5361241c6z2lqcn4@webmail.leidinger.net> <4A8465EF.7030604@fgznet.ch> In-Reply-To: <4A8465EF.7030604@fgznet.ch> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8; DelSp="Yes"; format="flowed" Content-Disposition: inline Content-Transfer-Encoding: 7bit User-Agent: Internet Messaging Program (IMP) 4.3.3 / FreeBSD-8.0 X-EBL-MailScanner-Information: Please contact the ISP for more information X-EBL-MailScanner-ID: 39AF08440A6.C06AC X-EBL-MailScanner: Found to be clean X-EBL-MailScanner-SpamCheck: not spam, spamhaus-ZEN, SpamAssassin (not cached, score=-1.439, required 6, autolearn=disabled, ALL_TRUSTED -1.44, DKIM_SIGNED 0.00) X-EBL-MailScanner-From: alexander@leidinger.net X-EBL-MailScanner-Watermark: 1250834646.1647@jCuBgmkQVldi5ZrkVDjtTQ X-EBL-Spam-Status: No 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 06:04:21 -0000 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. > 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. Bye, Alexander. -- Automobile, n.: A four-wheeled vehicle that runs up hills and down pedestrians. http://www.Leidinger.net Alexander @ Leidinger.net: PGP ID = B0063FE7 http://www.FreeBSD.org netchild @ FreeBSD.org : PGP ID = 72077137