Home | Docs | Forums | Lists | Bugs | Planet | Store | GMN | Get Gentoo!

Full Text Bug Listing

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

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?

Sounds good. Got a patch handy?

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?

$ 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.

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?

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.

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.

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

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

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

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

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

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

(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.

(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.

This is fixed in modular (7.0).

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