This directory contains the source code for
GRASS GIS 5.0.x in gzipped tar format.

The large (around 18 MB) file grass5.0.x_src.tar.gz is the
officially released GRASS 5.0.x source code in a single file.

Note: The required temporal space for a full compilation is currently 340MB
      (including object.files etc which can be removed later).
      The resulting binary package size is between 60MB and 150MB 
      depending on your system's architecture.

To extract do following:

- Create a directory for the source code:
  Example:

        mkdir /opt/src/grass50sources

- Put the package there and extract it (replace "X" with 
  the current version number of GRASS 5.0.X):

        gunzip grass5.0.X.tar.gz
	tar -xvf grass5.0.X.tar  

  Example:

        gunzip grass5.0.0.tar.gz
        tar -xvf grass5.0.0.tar

This will create the necessary directories and
files for you to compile GRASS.

***********************************************
Compile the source

-> Please read the included INSTALL text for details!
-> Default install path is /usr/local/grass5/

A) If you have "root" access to your machine:

   Jump into the new directory "grass5.0.X" (change X to the current 
   release number):
        cd grass5.0.X

   Now read the INSTALL file.
   To compile enter following:

        ./configure
        make
        make install

   Now the code will be compiled (takes around 1h depending on
   processor's speed).

   In case of problems read the INSTALL file and/or search the 
   web archives and/or the FAQ (often the questions were already
   answered).

B) If you have no "root" access: You can also compile 
   GRASS locally (replace "user" with your username):

   Jump into the new directory "grass5.0.X" (change X to the current
   release number):

        cd grass5.0.X

   Then start the process:

        ./configure --prefix=/home/user/ --with-bindir=/home/user
        make
        make install

   This will store the GRASS binaries into your local directory
   "/cesgrass/home/user/grass5" and the start script into your home.

  Example:
    
        ./configure --prefix=/home/roberta --with-bindir=/home/roberta
        make
        make install

  Now the code will be compiled (takes around 1h depending on
  processor's speed).

***********************************************
Installing single modules from source:

The "configure" process creates two scripts (after "make install"
these scripts will be stored in /usr/local/bin/ if not having used
configure's option "--with-bindir")

   gmake5
   gmake5 -i
   gmakelinks5 -i

Use script "gmake5" to compile single modules locally, run
"gmakelinks5" afterwards to set internal links for the new module.
The "-i" flag will install them into target directory, so that no
further "make install" is required.

Enjoy ongoing GRASS development!

***********************************************

Help us to improve GRASS. Report problems at our bug report page:
go here!

Send improvements to
          grass-web(at)lists.osgeo.org
          grass5@grass.itc.it

Thanks!

***********************************************