[GRASS-SVN] r66762 - grass/trunk/scripts/g.extension

[svn_grass at osgeo.org]

Author: neteler
Date: 2015-11-07 04:02:32 -0800 (Sat, 07 Nov 2015)
New Revision: 66762

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

Modified: grass/trunk/scripts/g.extension/g.extension.html
===================================================================
--- grass/trunk/scripts/g.extension/g.extension.html	2015-11-06 23:05:13 UTC (rev 66761)
+++ grass/trunk/scripts/g.extension/g.extension.html	2015-11-07 12:02:32 UTC (rev 66762)
@@ -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>
 
@@ -199,11 +210,25 @@
 <h2>KNOWN ISSUES</h2>
 
 Toolboxes in the official repository cannot be downloaded.
+<p>
 On MS Windows, only the official repository is working
 because there is no way of compiling the modules
+<!-- what does it mean? -->
 (a Python replacement for Python scripts should be implemented).
 
+<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>