Details Ticket 3318


Comment | Reply | Take | Open


Serial Number 3318
Subject ps.map man page comments
Area grass6
Queue grass
Requestors jidanni@jidanni.org
Owner none
Status resolved
Last User Contact Never contacted
Current Priority 30
Final Priority 70
Due No date assigned
Last Action Fri Feb 9 07:30:39 2007 (2 yr ago)
Created Sun Jun 5 22:50:39 2005 (3 yr ago)

Transaction History Ticket 3318


Sun, Jun 5 2005 22:50:39    Request created by jidanni@jidanni.org  
Return-Path <jidanni@jidanni.org>
Delivered-To grass-bugs@lists.intevation.de
To grass-bugs@intevation.de
Subject ps.map man page comments
From Dan Jacobson <jidanni@jidanni.org>
Date Mon, 06 Jun 2005 04:00:41 +0800
Message-ID <87r7fgefpy.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
GRASS 6.0.0 ps.map man page comments:

Nonexistent p.labels man page is mentioned. Maybe now it is v.label.


Often "|list" is mentioned, but the format of this list is not given
in an example. Also:
       USAGE:    raster mapname|list

       For  each  ps.map  run,  only one raster map layer (or set of layers or
imagery group; see below) can be requested.
If only one, then why "|list"?, the user asks.

Also here mention when to use raster, and when to use greyrast.


     One "pixel" is 1 inch / 72.
say:
     One "pixel" = 1/72 inch.

              The size of the PostScript font in 1/72 inch.  The default is 10.
say:
              The size of the PostScript font * 1/72 inch.  The
              default is 10, i.e., 10/72 inches.

Should be described differently:
vareas
       Selects a vector map layer for output.
vlines
       Selects a vector map layer for output.

  EXAMPLE ps.map INPUT FILE
       The following is an example of a ps.map script file. The file has  been
named  spear.soils.   For  the purposes of illustration, the file is in
       two columns.

It thankfully is not in two columns it seems.

Kindly document and put in the example that # can be apparently used
as a comment character in the ps.map language!  Also say if blank
lines in the input are OK.

Say what the default for masked=y or n.

Say what the default for color is if not given by the user.
Say what the default for all other things everywhere if not given.

Some things need "end" and some don't. E.g., setcolor vs. text.
Baffles user.



       If  the  header  instruction or the file sub-instruction is absent, the
header will consist of the map TITLE and location, each centered on the
       page above the map.  The default text color is black.

What if one doesn't want a header. Say how to use /dev/null or whatever.


Mention if ; can be used to put several commands into a one-liner.
Or say to do e.g.,
echo "vlines c3;cats $(seq -s , 10 10 700);end"|tr \; \\n|ps.map ...


paper
       Specifies paper size and margins.
       USAGE:    paper paper name
            point <-----why this here?
            height #




       The scale can be selected either as:

        a relative ratio, e.g. 1:25000;

        an absolute width of the printed map, e.g. 10 inches;

        the number of printed paper panels, e.g. 3 panels
              (at the present time, only 1 panel is supported);

        the number of miles per inch, e.g. 1 inch equals 4 miles.

       This example would set the scale of the map to 1 unit = 25000 units.
       EXAMPLE:
            scale 1:25000

OK, but give examples for how one would say "1 inch equals 4 miles",
etc.



vlines
       Selects a vector map layer for output.
       USAGE:    vlines vectormap|list
            type lines and/or boundaries <---not clear! clearer is:
$ d.vect help
     type   Type
            options: point,line,boundary,centroid,area,face
            default: point,line,boundary,centroid,area,face



This sentence should start with "opaque":
       whether or not the text should be opaque to vectors.   Entering  no  to
the  opaque  option  will  allow  the  user to see any vectors which go
       through the text's background box.  Otherwise, they  will  end  at  the
box's edge.
I see, so say the default is y if no opaque option is given.



            label label in legend
maybe say
            label [label in legend]
if optional, etc.


       COLORS below); the eps Encapsulate Postscript file
Encapsulated, no?



vareas
       Selects a vector map layer for output...
       EXAMPLE:
            vector forest
vector??


vareas
       Selects a vector map layer for output.
       USAGE:    vareas vectormap
            layer # (layer number used with cats/where option)
            cats list of categories (e.g. 1,3,5-7)
            where SQL where statementlike: vlastnik = 'Cimrman'...
       The user can specify:
But then 'where' is not mentioned though the other items are.
Perhaps put the like: vlastnik = 'Cimrman'... into a paragraph below.


Wed, Jul 6 2005 13:04:59    Comments added by hbowman  
fixed some of these.

p.labels
1/72"
Eps[d]
vareas eg


Hamish
Sat, Aug 13 2005 13:38:01    Area changed to grass6 by msieczka  
Fri, Feb 9 2007 07:30:39    Status changed to resolved by hbowman  
Fri, Feb 9 2007 07:30:39    Comments added by hbowman  
I've fixed most of these in 6.3 cvs, closing the bug.


Things I didn't fix:
> Say what the default for color is if not given by the user.

Too broad to list everything, it is pretty obvious after 1 iteration
what color things will be. (usually black)


> Say what the default for all other things everywhere if not given.

Too broad to list everything.


> Say what the default for masked=y or n.

I'm not sure enough to comment. Generally if you list the word it means "yes".
(see the yesno() fn)

> Mention if ; can be used to put several commands into a one-liner.
> Or say to do e.g.,
> echo "vlines c3;cats $(seq -s , 10 10 700);end"|tr \; \\n|ps.map ...

We cant't include a primer on UNIX scripting. The "further examples"
link to the wiki page has something similar:

ps.map out=foo << EOF
-instructions-
EOF

You are welcome to add an example there using the echo technique if you like.
Hamish
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