[GRASS5] [bug #3318] (grass) ps.map man page comments

[Request Tracker]

this bug's URL: http://intevation.de/rt/webrt?serial_num=3318
-------------------------------------------------------------------------

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.


--- Headers Follow ---

>From jidanni at jidanni.org  Sun Jun  5 22:50:39 2005
Return-Path: <jidanni at jidanni.org>
Delivered-To: grass-bugs at lists.intevation.de
Received: from mail.intevation.de (aktaia [212.95.126.10])
	by lists.intevation.de (Postfix) with ESMTP id 008011006CC
	for <grass-bugs at lists.intevation.de>; Sun,  5 Jun 2005 22:50:39 +0200 (CEST)
Received: from localhost (localhost [127.0.0.1])
	by mail.intevation.de (Postfix) with ESMTP id B45B036EA4
	for <grass-bugs at lists.intevation.de>; Sun,  5 Jun 2005 22:50:38 +0200 (CEST)
Received: from frodo.hserus.net (frodo.hserus.net [204.74.68.40])
	by mail.intevation.de (Postfix) with ESMTP id 9EDD636CE4
	for <grass-bugs at intevation.de>; Sun,  5 Jun 2005 22:50:35 +0200 (CEST)
Received: from [218.187.77.182] (port=32969 helo=jidanni1)
	by frodo.hserus.net with esmtpsa 
	(Cipher TLSv1:AES256-SHA:256) (Exim 4.51 #0)
	id 1Df24k-000OoB-O3 by authid <jidanni> with plain
	for <grass-bugs at intevation.de>; Mon, 06 Jun 2005 02:20:34 +0530
To: grass-bugs at intevation.de
Subject: ps.map man page comments
From: Dan Jacobson <jidanni at jidanni.org>
Date: Mon, 06 Jun 2005 04:00:41 +0800
Message-ID: <87r7fgefpy.fsf at 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: 

-------------------------------------------- Managed by Request Tracker