[GRASS-SVN] r66763 - grass/branches/releasebranch_7_0/scripts/g.extension

[svn_grass at osgeo.org]

Author: neteler
Date: 2015-11-07 04:04:10 -0800 (Sat, 07 Nov 2015)
New Revision: 66763

Modified:
   grass/branches/releasebranch_7_0/scripts/g.extension/g.extension.html
Log:
g.extension manual: demystify 'Please install GRASS development package' error message

Modified: grass/branches/releasebranch_7_0/scripts/g.extension/g.extension.html
===================================================================
--- grass/branches/releasebranch_7_0/scripts/g.extension/g.extension.html	2015-11-07 12:02:32 UTC (rev 66762)
+++ grass/branches/releasebranch_7_0/scripts/g.extension/g.extension.html	2015-11-07 12:04:10 UTC (rev 66763)
@@ -5,8 +5,19 @@
 <em>g.extension</em> downloads and installs, removes or updates
 extensions (addons) from the official
 <a href="http://grass.osgeo.org/grass70/manuals/addons/">GRASS GIS Addons repository</a>
-or user-specified source
-into the local GRASS GIS installation.
+or user-specified source into the local GRASS GIS installation.
+<p>
+Two types of extensions are supported:
+<ul>
+<li>Python scripts: they are installed without the need of compilation or (usually)
+    the need of special dependencies.</li>
+<li>Source code (mostly written in C programming language; may also be written
+    in C++, Fortran or other languages): while on MS-Windows systems the requested
+    GRASS GIS extension is downloaded pre-compiled from the GRASS GIS site, on Unix
+    based systems the installation is preceeded by the automated download of the
+    extension's source code along with subsequent compilation and installation.
+    This requires a compiler environment to be present on the user's computer.</li>
+</ul>
 
 <h3>Managing installed extensions</h3>
 
@@ -110,6 +121,19 @@
 g.extension extension=r.stream.distance operation=remove
 </pre></div>
 
+<h2>TROUBLESHOOTING</h2>
+
+Since extensions have to be compiled on Unix based systems (Linux, Mac OSX etc.)
+unless a Python extension is installed, a full compiler environment must be
+present on the user's computer.
+
+<h3>ERROR: Please install GRASS development package</h3>
+
+While GRASS GIS is available on the user's computer, the respective development
+package is lacking. If GRASS was installed from a (Linux) repository, also the
+grass-dev* package (commonly named "grass-dev" or "grass-devel", sometimes along
+with the version number) must be installed.
+
 <h2>SEE ALSO</h2>
 
 <em>