[GRASSweb-list]paul: web/grass54/source README.html,1.2,1.3

Mon Nov 8 10:29:46 EST 2004

Author: paul

Update of /grassrepository/web/grass54/source
In directory doto:/tmp/cvs-serv27188

Modified Files:
	README.html 
Log Message:
Remove clutter


Index: README.html
===================================================================
RCS file: /grassrepository/web/grass54/source/README.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3

--- README.html	8 Nov 2004 14:28:50 -0000	1.2
+++ README.html	8 Nov 2004 15:29:44 -0000	1.3
@@ -1,105 +1,64 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <HTML> <BODY BGCOLOR=#FFFFFF>
-<pre>
-This directory contains the source code for
-GRASS GIS 5.4.0 in gzipped tar format.
-
-The large (around 20 MB) file grass-5.4.0.tar.gz is the
-officially released GRASS 5.4.0 source code in a single file.
-
-Note: The required temporary space for a full compilation is currently 140MB
-      (including object.files etc which can be removed later).
-      The resulting binary package size is between 20MB and 150MB 
-      depending on your system's architecture and on whether the internal
-      GRASS libraries are compiled static or shared.
-
-To extract do following:
-
-- Create a directory for the source code:
-  Example:
-
-        mkdir /opt/src/grass540sources
-
-- Put the package there and extract it (replace "X" with 
-  the current version number of GRASS 5.4.0):
-
-        gunzip grass-5.4.0.tar.gz
-	tar -xvf grass-5.4.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/grass54/
-
-A) If you have "root" access to your machine:
-
-   Jump into the new directory "grass-5.4.0" (change X to the current 
-   release number):
-        cd grass-5.4.0
-
-   Now read the INSTALL file.
-   To compile enter following:
-
-        ./configure <parameters>
-        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):
+<p>This directory contains the source code for
+GRASS GIS 5.4.0 in gzipped tar format.</p>
 
-   Jump into the new directory "grass-5.4.0" (change X to the current
-   release number):
+<p>The large (around 20 MB) file grass-5.4.0.tar.gz is the
+officially released GRASS 5.4.0 source code in a single file.</p>
 
-        cd grass-5.4.0
+<h3>INSTALLATION</h3>
 
-   Then start the process:
+<p>Before you compile GRASS, please read the file <a href="REQUIREMENTS.html">REQUIREMENTS.html</a>.<br>
+Note: Building of modules that depend on certain pre-requisite software may 
+be disabled by passing options to the configure script (for example PostgreSQL 
+or fftw, see section on CONFIGURE OPTIONS in <a href="INSTALL">INSTALL</a>). For general
+usability of GRASS, leaving out a few modules will often pose no problem.</p>
 
-        ./configure --prefix=/home/user/ --with-bindir=/home/user
-        make
-        make install
+<p>This release of GRASS uses a new build system by default, known as
+the 'Alternate' build system. This uses separate build and source
+directories, i.e. you cannot run ./configure from the top-level source
+directory. This is convenient when dealing with a project with such a
+large code base as GRASS. In addition the alternate build system allows
+to compile the core GRASS libraries as shared, greatly reducing the
+size of the compiled binaries and install footprint.</p>
 
-   This will store the GRASS binaries into your local directory
-   "/home/user/grass54" and the start script into your home.
+<p>The intent of the install method is to have the following sequence
+of commands work to install GRASS on any platform.</p>
+<pre>
 
-  Example:
-    
-        ./configure --prefix=/home/roberta --with-bindir=/home/roberta
+        gunzip -fc grass-5.4.0.tar.gz | tar xvf -
+        mkdir grass-build
+        cd grass-build
+        ../grass-5.4.0/configure ... [system-specific options] ..
         make
-        make install
+        sudo make install
 
-  Now the code will be compiled (takes around 1h depending on
-  processor's speed).
+</pre>
+<p>Note: The required temporary space for a full compilation is currently 140MB
+      (including object.files etc which can be removed later).
+      The resulting binary package size is between 20MB and 150MB 
+      depending on your system's architecture and on whether the internal
+      GRASS libraries are compiled static or shared.</p>
 
 
-Enjoy ongoing GRASS development!
+<p>Enjoy ongoing GRASS development!</p>
 
-***********************************************
+<hr>
 
-Help us to improve GRASS. Report problems at our bug report page:
-<a href=http://grass.itc.it/bugtracking/bugreport.html>go here!</a>
+<p>Help us to improve GRASS. Report problems at our bug report page:
+<a href=http://grass.itc.it/bugtracking/bugreport.html>go here!</a></p>
 
-Send improvements to
-          grass5 at grass.itc.it (needs subscription)
+<p>Send improvements to<br>
+          grass5 at grass.itc.it (needs subscription)<br>
 
-Thanks!
+Thanks!</p>
 
-***********************************************
-</pre>
+<hr>
 
 Get this <a href=README.html>file.</a>
 
 <DIV ALIGN=right><font size=-1><i>Last change:
 $Date$
 </i></font></DIV>
+</body>
 </HTML>



