Hi Brian, On Fri, Aug 22, 2008 at 10:21 PM, brian m. carlson <[EMAIL PROTECTED]> wrote: > Manpages for the following functions are attached (in a tarball): > pthread_cancel(3) > pthread_create(3) > pthread_equal(3) > pthread_exit(3) > pthread_join(3) > pthread_kill(3) > pthread_self(3) > > Comments are appreciated. I will work on pthread_mutex_* functions next.
Late on Friday night here, so just a few quick comments/questions. You've submitted these pages against a Debian bug, which is fine, but I assume you'd like to see them go upstream. (So would I.) If so, please read man-pages(7) closely, since it has a few comments on style that are relevant. E.g., start new sentences on new source lines. You've heaed up the pages "NPTL". I'd rather avoid that. The reason is that I'd like the pages to be somewhat generic to threads, and then document deviations from the standard under (say) NOTES. And there I'd like to see mention of deviations for (ideally) both deviations by NPTL and by LinuxThreads. Under SEE ALSO, make all pages reference pthreads(7). Please supply some background on how the material for the pages was developed. E.g., experience with the API, reading glibc sources, reading the standard, etc. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
