On 08/11/2017 10:11 AM, Yubin Ruan wrote:
> 2017-08-09 3:27 GMT+08:00 Michael Kerrisk (man-pages) 
> <mtk.manpa...@gmail.com>:
>> Hi,
>> On 08/07/2017 06:42 PM, Randy Dunlap wrote:
>>> On 08/07/2017 09:31 AM, Yubin Ruan wrote:
>>>> Hi, I am wondering whether there is any progress for NPTL. In page[1]
>>>> I see lots of pthread-related pages are missing. Pretty shocked by
>>>> that.
>>>> Are there any plan for that? Who is the maintainer of NPTL? Why are
>>>> such an important lib missing manual pages?
>> Because no-one wrote all of them yet. I know it's not what you
>> hope to hear, but contributions are welcome.
>> Note, by the way, that the Linux man-pages project sits outside of
>> the glibc project. The documentation for that project is the
>> glibc manual, but many things also are not documented there.
>> Also, there are the POSIX man pages, which are distributed by the
>> Linux man-pages project. These are extracts from POSIX, and document
>> (the standard behavior) of all of the pthreads functions that are in
>> POSIX. Installing those pages may give you some of what you want.
>>>> [1]: https://www.kernel.org/doc/man-pages/missing_pages.html
>>> [adding Michael Kerrisk]
>>> Wikipedia says:
>>> {in https://en.wikipedia.org/wiki/Native_POSIX_Thread_Library}
>>> "NPTL has been part of Red Hat Enterprise Linux since version 3, and
>>> in the Linux kernel since version 2.6. It is now a fully integrated
>>> part of the GNU C Library.[2]"
>>> so I would expect the documentation to be part of that library.
> Hi,
> I can write some of them, although I cannot guarantee when I can finish that.
> If anyone is doing this already or have any suggestions please let me know.
> Not sure whether I am qualified for that, but I would like to try.
> I am going to port some pages from the POSIX thread standard docs, testing
> every features and modify the docs correspondingly.


Thanks for the offer to help. I suggest to start small, with one or two
pages that are free-standing (i.e., not part of a group of closely
related functions).  Be aware that the POSIX.1 man pages are copyright,
under a nonfree license. You can't just produce modified versions
of those pages. Rather, the new pages must be written in your own words.



Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to