Re: Documentation on functions

[ericblake at comcast dot net (Eric Blake)]

> > 
> > I noticed that when I boot fedora core 4, the function readdir is documented
> > in man. However, when I boot windows/Cygwin readdir is not available in info
> > or man. When I download the same code for "Beginning Programming in Linux"
> > from the www.wrox.com site I notice that all the code 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 or pthread_attr_init,
I usually refer directly to POSIX
(http://www.opengroup.org/onlinepubs/009695399/toc.htm) to at
least see what aspects of the function should be implemented
across various systems, although it doesn't document the extensions
that are permitted.  For non-standard functions, google is your
friend (for example, I recently patched newlib's argz_insert, which
was not behaving like BSD's version; googling for 'man argz_insert'
was what let me find out how BSD does it, since POSIX does not
require it).

Furthermore, some of the lack of documentation is the fault of
newlib, not cygwin, but both projects could use improvements.

--
Eric Blake



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