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 t

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, whic

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 ___ Bug-h

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 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 d

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 t

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 rea

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? > http://li

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 ski