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