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

« back to all changes in this revision

Viewing changes to doc/man/default.session.5

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2009-04-08 09:47:57 UTC
  • mto: This revision was merged to the branch mainline in revision 110.
  • Revision ID: james.westby@ubuntu.com-20090408094757-rs8ialby8p72at4e
Tags: upstream-2.26.0svn20090408
ImportĀ upstreamĀ versionĀ 2.26.0svn20090408

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\"
2
 
.\" GNOME default session manual page
3
 
.\" (C) 2000 Miguel de Icaza (miguel@helixcode.com).
4
 
.\" 
5
 
.\" This manual page is covered by the terms of the GNU General
6
 
.\" Public License.  
7
 
.\"
8
 
.TH GNOME 1 "GNOME 1.0" 
9
 
.SH NAME
10
 
default.session \- GNOME Default session configuration file.
11
 
.SH DESCRIPTION
12
 
The 
13
 
.I ${prefix}/share/gnome/default.session
14
 
file contains a list of programs to be launched the first time a user
15
 
logs into the GNOME environment.
16
 
.PP
17
 
The format of the file is the one used by the gnome_config libraries,
18
 
and it looks like this:
19
 
.PP
20
 
.nf
21
 
[Section]
22
 
SEQID,id=uniqueID
23
 
SEQID,Priority=PRIO
24
 
SEQID,RestartCommand=command
25
 
num_clients=TOP
26
 
.fi
27
 
.PP
28
 
There are three possible names for 
29
 
.B Section
30
 
And they are:
31
 
.PP
32
 
.I Default
33
 
.IP
34
 
This specifies the Default session to load
35
 
.PP
36
 
.I Chooser
37
 
.IP
38
 
Lets the user configure which non-session aware programs should be
39
 
started up when the session begins
40
 
.PP
41
 
.I Warner
42
 
.IP
43
 
.PP
44
 
Since the gnome_config file format is not very flexible, an array of
45
 
data is emulated by listing starting from 0 chunks of
46
 
"id,Priority,RestartCommand", and at the end the 
47
 
.I num_clients
48
 
variable lists the number of chunks listed.
49
 
.PP
50
 
The 
51
 
.B uniqueid
52
 
key provides a name that is unique within this file and passed to the
53
 
app as the client id which it must use to register with
54
 
gnome-session.
55
 
.PP
56
 
The 
57
 
.B RestartCommand
58
 
specifies the command to run from the $PATH.
59
 
.PP
60
 
The 
61
 
.B Priority
62
 
determines the order in which the commands are started
63
 
(with Priority = 0 first) and defaults to 50.
64
 
.PP
65
 
The clients must be numbered from 0 to the value of 
66
 
.I num_clients-1