[GRASS-SVN] r33181 - grass/branches/develbranch_6/lib/init
svn_grass at osgeo.org
svn_grass at osgeo.org
Sun Aug 31 22:52:52 EDT 2008
Author: hamish
Date: 2008-08-31 22:52:52 -0400 (Sun, 31 Aug 2008)
New Revision: 33181
Modified:
grass/branches/develbranch_6/lib/init/grass6.html
Log:
more cleanup and fixes
Modified: grass/branches/develbranch_6/lib/init/grass6.html
===================================================================
--- grass/branches/develbranch_6/lib/init/grass6.html 2008-09-01 02:51:44 UTC (rev 33180)
+++ grass/branches/develbranch_6/lib/init/grass6.html 2008-09-01 02:52:52 UTC (rev 33181)
@@ -17,7 +17,7 @@
<H2>SYNOPSIS</H2>
<B>grass64</B> [<B>-</B>] [<B>-v</B>] [<B>-h | -help | --help</B>]
- [<B>-text | -gui | -tcltk | -wx]</B>]
+ [<B>-text | -gui | -tcltk | -wxpython]</B>]
[[[<B><GISDBASE>/</B>]<B><LOCATION_NAME>/</B>]
<B><MAPSET></B>]
@@ -26,7 +26,7 @@
<H2>DESCRIPTION</H2>
<P>
-This program is used to launch GRASS GIS. It will parse the command line
+This command is used to launch GRASS GIS. It will parse the command line
arguments and then initialize GRASS for the user. Since GRASS programs
require a specific environment, this program must be called before any other
GRASS program can run. The command line arguments are optional and provide
@@ -37,10 +37,10 @@
<H2>FEATURES</H2>
<P>
-The GRASS program will remember both the desired user interface and mapset.
-Thus, the next time the user runs GRASS, typing <EM>grass64</EM> (without any
-options) will start GRASS with the previous settings for the user interface
-and mapset.
+The <em>grass64</em> startup program will remember both the desired user
+interface and mapset. Thus, the next time the user runs GRASS, typing
+<EM>grass64</EM> (without any options) will start GRASS with the previous
+settings for the user interface and mapset selected.
<P>
If you specify a graphical user interface (Tcl/Tk or wxPython) the <EM>grass64</EM>
@@ -70,11 +70,11 @@
<DT><B>-gui</B> (or <B>-tcltk</B>)
<DD> Indicates that the old Tcl/Tk based graphical user interface should be used
-<DT><B>-wx</B>
+<DT><B>-wxpython</B>
<DD> Indicates that the new Python based graphical user interface should be used
<DT><B>-v</B> <B>--version</B>
-<DD> Prints the version for GRASS
+<DD> Prints the version of GRASS and exits
</DL>
@@ -102,36 +102,45 @@
</DL>
+
<H2>ENVIRONMENT VARIABLES</H2>
+A number of environment variables are available at GRASS startup to assist
+with automation and customization. Most users will not need to bother with
+these.
+
+<P>
+In addition to these shell environment variables GRASS maintains a number of
+GIS environment variables in the <tt>$HOME/.grassrc6</tt> file. User changes
+to this file will be read during the next startup of GRASS. If this file
+becomes corrupted the user may edit it by hand or remove it to start afresh.
+See the list of <a href=variables.html>implemented GRASS variables</a> for
+more information.
+The rest of this help page will only consider shell environment variables.
+
+
<H3>User Interface Environment Variable</H3>
<P>
The <EM>grass64</EM> program will check for the existence of an environment
variable called GRASS_GUI which indicates the type of user interface for
GRASS to use. If this variable is not set when <EM>grass64</EM> is run, then
-it will be created and then saved in the $HOME/.grassrc6 file for the next
-time GRASS is run. In addition to "text", "tcltk" or "wx", the GRASS_GUI variable
-can be set to the name of the GUI to use, for example "gis.m" or "wxgrass".
+it will be created and then saved in the <tt>$HOME/.grassrc6</tt> file for
+the next time GRASS is run. In addition to "text", "tcltk" or "wxpython",
+the GRASS_GUI variable can be set to the name of the Tcl/Tk GUI to use, for
+example "gis.m" or "d.m".
<P>
There is an order of precedence in the way <EM>grass64</EM> determines the user
interface to use. The following is the hierarchy from highest precedence to
lowest.
-<P>
-The user may add own environment variable settings to $HOME/.grassrc6 file
-which are used during next startup of GRASS (list of
-<a href=variables.html>implemented environment variables</a>).
-
<DL>
-
-<DT><B>Interface precedence</B>
-<DD>Command line argument<BR>
- Environment variable GRASS_GUI<BR>
- Value set in $HOME/.grassrc6<BR>
- Default value - currently gis.m
-
+ <DT><B>Interface precedence</B>
+ <DD>• Command line argument<BR>
+ • Environment variable GRASS_GUI<BR>
+ • Value set in <tt>$HOME/.grassrc6</tt><BR>
+ • Default value - currently gis.m
</DL>
<H3>Tcl/Tk and Python Environment Variables</H3>
@@ -191,6 +200,12 @@
environment.
+<H3>HTML browser variable</H3>
+
+The GRASS_HTML_BROWSER environment variable allows the user to set the HTML
+web browser to use for dispalying help pages.
+
+
<H3>Location Environment Variables</H3>
<P>
@@ -355,9 +370,8 @@
</DL>
-<H2>BUGS AND CAVEAT</H2>
+<H2>CAVEAT</H2>
-<P>
If you start GRASS using the Tcl/Tk interface you must have a <tt>wish</tt>
command in your $PATH variable. That is, the command must be named
<tt>wish</tt> and not something like <tt>wish8.3</tt>. By default, some Tcl/Tk
@@ -377,6 +391,7 @@
your <tt>$PATH</tt> variable. GRASS searches your <tt>$PATH</tt> variable
until it finds the first version of <tt>wish</tt>.
+
<H2>FILES</H2>
<EM>$UNIX_BIN/grass64</EM> - GRASS startup program (Linux, MacOSX etc.)<BR>
@@ -403,7 +418,8 @@
<p>
<i>Last changed: $Date$</i>
<HR>
-<P><a href=index.html>Help Index</a>
+<P>
+<a href=index.html>Help Index</a>
</body>
</html>
More information about the grass-commit
mailing list