[GRASS-SVN] r31530 - grass/trunk/lib/init
svn_grass at osgeo.org
svn_grass at osgeo.org
Mon May 26 12:43:24 EDT 2008
Author: neteler
Date: 2008-05-26 12:43:23 -0400 (Mon, 26 May 2008)
New Revision: 31530
Added:
grass/trunk/lib/init/grass7.html
Removed:
grass/trunk/lib/init/grass6.html
Modified:
grass/trunk/lib/init/Makefile
grass/trunk/lib/init/README
grass/trunk/lib/init/grass.bat
grass/trunk/lib/init/helptext.html
grass/trunk/lib/init/init.bat
grass/trunk/lib/init/init.sh
grass/trunk/lib/init/variables.html
Log:
boosted to GRASS 7 for parallel installation
Modified: grass/trunk/lib/init/Makefile
===================================================================
--- grass/trunk/lib/init/Makefile 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/Makefile 2008-05-26 16:43:23 UTC (rev 31530)
@@ -72,7 +72,7 @@
default: $(FILES)
$(MKDIR) $(GISBASE)/docs/html
$(INSTALL_DATA) variables.html $(GISBASE)/docs/html/variables.html
- $(INSTALL_DATA) grass6.html $(GISBASE)/docs/html/grass6.html
+ $(INSTALL_DATA) grass7.html $(GISBASE)/docs/html/grass7.html
$(INSTALL_DATA) helptext.html $(GISBASE)/docs/html/helptext.html
$(INSTALL_DATA) help_loc_struct.png $(GISBASE)/docs/html/help_loc_struct.png
Modified: grass/trunk/lib/init/README
===================================================================
--- grass/trunk/lib/init/README 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/README 2008-05-26 16:43:23 UTC (rev 31530)
@@ -1,10 +1,11 @@
o GRASS text mode startup
- "grass63" starts up d.m by default (if not first time user).
- "grass63 -text" will start up in text mode.
- "grass63 -tcltk" or "grass63 -gui" will start up in tcltk mode.
+ "grass70" starts up d.m by default (if not first time user).
+ "grass70 -text" will start up in text mode.
+ "grass70 -tcltk" or "grass70 -gui" will start up in tcltk mode.
+ "grass70 -wxpython" will start up in wxpython mode.
- You can use alias "grass63" to "grass63 -text" to use text mode by default.
+ You can use alias "grass70" to "grass70 -text" to use text mode by default.
Or set env var GRASS_GUI=text.
@@ -25,18 +26,18 @@
export LOCATION_NAME=loc1
export MAPSET=map1
- grass63 - # non-interactive startup using LOCATION location
+ grass70 - # non-interactive startup using LOCATION location
ex2)
export GISDBASE=/usr/home/grass/usr/data1
export LOCATION_NAME=loc1
export MAPSET=map1
- grass63 - # non-interactive startup using
+ grass70 - # non-interactive startup using
# GISDBASE/LOCATION_NAME/MAPSET location
- Also, the first argument of grass63 can override these env vars.
+ Also, the first argument of grass70 can override these env vars.
ex3)
export LOCATION=/usr/home/grass/usr/data1/loc1/map1
@@ -44,7 +45,7 @@
export LOCATION_NAME=loc1
export MAPSET=map1
- grass63 /usr/home/grass/usr/data2/loc2-1/map1-1
+ grass70 /usr/home/grass/usr/data2/loc2-1/map1-1
# non-interactive startup using
# /usr/home/grass/usr/data2/loc2-1/map1-1 location
@@ -53,7 +54,7 @@
export LOCATION_NAME=loc1
export MAPSET=map1
- grass63 /usr/home/grass/usr/data2/loc2-1/map1-1
+ grass70 /usr/home/grass/usr/data2/loc2-1/map1-1
# non-interactive startup using
# /usr/home/grass/usr/data2/loc2-1/map1-1 location
@@ -63,7 +64,7 @@
export LOCATION_NAME=loc1
export MAPSET=map1
- grass63 map1-1 # non-interactive startup using
+ grass70 map1-1 # non-interactive startup using
# GISDBASE/LOCATION_NAME/map1-1 location
ex6)
@@ -72,7 +73,7 @@
export LOCATION_NAME=loc1
export MAPSET=map1
- grass63 loc2-1/map1-1
+ grass70 loc2-1/map1-1
# non-interactive startup using
# GISDBASE/loc2-1/map1-1 location
Modified: grass/trunk/lib/init/grass.bat
===================================================================
--- grass/trunk/lib/init/grass.bat 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/grass.bat 2008-05-26 16:43:23 UTC (rev 31530)
@@ -8,7 +8,7 @@
rem *******Environment variables***********
rem Uncomment and set the following values if they differ from the indicated default
-rem Directory where your .grassrc6 file will be stored
+rem Directory where your .grassrc7 file will be stored
rem set HOME=%USERPROFILE%
rem Name of the wish (Tk) executable
Deleted: grass/trunk/lib/init/grass6.html
===================================================================
--- grass/trunk/lib/init/grass6.html 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/grass6.html 2008-05-26 16:43:23 UTC (rev 31530)
@@ -1,373 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
- <TITLE>GRASS 6</TITLE>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <link rel="stylesheet" href="grassdocs.css" type="text/css">
-</head>
-
-<body bgcolor="white">
-
-<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
-
-<H2>NAME</H2>
-
-<EM><B>grass63</B></EM> - The GRASS startup program<BR>
-
-<H2>SYNOPSIS</H2>
-
-<B>grass63</B> [<B>-</B>] [<B>-v</B>] [<B>-h | -help | --help</B>]
- [<B>-text | -gui | -tcltk | -wx]</B>]
- [[[<B><GISDBASE>/</B>]<B><LOCATION_NAME>/</B>]
- <B><MAPSET></B>]
-
-<BR>
-
-<H2>DESCRIPTION</H2>
-
-<P>
-This program is used to start GRASS. 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 the user
-with a method to indicate the desired user interface, as well as the desired
-mapset to work on.
-
-<H2>FEATURES</H2>
-
-<P>
-The GRASS program will save both the desired user interface and mapset.
-Thus, the next time the user runs GRASS, typing <EM>grass63</EM> (without any
-options) will start grass with the previous settings for the user interface
-and mapset.
-
-<P>
-If you specify a graphical user interface (Tcl/Tk or wxPython), the <EM>grass63</EM>
-program will try to verify that the system you specified exists and that you
-can access it successfully. If any of these checks fail, then <EM>grass63</EM>
-will automatically switch back to the text user interface mode.
-
-<H2>OPTIONS</H2>
-
-<P>
-All command line options are optional.
-
-<H3>Flags:</H3>
-
-<DL>
-
-<DT><B>-</B>
-<DD> Tries to start GRASS using location environment variables (see below)
-
-<DT><B>-h</B> <B>-help</B> <B>--help</B>
-<DD> Prints a brief usage message
-
-<DT><B>-text</B>
-<DD> Indicates that the text based user interface should be used
-
-<DT><B>-gui</B> (or <B>-tcltk</B>)
-<DD> Indicates that the Tcl/Tk based graphical user interface should be used
-
-<DT><B>-wx</B>
-<DD> Indicates that the new Python based graphical user interface should be used (wxgrass)
-
-<DT><B>-v</B> <B>--version</B>
-<DD> Prints the version for GRASS
-
-</DL>
-
-<H3>Parameters:</H3>
-
-<DL>
-<DT><B>GISDBASE</B>
-<DD> Initial database directory which should be a fully qualified path
- (e.g., /usr/local/share/grassdata)
-
-<DT><B>LOCATION_NAME</B>
-<DD> Initial location directory which is a subdirectory of GISDBASE
-
-<DT><B>MAPSET</B>
-<DD> Initial mapset directory which is a subdirectory of LOCATION_NAME
-
-<DT><B>Note</B>
-<DD> You must specify one of the following<BR><BR>
- MAPSET<BR>
- LOCATION_NAME/MAPSET<BR>
- GISDBASE/LOCATION_NAME/MAPSET<BR>
-
-</DL>
-
-<H2>ENVIRONMENT VARIABLES</H2>
-
-<H3>User Interface Environment Variable</H3>
-
-<P>
-The <EM>grass63</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>grass63</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".
-
-<P>
-There is an order of precedence in the way <EM>grass63</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
-
-</DL>
-
-<H3>Tcl/Tk Environment Variables</H3>
-
-<P>
-If you choose to use the Tcl/Tk graphical user interface, then the following
-environment variables can be used to override your system default tclsh and
-wish commands. See the section immediately following the variable descriptions
-for an example.
-
-<DL>
-
-<DT><B>GRASS_TCLSH</B>
-<DD> Command to use to override tclsh
-
-<DT><B>GRASS_WISH</B>
-<DD> Command to use to override wish
-
-<DT><B>GRASS_PYTHON</B>
-<DD> Command to use to override python
-
-</DL>
-
-<H4>Example Use of GRASS Tcl/Tk Environment Variables</H4>
-
-<P>
-Suppose your system has Tcl/Tk 8.0 installed and you install your personal
-version of Tcl/Tk 8.3 binaries installed under $HOME/bin. You can use the
-above variables to have GRASS use the Tcl/Tk 8.3 binaries instead.
-
-<P>
-GRASS_TCLSH = $HOME/bin/tclsh8.3<BR>
-GRASS_WISH = $HOME/bin/wish8.3
-
-<H3>Addon path to extra local GRASS modules</H3>
-
-This environment variables allows to extend the GRASS paths to locally
-developed/installed modules which are not distributes through the standard
-release of GRASS.
-<P>
-GRASS_ADDON_PATH=/usr/mytools<BR>
-GRASS_ADDON_PATH=/usr/mytools:/usr/local/othertools
-
-<P>
-In this example above path(s) would be added to the standard GRASS path
-environment.
-
-
-<H3>Location Environment Variables</H3>
-
-<P>
-The Synopsis and Options sections above describe options that can be used to
-set the location and mapset that GRASS will use. These values can also be set
-with environment variables. However, specifying the location and mapset
-variables on the command line will override these environment variables. The
-available variables are as follows:
-
-<DL>
-
-<DT><B>LOCATION</B>
-<DD> A fully qualified path to a mapset
- (eg /usr/local/share/grassdata/spearfish60/PERMANENT). This environment variable
- overrides the GISDBASE, LOCATION_NAME, and MAPSET variables.
-
-<DT><B>GISDBASE</B>
-<DD> Initial database directory which should be a fully qualified path
- (eg /usr/local/share/grassdata)
-
-<DT><B>LOCATION_NAME</B>
-<DD> Initial location directory which is a subdirectory of GISDBASE
-
-<DT><B>MAPSET</B>
-<DD> Initial mapset directory which is a subdirectory of LOCATION_NAME
-
-</DL>
-
-<P>
-There are a variety of ways in which these variables can be used to specify
-the mapset to use. The following are some possible examples.
-
-<DL>
-
-<DT><B>Example 1</B>
-<DD> The environment variables are defined as follows:<BR><BR>
-
- LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
- GISDBASE = /usr/local/share/grassdata<BR>
- LOCATION_NAME = spearfish60<BR>
- MAPSET = PERMANENT<BR><BR>
-
- Start GRASS with the following command:<BR><BR>
-
- grass63 -<BR><BR>
-
- GRASS will start with the mapset defined by LOCATION since the LOCATION
- variable overrides the other variables.<BR><BR>
-
-<DT><B>Example 2</B>
-<DD> The environment variables are defined as follows:<BR><BR>
-
- GISDBASE = /usr/local/share/grassdata<BR>
- LOCATION_NAME = spearfish60<BR>
- MAPSET = PERMANENT<BR><BR>
-
- Start GRASS with the following command:<BR><BR>
-
- grass63 -<BR><BR>
-
- GRASS will start with the mapset defined by
- GISDBASE/LOCATION_NAME/MAPSET.<BR><BR>
-
-<DT><B>Example 3</B>
-<DD> The environment variables are defined as follows:<BR><BR>
-
- LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
- GISDBASE = /usr/local/share/grassdata<BR>
- LOCATION_NAME = spearfish60<BR>
- MAPSET = PERMANENT<BR><BR>
-
- Start GRASS with the following command:<BR><BR>
-
- grass63 /usr/home/grass/data/thailand/forests<BR><BR>
-
- GRASS will start with the mapset /home/grass/data/thailand/forests which
- overrides the environment variables.<BR><BR>
-
-<DT><B>Example 4</B>
-<DD> The environment variables are defined as follows:<BR><BR>
-
- LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
- GISDBASE = /usr/local/share/grassdata<BR>
- LOCATION_NAME = spearfish60<BR>
- MAPSET = PERMANENT<BR><BR>
-
- Start GRASS with the following command:<BR><BR>
-
- grass63 swamps<BR><BR>
-
- GRASS will start with the mapset defined by GISDBASE/LOCATION_NAME/swamps
- since the command line argument for the mapset overrides the environment
- variable MAPSET.<BR><BR>
-
-<DT><B>Example 5</B>
-<DD> The environment variables are defined as follows:<BR><BR>
-
- LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
- GISDBASE = /usr/local/share/grassdata<BR>
- LOCATION_NAME = spearfish60<BR>
- MAPSET = PERMANENT<BR><BR>
-
- Start GRASS with the following command:<BR><BR>
-
- grass63 thailand/forests<BR><BR>
-
- GRASS will start with the mapset defined by GISDBASE/thailand/forests
- since the command line arguments for the location and mapset overrides
- the environment variables LOCATION_NAME and MAPSET.<BR><BR>
-
-</DL>
-
-<H3>Note</H3>
-
-<P>
-Note that you will need to set these variables using the appropriate method
-required for the UNIX shell that you use.
-
-<H2>EXAMPLES</H2>
-
-<P>
-The following are some examples of how you could start GRASS
-
-<DL>
-
-<DT><B>grass63</B>
-<DD> Start GRASS using the default user interface. The user will be prompted
- to choose the appropriate location and mapset.
-
-<DT><B>grass63 -gui</B>
-<DD> Start GRASS using the Tcl/Tk based user interface. The user will be
- prompted to choose the appropriate location and mapset.
-
-<DT><B>grass63 -text</B>
-<DD> Start GRASS using the text based user interface. The user will be
- prompted to choose the appropriate location and mapset.
-
-<DT><B>grass63 -gui -</B>
-<DD> Start GRASS using the Tcl/Tk based user interface and try to obtain
- the location and mapset from environment variables.
-
-<DT><B>Other examples</B>
-<DD> See the <B>Location Environment Variables</B> section for further
- examples.
-
-</DL>
-
-<H2>BUGS AND CAVEAT</H2>
-
-<P>
-If you start GRASS using the Tcl/Tk interface you must have a <EM>wish</EM>
-command in your $PATH variable. That is, the command must be named
-<EM>wish</EM> and not something like <EM>wish8.3</EM>. By default, a Tcl/Tk
-installation does not create a <EM>wish</EM> command. Thus, the system
-administrator must create an appropriate link to the actual wish program.
-
-<P>
-For example, suppose Tcl/Tk 8.3 programs are installed in /usr/local/bin. Then
-the system administrator should go to the /usr/local/bin directory and run the
-commands <EM>ln -s wish8.3 wish</EM> and <EM>ln -s tclsh8.3 tclsh</EM> to
-properly install Tcl/Tk for use with GRASS.
-
-<P>
-Furthermore, if you have more than one version of Tcl/Tk installed, make sure
-that the version you want to use with GRASS is the first version found in
-your $PATH variable. GRASS searches your $PATH variable until it finds the
-first version of <EM>wish</EM>.
-
-<H2>FILES</H2>
-
-<EM>$UNIX_BIN/grass63</EM> - GRASS startup program (Linux, MacOSX etc.)<BR><BR>
-<EM>$WINDOWS_BIN/grass63.bat</EM> - GRASS startup program (MS-Windows)<BR><BR>
-<EM>$GISBASE/etc/Init.sh</EM> - GRASS initialization script called by
- <EM>grass63</EM><BR><BR>
-<EM>$GISBASE/etc/gis_set.tcl</EM> - Tcl/Tk script to set the
- location and mapset to use. Called by <EM>Init.sh</EM><BR><BR>
-
-<H2>SEE ALSO</H2>
-
-List of <a href=variables.html>implemented GRASS environment variables</a>.
-<p>
-<a href="http://grass.osgeo.org">GRASS Web site</a>
-<p>
-<a href="http://download.osgeo.org/grass/grass6_progman/">GRASS 6 Programmer's Manual</a>
-
-<H2>AUTHORS (of this page)</H2>
-
-Justin Hickey<br>
-Markus Neteler
-
-<p><i>Last changed: $Date$</i>
-<HR>
-<P><a href=index.html>Help Index</a>
-
-</body>
-</html>
Copied: grass/trunk/lib/init/grass7.html (from rev 31487, grass/trunk/lib/init/grass6.html)
===================================================================
--- grass/trunk/lib/init/grass7.html (rev 0)
+++ grass/trunk/lib/init/grass7.html 2008-05-26 16:43:23 UTC (rev 31530)
@@ -0,0 +1,373 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+ <TITLE>GRASS 7</TITLE>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <link rel="stylesheet" href="grassdocs.css" type="text/css">
+</head>
+
+<body bgcolor="white">
+
+<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
+
+<H2>NAME</H2>
+
+<EM><B>grass70</B></EM> - The GRASS startup program<BR>
+
+<H2>SYNOPSIS</H2>
+
+<B>grass70</B> [<B>-</B>] [<B>-v</B>] [<B>-h | -help | --help</B>]
+ [<B>-text | -gui | -tcltk | -wx]</B>]
+ [[[<B><GISDBASE>/</B>]<B><LOCATION_NAME>/</B>]
+ <B><MAPSET></B>]
+
+<BR>
+
+<H2>DESCRIPTION</H2>
+
+<P>
+This program is used to start GRASS. 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 the user
+with a method to indicate the desired user interface, as well as the desired
+mapset to work on.
+
+<H2>FEATURES</H2>
+
+<P>
+The GRASS program will save both the desired user interface and mapset.
+Thus, the next time the user runs GRASS, typing <EM>grass70</EM> (without any
+options) will start grass with the previous settings for the user interface
+and mapset.
+
+<P>
+If you specify a graphical user interface (Tcl/Tk or wxPython), the <EM>grass70</EM>
+program will try to verify that the system you specified exists and that you
+can access it successfully. If any of these checks fail, then <EM>grass70</EM>
+will automatically switch back to the text user interface mode.
+
+<H2>OPTIONS</H2>
+
+<P>
+All command line options are optional.
+
+<H3>Flags:</H3>
+
+<DL>
+
+<DT><B>-</B>
+<DD> Tries to start GRASS using location environment variables (see below)
+
+<DT><B>-h</B> <B>-help</B> <B>--help</B>
+<DD> Prints a brief usage message
+
+<DT><B>-text</B>
+<DD> Indicates that the text based user interface should be used
+
+<DT><B>-gui</B> (or <B>-tcltk</B>)
+<DD> Indicates that the Tcl/Tk based graphical user interface should be used
+
+<DT><B>-wx</B>
+<DD> Indicates that the new Python based graphical user interface should be used (wxgrass)
+
+<DT><B>-v</B> <B>--version</B>
+<DD> Prints the version for GRASS
+
+</DL>
+
+<H3>Parameters:</H3>
+
+<DL>
+<DT><B>GISDBASE</B>
+<DD> Initial database directory which should be a fully qualified path
+ (e.g., /usr/local/share/grassdata)
+
+<DT><B>LOCATION_NAME</B>
+<DD> Initial location directory which is a subdirectory of GISDBASE
+
+<DT><B>MAPSET</B>
+<DD> Initial mapset directory which is a subdirectory of LOCATION_NAME
+
+<DT><B>Note</B>
+<DD> You must specify one of the following<BR><BR>
+ MAPSET<BR>
+ LOCATION_NAME/MAPSET<BR>
+ GISDBASE/LOCATION_NAME/MAPSET<BR>
+
+</DL>
+
+<H2>ENVIRONMENT VARIABLES</H2>
+
+<H3>User Interface Environment Variable</H3>
+
+<P>
+The <EM>grass70</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>grass70</EM> is run, then
+it will be created and then saved in the $HOME/.grassrc7 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".
+
+<P>
+There is an order of precedence in the way <EM>grass70</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/.grassrc7 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/.grassrc7<BR>
+ Default value - currently gis.m
+
+</DL>
+
+<H3>Tcl/Tk Environment Variables</H3>
+
+<P>
+If you choose to use the Tcl/Tk graphical user interface, then the following
+environment variables can be used to override your system default tclsh and
+wish commands. See the section immediately following the variable descriptions
+for an example.
+
+<DL>
+
+<DT><B>GRASS_TCLSH</B>
+<DD> Command to use to override tclsh
+
+<DT><B>GRASS_WISH</B>
+<DD> Command to use to override wish
+
+<DT><B>GRASS_PYTHON</B>
+<DD> Command to use to override python
+
+</DL>
+
+<H4>Example Use of GRASS Tcl/Tk Environment Variables</H4>
+
+<P>
+Suppose your system has Tcl/Tk 8.0 installed and you install your personal
+version of Tcl/Tk 8.3 binaries installed under $HOME/bin. You can use the
+above variables to have GRASS use the Tcl/Tk 8.3 binaries instead.
+
+<P>
+GRASS_TCLSH = $HOME/bin/tclsh8.3<BR>
+GRASS_WISH = $HOME/bin/wish8.3
+
+<H3>Addon path to extra local GRASS modules</H3>
+
+This environment variables allows to extend the GRASS paths to locally
+developed/installed modules which are not distributes through the standard
+release of GRASS.
+<P>
+GRASS_ADDON_PATH=/usr/mytools<BR>
+GRASS_ADDON_PATH=/usr/mytools:/usr/local/othertools
+
+<P>
+In this example above path(s) would be added to the standard GRASS path
+environment.
+
+
+<H3>Location Environment Variables</H3>
+
+<P>
+The Synopsis and Options sections above describe options that can be used to
+set the location and mapset that GRASS will use. These values can also be set
+with environment variables. However, specifying the location and mapset
+variables on the command line will override these environment variables. The
+available variables are as follows:
+
+<DL>
+
+<DT><B>LOCATION</B>
+<DD> A fully qualified path to a mapset
+ (eg /usr/local/share/grassdata/spearfish60/PERMANENT). This environment variable
+ overrides the GISDBASE, LOCATION_NAME, and MAPSET variables.
+
+<DT><B>GISDBASE</B>
+<DD> Initial database directory which should be a fully qualified path
+ (eg /usr/local/share/grassdata)
+
+<DT><B>LOCATION_NAME</B>
+<DD> Initial location directory which is a subdirectory of GISDBASE
+
+<DT><B>MAPSET</B>
+<DD> Initial mapset directory which is a subdirectory of LOCATION_NAME
+
+</DL>
+
+<P>
+There are a variety of ways in which these variables can be used to specify
+the mapset to use. The following are some possible examples.
+
+<DL>
+
+<DT><B>Example 1</B>
+<DD> The environment variables are defined as follows:<BR><BR>
+
+ LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
+ GISDBASE = /usr/local/share/grassdata<BR>
+ LOCATION_NAME = spearfish60<BR>
+ MAPSET = PERMANENT<BR><BR>
+
+ Start GRASS with the following command:<BR><BR>
+
+ grass70 -<BR><BR>
+
+ GRASS will start with the mapset defined by LOCATION since the LOCATION
+ variable overrides the other variables.<BR><BR>
+
+<DT><B>Example 2</B>
+<DD> The environment variables are defined as follows:<BR><BR>
+
+ GISDBASE = /usr/local/share/grassdata<BR>
+ LOCATION_NAME = spearfish60<BR>
+ MAPSET = PERMANENT<BR><BR>
+
+ Start GRASS with the following command:<BR><BR>
+
+ grass70 -<BR><BR>
+
+ GRASS will start with the mapset defined by
+ GISDBASE/LOCATION_NAME/MAPSET.<BR><BR>
+
+<DT><B>Example 3</B>
+<DD> The environment variables are defined as follows:<BR><BR>
+
+ LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
+ GISDBASE = /usr/local/share/grassdata<BR>
+ LOCATION_NAME = spearfish60<BR>
+ MAPSET = PERMANENT<BR><BR>
+
+ Start GRASS with the following command:<BR><BR>
+
+ grass70 /usr/home/grass/data/thailand/forests<BR><BR>
+
+ GRASS will start with the mapset /home/grass/data/thailand/forests which
+ overrides the environment variables.<BR><BR>
+
+<DT><B>Example 4</B>
+<DD> The environment variables are defined as follows:<BR><BR>
+
+ LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
+ GISDBASE = /usr/local/share/grassdata<BR>
+ LOCATION_NAME = spearfish60<BR>
+ MAPSET = PERMANENT<BR><BR>
+
+ Start GRASS with the following command:<BR><BR>
+
+ grass70 swamps<BR><BR>
+
+ GRASS will start with the mapset defined by GISDBASE/LOCATION_NAME/swamps
+ since the command line argument for the mapset overrides the environment
+ variable MAPSET.<BR><BR>
+
+<DT><B>Example 5</B>
+<DD> The environment variables are defined as follows:<BR><BR>
+
+ LOCATION = /usr/local/share/grassdata/spearfish60/PERMANENT<BR>
+ GISDBASE = /usr/local/share/grassdata<BR>
+ LOCATION_NAME = spearfish60<BR>
+ MAPSET = PERMANENT<BR><BR>
+
+ Start GRASS with the following command:<BR><BR>
+
+ grass70 thailand/forests<BR><BR>
+
+ GRASS will start with the mapset defined by GISDBASE/thailand/forests
+ since the command line arguments for the location and mapset overrides
+ the environment variables LOCATION_NAME and MAPSET.<BR><BR>
+
+</DL>
+
+<H3>Note</H3>
+
+<P>
+Note that you will need to set these variables using the appropriate method
+required for the UNIX shell that you use.
+
+<H2>EXAMPLES</H2>
+
+<P>
+The following are some examples of how you could start GRASS
+
+<DL>
+
+<DT><B>grass70</B>
+<DD> Start GRASS using the default user interface. The user will be prompted
+ to choose the appropriate location and mapset.
+
+<DT><B>grass70 -gui</B>
+<DD> Start GRASS using the Tcl/Tk based user interface. The user will be
+ prompted to choose the appropriate location and mapset.
+
+<DT><B>grass70 -text</B>
+<DD> Start GRASS using the text based user interface. The user will be
+ prompted to choose the appropriate location and mapset.
+
+<DT><B>grass70 -gui -</B>
+<DD> Start GRASS using the Tcl/Tk based user interface and try to obtain
+ the location and mapset from environment variables.
+
+<DT><B>Other examples</B>
+<DD> See the <B>Location Environment Variables</B> section for further
+ examples.
+
+</DL>
+
+<H2>BUGS AND CAVEAT</H2>
+
+<P>
+If you start GRASS using the Tcl/Tk interface you must have a <EM>wish</EM>
+command in your $PATH variable. That is, the command must be named
+<EM>wish</EM> and not something like <EM>wish8.3</EM>. By default, a Tcl/Tk
+installation does not create a <EM>wish</EM> command. Thus, the system
+administrator must create an appropriate link to the actual wish program.
+
+<P>
+For example, suppose Tcl/Tk 8.3 programs are installed in /usr/local/bin. Then
+the system administrator should go to the /usr/local/bin directory and run the
+commands <EM>ln -s wish8.3 wish</EM> and <EM>ln -s tclsh8.3 tclsh</EM> to
+properly install Tcl/Tk for use with GRASS.
+
+<P>
+Furthermore, if you have more than one version of Tcl/Tk installed, make sure
+that the version you want to use with GRASS is the first version found in
+your $PATH variable. GRASS searches your $PATH variable until it finds the
+first version of <EM>wish</EM>.
+
+<H2>FILES</H2>
+
+<EM>$UNIX_BIN/grass70</EM> - GRASS startup program (Linux, MacOSX etc.)<BR><BR>
+<EM>$WINDOWS_BIN/grass70.bat</EM> - GRASS startup program (MS-Windows)<BR><BR>
+<EM>$GISBASE/etc/Init.sh</EM> - GRASS initialization script called by
+ <EM>grass70</EM><BR><BR>
+<EM>$GISBASE/etc/gis_set.tcl</EM> - Tcl/Tk script to set the
+ location and mapset to use. Called by <EM>Init.sh</EM><BR><BR>
+
+<H2>SEE ALSO</H2>
+
+List of <a href=variables.html>implemented GRASS environment variables</a>.
+<p>
+<a href="http://grass.osgeo.org">GRASS Web site</a>
+<p>
+<a href="http://download.osgeo.org/grass/grass6_progman/">GRASS 6 Programmer's Manual</a>
+
+<H2>AUTHORS (of this page)</H2>
+
+Justin Hickey<br>
+Markus Neteler
+
+<p><i>Last changed: $Date$</i>
+<HR>
+<P><a href=index.html>Help Index</a>
+
+</body>
+</html>
Modified: grass/trunk/lib/init/helptext.html
===================================================================
--- grass/trunk/lib/init/helptext.html 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/helptext.html 2008-05-26 16:43:23 UTC (rev 31530)
@@ -174,9 +174,9 @@
<H2>See also</H2>
-<a href="grass6.html">GRASS 6 launch manual page</a>
+<a href="grass7.html">GRASS 7 launch manual page</a>
<br>
-<a href="index.html">GRASS 6 Reference Manual</a>
+<a href="index.html">GRASS 7 Reference Manual</a>
<p><i>Last changed: $Date$</i>
<HR>
Modified: grass/trunk/lib/init/init.bat
===================================================================
--- grass/trunk/lib/init/init.bat 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/init.bat 2008-05-26 16:43:23 UTC (rev 31530)
@@ -14,7 +14,7 @@
rem and does not expect or provide an interactive terminal
rem running in addition to the GUI display.
rem
-rem COPYRIGHT: (C) 2006 by the GRASS Development Team
+rem COPYRIGHT: (C) 2006, 2008 by the GRASS Development Team
rem
rem This program is free software under the GNU General Public
rem License (>=v2). Read the file COPYING that comes with GRASS
@@ -30,7 +30,7 @@
set GRASS_VERSION=GRASS_VERSION_NUMBER
if "%HOME%"=="" set HOME=%USERPROFILE%
-set WINGISRC=%HOME%\.grassrc6
+set WINGISRC=%HOME%\.grassrc7
rem Make sure %GISRC% is set so g.dirseps will work
rem (not actually used)
set GISRC=junk
Modified: grass/trunk/lib/init/init.sh
===================================================================
--- grass/trunk/lib/init/init.sh 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/init.sh 2008-05-26 16:43:23 UTC (rev 31530)
@@ -159,7 +159,7 @@
export GIS_LOCK
# Set the global grassrc file
-GISRCRC="$HOME/.grassrc6"
+GISRCRC="$HOME/.grassrc7"
# Set the session grassrc file
if [ "$MINGW" ] ; then
@@ -187,8 +187,8 @@
## use TMPDIR if it exists, otherwise /tmp
#tmp=${TMPDIR-/tmp}
-#tmp="$tmp/grass6-$USER-$GIS_LOCK"
-tmp=/tmp/grass6-$USER-$GIS_LOCK
+#tmp="$tmp/grass7-$USER-$GIS_LOCK"
+tmp=/tmp/grass7-$USER-$GIS_LOCK
(umask 077 && mkdir "$tmp") || {
echo "Cannot create temporary directory! Exiting." 1>&2
exit 1
Modified: grass/trunk/lib/init/variables.html
===================================================================
--- grass/trunk/lib/init/variables.html 2008-05-26 14:43:08 UTC (rev 31529)
+++ grass/trunk/lib/init/variables.html 2008-05-26 16:43:23 UTC (rev 31530)
@@ -75,7 +75,7 @@
<h2>Setting GRASS variables</h2>
Use <em><a href="g.gisenv.html">g.gisenv</a></em> within GRASS. This permanently
-predefines GRASS variables in the <tt>.grassrc6</tt> file.
+predefines GRASS variables in the <tt>.grassrc7</tt> file.
<br><br>
Usage:
<div class="code"><pre>
@@ -107,7 +107,7 @@
<br>
<dt>GISRC</dt>
- <dd>name of <tt>.grassrc6</tt> file. Defines the system wide value
+ <dd>name of <tt>.grassrc7</tt> file. Defines the system wide value
while in a GRASS session.</dd>
<br>
@@ -559,11 +559,11 @@
<h2>GRASS-related Files</h2>
<dl>
- <dt>$HOME/.grassrc6</dt>
+ <dt>$HOME/.grassrc7</dt>
<dd>stores the GRASS variables (but not environment variables)</dd>
<br>
- <dt>$HOME/.grasslogin6</dt>
+ <dt>$HOME/.grasslogin7</dt>
<dd>stores the DBMI passwords in this hidden file.
Only the file owner can access this file.</dd>
More information about the grass-commit
mailing list