[GRASS-SVN] r54709 - grass/trunk/vector/v.build

[svn_grass at osgeo.org]

Author: martinl
Date: 2013-01-19 05:40:03 -0800 (Sat, 19 Jan 2013)
New Revision: 54709

Modified:
   grass/trunk/vector/v.build/main.c
   grass/trunk/vector/v.build/v.build.html
Log:
v.build: explain -e flag


Modified: grass/trunk/vector/v.build/main.c
===================================================================
--- grass/trunk/vector/v.build/main.c	2013-01-19 13:39:26 UTC (rev 54708)
+++ grass/trunk/vector/v.build/main.c	2013-01-19 13:40:03 UTC (rev 54709)
@@ -58,7 +58,7 @@
     opt->multiple = YES;
     opt->answer = "build";
     opt->description =
-	_("Build topology or dump topology or spatial index to stdout");
+	_("Build topology or dump topology or indeces to standard output");
     opt_desc = NULL;
     G_asprintf(&opt_desc,
 	       "build;%s;dump;%s;sdump;%s;cdump;%s;fdump;%s",
@@ -66,7 +66,7 @@
 	       _("write topology to stdout"),
 	       _("write spatial index to stdout"),
 	       _("write category index to stdout"),
-	       _("write feature index to stdout (non-native formats only)"));
+	       _("write feature index to stdout (OGR simple-feature-based formats only)"));
     opt->descriptions = opt_desc;
     opt->required = YES;
     

Modified: grass/trunk/vector/v.build/v.build.html
===================================================================
--- grass/trunk/vector/v.build/v.build.html	2013-01-19 13:39:26 UTC (rev 54708)
+++ grass/trunk/vector/v.build/v.build.html	2013-01-19 13:40:03 UTC (rev 54709)
@@ -23,6 +23,51 @@
 In case of errors, the user can optionally generate an <b>error</b>
 vector map containing the erroneous vectors for later inspection.
 
+<p>
+If <b>error</b> vector map is specified, <em>v.build</em> checks:
+
+<ul>
+  <li>isolated bondaries (which are not forming any areas),</li>
+  <li>centroids outside of area,</li>
+  <li>duplicated centroids.</li>
+</ul>
+
+<p>
+Extensive checks for topological errors (flag <b>-e</b>) also
+includes:
+
+<ul>
+  <li>lines or boundaries of zero length,</li>
+  <li>intersecting boundaries, ie. overlapping areas,</li>
+  <li>areas without centroids that are not isles.</li>
+</ul>
+
+<h2>EXAMPLES</h2>
+
+<h3>Build topology</h3>
+
+Note that <b>option=build</b> recreates also spatial and category
+indeces, not only topology. For linked OGR layers
+(see <em><a href="v.external.html">v.external</a></em>) also feature
+index is created.
+
+<div class="code"><pre>
+v.build map=urbanareas option=build
+</pre></div>
+
+Note that the vector map <i>urbanarea</i> must be located in the
+current mapset.
+
+<h3>Dump topology or indeces</h3>
+
+Dump options print topology, spatial, category or feature index to
+standard output. Such information can be printed also for vector maps
+from other mapsets.
+
+<div class="code"><pre>
+v.build map=urbanareas at PERMANENT option=dump
+</pre></div>
+
 <h2>SEE ALSO</h2>
 
 <em>
@@ -32,11 +77,9 @@
 
 <h2>AUTHORS</h2>
 
-Dave Gerdes, U.S.Army Construction Engineering 
-Research Laboratory,<br>
-Michael Higgins,
-U.S.Army Construction Engineering 
-Research Laboratory,<br>
+Dave Gerdes, U.S.Army Construction Engineering Research
+Laboratory,<br>
+Michael Higgins, U.S.Army Construction Engineering Research Laboratory,<br>
 Radim Blazek, ITC-irst, Trento, Italy
 
 <p>