Re: Documentation on functions

2005-09-16 Thread Joshua Daniel Franklin
noted, for libc functions you submit a patch to the newlib mailing list and then it trickles into Cygwin via my cygwin-doc package. For the Cygwin-specific functions, the documentation is in the Cygwin CVS http://cygwin.com/cvs.html and is written in XML DocBook. Unfortunately there have been

RE: Documentation on functions

2005-09-15 Thread Siegfried Heintze
Is there documentation on the documentation? In other words, is the process of submitting documentation documented? Does one use the GNU texi or SGML docbook or some other format? I've been curious about these tools for years but have never used them. Are there any functions documented (and I

RE: Documentation on functions

2005-09-15 Thread Reid Thompson
Siegfried Heintze wrote: Is there documentation on the documentation? In other words, is the process of submitting documentation documented? Does one use the GNU texi or SGML docbook or some other format? I've been curious about these tools for years but have never used them. Are there

RE: Documentation on functions

2005-09-15 Thread Eric Blake
of glue .tex files, which are then processed during the newlib build by texinfo to create the documentation. I just followed the existing styles, so strftime.c is an example you can use when adding documentation to functions that have none. I'm not sure about adding cygwin function documentation

Documentation on functions

2005-09-14 Thread Siegfried Heintze
is the documentation on these functions? Thanks, Siegfried/ -- Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple Problem reports: http://cygwin.com/problems.html Documentation: http://cygwin.com/docs.html FAQ: http://cygwin.com/faq/

Re: Documentation on functions

2005-09-14 Thread Eric Blake
compiles and seems to run! But, I notice, pthread_attr_init is not in man or info either. Where is the documentation on these functions? Missing because no one has ever contributed it. http://cygwin.com/acronyms#PTC -- Eric Blake -- Unsubscribe info: http://cygwin.com/ml/#unsubscribe

Re: Documentation on functions

2005-09-14 Thread Eric Blake
on pthreads compiles and seems to run! But, I notice, pthread_attr_init is not in man or info either. Where is the documentation on these functions? Missing because no one has ever contributed it. http://cygwin.com/acronyms#PTC Followup - for standard functions, like readdir

RE: Documentation on functions

2005-09-14 Thread Reid Thompson
is not in man or info either. Where is the documentation on these functions? Thanks, Siegfried/ http://www.die.net/doc/linux/man/man3/readdir.3.html http://www.die.net/doc/linux/man/ reid -- Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple Problem reports: http

RE: Documentation on functions

2005-09-14 Thread Reid Thompson
Eric Blake wrote: Followup - for standard functions, like readdir or pthread_attr_init, I usually refer directly to POSIX (http://www.opengroup.org/onlinepubs/009695399/toc.htm) to at great pointer -- thanks reid -- Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple Problem

Re: Documentation on functions

2005-09-14 Thread Christopher Faylor
On Wed, Sep 14, 2005 at 08:26:30AM -0600, Siegfried Heintze wrote: This is the third time I have mailed this to Cygwin and it has not showed up yet in the list. I am subscribed. Obviously, if you are seeing this, then it succeeded. What a mystery. Two bounce messages were sent to you: Tue Sep

RE: Documentation on functions

2005-09-14 Thread Gary R. Van Sickle
From: Siegfried Heintze Sent: Wednesday, September 14, 2005 9:27 AM To: cygwin@cygwin.com Subject: Documentation on functions This is the third time I have mailed this to Cygwin@cygwin.com and it has not showed up yet in the list. I am subscribed. Obviously, if you are seeing

Re: Documentation on functions

2005-09-14 Thread Christopher Faylor
On Wed, Sep 14, 2005 at 08:01:24PM -0500, Gary R. Van Sickle wrote: From: Siegfried Heintze Sent: Wednesday, September 14, 2005 9:27 AM Subject: Documentation on functions This is the third time I have mailed this to Cygwin and it has not showed up yet in the list. I am subscribed