.TH g.gui 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBg.gui\fR\fR  - Launches a GRASS graphical user interface (GUI) session.
.SH KEYWORDS
general, gui
.SH SYNOPSIS
\fBg.gui\fR
.br
\fBg.gui help\fR
.br
\fBg.gui\fR [\-\fBun\fR]  [\fBgui\fR=\fIstring\fR]   [\fBworkspace\fR=\fIname\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-u\fR" 4m
.br
Update default GUI setting
.IP "\fB\-n\fR" 4m
.br
Do not launch GUI after updating the default GUI setting
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBgui\fR=\fIstring\fR" 4m
.br
GUI type
.br
Default value: GRASS_GUI if defined, otherwise wxpython
.br
Options: \fIwxpython,tcltk,oldtcltk,text\fR
.br
\fBwxpython\fR: wxPython based GUI - wxGUI
.br
\fBtcltk\fR: Tcl/Tk based GUI - GIS Manager (gis.m)
.br
\fBoldtcltk\fR: Old Tcl/Tk based GUI - Display Manager (d.m)
.br
\fBtext\fR: command line interface only
.IP "\fBworkspace\fR=\fIname\fR" 4m
.br
Name of workspace file
.PP
.SH DESCRIPTION
.PP
This program allows user to start a selected graphical user interface (GUI)
from the command line prompt.
.PP
Currently three different GUIs are supported:
.RS
.IP
\fBtcltk\fR - Current Tcl/Tk based GUI aka the \fIgis.m\fR
GIS Manager
.IP
\fBoldtcltk\fR - Old Tcl/Tk based GUI aka the \fId.m\fR
Display Manager
.IP
\fBwxpython\fR - New wxPython based GUI aka
wxGUI
.RE
If the \fB-u\fR update flag is given or the \fIg.gisenv\fR
GRASS_GUI variable is missing, then the GRASS_GUI
variable is permanently changed and the selected GUI will be used
as the default UI from then on.
.SH NOTES
Valid values for GRASS_GUI are text, tcltk,
oldtcltk, and wxpython.
\fIg.gisenv\fR variables are stored in the user's home directory
in a hidden file called ".grassrc6". They are not shell environment
variables and the "rc" file is not a classic UNIX run command file,
it just contains persistent GRASS variables and is not executed.
.SH EXAMPLE
Set the command line to be the default UI:
\fC
.DS
.br
g.gui text
.br
.DE
\fR
.SH SEE ALSO
\fI
wxPython based new generation GUI,
wxGUI wiki-page
.br
Tcl/Tk based GIS Manager (gis.m),
.br
Tcl/Tk based Display Manager (d.m),
.br
GRASS variables list
\fR
.SH AUTHORS
Martin Landa, FBK-irst, Trento, Italy
.br
Hamish Bowman, Otago University, Dunedin, New Zealand (fine tuning)
.PP
\fILast changed: $Date: 2013-04-15 06:24:55 +0200 (Mon, 15 Apr 2013) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team