November 1999

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


The large (20 mb) file grass5.0beta6final.tar.gz is the
whole source in a single file.  Get this file.

To extract do following:

- Create a directory for the source code:
  Example:

        mkdir /opt/grass5sources

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

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

  Example:

        gunzip grass5.0beta6final.tar.gz
        tar -xvf grass5.0beta6final.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!

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

  Jump into the new directory "grass5.0beta":
        cd grass5.0beta

  To compile enter following:

        ./configure
        make install

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

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

   Jump into the new directory "grass5.0beta":
        cd grass5.0beta

   Then start the process:

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

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

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

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

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

The "configure" process creates two scripts (they will be stored in
/usr/local/bin/ if not specified with option "--with-bindir")

   gmake5
   gmake5links

Use script "gmake5" to compile single modules locally, run
"gmake5links" afterwards to set internal links for the new module.

Enjoy ongoing GRASS development!

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

If you experience any problems, please email
us at:    grass@baylor.edu

Report bugs to (if not listed in "know_bugs"-file within sources):
          grass@baylor.edu
          neteler@geog.uni-hannover.de

Send improvements to
          neteler@geog.uni-hannover.de

Thanks!

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