[GRASS-SVN] r58176 - in grass/trunk/general: g.mlist g.mremove

svn_grass at osgeo.org svn_grass at osgeo.org
Sat Nov 9 07:24:28 PST 2013


Author: neteler
Date: 2013-11-09 07:24:27 -0800 (Sat, 09 Nov 2013)
New Revision: 58176

Modified:
   grass/trunk/general/g.mlist/g.mlist.html
   grass/trunk/general/g.mremove/g.mremove.html
Log:
g.mlist, g.mremove: examples improved

Modified: grass/trunk/general/g.mlist/g.mlist.html
===================================================================
--- grass/trunk/general/g.mlist/g.mlist.html	2013-11-09 15:13:34 UTC (rev 58175)
+++ grass/trunk/general/g.mlist/g.mlist.html	2013-11-09 15:24:27 UTC (rev 58176)
@@ -1,33 +1,41 @@
 <h2>DESCRIPTION</h2>
 
 <em>g.mlist</em> searches for data files matching a pattern given by
-wildcards or POSIX Extended Regular Expressions.
+wildcards or POSIX Extended Regular Expressions. It is is an extended
+version of <em><a href="g.list.html">g.list</a></em>.
 
-<p>See the <em>g.list</em> help page for discussion of module options.
+<p>
+See also the <em>g.list</em> help page for discussion of some module
+options.
 
+<h2>NOTES</h2>
 
+The output of <em>g.mlist</em> may be useful for other programs' parameter
+input (e.g. time series for <em><a href="r.series.html">r.series</a></em>)
+when used with <em>separator=comma</em>.
+
 <h2>EXAMPLES</h2>
 
 List all available GRASS data base files:
 <div class="code"><pre>
-  g.mlist type=all
+g.mlist type=all
 </pre></div>
 
 List all raster and vector maps:
 <div class="code"><pre>
-  g.mlist type=rast,vect
+g.mlist type=rast,vect
 </pre></div>
 
 <h3>Wildcards:</h3>
 
 List all vector maps starting with letter "r":
 <div class="code"><pre>
-  g.mlist type=vect pattern="r*"
+g.mlist type=vect pattern="r*"
 </pre></div>
 
 List certain raster maps with one variable character/number:
 <div class="code"><pre>
-  g.mlist type=rast pattern="N45E00?.meters"
+g.mlist type=rast pattern="N45E00?.meters"
 </pre></div>
 
 Use of <em>exclude</em> parameter:
@@ -53,37 +61,43 @@
 
 <h3>Regular expressions:</h3>
 
-Print out all soils map with "soils" in their name:
+List all soil maps starting with "soils" in their name:
 <div class="code"><pre>
-  g.mlist -r type=rast pattern='^soils'
+g.mlist -r type=rast pattern='^soils'
 </pre></div>
 
-Print out "tmp" if "tmp" raster map exists:
+List "tmp" if "tmp" raster map exists:
 <div class="code"><pre>
-  g.mlist -r pattern='^tmp$'
+g.mlist -r pattern='^tmp$'
 </pre></div>
 
-Print out "tmp0" ..."tmp9" if corresponding vector map exists
- (each map name linewise):
+List "tmp0" ..."tmp9" if corresponding vector map exists (each map name linewise):
 <div class="code"><pre>
-  g.mlist -r type=vect pattern='^tmp[0-9]$'
+g.mlist -r type=vect pattern='^tmp[0-9]$'
 </pre></div>
 
-Print out "tmp0" ..."tmp9" if corresponding vector map exists
- (each map name comma separated):
+List "tmp0" ..."tmp9" if corresponding vector map exists (each map name comma separated):
 <div class="code"><pre>
-  g.mlist -r type=vect separator=, pattern='^tmp[0-9]$'
+g.mlist -r type=vect separator=comma pattern='^tmp[0-9]$'
 </pre></div>
 
-This may be useful for other programs' parameter input 
-(e.g. <em><a href="r.series.html">r.series</a></em>).
 
+<h3>Extended regular expressions:</h3>
 
+List all precipitation maps for the years 1997-2012, comma separated:
+<div class="code"><pre>
+g.mlist -e type=rast separator=comma pattern="precip_total.(199[7-9]|200[0-9]|201[0-2]).sum"
+</pre></div>
+
 <h2>SEE ALSO</h2>
 
-<em><a href="g.list.html">g.list</a></em>
-<p><a href="http://en.wikipedia.org/wiki/Regular_expression">Regular expressions</a>
-(aka regex) -  from Wikipedia, the free encyclopedia
+<em>
+<a href="g.list.html">g.list</a>,
+<a href="r.series.html">r.series</a>
+</em>
+<p>
+<a href="http://en.wikipedia.org/wiki/Regular_expression">Regular expressions</a>
+(aka regex) - from Wikipedia, the free encyclopedia
 
 
 <h2>AUTHOR</h2>
@@ -91,4 +105,5 @@
 Huidae Cho<br>
 grass4u at gmail.com
 
-<p><i>Last changed: $Date$</i>
+<p>
+<i>Last changed: $Date$</i>

Modified: grass/trunk/general/g.mremove/g.mremove.html
===================================================================
--- grass/trunk/general/g.mremove/g.mremove.html	2013-11-09 15:13:34 UTC (rev 58175)
+++ grass/trunk/general/g.mremove/g.mremove.html	2013-11-09 15:24:27 UTC (rev 58176)
@@ -8,18 +8,25 @@
 <h2>EXAMPLE</h2>
 
 Delete all raster maps starting with "<tt>tmp_</tt>" in the current mapset:
+
 <div class="code"><pre>
-  g.mremove -f "tmp_*"
+# show matching raster maps but do not delete yet (as verification)
+g.mremove rast="tmp_*"
+
+# actually delete the matching raster maps
+g.mremove -f rast="tmp_*"
 </pre></div>
 
 <h2>SEE ALSO</h2>
 
-<em><a href="g.remove.html">g.remove</a></em>
-<p><a href="http://en.wikipedia.org/wiki/Regular_expression">Regular expression</a> (from Wikipedia, the free encyclopedia)
+<em>
+<a href="g.remove.html">g.remove</a>
+</em>
 
 <h2>AUTHOR</h2>
 
 Huidae Cho<br>
 grass4u at gmail.com
 
-<p><i>Last changed: $Date$</i>
+<p>
+<i>Last changed: $Date$</i>



More information about the grass-commit mailing list