Summary: | sys-apps/man-pages-6.03 missing pthreads pages | ||
---|---|---|---|
Product: | Gentoo Linux | Reporter: | Esteve Varela Colominas <esteve.varela> |
Component: | Current packages | Assignee: | Gentoo's Team for Core System packages <base-system> |
Status: | RESOLVED INVALID | ||
Severity: | normal | CC: | toolchain |
Priority: | Normal | ||
Version: | unspecified | ||
Hardware: | All | ||
OS: | Linux | ||
See Also: | https://bugzilla.kernel.org/show_bug.cgi?id=217148 | ||
Whiteboard: | |||
Package list: | Runtime testing required: | --- |
Description
Esteve Varela Colominas
2023-03-06 18:08:09 UTC
sys-apps/man-pages-posix appears to cover the missing functions. Could you give an example of a missing page which is in Debian's but not in posix-man-pages? I'm confused. I could've sworn that running "man pthread_cond_wait" resulted in the man page not being found yesterday, yet when I run it now, it properly opens pthread_cond_timedwait(3p). This happens despite there not being a symlink to the page. So I guess this is NOTABUG... It's weird, because some pages are referral pages instead of providing symlinks or similar. For example "man 3p pthread_mutex_unlock" properly redirects to pthread_mutex_lock(3p), yet running "man 3p pthread_mutex_trylock" opens a completely different page that tells you to "Refer to pthread_mutex_lock()" for more information. Doing some more digging, it appears the debian pages are lifted from old glibc source, and describe the old LinuxThreads implementation, see [1], at the bottom of the page. I consider these useful to complement the man-pages-posix documentation, as they're written in a more concise and practical manner, like the rest of man-pages. But I guess this should be solved upstream, as they're not considered up to standards right now... The only functions I could find that aren't in man-pages-posix are pthread_mutexattr_getkind_np and pthread_mutexattr_setkind_np, but these aren't very relevant. [1]: https://www.kernel.org/doc/man-pages/missing_pages.html (In reply to Esteve Varela Colominas from comment #3) > I'm confused. I could've sworn that running "man pthread_cond_wait" resulted > in the man page not being found yesterday, yet when I run it now, it > properly opens pthread_cond_timedwait(3p). This happens despite there not > being a symlink to the page. So I guess this is NOTABUG... > > It's weird, because some pages are referral pages instead of providing > symlinks or similar. For example "man 3p pthread_mutex_unlock" properly > redirects to pthread_mutex_lock(3p), yet running "man 3p > pthread_mutex_trylock" opens a completely different page that tells you to > "Refer to pthread_mutex_lock()" for more information. > > Doing some more digging, it appears the debian pages are lifted from old > glibc source, and describe the old LinuxThreads implementation, see [1], at > the bottom of the page. I consider these useful to complement the > man-pages-posix documentation, as they're written in a more concise and > practical manner, like the rest of man-pages. But I guess this should be > solved upstream, as they're not considered up to standards right now... > Yeah, we discussed this more on IRC in #gentoo-toolchain, and concluded the Debian pages should really be sent upstream to the man-pages project or just removed from Debian. They look pretty old. > The only functions I could find that aren't in man-pages-posix are > pthread_mutexattr_getkind_np and pthread_mutexattr_setkind_np, but these > aren't very relevant. > I'd file a bug with man-pages to document them. I figured it out, there's a daily cronjob in /etc/cron.daily/man-db that updates the man database, instead of doing it in a postinst phase...... The bug has been referenced in the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=71a802d5c12420638e3cc4f7116634ec40f0754f commit 71a802d5c12420638e3cc4f7116634ec40f0754f Author: Sam James <sam@gentoo.org> AuthorDate: 2024-02-12 08:46:47 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2024-02-12 08:50:33 +0000 sys-apps/man-pages: add 6.06, now with verify-sig This release also has some new pthread man page documentation imported from glibc and such (mentioned in the linked bug #899950). Bug: https://bugs.gentoo.org/899950 Signed-off-by: Sam James <sam@gentoo.org> sys-apps/man-pages/Manifest | 2 + sys-apps/man-pages/man-pages-6.06.ebuild | 150 +++++++++++++++++++++++++++++++ sys-apps/man-pages/man-pages-9999.ebuild | 34 ++++++- 3 files changed, 183 insertions(+), 3 deletions(-) |