[Bug 80541] New: man pages for unimplemented functions provoke name clash

[Bug 80541] New: man pages for unimplemented functions provoke name clash

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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/vQLgFONoPN62D2FQJk+8+b@public.gmane.org
          Reporter: j.wuttke-97/bSmCnXvjoK6nBLMlh1Q@public.gmane.org
        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.

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 80541] man pages for unimplemented functions provoke name clash

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

https://bugzilla.kernel.org/show_bug.cgi?id=80541

Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org

--- Comment #1 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
Hello Joachim,

>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

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 80541] man pages for unimplemented functions provoke name clash

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

https://bugzilla.kernel.org/show_bug.cgi?id=80541

--- Comment #2 from Joachim Wuttke <j.wuttke-97/bSmCnXvjoK6nBLMlh1Q@public.gmane.org> ---
(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

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 80541] man pages for unimplemented functions provoke name clash

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

https://bugzilla.kernel.org/show_bug.cgi?id=80541

--- Comment #3 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
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.

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 80541] man pages for unimplemented functions provoke name clash

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

https://bugzilla.kernel.org/show_bug.cgi?id=80541

Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |CODE_FIX

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html