Re: Library/function documentation

2007-12-18 Thread olafBuddenhagen
Hi, On Sat, Dec 15, 2007 at 12:17:24AM +0530, Shakthi Kannan wrote: How do core developers go through Hurd servers/library or gnumach functions? Do you use etags/ctags? Everyone uses what suits him best :-) As for myself (definitely not a core developer), I'm using ctags extensively, which

Re: Library/function documentation

2007-12-18 Thread Shakthi Kannan
Hi, - On Dec 16, 2007 11:38 PM, [EMAIL PROTECTED] wrote: | any normal comments in the code -- doxygen can link every function to | the corresponding location in the source code. \-- Here is a customized doxygen config file which I am satisfied with (for reference, if others would like to

Re: Library/function documentation

2007-12-17 Thread Samuel Thibault
Hi, Shakthi Kannan, le Mon 17 Dec 2007 11:35:14 +0530, a écrit : - On Dec 16, 2007 7:40 PM, Carl Fredrik Hammar [EMAIL PROTECTED] wrote: | The consensus seem to be that proper overview documentation belongs in | info pages were it can be handled more appropriate. \-- Where are the info

Re: Library/function documentation

2007-12-17 Thread Shakthi Kannan
Hi, - On Dec 17, 2007 4:02 PM, Samuel Thibault [EMAIL PROTECTED] wrote: | And different have different ways of documenting the code, and that | seems to be the point that needs to be the most stable else you get a | mess :) \-- True. I shall have a look at the info pages. An intuitive web

Re: Library/function documentation

2007-12-17 Thread Samuel Thibault
Shakthi Kannan, le Mon 17 Dec 2007 17:30:19 +0530, a écrit : - On Dec 17, 2007 4:02 PM, Samuel Thibault [EMAIL PROTECTED] wrote: | And different have different ways of documenting the code, and that | seems to be the point that needs to be the most stable else you get a | mess :) \--

Re: Library/function documentation

2007-12-17 Thread Shakthi Kannan
Hi, - On Dec 17, 2007 5:37 PM, Samuel Thibault [EMAIL PROTECTED] wrote: | I guess there is some texinfo2html tool somewhere. \-- The following works: texi2html hurd.texi Regards, SK -- Shakthi Kannan http://www.shakthimaan.com ___

Re: Library/function documentation

2007-12-16 Thread Carl Fredrik Hammar
Hello! Hi, How do core developers go through Hurd servers/library or gnumach functions? Do you use etags/ctags? Personally I use etags when browsing through code. Wouldn't it be useful for newbies if all functions can have comments to generate gtk-doc style documentation?

Re: Library/function documentation

2007-12-16 Thread Shakthi Kannan
Hi, - On Dec 16, 2007 7:40 PM, Carl Fredrik Hammar [EMAIL PROTECTED] wrote: | The consensus seem to be that proper overview documentation belongs in | info pages were it can be handled more appropriate. \-- Where are the info pages available? Different developers have different ways of

Library/function documentation

2007-12-15 Thread Shakthi Kannan
Hi, How do core developers go through Hurd servers/library or gnumach functions? Do you use etags/ctags? Wouldn't it be useful for newbies if all functions can have comments to generate gtk-doc style documentation? http://library.gnome.org/devel/glib/unstable/index.html It will be helpful to