[GRASS-SVN] r58178 - grass/branches/releasebranch_6_4/scripts/g.mlist

[svn_grass at osgeo.org]

Author: neteler
Date: 2013-11-09 07:25:49 -0800 (Sat, 09 Nov 2013)
New Revision: 58178

Modified:
   grass/branches/releasebranch_6_4/scripts/g.mlist/description.html
Log:
g.mlist: examples improved

Modified: grass/branches/releasebranch_6_4/scripts/g.mlist/description.html
===================================================================
--- grass/branches/releasebranch_6_4/scripts/g.mlist/description.html	2013-11-09 15:25:25 UTC (rev 58177)
+++ grass/branches/releasebranch_6_4/scripts/g.mlist/description.html	2013-11-09 15:25:49 UTC (rev 58178)
@@ -1,8 +1,8 @@
 <h2>DESCRIPTION</h2>
 
-<em>g.mlist</em> is an extended version of 
-<em><a href="g.list.html">g.list</a></em> which
-provides (extended) regular expression and wildcard support.
+<em>g.mlist</em> searches for data files matching a pattern given by
+wildcards or POSIX Extended Regular Expressions. It is is an extended
+version of <em><a href="g.list.html">g.list</a></em>.
 <em>g.mlist</em> will only print map names and an optional separator,
 without extraneous output. In addition, map search is also available.
 
@@ -13,7 +13,8 @@
 <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>).
+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>
 
@@ -46,7 +47,27 @@
 g.mlist type=rast pattern="N45E00?.meters"
 </pre></div>
 
+Use of <em>exclude</em> parameter:
+<div class="code"><pre>
+# without exclude:
+  g.mlist rast pat="r*" mapset=PERMANENT
+  railroads
+  roads
+  rstrct.areas
+  rushmore
 
+# exclude only complete word(s):
+  g.mlist rast pat="r*" exclude=roads mapset=PERMANENT
+  railroads
+  rstrct.areas
+  rushmore
+
+# exclude with wildcard:
+  g.mlist rast pat="r*" exclude="*roads*" mapset=PERMANENT
+  rstrct.areas
+  rushmore
+</pre></div>
+
 <h3>Regular expressions:</h3>
 
 List all soil maps starting with "soils" in their name:
@@ -73,9 +94,9 @@
 </pre></div>
 
 
-<h3>Regular expressions:</h3>
+<h3>Extended regular expressions:</h3>
 
-List all precipitation maps of the years 1997-2012, comma separated:
+List all precipitation maps for the years 1997-2012, comma separated:
 <div class="code"><pre>
 g.mlist -e type=rast sep=comma pattern="precip_total.(199[7-9]|200[0-9]|201[0-2]).sum"
 </pre></div>
@@ -92,6 +113,9 @@
 
 
 <h2>AUTHOR</h2>
-Huidae Cho
+
+Huidae Cho<br>
+grass4u at gmail.com
+
 <p>
 <i>Last changed: $Date$</i>