Re: tools/kerneldoc

From: Alexander Leidinger <Alexander_at_Leidinger.net>
Date: Fri, 14 Aug 2009 08:04:00 +0200
Quoting Andreas Tobler <andreast-list_at_fgznet.ch> (from Thu, 13 Aug  
2009 21:13:51 +0200):

> Alexander Leidinger wrote:
>> Quoting Andreas Tobler <andreast-list_at_fgznet.ch> (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 _at_ Leidinger.net: PGP ID = B0063FE7
http://www.FreeBSD.org       netchild _at_ FreeBSD.org  : PGP ID = 72077137
Received on Fri Aug 14 2009 - 04:04:21 UTC

This archive was generated by hypermail 2.4.0 : Wed May 19 2021 - 11:39:53 UTC