source: gnome/applications/gnome-session.xml@ e9994679

gnome
Last change on this file since e9994679 was e9994679, checked in by Christopher Gregory <cjg@…>, 10 years ago

Added new pages gnome-menus gnome-session

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/gnome@13377 af4574ff-66df-0310-9fd7-8a98e5e911e0

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