[GRASS-SVN] r40256 - grass/branches/develbranch_6/ps/ps.map

[svn_grass at osgeo.org]

Author: hamish
Date: 2010-01-05 10:39:49 -0500 (Tue, 05 Jan 2010)
New Revision: 40256

Modified:
   grass/branches/develbranch_6/ps/ps.map/description.html
Log:
document header file instruction

Modified: grass/branches/develbranch_6/ps/ps.map/description.html
===================================================================
--- grass/branches/develbranch_6/ps/ps.map/description.html	2010-01-05 14:24:49 UTC (rev 40255)
+++ grass/branches/develbranch_6/ps/ps.map/description.html	2010-01-05 15:39:49 UTC (rev 40256)
@@ -569,7 +569,39 @@
 and the location's description.<!-- PERMANENT/MYNAME -->
 The text will be centered on the page above the map.
 The default text color is black.
+<P>
+If the <EM>file</EM> sub-instruction is given the header will consist
+of the text in the text file specified, with some special formatting keys:
 
+<ul>
+<li><tt>%%</tt>  - a literal %
+<li><tt>%n</tt>  - ? newline ?
+<li><tt>%_</tt>  - horizontal bar
+<li><tt>%c</tt>  - "&lt;raster name&gt; in mapset &lt;mapset name&gt;"
+<li><tt>%d</tt>  - today's date
+<li><tt>%l</tt>  - location name
+<li><tt>%L</tt>  - Location's text description
+<li><tt>%m</tt>  - mapset name
+<li><tt>%u</tt>  - user name
+<li><tt>%x</tt>  - mask info
+<li><tt>%-</tt>  - advance to this character column number (see example below)
+
+</ul>
+
+Example header file:
+<div class="code"><pre>
+%_
+LOCATION: %-27l  DATE: %d
+MAPSET:   %-27m  USER: %u
+
+RASTER MAP: %c
+MASK:     %x
+%_
+Produced by: US Army CERL, Champaign Illinois
+Software:    GRASS
+%_
+</pre></div>
+
 <P>
 
 This example prints (in red) whatever is in the file <EM>soils.hdr</EM> above