[gentoo-user] Cleaning up multiple man pages (how?)

[gentoo-user] Cleaning up multiple man pages (how?)

[Kevin O'Gorman]

I've noticed that the whereis(1) command gives multiple results for
some queries.  For instance, "whereis lilo" gives me

kevin@treat ~ $ whatis lilo
lilo                 (8)  - install boot loader
lilo.conf [lilo]     (5)  - configuration file for lilo
lilo                 (8)  - install boot loader
lilo.conf [lilo]     (5)  - configuration file for lilo
lilo                 (8)  - install boot loader
lilo.conf [lilo]     (5)  - configuration file for lilo
kevin@treat ~ $

I surmise from this that there are multiple copies of the man pages
in various historical hiding places.  However, I can't get whereis
or anything else to tell me where it found them.  Is there some
neat way to find the locations?  I'd like to figure out which ones
correspond to my actual software and to ditch the others.

-- 
Kevin O'Gorman, PhD
-- 
gentoo-user@gentoo.org mailing list

Re: [gentoo-user] Cleaning up multiple man pages (how?)

[Willie Wong]

On Thu, Aug 17, 2006 at 06:43:15PM -0700, Penguin Lover Kevin O'Gorman squawked:
> I've noticed that the whereis(1) command gives multiple results for
> some queries.  For instance, "whereis lilo" gives me
> 
> kevin@treat ~ $ whatis lilo
> lilo                 (8)  - install boot loader
> lilo.conf [lilo]     (5)  - configuration file for lilo
> lilo                 (8)  - install boot loader
> lilo.conf [lilo]     (5)  - configuration file for lilo
> lilo                 (8)  - install boot loader
> lilo.conf [lilo]     (5)  - configuration file for lilo
> kevin@treat ~ $
> 
> I surmise from this that there are multiple copies of the man pages
> in various historical hiding places.  However, I can't get whereis
> or anything else to tell me where it found them.  Is there some
> neat way to find the locations?  I'd like to figure out which ones
> correspond to my actual software and to ditch the others.

Well, the whatis database is generated by /usr/sbin/makewhatis
I took a cursory glance and couldn't figure out why the repeats.
Perhaps you'd have better understanding?

W
-- 
I'm dead sexy.
    ~Alex MacDonald
Sortir en Pantoufles: up 22 days,  8:50
-- 
gentoo-user@gentoo.org mailing list

[gentoo-user] Re: Cleaning up multiple man pages (how?)

[Remy Blank]

Willie Wong wrote:
> On Thu, Aug 17, 2006 at 06:43:15PM -0700, Penguin Lover Kevin O'Gorman squawked:
>> I've noticed that the whereis(1) command gives multiple results for
>> some queries.

My guess is that it's (partly) due to the following definitions in
/etc/man.conf:

MANPATH /usr/share/man
MANPATH /usr/local/share/man
MANPATH /usr/X11R6/man
MANPATH /usr/local/man
MANPATH /usr/man

...because /usr/man is a symlink to /usr/share/man, and at least on some
machines /usr/X11R6 is a symlink to /usr. I haven't tried removing the
"duplicates" though. The MANPATH_MAP possibly also have an influence.

-- Remy


Remove underscore and suffix in reply address for a timely response.

-- 
gentoo-user@gentoo.org mailing list

Re: [gentoo-user] Cleaning up multiple man pages (how?)

[Benno Schulenberg]

[-- Attachment #1: Type: text/plain, Size: 2559 bytes --]

Kevin O'Gorman wrote:
> I've noticed that the whereis(1) command gives multiple results
> for some queries.  For instance, "whereis lilo" gives me
>
> kevin@treat ~ $ whatis lilo

Ehm... 'whatis' is not 'whereis'.  But leaving that aside, have a 
look at your MANPATH: echo $MANPATH.  If it contains repeated 
entries, you may have to clean up /etc/env.d a bit: cd /etv/env.d/ 
and grep MANPATH *, prune the identical repetitions, then run 
env-update, re-login and run makewhatis.

Also have a look at /etc/man.conf.  The NOAUTOPATH keyword is 
probably needed.  Check with:

# grep -v ^# /etc/man.conf
FHS

MANPATH /usr/share/man
MANPATH /usr/local/share/man


MANPATH_MAP     /bin                    /usr/share/man
MANPATH_MAP     /sbin                   /usr/share/man
MANPATH_MAP     /usr/bin                /usr/share/man
MANPATH_MAP     /usr/sbin               /usr/share/man
MANPATH_MAP     /usr/local/bin          /usr/local/share/man
MANPATH_MAP     /usr/local/sbin         /usr/local/share/man
MANPATH_MAP     /usr/bin/mh             /usr/share/man

NOAUTOPATH


TROFF           /usr/bin/groff -Tps -mandoc
NROFF           /usr/bin/nroff -Tascii -c -mandoc
JNROFF          /usr/bin/groff -Tnippon -mandocj
EQN             /usr/bin/geqn -Tps
NEQN            /usr/bin/geqn -Tlatin1
JNEQN           /usr/bin/geqn -Tnippon
TBL             /usr/bin/gtbl
REFER           /usr/bin/refer
PIC             /usr/bin/pic
VGRIND
GRAP
PAGER           /usr/bin/less -is
BROWSER         /usr/bin/less -is
HTMLPAGER       /bin/cat
CAT             /bin/cat

CMP             /usr/bin/cmp -s

COMPRESS        /bin/cat
COMPRESS_EXT    .F

MANSECT         1:1p:8:2:3:3p:4:5:6:7:9:0p:tcl:n:l:p:o:1x:2x:3x:4x:5x:6x:7x:8x


.gz             /bin/gunzip -c
.bz2            /bin/bzip2 -c -d
.z
.Z              /bin/zcat
.F
.Y


# whatis man
man                  (1)  - format and display the on-line manual pages
man                  (1p)  - display system documentation
man                  (7)  - macros to format man pages
man.conf [man]       (5)  - configuration data for man

To get rid of the multiple reports by 'whereis', apply the attached 
patch in an overlay to util-linux.  It removes from the whereis 
search path the dirs that on my system are symlinks.

# whereis man
man: /usr/bin/man /etc/man.conf /usr/local/man /usr/share/man /usr/share/man/man1/man.1.gz /usr/share/man/man7/man.7.gz /usr/share/man/man1p/man.1p.gz

Benno

-- 
Cetere mi opinias ke ne ĉio tradukenda estas.

[-- Attachment #2: util-linux--whereis-remove-symlinks.patch --]
[-- Type: text/x-diff, Size: 442 bytes --]

--- misc-utils/whereis.c.old	2001-03-15 11:09:58.000000000 +0100
+++ misc-utils/whereis.c	2006-08-18 13:57:23.000000000 +0200
@@ -75,9 +75,7 @@
    "/usr/tex/bin",
    "/usr/interviews/bin/LINUX",
    
-   "/usr/X11R6/bin",
    "/usr/X386/bin",
-   "/usr/bin/X11",
    "/usr/X11/bin",
    "/usr/X11R5/bin",
 
@@ -111,7 +109,6 @@
 };
 
 static char *mandirs[] = {
-	"/usr/man/*",
 	"/usr/share/man/*",
 	"/usr/X386/man/*",
 	"/usr/X11/man/*",

[gentoo-user] Re: Cleaning up multiple man pages (how?)

[Marco Costa]

Kevin O'Gorman wrote:
> I've noticed that the whereis(1) command gives multiple results for
> some queries.  For instance, "whereis lilo" gives me
> 
> kevin@treat ~ $ whatis lilo
> lilo                 (8)  - install boot loader
> lilo.conf [lilo]     (5)  - configuration file for lilo
> lilo                 (8)  - install boot loader
> lilo.conf [lilo]     (5)  - configuration file for lilo
> lilo                 (8)  - install boot loader
> lilo.conf [lilo]     (5)  - configuration file for lilo
> kevin@treat ~ $
> 
> I surmise from this that there are multiple copies of the man pages
> in various historical hiding places.  However, I can't get whereis
> or anything else to tell me where it found them.  Is there some
> neat way to find the locations?  I'd like to figure out which ones
> correspond to my actual software and to ditch the others.
> 

Remove /var/cache/man (I don't have it anymore, so I am not really sure that this is the name) but it is the cause of the multiple entries.
Note that you will still have double entries for some pages, as they are POSIX and linux variants.

Regards,

Marco

-- 
gentoo-user@gentoo.org mailing list