Details Ticket 2815


Comment | Reply | Take | Resolve


Serial Number 2815
Subject 'd.vect help' returns 'value' for each numerical parameter while man differentiates 'integer' and 'float'
Area grass6
Queue grass
Requestors jidanni@jidanni.org
Owner none
Status open
Last User Contact Thu Aug 24 11:57:25 2006 (2 yr ago)
Current Priority 30
Final Priority 70
Due No date assigned
Last Action Thu Aug 24 11:59:02 2006 (2 yr ago)
Created Thu Dec 9 00:14:32 2004 (4 yr ago)

Transaction History Ticket 2815


Thu, Dec 9 2004 00:14:32    Request created by jidanni@jidanni.org  
Return-Path <jidanni@jidanni.org>
Delivered-To grass-bugs@lists.intevation.de
To grass-bugs@intevation.de
Subject d.vect help: where=string looks better
From Dan Jacobson <jidanni@jidanni.org>
Date Thu, 09 Dec 2004 06:53:58 +0800
Message-ID <87acsoxuyh.fsf@jidanni.org>
MIME-Version 1.0
Content-Type text/plain; charset=us-ascii
X-Spam-Status No, hits=-4.9 tagged_above=-999.0 required=3.0 tests=BAYES_00
X-Spam-Level
$ d.vect help
Usage:
   [field=value] [cats=name] [where=name] [color=name] [fcolor=name]
where=name?
where=string looks better.


Thu, Dec 9 2004 15:11:43    Mail sent by neteler@itc.it  
Return-Path <neteler@itc.it>
Delivered-To grass-bugs@lists.intevation.de
Date Thu, 9 Dec 2004 15:11:42 +0100
From Markus Neteler <neteler@itc.it>
To Request Tracker <grass-bugs@intevation.de>
Cc grass5@grass.itc.it
Subject Re: [GRASS5] [bug #2815] (grass) d.vect help: where=string looks better
Message-ID <20041209141142.GI4854@thuille.itc.it>
Mail-Followup-To Request Tracker <grass-bugs@intevation.de>, grass5@grass.itc.it
References <20041208231432.631AF102C54@lists.intevation.de>
Mime-Version 1.0
Content-Type text/plain; charset=us-ascii
Content-Disposition inline
In-Reply-To <20041208231432.631AF102C54@lists.intevation.de>
User-Agent Mutt/1.4.1i
X-Spam-Status No, hits=-4.9 tagged_above=-999.0 required=3.0 tests=BAYES_00
X-Spam-Level
On Thu, Dec 09, 2004 at 12:14:32AM +0100, Request Tracker wrote:
> this bug's URL: http://intevation.de/rt/webrt?serial_num=2815
> -------------------------------------------------------------------------
> 
> $ d.vect help
> Usage:
>    [field=value] [cats=name] [where=name] [color=name] [fcolor=name]
> where=name?
> where=string looks better.

This would require a change in
 lib/gis/parser.c

(G_OPT_WHERE)

Not sure that it is trivial, probably all 'name' above would get
changed to 'string' then.

Desired?

Markus


Fri, Dec 10 2004 08:38:35    Mail sent by hamish_nospam@yahoo.com  
Return-Path <hamish_nospam@yahoo.com>
Delivered-To grass-bugs@lists.intevation.de
Date Fri, 10 Dec 2004 20:38:23 +1300
From Hamish <hamish_nospam@yahoo.com>
To Markus Neteler <neteler@itc.it>
Cc grass-bugs@intevation.de, grass5@grass.itc.it
Subject Re: [GRASS5] [bug #2815] (grass) d.vect help: where=string looks better
Message-Id <20041210203823.7056265f.hamish_nospam@yahoo.com>
In-Reply-To <20041209141142.GI4854@thuille.itc.it>
References <20041208231432.631AF102C54@lists.intevation.de> <20041209141142.GI4854@thuille.itc.it>
X-Mailer Sylpheed version 1.0.0beta3 (GTK+ 1.2.10; i386-pc-linux-gnu)
X-Face M<EoB)"*Z~u!,vFhXmw}R_KbdBta*P_=T|rbBL'e1/CQ9;/1g\BU3&!=y8ria$2Uk!HT&BB 8i?|X_+7~1jsy}F~g$2va%3fV`*=L(*cem[@3\yg,G,@rg6/QMJ
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Spam-Status No, hits=-4.0 tagged_above=-999.0 required=3.0 tests=BAYES_00, FORGED_YAHOO_RCVD
X-Spam-Level
> On Thu, Dec 09, 2004 at 12:14:32AM +0100, Request Tracker wrote:
> > this bug's URL: http://intevation.de/rt/webrt?serial_num=2815
> > -------------------------------------------------------------------------
> > 
> > $ d.vect help
> > Usage:
> >    [field=value] [cats=name] [where=name] [color=name] [fcolor=name]
> > where=name?
> > where=string looks better.
> 
> This would require a change in
>  lib/gis/parser.c
> 
> (G_OPT_WHERE)
> 
> Not sure that it is trivial, probably all 'name' above would get
> changed to 'string' then.
> 
> Desired?


does "string" mean anything to non-programmers besides a piece of rope?


Hamish


Fri, Dec 10 2004 08:45:08    Mail sent by neteler@itc.it  
Return-Path <neteler@itc.it>
Delivered-To grass-bugs@lists.intevation.de
Date Fri, 10 Dec 2004 08:45:05 +0100
From Markus Neteler <neteler@itc.it>
To Hamish <hamish_nospam@yahoo.com>
Cc grass-bugs@intevation.de, grass5@grass.itc.it
Subject Re: [GRASS5] [bug #2815] (grass) d.vect help: where=string looks better
Message-ID <20041210074505.GA17066@thuille.itc.it>
Mail-Followup-To Hamish <hamish_nospam@yahoo.com>, grass-bugs@intevation.de, grass5@grass.itc.it
References <20041208231432.631AF102C54@lists.intevation.de> <20041209141142.GI4854@thuille.itc.it> <20041210203823.7056265f.hamish_nospam@yahoo.com>
Mime-Version 1.0
Content-Type text/plain; charset=us-ascii
Content-Disposition inline
In-Reply-To <20041210203823.7056265f.hamish_nospam@yahoo.com>
User-Agent Mutt/1.4.1i
X-Spam-Status No, hits=-4.9 tagged_above=-999.0 required=3.0 tests=BAYES_00
X-Spam-Level
On Fri, Dec 10, 2004 at 08:38:23PM +1300, Hamish wrote:
> > On Thu, Dec 09, 2004 at 12:14:32AM +0100, Request Tracker wrote:
> > > this bug's URL: http://intevation.de/rt/webrt?serial_num=2815
> > > -------------------------------------------------------------------------
> > > 
> > > $ d.vect help
> > > Usage:
> > >    [field=value] [cats=name] [where=name] [color=name] [fcolor=name]
> > > where=name?
> > > where=string looks better.
> > 
> > This would require a change in
> >  lib/gis/parser.c
> > 
> > (G_OPT_WHERE)
> > 
> > Not sure that it is trivial, probably all 'name' above would get
> > changed to 'string' then.
> > 
> > Desired?
> 
> 
> does "string" mean anything to non-programmers besides a piece of rope?

Yes :-)

http://www.m-w.com/cgi-bin/dictionary?book=Dictionary&va=string

Markus


Sun, Dec 12 2004 23:26:28    Mail sent by hamish_nospam@yahoo.com  
Return-Path <hamish_nospam@yahoo.com>
Delivered-To grass-bugs@lists.intevation.de
Date Mon, 13 Dec 2004 11:26:10 +1300
From Hamish <hamish_nospam@yahoo.com>
To Markus Neteler <neteler@itc.it>
Cc grass-bugs@intevation.de, grass5@grass.itc.it
Subject Re: [GRASS5] [bug #2815] (grass) d.vect help: where=string looks better
Message-Id <20041213112610.3dc8ca88.hamish_nospam@yahoo.com>
In-Reply-To <20041210074505.GA17066@thuille.itc.it>
References <20041208231432.631AF102C54@lists.intevation.de> <20041209141142.GI4854@thuille.itc.it> <20041210203823.7056265f.hamish_nospam@yahoo.com> <20041210074505.GA17066@thuille.itc.it>
X-Mailer Sylpheed version 1.0.0beta3 (GTK+ 1.2.10; i386-pc-linux-gnu)
X-Face M<EoB)"*Z~u!,vFhXmw}R_KbdBta*P_=T|rbBL'e1/CQ9;/1g\BU3&!=y8ria$2Uk!HT&BB 8i?|X_+7~1jsy}F~g$2va%3fV`*=L(*cem[@3\yg,G,@rg6/QMJ
Mime-Version 1.0
Content-Type text/plain; charset=ISO-8859-1
Content-Transfer-Encoding quoted-printable
X-Spam-Status No, hits=-4.0 tagged_above=-999.0 required=3.0 tests=BAYES_00, FORGED_YAHOO_RCVD
X-Spam-Level
> > > > this bug's URL: http://intevation.de/rt/webrt?serial_num=3D2815
> > > > ---------------------------------------------------------------
> > > >=20
> > > > $ d.vect help
> > > > Usage:
> > > >    [field=3Dvalue] [cats=3Dname] [where=3Dname] [color=3Dname]
> > > >    [fcolor=3Dname]
> > > > where=3Dname?
> > > > where=3Dstring looks better.
...
> > > Not sure that it is trivial, probably all 'name' above would get
> > > changed to 'string' then.
> > >=20
> > > Desired?
> >=20
> > does "string" mean anything to non-programmers besides a piece of
> > rope?
>=20
> Yes :-)
>=20
> http://www.m-w.com/cgi-bin/dictionary?book=3DDictionary&va=3Dstring
>=20
> Markus


Pertinent sections reproduced here:

Main Entry: [1]string
Pronunciation: 'stri[ng]
Function: noun
Etymology: Middle English, from Old English streng; akin to Old High
German strang rope, Latin stringere to bind tight -- more at STRAIN
[...]
11 : a scanty bikini -- called also string bikini
12 : a hypothetical one-dimensional object that is infinitely thin but
has a length of 10=AF33 centimeters, that vibrates as it moves through
space, and whose mode of vibration manifests itself as a subatomic
particle


:)


Mon, Dec 12 2005 12:07:07    Mail sent by msieczka  
"d.vect --help" still prints "where=name", but the html manual reads
"[where=string]" and "where=string".

Inconsistent.

Maciek
Mon, Dec 12 2005 12:07:13    Area changed to grass6 by msieczka  
Mon, Dec 12 2005 12:12:52    Mail sent by msieczka  
"d.vect --help" still prints "where=name", but the html manual reads
"[where=string]" and "where=string".

Inconsistent.

Besides, I agree with Hamish that "string" might be not the most fortunate
word here, though I like the pleasing idea of bikini connection.

Could the "string" here be replaced with sth like "sql_statement", or "sql_query"?
Maciek
Mon, Dec 12 2005 12:13:05    Subject changed to d.vect help: where=string looks better (?) by msieczka  
Mon, Dec 12 2005 22:47:20    Mail sent by hamish_nospam@yahoo.com  
Return-Path <hamish_nospam@yahoo.com>
Delivered-To grass-bugs@lists.intevation.de
Date Tue, 13 Dec 2005 10:47:02 +1300
From Hamish <hamish_nospam@yahoo.com>
To Maciek Sieczka via RT <grass-bugs@intevation.de>
Cc jidanni@jidanni.org, grass5@grass.itc.it
Subject Re: [GRASS5] [bug #2815] (grass) d.vect help: where=string looks better
Message-Id <20051213104702.2835b2ee.hamish_nospam@yahoo.com>
In-Reply-To <20051212111252.9A612101F05@lists.intevation.de>
References <20051212111252.9A612101F05@lists.intevation.de>
X-Mailer Sylpheed version 1.0.4 (GTK+ 1.2.10; i386-pc-linux-gnu)
X-Face M<EoB)"*Z~u!,vFhXmw}R_KbdBta*P_=T|rbBL'e1/CQ9;/1g\BU3&!=y8ria$2Uk!HT&BB 8i?|X_+7~1jsy}F~g$2va%3fV`*=L(*cem[@3\yg,G,@rg6/QMJ
Mime-Version 1.0
Content-Type text/plain; charset=US-ASCII
Content-Transfer-Encoding 7bit
X-Spam-Status No, hits=-4.0 tagged_above=-999.0 required=3.0 tests=BAYES_00, FORGED_YAHOO_RCVD
X-Spam-Level
> "d.vect --help" still prints "where=name", but the html manual reads
> "[where=string]" and "where=string".
>
> Inconsistent. 

I fixed that a few days ago in CVS.

  http://grass.itc.it/pipermail/grass-commit/2005-December/019395.html

still different for integer,float vs. "value". shrug.


> Besides, I agree with Hamish that "string" might be not the most
> fortunate word here,

I don't think it is unfortunate, just obscure to non-programmers.
Anything better that doesn't confuse either beginners or power users?


> Could the "string" here be replaced with sth like "sql_statement", or
> "sql_query"?

Yes. "string" (or "value" for others) is just the default if the
option's ->type is defined as TYPE_STRING.

If you add a line to the option definition like:

  option->key_desc = "sql_query";

you will get where=sql_query in the help usage, HTML, XML, and GUI 
incarnations.

e.g. `d.barscale --help` gives "at=x,y" not "at=value".

In this case "where=" is a common option with specifics defined in 
lib/gis/parser.c  G_define_standard_option().


It would probably be good to do the same for the G_OPT_V_CATS standard
option too [d.vect cats= (v.extract list=range ??unfortunate)].

(both standard where= and cats= options modified in cvs just now.)



Hamish


Wed, Aug 23 2006 20:35:18    Mail sent by guest  
So, can d.text be modified to have something better than 'name'? Or should
this 'bug' just be relagated to a wish?

~ Eric.
Thu, Aug 24 2006 11:57:25    Mail sent by msieczka  
guest wrote (Wed, Aug 23 2006 20:35:18):

> So, can d.text

It's about d.vect; I'll take it for a typo.

> be modified to have something better than 'name'? Or should
> this 'bug' just be relagated to a wish?

'd.vect help' says now (6.3 CVS, today)
[where=sql_query]

which is OK.

But there is still a difference between how numeric parameters are described
in the manual and in the 'd.vect help' output, eg:

'd.vect help':

[size=value]
[wscale=value]

while in the manual we have:

size=integer
wscale=float

and so on. I'm changing the subject accordingly.

Maciek
Thu, Aug 24 2006 11:59:02    Subject changed to 'd.vect help' returns 'value' for each numerical parameter while man differentiates 'integer' and 'f by msieczka  
Comment | Reply | Take | Resolve

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