From owner-freebsd-current@FreeBSD.ORG Thu Aug 13 19:14:04 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 C31601065674 for ; Thu, 13 Aug 2009 19:14:04 +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 6149E8FC47 for ; Thu, 13 Aug 2009 19:14:03 +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 n7DJDp7I098998; Thu, 13 Aug 2009 21:13:52 +0200 (CEST) (envelope-from andreast-list@fgznet.ch) Message-ID: <4A8465EF.7030604@fgznet.ch> Date: Thu, 13 Aug 2009 21:13:51 +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> In-Reply-To: <20090813081538.5361241c6z2lqcn4@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: Thu, 13 Aug 2009 19:14:05 -0000 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. > I haven't tested a lot there, e.g. the USB stuff needs review, as I > didn't had a look at it since the new USB subsystem went in. > > Personally I care about the subsys part, but my spare time for it was > not enough lately. I have some hope that I can setup an automatic run > with the HTML files available on a public webserver after 8.0-release. > At the time I do this, I will also have the time to check everything > and commit the patches (I don't think this part is important enough to > fix it this late in the release process, on the other hand it is > something optional and a commit wouldn't hurt more than letting it in > the current shape...). I agree here, I do not think that this is release critical. I just wondered if anybody is in touch with this code at all. 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? TIA, Andreas