Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 171008 - sys-libs/glibc - missing man pages for some utilities
Summary: sys-libs/glibc - missing man pages for some utilities
Status: RESOLVED UPSTREAM
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High normal with 1 vote (vote)
Assignee: Gentoo Toolchain Maintainers
URL:
Whiteboard:
Keywords:
: 149232 (view as bug list)
Depends on:
Blocks:
 
Reported: 2007-03-15 09:09 UTC by vicaya
Modified: 2012-05-05 00:48 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description vicaya 2007-03-15 09:09:45 UTC
Missing man pages for following programs from glibc
/usr/bin/catchsegv
/usr/bin/lddlibc4
/usr/bin/mtrace
/usr/bin/pcprofiledump
/usr/bin/rpcgen
/usr/bin/sprof
/usr/bin/xtrace
/usr/sbin/iconvconfig
/usr/sbin/rpcinfo

Commonly needed and found on other systems (debian/ubuntu):
catchsegv(1), sprof(1), rpcgen(1), xtrace(1), mtrace(1), rpcinfo(8), iconvconfig(8)

Reproducible: Always




probably should be included in the patches (in extra/) like locale-gen(8)

I personally care about rpcgen and mtrace, in that order. I can attach rpcgen.1 from ubuntu if you need it.
Comment 1 Lucas 2008-12-02 02:48:14 UTC
lthode@blazinpenguin ~ $ ls /usr/bin/catchsegv
/usr/bin/catchsegv
lthode@blazinpenguin ~ $ man catchsegv
No manual entry for catchsegv
lthode@blazinpenguin ~ $ ls /usr/bin/lddlibc4
/usr/bin/lddlibc4
lthode@blazinpenguin ~ $ man lddlibc4
No manual entry for lddlibc4
lthode@blazinpenguin ~ $ ls /usr/bin/mtrace
/usr/bin/mtrace
lthode@blazinpenguin ~ $ man mtrace
Formatting page, please wait...
lthode@blazinpenguin ~ $ man 1 mtrace
No entry for mtrace in section 1 of the manual
lthode@blazinpenguin ~ $ ls /usr/bin/pcprofiledump
/usr/bin/pcprofiledump
lthode@blazinpenguin ~ $ man pcprofiledump
No manual entry for pcprofiledump
lthode@blazinpenguin ~ $ ls /usr/bin/rpcgen
/usr/bin/rpcgen
lthode@blazinpenguin ~ $ man rpcgen
No manual entry for rpcgen
lthode@blazinpenguin ~ $ ls /usr/bin/sprof
/usr/bin/sprof
lthode@blazinpenguin ~ $ man sprof
No manual entry for sprof
lthode@blazinpenguin ~ $ ls /usr/bin/xtrace
/usr/bin/xtrace
lthode@blazinpenguin ~ $ man xtrace
No manual entry for xtrace
lthode@blazinpenguin ~ $ ls /usr/sbin/iconfconfig
ls: cannot access /usr/sbin/iconfconfig: No such file or directory
lthode@blazinpenguin ~ $ ls /usr/sbin/iconvconfig
/usr/sbin/iconvconfig
lthode@blazinpenguin ~ $ man iconvconfig
No manual entry for iconvconfig
lthode@blazinpenguin ~ $ ls /usr/sbin/rpcinfo
/usr/sbin/rpcinfo
lthode@blazinpenguin ~ $ man rpcinfo
No manual entry for rpcinfo
lthode@blazinpenguin ~ $ /lib/libc.so.6 
GNU C Library stable release version 2.8, by Roland McGrath et al.
Copyright (C) 2008 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.
Compiled by GNU CC version 4.1.2 (Gentoo 4.1.2 p1.1).
Compiled on a Linux >>2.6.25-gentoo-r7<< system on 2008-09-11.
Available extensions:
	C stubs add-on version 2.1.2
	crypt add-on version 2.1 by Michael Glad and others
	Gentoo snapshot 20080602
	Gentoo patchset 2
	GNU Libidn by Simon Josefsson
	Native POSIX Threads Library by Ulrich Drepper et al
	Support for some architectures added on, not maintained in glibc core.
	BIND-8.2.3-T5B
For bug reporting instructions, please see:
<http://www.gnu.org/software/libc/bugs.html>.

Nice...NOT!  
Comment 2 Doug Goldstein (RETIRED) gentoo-dev 2009-05-29 19:04:08 UTC
Unfortunately the glibc developers don't feel they need to document it with man pages. As such the man-page project has risen up to fill this very necessary hole. Example (output edited for length):

$ equery files glibc | grep man
/usr/share/man/man5/locale.gen.5.bz2
/usr/share/man/man8/locale-gen.8.bz2

$ equery belongs rpcgen
 * Searching for rpcgen ... 
sys-libs/glibc-2.10.1 (/usr/bin/rpcgen)

We can see about upstreaming to the man-pages project a few of those man pages and then bringing others in as necessary.
Comment 3 Doug Goldstein (RETIRED) gentoo-dev 2009-05-29 19:04:43 UTC
*** Bug 149232 has been marked as a duplicate of this bug. ***
Comment 4 Martin Walch 2010-12-06 11:46:46 UTC
This bug seems very similar to bug #42617 (man page for getent is missing). Can these two be merged?
Comment 5 SpanKY gentoo-dev 2012-05-05 00:48:05 UTC
some apps will be documented elsewhere while some are a little too simple to bother writing a man page for them (like lddlibc4).