tools/kerneldoc

[Alexander Leidinger]

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 @ Leidinger.net: PGP ID = B0063FE7
http://www.FreeBSD.org       netchild @ FreeBSD.org  : PGP ID = 72077137