* [Bug 217148] New: man-pages-posix: create symlinks during installation
@ 2023-03-06 18:01 bugzilla-daemon
2023-05-19 12:02 ` [Bug 217148] " bugzilla-daemon
2023-05-19 12:02 ` bugzilla-daemon
0 siblings, 2 replies; 3+ messages in thread
From: bugzilla-daemon @ 2023-03-06 18:01 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217148
Bug ID: 217148
Summary: man-pages-posix: create symlinks during installation
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages@kernel-bugs.osdl.org
Reporter: esteve.varela@gmail.com
Regression: No
Doing some pthreads programming as of recently, I've found that the
documentation is scattered across the man-pages and man-pages-posix projects.
Various pages refer to the existence of other pages, which simply don't exist
in a default installation as created by "make install" of man-pages-posix. For
example, pthreads(3) refers to pthread_cond_wait(3). Running "man
pthread_cond_wait" will result in the man page not being found.
On the website[1], this page appears to be a symlink. The correct page it
should lead to, being pthread_cond_wait(3p) (yes, 3p, not 3, as was referred).
However, currently no distributions make a symlink for these, so the correct
page is frequently hard to find.
I'd like to have a default set of man page symlinks created by the
man-pages-posix distribution tarball, reflecting whatever the man7.org site
does, such that these pages are more easily found, and the documentation is
consistent across linux distributions.
Interestingly, debian has a set of pages[2] for some of the "missing" pages,
but these aren't shipped in any other distribution I'm aware of.
[1]: https://man7.org/linux/man-pages/man3/pthread_cond_wait.3p.html
[2]: https://manpages.debian.org/bullseye/glibc-doc/index.html
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 3+ messages in thread
* [Bug 217148] man-pages-posix: create symlinks during installation
2023-03-06 18:01 [Bug 217148] New: man-pages-posix: create symlinks during installation bugzilla-daemon
@ 2023-05-19 12:02 ` bugzilla-daemon
2023-05-19 12:02 ` bugzilla-daemon
1 sibling, 0 replies; 3+ messages in thread
From: bugzilla-daemon @ 2023-05-19 12:02 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217148
--- Comment #1 from Alejandro Colomar (alx@kernel.org) ---
The man-pages-posix project is for POSIX documentation. There is actual
glibc documentation for those phtreads functions, but it's not (yet?) in
the Linux man-pages project. In Debian you can get those manual pages
through the glibc-doc package. I've asked the maintainers to merge
those pages into the Linux man-pages project.
<https://lore.kernel.org/linux-man/703ec07e-dd2b-bbc6-f1bc-f495e53b764f@gmail.com/T/#u>
I hope we soon have these Debian pages in the project.
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 3+ messages in thread
* [Bug 217148] man-pages-posix: create symlinks during installation
2023-03-06 18:01 [Bug 217148] New: man-pages-posix: create symlinks during installation bugzilla-daemon
2023-05-19 12:02 ` [Bug 217148] " bugzilla-daemon
@ 2023-05-19 12:02 ` bugzilla-daemon
1 sibling, 0 replies; 3+ messages in thread
From: bugzilla-daemon @ 2023-05-19 12:02 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=217148
Alejandro Colomar (alx@kernel.org) changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |ASSIGNED
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2023-05-19 12:02 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-03-06 18:01 [Bug 217148] New: man-pages-posix: create symlinks during installation bugzilla-daemon
2023-05-19 12:02 ` [Bug 217148] " bugzilla-daemon
2023-05-19 12:02 ` bugzilla-daemon
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).