clean up language (https://trac.osgeo.org/grass/ticket/1591)

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

display/d.where/d.where.html

@@ -22,8 +22,8 @@ it will be written to the file as well.
 </pre>
 
 The left mouse button prints the coordinates at the selected point,
-the middle mouse button allows to query two points (they are connected by a
-line for convenience). By using the right mouse button the module is left.
+the middle mouse button allows you to query two points (they are connected
+by a line for convenience). Use the right mouse button to exit the module.
 
 
 <h2>NOTES</h2>

general/g.mapset/g.mapset.html

@@ -1,6 +1,9 @@
 <h2>DESCRIPTION</h2>
 
-<em>g.mapset</em> allows to change the current mapset 
+<em>g.mapset</em> changes the current working MAPSET, LOCATION, or GISDBASE.
+This is a fairly radical maneuver to run mid-session, take care when running
+the GUI at the same time.
+
 
 <h2>NOTES</h2>
 
@@ -9,17 +12,23 @@ you can switch the history to the new settings by commands:<br>
 <br>
 <div class="code"><pre>
    history -w
-   history -r /$GISDBASE/$LOCATION/$MAPSET/.bash_history
-   HISTFILE=/$GISDBASE/$LOCATION/$MAPSET/.bash_history
+   history -r /"$GISDBASE/$LOCATION/$MAPSET"/.bash_history
+   HISTFILE=/"$GISDBASE/$LOCATION/$MAPSET"/.bash_history
 </pre></div><br>
 
+
 <h2>SEE ALSO</h2>
 
-<em><a href="g.gisenv.html">g.gisenv</a></em><br>
-<em><a href="g.mapsets.html">g.mapsets</a></em><br>
+<em>
+<a href="g.gisenv.html">g.gisenv</a><br>
+<a href="g.mapsets.html">g.mapsets</a>
+</em>
+<br>
+
 
 <h2>AUTHOR</h2>
 
 Radim Blazek
 
-<p><i>Last changed: $Date$</i>
+<p>
+<i>Last changed: $Date$</i>

gui/wxpython/animation/g.gui.animation.html

@@ -6,7 +6,7 @@ The <b>Animation Tool</b> is a <em><a href="wxGUI.html">wxGUI</a></em> component
 for animating a series of GRASS raster maps or a space time raster dataset (created by t.* modules).
 
 <p>
-Animation Tool allows to:
+Animation Tool allows you to:
 
 <ul>
   <li>display up to 4 synchronized animations</li>
@@ -38,12 +38,14 @@ To display 3D view animation follow these steps:
 <br>
 </center>
 
+
 <h2>TODO</h2>
 <ul>
   <li>export animation</li>
   <li>...</li>
 </ul>
 
+
 <h2>SEE ALSO</h2>
 
 <em>
@@ -63,6 +65,7 @@ To display 3D view animation follow these steps:
   <a href="g.gui.vdigit.html">g.gui.vdigit</a>
 </em>
 
+
 <h2>AUTHOR</h2>
 
 Anna Kratochvilova,

gui/wxpython/dbmgr/g.gui.dbmgr.html

@@ -10,7 +10,7 @@ alt="icon"> in the toolbar. It's also available as a stand-alone
 module <em>g.gui.dbmgr</em>.
 
 <p>
-<em>Attribute table manager</em> allows to:
+<em>Attribute table manager</em> allows you to:
 
 <ul>
   <li>browse attribute data of vector map, perform SQL select
@@ -30,6 +30,7 @@ module <em>g.gui.dbmgr</em>.
 <br><br>
 </center>
 
+
 <h2>SEE ALSO</h2>
 
 <em>

gui/wxpython/docs/wxGUI.nviz.html

@@ -117,7 +117,7 @@ Ctrl key switches flight mode in the way that position of viewpoint is
 changed (not the direction).
 
 <h3>Data properties</h3> 
-This tab allows to control parameters related to map layers. It consists
+This tab controls the parameters related to map layers. It consists
 of four collapsible panels - <em>Surface</em>, <em>Constant surface</em>, 
 <em>Vector</em> and <em>Volume</em>.
 
@@ -325,7 +325,7 @@ light model is displayed to visualize the light settings.
   <br><img src="wxGUI_nviz_tools_light.jpg" border="1" alt="toolbox"><br><br>
 </center>
 <p>
-The <em>Fringe</em> panel allows to draw fringes in different directions
+The <em>Fringe</em> panel allows you to draw fringes in different directions
 (North & East, South & East, South & West, North & West). It is possible
 to set fringe color and height of the bottom edge.
 <p>

gui/wxpython/docs/wxGUI.vnet.html

@@ -12,7 +12,7 @@ tool</i> or from Map Display toolbar <i>Analyse map &rarr; Vector
 network analysis tool</i> <img src="icons/vector-tools.png" alt="icon">.
 
 <p>
-<em>Vector Network Analysis Tool</em> currently allows to:
+<em>Vector Network Analysis Tool</em> currently allows you to:
 
 <ul>
   <li> perform these network analyses:
@@ -61,12 +61,12 @@ The tool is split into tabs. Every tab represents some functionality:
   label. Then from pop-up menu choose <em>Add column</em>, where new
   column for cost values can be created. After that by right mouse
   button click on the added column label can be chosen item <em>Field
-  calculator</em>. This tool allows to compute cost values.</dd>
+  calculator</em>. This tool computes cost values.</dd>
   <dt><b>Result tables</b> tab</dt>
-  <dd>Result of vector network analysis is always vector map. Some
+  <dd>The result of vector network analysis is always a vector map. Some
   vector network analysis results can also include attribute
-  tables. If such a table is connected to result map, this tab is
-  showed and allows to browse these data.</dd>
+  tables. If such a table is connected to the result map, this tab is
+  shown and with it you can browse the data.</dd>
 </dl>
 
 <h2>KNOWN ISSUES</h2>

gui/wxpython/gmodeler/g.gui.gmodeler.html

@@ -4,7 +4,7 @@
 
 <p>
 The <b>Graphical Modeler</b> is
-a <em><a href="wxGUI.html">wxGUI</a></em> component which allows to
+a <em><a href="wxGUI.html">wxGUI</a></em> component which allows the user to
 create, edit, and manage complex models using easy-to-use
 interface. When performing analytical operations in GRASS, the
 operations are not isolated, but part of a chain of operations. Using
@@ -19,7 +19,7 @@ toolbar <img src="icons/modeler-main.png" alt="icon">. It's also
 available as stand-alone module <em>g.gui.gmodeler</em>.
 
 <p>
-The Graphical Modeler allows to:
+The Graphical Modeler allows you to:
 
 <ul>
   <li>define data items (raster, vector, 3D raster maps)</li>

gui/wxpython/gui_core/gselect.py

@@ -131,7 +131,7 @@ class Select(wx.combo.ComboCtrl):
 class VectorSelect(Select):
     def __init__(self, parent, ftype, **kwargs):
         """!Custom to create a ComboBox with a tree control to display and
-        select vector maps. Control allows to filter vector maps. If you
+        select vector maps. You can filter the vector maps. If you
         don't need this feature use Select class instead
         
         @param ftype filter vector maps based on feature type

gui/wxpython/iclass/g.gui.iclass.html

@@ -16,7 +16,7 @@ supervised classification</i> or via command line
 as <em>g.gui.iclass</em>.
 
 <p>
-<em>wxIClass</em> currently allows to:
+<em>wxIClass</em> currently allows you to:
 
 <ul>
   <li>create training areas

gui/wxpython/mapdisp/mapwindow.py

@@ -1832,7 +1832,7 @@ class BufferedWindow(MapWindow, wx.Window):
         self.frame.OnPointer(event = None)
         
     def RegisterGraphicsToDraw(self, graphicsType, setStatusFunc = None, drawFunc = None):
-        """! Method allows to register graphics to draw.
+        """! This method registers graphics to draw.
         
         @param type (string) - graphics type: "point" or "line"
         @param setStatusFunc (function reference) - function called before drawing each item
@@ -1840,7 +1840,7 @@ class BufferedWindow(MapWindow, wx.Window):
                     item - passes instance of GraphicsSetItem which will be drawn
                     itemOrderNum - number of item in drawing order (from O)
                                    Hidden items are also counted in drawing order.
-        @param drawFunc (function reference) - allows to define own function for drawing
+        @param drawFunc (function reference) - defines own function for drawing
                             If function is not defined DrawCross method is used for type "point"
                             or DrawLines method for type "line".
                             

gui/wxpython/mapswipe/g.gui.mapswipe.html

@@ -9,7 +9,7 @@ It is useful e.g. for comparing raster maps from different time periods.
 Map Swipe can be launched from the menu <tt>File -&gt; Map Swipe</tt>.
 
 <p>
-Map Swipe allows to:
+Map Swipe allows you to:
 
 <ul>
   <li>switch orientation of the swipe line (horizontal or vertical)</li>
@@ -24,7 +24,8 @@ Map Swipe allows to:
 <center>
 <br>
 <img src="mapswipe_tsunami.jpg" border="1" alt="Map swipe screenshot">
-<br>Pre and post disaster images of the tsunami in Japan in 2011. The upper MODIS image
+<br>
+Pre and post disaster images of the tsunami in Japan in 2011. The upper MODIS image
 taken on February 26, 2011, shows the coastline under normal conditions while the lower
 MODIS image on March 13, 2011, shows a clear view of tsunami flooding along the coastline.
 Water, black and dark blue in these false-color images, still covers the ground as much
@@ -33,6 +34,7 @@ Source: <a href="http://earthobservatory.nasa.gov/NaturalHazards/view.php?id=496
 <br>
 </center>
 
+
 <h2>SEE ALSO</h2>
 
 <em>
@@ -55,6 +57,7 @@ Source: <a href="http://earthobservatory.nasa.gov/NaturalHazards/view.php?id=496
 <p>
 See also the user <a href="http://grasswiki.osgeo.org/wiki/WxGUI_Map_Swipe">wiki</a> page.
 
+
 <h2>AUTHOR</h2>
 
 Anna Kratochvilova,

gui/wxpython/mapswipe/g.gui.mapswipe.py

@@ -20,7 +20,7 @@
 ############################################################################
 
 #%module
-#% description: Allows to interactively compare two maps by swiping.
+#% description: Interactively compares two maps by swiping a visibility bar.
 #% keywords: general
 #% keywords: gui
 #% keywords: display

gui/wxpython/vdigit/g.gui.vdigit.html

@@ -43,9 +43,9 @@ in Layer Manager and opened for editing. "Select vector map"
 combobox in digitizer toolbar also allows switching easily between
 vector maps to be edited.
 <p>
-Vector digitizer allows to define &quot;background&quot; vector map. A
-background map can be selected from map layer contextual menu in Layer
-Manager (&quot;Use as Background Map&quot;). Newly digitized vector
+The vector digitizer allows you to define a &quot;background&quot; vector map.
+A background map can be selected from the map layer contextual menu, in
+<em>Layer Manager</em> (&quot;Use as Background Map&quot;). Newly digitized vector
 features are snapped in the given threshold to the features from the
 background map. Vector features may be also copied from the background
 map by &quot;Copy features from (background) vector map&quot; tool

imagery/i.topo.corr/i.topo.corr.html

@@ -8,10 +8,10 @@ ground and the sun rays. It can be obtained with <em>r.sun</em>
 (parameter incidout), and then calculating its cosine with float precision.
 
 <p>
-Using flag -i and given an elevation map as basemap (metric),
-<em>i.topo.corr</em> permits to obtain a simple illumination model from the formula:
+Using the <b>-i</b> flag and given an elevation basemap (metric),
+<em>i.topo.corr</em> creates a simple illumination model using the formula:
 <ul>
-	<li> cos_i = cos(s) * cos(z) + sin(s) * sin(z) * cos(a - o) </li>
+  <li> cos_i = cos(s) * cos(z) + sin(s) * sin(z) * cos(a - o) </li>
 </ul>
 where,
 <em>s</em> is the terrain slope angle, <em>z</em> is the solar zenith angle,
@@ -26,13 +26,13 @@ the original reflectance (ref_o) using one of the four offered methods
 <h3>Method: cosine</h3>
 
 <ul>
-<li> ref_c = ref_o * cos_z / cos_i </li>
+  <li> ref_c = ref_o * cos_z / cos_i </li>
 </ul>
 
 <h3>Method: minnaert</h3>
 
 <ul>
-<li>ref_c = ref_o * (cos_z / cos_i) ^k</li>
+  <li>ref_c = ref_o * (cos_z / cos_i) ^k</li>
 </ul>
 where,
 <em>k</em> is obtained by linear regression of<br>
@@ -41,7 +41,7 @@ ln(ref_o) = ln(ref_c) - k ln(cos_i/cos_z)
 <h3>Method: c-factor</h3>
 
 <ul>
-<li>ref_c = ref_o * (cos_z + c)/ (cos_i + c)</li>
+  <li>ref_c = ref_o * (cos_z + c)/ (cos_i + c)</li>
 </ul>
 where,
 <em>c</em> is a/m from ref_o = a + m * cos_i
@@ -54,9 +54,10 @@ then the transformation (cos_i + 1)/2 varied from 0
 (direct exhibition to the sun: no correction) and the corrected reflectance can
 be calculated as
 <ul>
-<li>ref_c = ref_o * 2 / (cos_i + 1)</li>
+  <li>ref_c = ref_o * 2 / (cos_i + 1)</li>
 </ul>
 
+
 <h2>NOTES</h2>
 
 <ol>
@@ -67,6 +68,7 @@ be calculated as
 <li>The elevation map to calculate the illumination model should be metric.</li>
 </ol>
 
+
 <h2>EXAMPLES</h2>
 
 First, make a illumination model from the elevation map (here, SRTM). Then
@@ -81,6 +83,7 @@ i.topo.corr base=SRTM.illumination input=toar.5,toar.4,toar.3 out=tcor \
   zenith=33.3631 method=c-factor
 </pre></div>
 
+
 <h2>REFERENCES</h2>
 
 <ul>
@@ -109,6 +112,7 @@ i.topo.corr base=SRTM.illumination input=toar.5,toar.4,toar.3 out=tcor \
 <a href="r.sun.html">r.sun</a>
 </em>
 
+
 <h2>AUTHOR</h2>
 
 E. Jorge Tizado  (ej.tizado unileon es)<br>

lib/init/variables.html

@@ -83,9 +83,9 @@ PERMANENT
     while in a GRASS session.</dd>
   
   <dt>GRASS_ADDON_PATH</dt>
-  <dd>[grass startup script]<br> allows to specify additional paths to
-    local GRASS modules or user scripts extra to standard GRASS
-    distribution.</dd>
+  <dd>[grass startup script, g.extension]<br>
+    specifies additional path(s) containing local and/or custom GRASS 
+    modules extra to the standard distribution.</dd>
 
   <dt>GRASS_ADDON_BASE</dt>
   <dd>[grass startup script]<br> allows to specify additional GISBASE

raster/r.in.gdal/r.in.gdal.html

@@ -21,7 +21,7 @@ PERMANENT mapset.
 
 Full details on GDAL supported formats are available at:<p>
 <a href="http://www.gdal.org/formats_list.html">http://www.gdal.org/formats_list.html</a><p>
-Selected formats of more than 80 supported formats:
+Selected formats of the more than 80 supported formats:
 <div class="code"><pre>
 
 Long Format Name                                        Code                    Creation        Georeferencing          Maximum File Size
@@ -101,7 +101,7 @@ imported with the indicated <b>output</b> name into the PERMANENT mapset.
 
 <p>Support for GCPs: In case the image contains GCPs they are written to a
 POINTS file within an imagery group. They can directly be used for 
-<a href=i.rectify.html>i.rectify</a>. The <b>target</b> option allows to
+<a href=i.rectify.html>i.rectify</a>. The <b>target</b> option allows you to
 automatically re-project the GCPs from their own projection into another
 projection read from the PROJ_INFO file of the location name
 <b>target</b>.

raster/r.region/r.region.html

@@ -6,7 +6,7 @@ and/or set from a region definition file (stored under the
 <kbd>windows</kbd> directory in the user's current mapset), a raster
 or vector map, or a 3dview file.
 <p>
-The <b>align</b> parameter allows to set the current resolution equal to
+The <b>align</b> parameter sets the current resolution equal to
 that of the named raster map, and align the boundaries to a row and column
 edge in the named map.  Alignment only moves the existing boundaries outward
 to the edges of the next nearest cell in the named raster map -- not to the

scripts/v.db.join/v.db.join.py

@@ -15,7 +15,7 @@
 #############################################################################
 
 #%module
-#% description: Allows to join a table to a vector map table.
+#% description: Joins a database table to a vector map table.
 #% keywords: vector
 #% keywords: attribute table
 #% keywords: database

scripts/v.db.update/v.db.update.html

@@ -1,15 +1,17 @@
 <h2>DESCRIPTION</h2>
 
-<em>v.db.update</em> allows to assign a new value to a column in the
+<em>v.db.update</em> assigns a new value to a column in the
 attribute table connected to a given map. Alternatively, values can be
 copied from another column in the table.
 
+
 <h2>NOTES</h2>
 
 <em>v.db.update</em> is just a front-end to <em>db.execute</em> to
 allow easier usage.
 <p>For complex SQL UPDATE statements, <em>db.execute</em> should be used.
 
+
 <h2>EXAMPLES</h2>
 
 In this example, selectively display lakes without (blue) and with
@@ -52,6 +54,7 @@ v.db.update mygeodetic_pts col=zval qcol="CAST(z_value AS double precision)" \
             where="z_value &lt;&gt; 'N/A'"
 </pre></div>
 
+
 <h2>SEE ALSO</h2>
 
 <em>
@@ -70,4 +73,5 @@ v.db.update mygeodetic_pts col=zval qcol="CAST(z_value AS double precision)" \
 
 Moritz Lennert (mlennert@club.worldonline.be)
 
-<p><i>Last changed: $Date$</i>
+<p>
+<i>Last changed: $Date$</i>

scripts/v.db.update/v.db.update.py

@@ -16,7 +16,7 @@
 #############################################################################
 
 #%module
-#% description: Allows to update a column in the attribute table connected to a vector map.
+#% description: Updates a column in the attribute table connected to a vector map.
 #% keywords: vector
 #% keywords: attribute table
 #% keywords: database

vector/v.what/v.what.html

@@ -4,9 +4,10 @@
 Outputs the category number value(s) associated with user-specified location(s) 
 in user-specified vector map layer(s).  This module was derived from the
 <em>d.what.vect</em> module by removing all interactive code and
-modification of the output for easy parsing. Using the <em>-g</em> flag permits to
-generate script style output which is easily parsable.
-<p>This module always reports standard acres, even when the location uses
+modification of the output for easy parsing. Using the <em>-g</em> flag
+generates script-style output which is easily parsable.
+<p>
+This module always reports standard acres, even when the location uses
 US Survey feet as the map unit.
 
 
@@ -28,4 +29,5 @@ v.what fields east_north=599121.75,4922981.125
 Trevor Wiens<br>
 Edmonton, Alberta, Canada
 
-<p><i>Last changed: $Date$</i>
+<p>
+<i>Last changed: $Date$</i>

vector/vectorintro.html

@@ -98,7 +98,7 @@ topology for areas.
 The <a href="v.type.html">v.type</a> module can be used to convert
 between vector types if
 possible. The <a href="v.build.html">v.build</a> module is used to
-generate topology. It optionally allows to extract the erroneous
+generate topology. It optionally allows the user to extract erroneous
 vector objects into a separate map. Topological errors can be
 corrected either manually
 within <a href="wxGUI.Vector_Digitizer.html">wxGUI vector