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

[grass at intevation.de]

Author: hamish

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

Modified Files:
	README.html 
Log Message:
more help


Index: README.html
===================================================================
RCS file: /grassrepository/web/grass62/binary/mswindows/README.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- README.html	15 Feb 2007 01:44:31 -0000	1.5
+++ README.html	15 Feb 2007 07:54:48 -0000	1.6
@@ -3,16 +3,21 @@
 
 <h3>Installation instructions for GRASS on MS Windows with Cygwin (winGRASS)</h3>
 
-Prerequisites:
+<h4>Prerequisites:</h4>
 <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
+The next version 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
+source code, this is a non-trivial task, so bear with us and help test
 if you can!
 <P>
+Due to the Cygwin dependency GRASS 6.2 can not be installed directly.
+Fortunately the Cygwin setup program is fairly easy to use, and both
+it and GRASS can be installed by following a few simple instructions.
+<BR>(Don't panic!)
+<P>
 For installation of Cygwin, see
 <a href="http://geni.ath.cx/grass.html#toc5">http://geni.ath.cx/grass.html#toc5</a>.
 
@@ -26,18 +31,20 @@
 <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>
+At the xterm prompt type "<tt>grass62</tt>". To start GRASS from an icon on
+the Desktop, see below.
+
+<br><br>
+<hr>
 <br>
 
-Installing data:
-<P>
+<h4>Installing data:</h4>
+
 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>)
+your Cygwin home directory [aka "~" or c:\cygwin\home\$USER\]</i>)
 
 <DD>
 <pre>
@@ -51,13 +58,57 @@
 Then start GRASS using <tt>/home/$USER/grassdata/</tt> as your GIS data
 directory.
 
-<br><br><br>
-<hr width=600>
+<br><br>
+<hr>
+<BR>
+
+<h4>Starting Cygwin GRASS from an icon on the desktop:</h4>
+
+copy c:\cygwin.bat to c:\cygwin_grass.bat
+<P>
+edit c:\cygwin_grass.bat so it looks like this:
+  (add "set GRASS_AUTOSTART=1" and "-c startx")
+<BR>
+<DD><PRE>
+ at echo off
+
+C:
+chdir C:\cygwin\bin
+
+set GRASS_AUTOSTART=1
+bash --login -i -c startx
+</PRE></DD>
+<BR>
+<P>
+Next in your cygwin home dir add this to the end of ~/.bashrc :
+<DD><PRE>
+#################
+# Start GRASS
+if [ -n "$DISPLAY" ] && [ -n "$GRASS_AUTOSTART" ] ; then
+   unset GRASS_AUTOSTART
+   grass62
+fi
+#################
+</PRE></DD>
+<BR>
+<P>
+Finally make a shortcut from cygwin_grass.bat to the Desktop.
+<P>
+<a href="http://freegis.org/cgi-bin/viewcvs.cgi/*checkout*/grass6/lib/init/grass.ico?rev=HEAD">
+Download the GRASS icon</a> and select it by right-clicking on the desktop
+shortcut and in "Preferences" click on Change Icon.
+<P>
+done!
+
+<br><br>
+<hr>
 <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>)
+
+<h4>Installing packages by hand:</h4>
+
+(<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
@@ -78,11 +129,14 @@
 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 width=600>
+<BR><BR>
+<hr>
+
 Please help us and report bugs:
 <a href="http://grass.itc.it/bugtracking/">Bug report form</a>
-
+<P>
+Last changed: $Date$
+</P>
 </BODY>
 </HTML>