v.split/segment/parallel manuals: improvements (contributed by Milena Nowotarska)

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@59355 15284696-431f-4ddb-bdfa-cd5b030d7da7

vector/v.parallel/v.parallel.html

@@ -3,6 +3,14 @@
 <em>v.parallel</em> creates parallel lines to the input vector lines which
 can be used as half-buffers.
 
+<h2>NOTES</h2>
+Usage of <b>-b</b> flag will overrule the <b>side</b> parameter.
+
+<h2>BUGS</h2>
+There is a problem with side-offset parallel line generation for inside corners.
+To avoid this problem, the <b>-b</b> flag might be used.
+<!-- in Vect_line_parallel(), v.segment is also affected -->
+
 <h2>SEE ALSO</h2>
 
 <em>

vector/v.segment/v.segment.html

@@ -1,7 +1,8 @@
 <h2>DESCRIPTION</h2>
 
 <em>v.segment</em> generates segments or points from input lines and from
-positions read from a text file or '<tt>stdin</tt>'.
+positions read from a text file or '<tt>stdin</tt>'. It includes the creation 
+of parallel lines or points in given destination from the line.
 
 <p>The format is:
 <div class="code"><pre>

vector/v.split/v.split.html

@@ -1,13 +1,15 @@
 <h2>DESCRIPTION</h2>
 
-<em>v.split</em> split vector lines into shorter segments using a
-maximal distance between nodes.
+<em>v.split</em> splits vector lines into shorter segments using 
+a maximal distance between nodes. The resulting length of all segments
+is expected to be equal and not higher than the given <b>length</b> 
+parameter.
 
 <h2>EXAMPLES</h2>
 
 The examples are based on the North Carolina sample data location.
 
-<h3>Example 1: Inserting kilometric nodes to railroad map</h3>
+<h3>Example 1: Inserting nodes to railroad map</h3>
 
 <div class="code"><pre>
 # extract data for this example
@@ -16,7 +18,7 @@ v.extract railroads out=myrr cats=1
 # show line, category, direction (to find the beginning)
 d.vect myrr disp=shape,cat,dir
 
-# insert nodes at 1000m distance (max)
+# insert nodes at a distance not longer than 1000m
 v.split myrr out=mrr_split length=1000
 d.vect myrr_split disp=shape,topo
 </pre></div>
@@ -29,12 +31,12 @@ v.build.polylines myrr out=myrr_poly
 v.category myrr_pol out=myrailroads option=add
 </pre></div>
 
-<h3>Example 2: Inserting kilometric vertices to railroad map</h3>
+<h3>Example 2: Inserting vertices to railroad map</h3>
 
 Note: first run the two steps from example 1.
 
 <div class="code"><pre>
-# insert vertices at 1000m distance (max)
+# insert vertices at a distance not longer than 1000m
 v.split -n myrr out=myrr_split length=1000
 d.vect myrr_split disp=shape,topo
 </pre></div>