[GRASS-SVN] r60446 - grass/trunk/lib/python/pygrass/docs

[svn_grass at osgeo.org]

Author: neteler
Date: 2014-05-23 05:13:36 -0700 (Fri, 23 May 2014)
New Revision: 60446

Modified:
   grass/trunk/lib/python/pygrass/docs/index.rst
Log:
pygrass manual: intro text expanded

Modified: grass/trunk/lib/python/pygrass/docs/index.rst
===================================================================
--- grass/trunk/lib/python/pygrass/docs/index.rst	2014-05-23 11:20:55 UTC (rev 60445)
+++ grass/trunk/lib/python/pygrass/docs/index.rst	2014-05-23 12:13:36 UTC (rev 60446)
@@ -3,21 +3,14 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-PyGRASS documentation!
+PyGRASS documentation
 ===================================
 
-``PyGRASS`` improves the integration between GRASS GIS and Python, making
-the use of Python under GRASS more consistent with the language itself. Furthermore,
-it simplifies GRASS scripting and programming and more natural for the user.
+Python is a programming language which is more powerful than shell scripting but easier and more forgiving than C. ``PyGRASS`` is an object-oriented Python Application Programming Interface (API) for GRASS GIS. ``PyGRASS`` offers interfaces to GRASS modules and functionality, as well as to vector and raster data. For details, see Zambelli et al. (2013) in the references below. ``PyGRASS`` improves the integration between GRASS GIS and Python, making the use of Python under GRASS more consistent with the language itself. Furthermore, it simplifies GRASS scripting and programming and more natural for the user.
 
-Background: In 2006, GRASS GIS developers started to adopt Python for the new GUI. Due
-to this Python became more and more important and developers converted all
-shell scripts from GRASS GIS 6 to Python for GRASS GIS 7.
+Background: In 2006, GRASS GIS developers started to adopt Python for the new GUI. Due to this Python became more and more important and developers converted all shell scripts from GRASS GIS 6 to Python for GRASS GIS 7.
 
-To work with ``PyGRASS`` you need an up-to-date version of GRASS GIS 7.
-The only action before starting to work with ``PyGRASS`` is to launch 
-GRASS GIS 7 and from the console launch ``python`` or ``ipython`` 
-(the second one is the recommended way)
+To work with ``PyGRASS`` you need an up-to-date version of GRASS GIS 7. The only action before starting to work with ``PyGRASS`` is to launch GRASS GIS 7 and from the console launch ``python`` or ``ipython`` (the second one is the recommended way).
 
 Contents:
 
@@ -34,7 +27,8 @@
 References
 ============
 
-Zambelli P, Gebbert S, Ciolli M., 2013. *Pygrass: An Object Oriented Python Application Programming Interface (API) for Geographic Resources Analysis Support System (GRASS) Geographic Information System (GIS)*. ISPRS International Journal of Geo-Information. 2(1):201-219. `doi:10.3390/ijgi2010201 <http://dx.doi.org/10.3390/ijgi2010201>`_
+* Zambelli P, Gebbert S, Ciolli M., 2013. *Pygrass: An Object Oriented Python Application Programming Interface (API) for Geographic Resources Analysis Support System (GRASS) Geographic Information System (GIS)*. ISPRS International Journal of Geo-Information. 2(1):201-219. `doi:10.3390/ijgi2010201 <http://dx.doi.org/10.3390/ijgi2010201>`_
+* `Python related articles in the GRASS GIS Wiki <http://grasswiki.osgeo.org/wiki/Category:Python>`_
 
 This project has been funded with support from the `Google Summer of Code 2012 <http://trac.osgeo.org/grass/wiki/GSoC#PythonhighlevelmapinteractionforGRASSGIS>`_