[GRASSweb-list] hamish: web/grass62/binary/mswindows README.html, 1.4, 1.5

Wed Feb 14 20:44:33 EST 2007

Author: hamish

Update of /grassrepository/web/grass62/binary/mswindows
In directory doto:/tmp/cvs-serv14142

Modified Files:
	README.html 
Log Message:
flesh out instructions. point to binaries on Ibiblio & mirrors to ease
the burden on ITC.


Index: README.html
===================================================================
RCS file: /grassrepository/web/grass62/binary/mswindows/README.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5

--- README.html	11 Feb 2007 23:21:54 -0000	1.4
+++ README.html	15 Feb 2007 01:44:31 -0000	1.5
@@ -1,22 +1,75 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <HTML> <BODY BGCOLOR=#FFFFFF>
 
-<h3>Installation instructions for winGRASS/Cygwin</h3>
+<h3>Installation instructions for GRASS on MS Windows with Cygwin (winGRASS)</h3>
 
-Prerequisites: For installation of Cygwin, see  <a href="http://geni.ath.cx/grass.html#toc5">http://geni.ath.cx/grass.html#toc5</a>. These instructions can be used, but at step #3 use
-http://grass.itc.it/grass62/binary/mswindows/ instead of http://geni.ath.cx/grass .
-Also, the version in step #5 is 6.2.1-1 instead of 6.0.cvs-1, and there's no grass.bat
-script (just run "grass62" from an xterm).
+Prerequisites:
+<P>
+GRASS 6.2 for Windows requires the Free 
+<a href="http://www.cygwin.com">Cygwin UNIX compatibility</a> software.
+Newer versions of GRASS (starting with version 6.3) will work in Windows
+directly -- this is currently under active development. As GRASS has been a
+UNIX program for the last 20 years, and covers nearly a million lines of
+source code, this is a non-trivial project, so bear with us and help test
+if you can!
+<P>
+For installation of Cygwin, see
+<a href="http://geni.ath.cx/grass.html#toc5">http://geni.ath.cx/grass.html#toc5</a>.
 
-<p>
-The winGRASS package made is just a .tar.gz file. It should be extracted
-into Cygwin's root directory (or use setup.ini as explained in above external notes),
+These instructions can be used, but at step #3 use
+<tt>http://grass.ibiblio.org/grass62/binary/mswindows/</tt>
+(or a <a href="http://grass.ibiblio.org/mirrors.php">local mirror</a>)
+instead of <tt>http://geni.ath.cx/grass</tt>.
+
+Also, in step #5 the version is 6.2.1-1 instead of 6.0.cvs-1, and there's no
+grass.bat script.
+<P>
+To start GRASS, double-click on the Cygwin icon and run "<tt>startx</tt>" at
+the command prompt. This will start X-Windows and open a new xterm window.
+At the xterm prompt type "<tt>grass62</tt>".
+<br><br><br>
+<hr width=600>
+<br>
+
+Installing data:
+<P>
+Create a new directory in your Cywgin home directory called
+"<tt>grassdata/</tt>" for your data.<BR> For example, using the
+<a href="http://grass.ibiblio.org/download/data.php">Spearfish sample dataset</a>:
+<BR>(<i>assumes you have already downloaded the dataset and put the file in
+your Cygwin home directory [aka "~"]</i>)
+
+<DD>
+<pre>
+$ cd ~
+$ mkdir grassdata/
+$ cd grassdata/
+$ tar xzf ~/spearfish_grass60data-0.3.tar.gz
+</pre>
+</DD>
+
+Then start GRASS using <tt>/home/$USER/grassdata/</tt> as your GIS data
+directory.
+
+<br><br><br>
+<hr width=600>
+<br>
+
+Installing packages by hand:<BR>
+(<i>only required if you didn't install via a GRASS mirror (with "setup.ini") from within
+the Cywin installer</i>)
+
+<P>
+The winGRASS package is just a .tar.bz2 file. It can be extracted into Cygwin's
+root directory (or use setup.ini as explained in above external notes),
 e.g.:
 
+<DD>
 <pre>
-	$ cd /
-	$ tar xzf /path/to/grass-6.2.1-1.cygwin.tar.gz
+$ cd /
+$ tar xjf /path/to/grass-6.2.1-1.cygwin.tar.bz2
 </pre>
+</DD>
 
 Everything will be /usr/local/grass-6.2.1, except for the grass62
 script which is in /usr/local/bin.
@@ -25,8 +78,9 @@
 provided by Cygwin are GDAL and Tcl/Tk. They can be downloaded
 above and they have to be extracted into Cygwin's root directory
 as well (or use setup.ini as explained in above external notes).
+<BR>
 
-<hr>
+<hr width=600>
 Please help us and report bugs:
 <a href="http://grass.itc.it/bugtracking/">Bug report form</a>
 



