Bug 29541 – [manpages,xorg-x11]: `/usr/share/man/man4/mouse.4' shadows `/usr/X11R6/man/man4/mouse.4'

• Status: RESOLVED FIXED
• Product: Gentoo Linux

[Description bartron 2003-09-24 15:19:55 UTC]

sys-apps/manpages and xfree both install a manpage with the 
same name, the one in `/usr/share/man' taking precedence.

 $ man -aw mouse
 /usr/share/man/man4/mouse.4.gz
 /usr/X11R6/man/man4/mouse.4.gz

[Comment 1 Andrew Bevitt 2003-11-27 16:35:33 UTC]

This is still the case with 4.3.99.16 so possible suggestion for fix
- rename the X man page to : xmouse 

Any futher suggestions?

[Comment 2 Donnie Berkholz (RETIRED) 2004-03-20 20:33:00 UTC]

Sounds good. Got a patch handy?

[Comment 3 L.Stohlmann 2005-06-12 07:47:14 UTC]

Why dont we move all X man pages to /usr/share/man[1-8]x, so 

man 4x mouse would get the right page and
man 4 mouse the RS232 mouse thingy?

Since /usr/X11R6 went to /usr, this would make sense to me, and its pretty easy
to achieve, afaik would not violate FHS and only needs some more lines in the
Makefiles for the man pages.

Or do I err here?

[Comment 4 Donnie Berkholz (RETIRED) 2005-06-12 17:05:53 UTC]

$ equery files xorg-x11 | grep mouse | grep man
/usr/share/man/man4/mouse.4x.gz

It already is. The problem is that `man` apparently can't discriminate between 4
and 4x.

[Comment 5 L.Stohlmann 2005-06-20 08:49:21 UTC]

Well, by moving them to the dirs named man[1-8]x and adding those to
/etc/man.conf this works quite well. Actually, thats what I do manually whenever
I updated anything with *.[[:digit:]]x.gz named man pages.

Would be nice to have it automagically, though. So where is the issue with
putting all X man pages to those directories?

[Comment 6 Donnie Berkholz (RETIRED) 2005-06-21 21:06:47 UTC]

Because that's not how it's supposed to work. See
http://www.pathname.com/fhs/pub/fhs-2.3.html#USRSHAREMANMANUALPAGES :

"The numbered sections "1" through "8" are traditionally defined. In general,
the file name for manual pages located within a particular section end with
.<section>.

In addition, some large sets of application-specific manual pages have an
additional suffix appended to the manual page filename. For example, the MH mail
handling system manual pages must have mh appended to all MH manuals. All X
Window System manual pages must have an x appended to the filename."

Note that it's just the filename that changes and not the directory it's in.

[Comment 7 L.Stohlmann 2005-09-28 13:26:28 UTC]

Oh well.

I dont give anything about that stupid FHS in this case. xmouse is sth very
different from man4x/mouse.4x*

It worked well with manXx, and it was reasonable usable. It isnt now.

I am really fed up with messages like "bla FHS bla" - especially in this case.

Anybody ever thought about the FHS *not* being the ultimate thing? Esp. when I
read this under your URL:
"Manual pages for commands and data under /usr/local are stored in
/usr/local/man. Manual pages for X11R6 are stored in /usr/X11R6/man. It follows
that all manual page hierarchies in the system must have the same structure as
/usr/share/man."

Whatever you are doing there, you dont make things better.

Just my 2cent, fed up, good night.
L.

[Comment 8 Stéphane Gimenez 2005-12-05 10:01:51 UTC]

I've actualy runned into a collision-protect block. Maybe it's time to do
something and close this bug.

* checking 2 files for package collisions
existing file /usr/share/man/man4/mouse.4.gz is not owned by this package
-snip-
package x11-drivers/xf86-input-mouse-1.0.2 NOT merged

[Comment 9 Stéphane Gimenez 2005-12-05 10:05:58 UTC]

(In reply to comment #8)
> I've actualy runned 

[Comment 10 Stéphane Gimenez 2005-12-05 10:05:58 UTC]

(In reply to comment #8)
> I've actualy runned 
err, i'm quite tired, please forgive my english :/

[Comment 11 Petteri Räty (RETIRED) 2005-12-06 10:36:28 UTC]

*** Bug 114641 has been marked as a duplicate of this bug. ***

[Comment 12 Petteri Räty (RETIRED) 2005-12-06 10:37:38 UTC]

Also the modular X ebuilds collide with man-pages. See bug 114641 for more details.

[Comment 13 Joshua Baergen (RETIRED) 2005-12-07 13:26:16 UTC]

This should be changed upstream, shouldn't it?  Both man-pages and X are pretty
standard packages...

[Comment 14 Petteri Räty (RETIRED) 2005-12-07 13:31:25 UTC]

(In reply to comment #12)
> This should be changed upstream, shouldn't it?  Both man-pages and X are pretty
> standard packages...

Actually the way x11-drivers/xf86-input-mouse-1.0.1 works would solve this problem:
betelgeuse@pena /usr/portage/media-sound/amarok $ qfile
/usr/share/man/man4x/mouse.4x.gz
x11-drivers/xf86-input-mouse (/usr/share/man/man4x/mouse.4x.gz)

For some reason the newer version does not install under the 4x category any more.

[Comment 15 Donnie Berkholz (RETIRED) 2005-12-07 14:02:57 UTC]

(In reply to comment #13)
> (In reply to comment #12)
> > This should be changed upstream, shouldn't it?  Both man-pages and X are pretty
> > standard packages...
> 
> Actually the way x11-drivers/xf86-input-mouse-1.0.1 works would solve this
problem:
> betelgeuse@pena /usr/portage/media-sound/amarok $ qfile
> /usr/share/man/man4x/mouse.4x.gz
> x11-drivers/xf86-input-mouse (/usr/share/man/man4x/mouse.4x.gz)
> 
> For some reason the newer version does not install under the 4x category any more.

That was decided to be a bug and changed, as [0-9]x are nonstandard search
directories for man.

[Comment 16 Joshua Baergen (RETIRED) 2005-12-09 15:34:58 UTC]

This is fixed in modular (7.0).

[Comment 17 Donnie Berkholz (RETIRED) 2006-02-02 01:30:05 UTC]

*** Bug 121271 has been marked as a duplicate of this bug. ***