source: archive/gnome/gnome-session.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.

  • Property mode set to 100644
File size: 7.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gnome-session-download-http
8 "&gnome-download-http;/gnome-session/3.6/gnome-session-&gnome-session-version;.tar.xz">
9 <!ENTITY gnome-session-download-ftp
10 "&gnome-download-ftp;/gnome-session/3.6/gnome-session-&gnome-session-version;.tar.xz">
11 <!ENTITY gnome-session-md5sum "355730543dbcc166f331d806cd0da22d">
12 <!ENTITY gnome-session-size "716 KB">
13 <!ENTITY gnome-session-buildsize "20 MB">
14 <!ENTITY gnome-session-time "0.3 SBU">
15]>
16
17<sect1 id="gnome-session" xreflabel="gnome-session-&gnome-session-version;">
18 <?dbhtml filename="gnome-session.html"?>
19
20
21 <title>gnome-session-&gnome-session-version;</title>
22
23 <indexterm zone="gnome-session">
24 <primary sortas="a-gnome-session">gnome-session</primary>
25 </indexterm>
26
27 <sect2 role="package">
28 <title>Introduction to GNOME Session</title>
29
30 <para>
31 The <application>GNOME Session</application> package contains
32 the <application>GNOME</application> session manager.
33 </para>
34
35 &lfs72_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>
41 Download (HTTP): <ulink url="&gnome-session-download-http;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download (FTP): <ulink url="&gnome-session-download-ftp;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download MD5 sum: &gnome-session-md5sum;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download size: &gnome-session-size;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &gnome-session-buildsize;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated build time: &gnome-session-time;
67 </para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">GNOME Session Dependencies</bridgehead>
72
73 <bridgehead renderas="sect4">Required</bridgehead>
74 <para role="required">
75 <xref linkend="GConf"/>,
76 <xref linkend="gtk3"/>,
77 <xref linkend="json-glib"/> and
78 <xref linkend="upower"/>
79 </para>
80
81 <bridgehead renderas="sect4">Optional</bridgehead>
82 <para role="optional">
83 <xref linkend="xmlto"/>
84 </para>
85
86 <bridgehead renderas="sect4">Runtime Dependencies</bridgehead>
87 <para role="required">
88 <xref linkend="consolekit"/> (if you intend to use startx to initiate
89 your <application>GNOME</application> desktop)
90 </para>
91
92 <para condition="html" role="usernotes">User Notes:
93 <ulink url="&blfs-wiki;/gnome-session"/>
94 </para>
95 </sect2>
96
97 <sect2 role="installation">
98 <title>Installation of GNOME Session</title>
99
100 <para>
101 Install <application>GNOME Session</application> by
102 running the following commands:
103 </para>
104
105<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/gnome-session &amp;&amp;
106make</userinput></screen>
107
108 <para>
109 This package does not come with a test suite.
110 </para>
111
112 <para>
113 Now, as the <systemitem class="username">root</systemitem> user:
114 </para>
115
116<screen role="root"><userinput>make install</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <para>
124 <option>--enable-docbook-docs</option>: This switch is used to
125 enable building of the documentation.
126 </para>
127
128 </sect2>
129
130 <sect2 role="configuration" id="gnome-session-config">
131 <title>Configuring GNOME Session</title>
132
133 <sect3>
134 <title>Configuration Information</title>
135
136 <para>
137 If you are not using <application>GDM</application> to start your
138 <application>GNOME</application> desktop, you will need to invoke
139 <command>gnome-session</command> <emphasis>instead of</emphasis> invoking
140 a window-manager directly. All of the packages in the 'Desktop' section of
141 this chapter need to be installed first, and some of the 'Applications' -
142 particularly <application>GNOME Terminal</application>
143 (<application>xterm</application> does not install a '.desktop' file and
144 so not appear in the menus).
145 </para>
146
147 <para>
148 When <command>gnome-session</command> is run, it invokes the necessary
149 daemons and either <application>Metacity</application> or
150 <application>gnome-shell</application>. A desktop manager such as
151 <application>GDM</application> will invoke <application>ConsoleKit</application>
152 before the window manager, but if you use <command>startx</command> the first
153 invocation after booting may fail because the daemon is not already running,
154 so it is invoked first.
155 </para>
156
157 <para>
158 To automatically start the <application>gnome-session</application>
159 window manager when you issue the <command>startx</command> command,
160 backup your current <filename>~/.xinitrc</filename> before proceeding.
161 Note that you will be able to invoke <application>GNOME Terminal</application>
162 from the menu, so there is no reason to invoke <command>xterm</command> here.
163 Create a new <filename>.xinitrc</filename> using this command:
164 </para>
165
166 <indexterm zone="metacity gnome-session-config">
167 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
168 </indexterm>
169
170<screen><userinput>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"
171<literal>exec ck-launch-session dbus-launch --exit-with-session gnome-session</literal>
172EOF</userinput></screen>
173
174 </sect3>
175
176 </sect2>
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Programs</segtitle>
183 <segtitle>Installed Libraries</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>
188 gnome-session, gnome-session-properties and gnome-session-quit
189 </seg>
190 <seg>
191 None
192 </seg>
193 <seg>
194 /usr/lib/gnome-session,
195 /usr/share/doc/gnome-session and
196 /usr/share/gnome-session
197 </seg>
198 </seglistitem>
199 </segmentedlist>
200
201 <variablelist>
202 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
203 <?dbfo list-presentation="list"?>
204 <?dbhtml list-presentation="table"?>
205
206 <varlistentry id="gnome-session-prog">
207 <term><command>gnome-session</command></term>
208 <listitem>
209 <para>
210 is used to start up the <application>GNOME</application>
211 Desktop environment.
212 </para>
213 <indexterm zone="gnome-session gnome-session-prog">
214 <primary sortas="b-gnome-session">gnome-session</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="gnome-session-properties">
220 <term><command>gnome-session-properties</command></term>
221 <listitem>
222 <para>
223 allows the users to configure which applications should be
224 started at login.
225 </para>
226 <indexterm zone="gnome-session gnome-session-properties">
227 <primary sortas="b-gnome-session-properties">gnome-session-properties</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="gnome-session-quit">
233 <term><command>gnome-session-quit</command></term>
234 <listitem>
235 <para>
236 is used to end the <application>GNOME</application> Session.
237 </para>
238 <indexterm zone="gnome-session gnome-session-quit">
239 <primary sortas="b-gnome-session-quit">gnome-session-quit</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 </variablelist>
245
246 </sect2>
247
248</sect1>
Note: See TracBrowser for help on using the repository browser.