DESCRIPTION

g.extension downloads and installs, removes or updates extensions (Addons) from the GRASS GIS Addons repository into the local GRASS GIS installation.

Re-running g.extension on an installed GRASS GIS Addon extension re-installs the requested extension which may include updates.

In order to bulk-update all locally installed GRASS GIS extensions, they can be re-installed altogether by the g.extension.all module.

NOTES

GRASS GIS extensions are installed by g.extension into a dedicated directory (GRASS_ADDON_BASE). The default on GNU/Linux is $HOME/.grass7/addons, on MS-Windows it is $APPDATA\GRASS7\addons.

The flag -s changes this install target directory to the GRASS GIS installation directory (GISBASE, e.g. /usr/) rather than the default GRASS_ADDON_BASE directory (see also variables). g.extension checks if the user has permission to write to GISBASE or GRASS_ADDON_BASE.

On MS-Windows systems, g.extension downloads an executable from the GRASS GIS project server. On all other operating systems, it downloads the source code of the requested Addon and compiles it locally.

EXAMPLES

Download and install of an extension

Download and install r.stream.distance into current GRASS installation

g.extension extension=r.stream.distance

Removal of a locally installed extension

g.extension extension=r.stream.distance operation=remove

List all available extensions from GRASS Addons SVN repository

g.extension -l

List all locally installed extensions

g.extension -a

AUTHORS

Markus Neteler (original shell script)
Martin Landa, Czech Technical University in Prague, Czech Republic (Python rewrite)

Last changed: $Date$