Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 105188 - coreutils-related man pages in sys-apps/man-pages are very outdated
Summary: coreutils-related man pages in sys-apps/man-pages are very outdated
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Core system (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Gentoo's Team for Core System packages
URL:
Whiteboard:
Keywords:
: 158985 177826 (view as bug list)
Depends on:
Blocks:
 
Reported: 2005-09-07 14:39 UTC by Nelson Benítez
Modified: 2007-05-10 07:09 UTC (History)
6 users (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 Nelson Benítez 2005-09-07 14:39:13 UTC
Hi,
I thought I had found a bug in mv according to contradictions to what it is said
in its man page, but after asking in the mail list[1] it seems that gentoo is
shipping a mv man page not corresponding to the mv program that it's shipped.

Explanation:
Older versions of mv came in the fileutils package, but last versions came in
the coreutils packages. Gentoo is shipping last mv from coreutils package but
old man page from deprecated fileutils package.

Reproduceability:
Coreutils install man pages for the binaries it provides, but as you see this is
not the case for the mv man page:

gnelson man # equery files sys-apps/coreutils | grep mv
/bin/mv
/usr/bin/mv -> /bin/mv
gnelson man #

Instead the mv man page is located in the man-pages ebuild:

gnelson man # equery files sys-apps/man-pages | grep mv
/usr/share/man/man1/mv.1.gz
/usr/share/man/man1p/mv.1p.gz
gnelson man #


Solution:
Install man pages that comes in coreutils package[2] and delete the deprecated
ones that are in man-pages ebuild. Apart from mv I think other coreutils
binaries like cp has the same problem.

[1] http://lists.gnu.org/archive/html/bug-coreutils/2005-08/msg00078.html
[2] http://www.gnu.org/software/coreutils/

Reproducible: Always
Steps to Reproduce:
Comment 1 SpanKY gentoo-dev 2005-09-07 16:40:42 UTC
not really, we use the manpage from the man-pages package, not from coreutils
Comment 2 Joe Peterson (RETIRED) gentoo-dev 2006-08-26 09:43:44 UTC
I also see this problem with "ls".  In fact, the date at the bottom of the ls man page is "1998-11", and the page is missing some options (the one I was looking for was --time-style).

If you look on FC5 or Ubuntu, the man pages are from coreutils and are much more up-to-date and match the command better.  Also, since "ls" is part of coreutils, it does indeed seem wrong not to include the coreutils man pages for the applicable commands.

I suggest somethine be done to at least get more relevant man pages or Gentoo, which I love, looks a bit stale when it comes to some of the man pages.
Comment 3 Erik Logtenberg 2006-11-13 04:43:25 UTC
I would also like to kindly request Gentoo to use the coreutils manpages instead of the (very) outdated man-pages package. It is annoying to have to login to a Fedora machine and read the manpages there, to find out what the commandline options are. Gentoo supports the same commandline options, but they're "undocumented" because the manpages are obsolete. New uptodate manpages exist, I would very much appreciate it if they could be used instead.

Comment 4 SpanKY gentoo-dev 2006-12-24 02:44:32 UTC
*** Bug 158985 has been marked as a duplicate of this bug. ***
Comment 5 Azamat H. Hackimov 2006-12-24 03:12:15 UTC
OK, I'll try better search before posting bug...
Anyway, I modified ebuilds for man-pages and coreutils to resolve this problem.
See there:
https://bugs.gentoo.org/attachment.cgi?id=104674 (coreutils)
https://bugs.gentoo.org/attachment.cgi?id=104675 (man-pages)
Comment 6 Jakub Moc (RETIRED) gentoo-dev 2007-04-08 16:25:49 UTC
Sigh; why are we still installing the horribly obsolete stuff? :/
Comment 7 Thilo Bangert (RETIRED) (RETIRED) gentoo-dev 2007-04-17 10:01:02 UTC
i find this rather annoying as well. is there a specific reason for not providing the man pages to the programs we actually use?
Comment 8 SpanKY gentoo-dev 2007-04-30 18:54:13 UTC
fixed in coreutils-6.9-r1
Comment 9 Jakub Moc (RETIRED) gentoo-dev 2007-05-09 17:13:30 UTC
*** Bug 177826 has been marked as a duplicate of this bug. ***
Comment 10 Heiko Baumann 2007-05-10 07:09:14 UTC
sorry for the duplicate bug report. i should search with prefix 'ALL' before reporting new bugs :(