New: man pages for unimplemented functions provoke name clash
https://bugzilla.kernel.org/show_bug.cgi?id=80541
Bug ID: 80541
Summary: man pages for unimplemented functions provoke name
clash
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages-ztI5WcYan/[email protected]
Reporter: j.wuttke-97/[email protected]
Regression: No
A page like cerf(3), which says "not yet in glibc, as at version 2.12", provokes a name clash if some other library provides the missing implementation.
The rpm package managers reacts to such name clash by suggesting to uninstall libc, which is no clever resolution.
I suggest to resolve this problem by moving man pages of unimplemented functions to manual section 7, so that they can peacefully coexist in the shadow of section 3 pages provided by more specific libraries.
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): bug-80541-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/
[Bug 80541] man pages for unimplemented functions provoke name clash
https://bugzilla.kernel.org/show_bug.cgi?id=80541
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]
--- Comment #1 from Michael Kerrisk <[email protected]> --- Hello Joachim,
Quoted 1 line
From my perspective, pages such as this are of marginal value, and if they
provoke conflicts, I'd consider removing them. But... which other package provides this man page?
Cheers,
Michael
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 80541] man pages for unimplemented functions provoke name clash
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=80541
--- Comment #2 from Joachim Wuttke <j.wuttke-97/[email protected]> --- (In reply to Michael Kerrisk from comment #1)
cerf(3) and related functions are provided by libcerf. Source available from
http://apps.jcns.fz-juelich.de/doku/sc/libcerf. For binary packages, see links at bottom of that page.
Removing the man pages of the non-implemented functions sounds like the easiest and most straightforward solution to me. Thanks for considering this further.
Best regards - Joachim
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 80541] man pages for unimplemented functions provoke name clash
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=80541
--- Comment #3 from Michael Kerrisk <[email protected]> ---
Summary: These functions don't exist in glibc, aren't specified in C99 or C11 (those standards merely reserve the names for future use), cause package conflicts for libcerf (http://apps.jcns.fz-juelich.de/doku/sc/libcerf), which does provide implementations and man-pages for these functions, and cause confusion for readers who (not looking too closely at the page) wonder where the glibc implementation is.
I've removed the cerf(3) and its links from man-pages. Sorry for the slow follow up.
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 80541] man pages for unimplemented functions provoke name clash
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=80541
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
Resolution|--- |CODE_FIXSignature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html