Details Ticket 4992


Comment | Reply | Take | Open


Serial Number 4992
Subject man conflict
Area grass6
Queue grass
Requestors oracle@provocation.net
Owner none
Status resolved
Last User Contact Thu Aug 24 21:12:41 2006 (2 yr ago)
Current Priority 30
Final Priority 70
Due No date assigned
Last Action Thu Aug 24 21:12:46 2006 (2 yr ago)
Created Sat Aug 12 06:29:31 2006 (2 yr ago)

Transaction History Ticket 4992


Sat, Aug 12 2006 06:29:31    Request created by guest  
Subject: man conflict

grass obtained from: Trento Italy site
grass binary for platform: Compiled from source (through RPM with LSB locations)
GRASS Version: 6.1.0

db/drivers/mysql/mysql.html is converted to man1/mysql.1.gz which conflicts with
the man page of the database application and causes this:

rpm -Uhv /usr/src/redhat/RPMS/i386/grass-6.1.0-1.centos4.i386.rpm
Preparing...                ########################################### [100%]
file /usr/share/man/man1/mysql.1.gz from install of grass-6.1.0-1.centos4 conflicts
with file from package mysql-4.1.20-1.RHEL4.1

'mysql' is anyway a misnomer for a manual about the use of db.connect and nobody
will ever type 'man mysql' for it. The same goes for dbf, pg, odbc etc, so db/drivers/*/*
should be excluded from conversion to man in man/Makefile . 
Sat, Aug 12 2006 12:53:45    Mail sent by tutey@o2.pl  
Return-Path <tutey@o2.pl>
Delivered-To grass-bugs@lists.intevation.de
Message-ID <44DDB332.20505@o2.pl>
Date Sat, 12 Aug 2006 12:53:38 +0200
From Maciej Sieczka <tutey@o2.pl>
User-Agent Thunderbird 1.5.0.5 (X11/20060728)
MIME-Version 1.0
To Request Tracker <grass-bugs@intevation.de>
Cc grass-dev@grass.itc.it, Hamish <hamish_nospam@yahoo.com>, Markus Neteler <neteler@itc.it>
Subject Re: [GRASS-dev] [bug #4992] (grass) man conflict
References <20060812042932.03E25100160@lists.intevation.de>
In-Reply-To <20060812042932.03E25100160@lists.intevation.de>
Content-Type text/plain; charset=ISO-8859-1
Content-Transfer-Encoding 7bit
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-4.871 tagged_above=-999 required=3 tests=[AWL=0.129, BAYES_00=-5]
X-Spam-Level
Looks like a candidate for 6.1.1, ?

Maciek


Sat, Aug 12 2006 16:42:05    Mail sent by mneteler  
Hi,

> 'mysql' is anyway a misnomer for a manual about the use of db.connect and 
in the GRASS case this refers to the name of the driver for mysql (likewise
for the other drivers).

> nobody will ever type 'man mysql' for it. 

That's true. But it would be in any case:

g.manual mysql

> The same goes for dbf, pg, odbc etc,
> so db/drivers/*/* should be excluded from conversion to man in
> man/Makefile . 

I don't think so since the user is definitely interested how to
use the DB *drivers*, have a look at:
http://grass.itc.it/grass61/manuals/html61_user/sql.html

The RPM conflicts looks like a spec file problem to me
(usually the GRASS man pages remain in the GRASS subdir)

Markus
Sat, Aug 12 2006 18:01:50    Mail sent by guest  
> g.manual mysql

The information in mysql.html could be part of db.connect.html and thus
accessible by man/g.manual db.connect. 

> The RPM conflicts looks like a spec file problem to me
> (usually the GRASS man pages remain in the GRASS subdir)

It's a problem of distro compliance. To be RH-compliant, an rpm must put its
manuals in /usr/share/man/ . That is also the only place that's in the
distro's MANPATH, so man pages elsewhere are not found by the system unless
MANPATH is tweaked system-wide. If you do tweak MANPATH, you get back the
conflict and break makewhatis on top of it. In other words, this goes well
beyond a simple specfile problem, it has to do with the very fact that grass
uses its own "everything in one place" directory structure and RH doesn't like
that. 

I assume that grass' directory structure won't change any day soon, so that's
why I'm suggesting excluding mysql.html from html2man or, better, moving the
contents of <db_driver>.html to db.connect.html. 

As for the specfile, I worked around the problem by deleting the driver
manuals in the %install section. It's not nice, but it works.
Sat, Aug 12 2006 18:13:49    Mail sent by guest  
Come to think about it, there is a conflict of (both yours and my) intentions
at the bottom of this. The question is: should grass' manuals be accessible by
man or not? If they should, then they should be system-wide and there is no
need for g.manual to exist at all. If, on the other hand, g.manual has a valid
raison d'étre, grass' manuals should be kept out of the reach of system man
and *only* be accessible through g.manual. 

If you think the latter is a better solution, I'll change the rpm.
  
Sun, Aug 13 2006 01:33:24    Mail sent by glynn@gclements.plus.com  
Return-Path <glynn@gclements.plus.com>
Delivered-To grass-bugs@lists.intevation.de
From Glynn Clements <glynn@gclements.plus.com>
MIME-Version 1.0
Content-Type text/plain; charset=us-ascii
Content-Transfer-Encoding 7bit
Message-ID <17630.25916.200737.157465@cerise.gclements.plus.com>
Date Sun, 13 Aug 2006 00:33:16 +0100
To Markus Neteler via RT <grass-bugs@intevation.de>
Cc oracle@provocation.net, grass-dev@grass.itc.it
Subject Re: [GRASS-dev] [bug #4992] (grass) man conflict
In-Reply-To <20060812144205.D6DCC1005AF@lists.intevation.de>
References <20060812144205.D6DCC1005AF@lists.intevation.de>
X-Mailer VM 7.07 under 21.4 (patch 15) "Security Through Obscurity" XEmacs Lucid
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-3.871 tagged_above=-999 required=3 tests=[AWL=1.129, BAYES_00=-5]
X-Spam-Level
Markus Neteler via RT wrote:

> > 'mysql' is anyway a misnomer for a manual about the use of db.connect and
> 
> in the GRASS case this refers to the name of the driver for mysql (likewise
> for the other drivers).
> 
> > nobody will ever type 'man mysql' for it. 
> 
> That's true. But it would be in any case:
> 
> g.manual mysql
> 
> > The same goes for dbf, pg, odbc etc,
> > so db/drivers/*/* should be excluded from conversion to man in
> > man/Makefile . 
> 
> I don't think so since the user is definitely interested how to
> use the DB *drivers*, have a look at:
> http://grass.itc.it/grass61/manuals/html61_user/sql.html
> 
> The RPM conflicts looks like a spec file problem to me
> (usually the GRASS man pages remain in the GRASS subdir)

It ought to be possible to view GRASS manpages from outside a GRASS
session. I normally view them using XEmacs' "M-x manual-entry" (by
adding $GISBASE/man to $MANPATH).

The names of GRASS manual pages shouldn't have any unnecessary
conflicts with those from other packages. Even if they are installed
in $GISBASE, they should avoid "shadowing" any other manpages which
might be in the manual search path.

IMHO, the pages for the DB drivers should be renamed to e.g. 
dbmi-mysql etc, so as not to conflict with the pages for the actual
database packages.

-- 
Glynn Clements <glynn@gclements.plus.com>


Mon, Aug 14 2006 13:11:11    Mail sent by tutey@o2.pl  
Return-Path <tutey@o2.pl>
Delivered-To grass-bugs@lists.intevation.de
Message-ID <44E05A4B.90902@o2.pl>
Date Mon, 14 Aug 2006 13:11:07 +0200
From Maciej Sieczka <tutey@o2.pl>
User-Agent Thunderbird 1.5.0.5 (X11/20060728)
MIME-Version 1.0
To Glynn Clements <glynn@gclements.plus.com>
Cc Markus Neteler via RT <grass-bugs@intevation.de>, oracle@provocation.net, grass-dev@grass.itc.it
Subject Re: [GRASS-dev] [bug #4992] (grass) man conflict
References <20060812144205.D6DCC1005AF@lists.intevation.de> <17630.25916.200737.157465@cerise.gclements.plus.com>
In-Reply-To <17630.25916.200737.157465@cerise.gclements.plus.com>
Content-Type text/plain; charset=us-ascii
Content-Transfer-Encoding 8bit
X-Virus-Scanned by amavisd-new at intevation.de
X-Spam-Status No, hits=-4.884 tagged_above=-999 required=3 tests=[AWL=0.116, BAYES_00=-5]
X-Spam-Level
Glynn Clements napisa?(a):

> The names of GRASS manual pages shouldn't have any unnecessary
> conflicts with those from other packages. Even if they are installed
> in $GISBASE, they should avoid "shadowing" any other manpages which
> might be in the manual search path.

> IMHO, the pages for the DB drivers should be renamed to e.g. 
> dbmi-mysql etc, so as not to conflict with the pages for the actual
> database packages.

Good point. Though I'd suggest grass-mysql or something. 'dbmi' prefix
might be not uniqe enough someday-somewhere.

Maciek


Thu, Aug 24 2006 21:12:41    Mail sent by mneteler  
Hi,

https://intevation.de/rt/webrt?serial_num=4992
fixed, also for 6.2.

I have renamed all dbmi driver html files to
grass-<driver>.html and updated related docs.

Markus
Thu, Aug 24 2006 21:12:46    Status changed to resolved by mneteler  
Comment | Reply | Take | Open

You are currently authenticated as guest.
[Show Configuration] [Login as another user]

Users Guide - Mail Commands - Homepage of RequestTracker 1.0.7 - list any request