← Back to branch summary

~ubuntu-branches/ubuntu/maverick/gnome-session/maverick

« back to all changes in this revision

Viewing changes to man/gnome-session.1.in

  • Committer: Bazaar Package Importer
  • Author(s): Josselin Mouette
  • Date: 2009-04-14 19:24:09 UTC
  • mto: (1.3.1 upstream) (2.1.5 experimental)
  • mto: This revision was merged to the branch mainline in revision 112.
  • Revision ID: james.westby@ubuntu.com-20090414192409-koxw9bt1lf1zr01z
Import upstream version 2.26.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/gnome-session.1.in
1
 
.\" 
2
 
.\" gnome-session manual page.
3
 
.\" (C) 2000 Miguel de Icaza (miguel@helixcode.com)
4
 
.\"
5
 
.TH GNOME 1 "GNOME 1.0"
6
 
.SH NAME
7
 
gnome-session \- Starts up the GNOME desktop environment
8
 
.SH SYNOPSIS
9
 
.B gnome-session [\-\-choosesession] [\-\-failsafe]
10
 
[\-\-purge-delay=DELAY] [\-\-warn-delay=DELAY]
11
 
[\-\-suicide-delay=DELAY] [session-name]
12
 
.SH DESCRIPTION
13
 
The \fIgnome-session\fP program starts up the GNOME desktop
14
 
environment.  This command is typically executed by your login manager
15
 
(either gdm, xdm, or from your X startup scripts).  It will load
16
 
either your last session, or it will provide a default session for the
17
 
user as defined by the system administrator (or the default GNOME
18
 
installation on your system).
19
 
.PP
20
 
You can optionally specify a specific session name to restore.
21
 
.PP
22
 
\fIgnome-session\fP is an X11R6 session manager.  It can manage GNOME
23
 
applications as well as any X11R6 SM compliant.
24
 
.PP
25
 
\fIgnome-session\fP uses the contents of the  ~/.gnome2/session file
26
 
for starting up as specified by the "CurrentSession" key in the
27
 
~/.gnome2/session-options file.  Various default values are 
28
 
provided in case the file entry does not exist.
29
 
.PP
30
 
If the session file does not exist, \fIgnome-session\fP will use the
31
 
contents of the 
32
 
.I @datadir@/gnome/default.session
33
 
file.
34
 
.SH OPTIONS
35
 
The following options are supported:
36
 
.TP
37
 
.I "--choose-session=ARG"
38
 
User can specify a session to load, as opposed to the session 
39
 
specified in the ~/.gnome2/session-options file. If that entry
40
 
does not exist in the ~/.gnome2/session file (or if that file
41
 
doesn't exist), it will use the default session and all saves
42
 
to that session will be to the new session name.
43
 
.TP
44
 
.I "--failsafe"
45
 
Fail safe operations mode: only reads saved sessions from the
46
 
default.session file.
47
 
.TP
48
 
.I "--purge-delay=ARG"
49
 
The number of millisecond that \fIgnome-session\fP will wait for
50
 
clients to register, if you use 0 it will wait forever (default value:
51
 
30,000 milliseconds).
52
 
.TP
53
 
.I "--warn-delay=ARG"
54
 
The number of millisecond that \fIgnome-session\fP will wait for
55
 
clients to respond, if you use 0 it will wait forever (default value:
56
 
10,000 milliseconds).
57
 
.TP
58
 
.I "--suicide-delay=ARG"
59
 
The number of millisecond that \fIgnome-session\fP will wait for
60
 
clients to die, if you use 0 it will wait forever (default value:
61
 
10,000 milliseconds).
62
 
.SH ENVIRONMENT
63
 
\fIgnome-session\fP accepts all of the standard environment variables
64
 
used by gnome programs, other than the SESSION_MANAGER 
65
 
environment variable. [ xref to a manpage where this is documented. ] 
66
 
gnome-session also sets several environment variables
67
 
for the use of its child processes.
68
 
.PP 
69
 
.B SESSION_MANAGER
70
 
.IP
71
 
This variable is used by session-manager aware clients to contact
72
 
gnome-session. 
73
 
.PP
74
 
.B DISPLAY
75
 
.IP
76
 
This variable is set to the X display being used by 
77
 
\fIgnome-session\fP. Note that if the --display option is used
78
 
this might be different from the setting of the environment variable
79
 
when gnome-session is invoked.
80
 
.SH SEE ALSO
81
 
.BR default.session (5), gnome-session-save(1)
82
 
.SH BUGS
83
 
If you find bugs in the \fIgnome-session\fP program, please report
84
 
these using \fIbug-buddy\fP or the \fIgnome-bug\fP script included
85
 
with the GNOME libraries distribution.
86