Bug#460637: LinuxThreads manual pages
clone 460637 -1
retitle 460637 manpages-dev: Port over whatever is useful from LinuxThreads pages
severity 460637 wishlist
reassign 460637 manpages-dev
retitle -1 Please remove outdated LinuxThreads manpages
forcemerge 572716 -1
severity -1 minor
block -1 by 519781
thanks
Jonathan Nieder wrote:
> Josef Spillner wrote:
>> The man pages are LinuxThreads-specific, even though the default
>> implementation of pthreads is NPTL nowadays. Some library calls such as
>> pthread_mutexattr_setpshared are missing, and some of the limitations
>> (such as using inter-process mutex locking), options and other
>> peculiarities also differ.
>>
>> Unfortunately I think that the docs are outdated upstream as well
>
> Indeed, the LinuxThreads man pages are not even maintained upstream
> any more AFAICT.
>
> My suggestion would be to copy over any information and text that applies
> for NPTL to the man-pages project, and once the man-pages versions are
> deemed suitable (or maybe right away), get the Debian glibc-doc package
> to stop shipping these files and manpages-dev to start.
So splitting the bug in two:
- Since the LinuxThreads man pages tend to be nice though outdated, I will
be working as time permits to copy what is still applicable to man-pages.
mtk seems to be okay with this plan, which is nice. See [1] for details
on how to help out.
- The pages in man-pages are usable and maintained, and I think we should
ship them. This requires coordination between the two packages.
Actually, manpages-dev should be changed first (with Replaces: glibc-doc,
this requires no action by the glibc maintainers).
[1] http://bugs.debian.org/460637
Reply to: