source: xfce/core/xfce4-session.xml@ 3441548

10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 3441548 was 3441548, checked in by Bruce Dubbs <bdubbs@…>, 11 months ago

Update to xfce4-4.16. Includes garcon-0.8.0 and exo-4.16.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24038 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.3 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 xfce4-session-download-http
8 "http://archive.xfce.org/src/xfce/xfce4-session/&xfce4-version;/xfce4-session-&xfce4-session-version;.tar.bz2">
9 <!ENTITY xfce4-session-download-ftp " ">
10 <!ENTITY xfce4-session-md5sum "2bb95124f91e9469ea5571c94d6034fe">
11 <!ENTITY xfce4-session-size "856 KB">
12 <!ENTITY xfce4-session-buildsize "15 MB">
13 <!ENTITY xfce4-session-time "0.1 SBU">
14]>
15
16<sect1 id="xfce4-session" xreflabel="xfce4-session-&xfce4-session-version;">
17 <?dbhtml filename="xfce4-session.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>xfce4-session-&xfce4-session-version;</title>
25
26 <indexterm zone="xfce4-session">
27 <primary sortas="a-xfce4-session">xfce4-session</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Xfce4 Session</title>
32
33 <para>
34 <application>Xfce4 Session</application> is a session manager for
35 <application>Xfce</application>. Its task is to save the state of your
36 desktop (opened applications and their location) and restore it during a
37 next startup. You can create several different sessions and choose one of
38 them on startup.
39 </para>
40
41 &lfs10_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&xfce4-session-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&xfce4-session-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &xfce4-session-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &xfce4-session-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &xfce4-session-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &xfce4-session-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Xfce4 Session Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="libwnck"/> and
82 <xref linkend="libxfce4ui"/>
83 </para>
84
85 <bridgehead renderas="sect4">Recommended</bridgehead>
86 <para role="recommended">
87 <xref linkend="desktop-file-utils"/>,
88 <xref linkend="shared-mime-info"/> and
89 <xref linkend="polkit-gnome"/>
90 </para>
91
92 <bridgehead renderas="sect4">Required Runtime</bridgehead>
93 <para role="required">
94 <xref role="runtime" linkend="xfdesktop"/>
95 </para>
96
97 <para condition="html" role="usernotes">
98 User Notes: <ulink url="&blfs-wiki;/xfce4-session"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of Xfce4 Session</title>
104
105 <para>
106 Install <application>Xfce4 Session</application> by running the following
107 commands:
108 </para>
109
110<screen><userinput>./configure --prefix=/usr \
111 --sysconfdir=/etc \
112 --disable-legacy-sm &amp;&amp;
113make</userinput></screen>
114
115 <para>
116 This package does not come with a test suite.
117 </para>
118
119 <para>
120 Now, as the <systemitem class="username">root</systemitem> user:
121 </para>
122
123<screen role="root"><userinput>make install</userinput></screen>
124
125 </sect2>
126
127 <sect2 role="commands">
128 <title>Command Explanations</title>
129
130 <para>
131 <parameter>--disable-legacy-sm</parameter>: This switch disables
132 legacy session management which isn't necessary on modern
133 system.
134 </para>
135
136 </sect2>
137
138 <sect2 role="configuration">
139 <title>Configuring Xfce4 Session</title>
140
141 <para>
142 There are several optional run time dependencies for
143 <application>Xfce4</application>:
144 <xref linkend="dbus"/>,
145 <xref linkend="gnupg2"/>,
146 <xref linkend="hicolor-icon-theme"/> and
147 <xref linkend="openssh"/>
148 </para>
149
150 <para>
151 When building an <application>Xfce4</application> package, some
152 configuration files are installed in <filename class="directory">
153 /usr/share/applications</filename>, <filename class="directory">
154 /usr/share/icons</filename>, and <filename class="directory">
155 /usr/share/mime</filename>. In order to use those files in your
156 <application>Xfce4</application> session, you need to update various
157 databases. Do that by running, as the <systemitem class="username">
158 root</systemitem> user (you need to have the recommended dependencies
159 installed):
160 </para>
161
162<screen role="root"><userinput>update-desktop-database &amp;&amp;
163update-mime-database /usr/share/mime</userinput></screen>
164 </sect2>
165
166 <sect2 role="starting">
167 <title>Starting Xfce4</title>
168
169 <para revision="sysv">
170 You can start <application>Xfce4</application> from runlevel 3, using
171 <xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
172 such as <xref linkend="lightdm"/>.
173 </para>
174
175 <para revision="systemd">
176 You can start <application>Xfce4</application> from a TTY using
177 <xref linkend="xinit"/>, or from a graphical display manager, such as
178 <xref linkend="lightdm"/>.
179 </para>
180
181 <para>
182 To start <application>Xfce4</application> using <xref linkend="xinit"/>,
183 run the following commands:
184 </para>
185
186<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
187<literal>dbus-launch --exit-with-session startxfce4</literal>
188EOF
189
190startx</userinput></screen>
191
192 <para>
193 The X session starts on the first unused virtual terminal, normally vt7.
194 You can switch to another vt<emphasis>n</emphasis> simultaneously
195 pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
196 (<emphasis>n</emphasis>=1, 2, ...). To switch back to the X session,
197 normally started at vt7, use Ctrl-Alt-F7. The vt where the command
198 <command>startx</command> was executed will display many messages,
199 including X starting messages, applications automatically started with
200 the session, and eventually, some warning and error messages. You may
201 prefer to redirect those messages to a log file, which not only will keep
202 the initial vt uncluttered, but can also be used for debugging purposes. This
203 can be done starting X with:
204 </para>
205
206 <screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>
207
208 <note revision="sysv">
209 <para>
210 You may wish to drop dbus-launch, e.g., just using
211 startxfce4 in ~/.xinitrc. However some capabilities such as mounting or
212 umounting file systems from a file manager will not be possible, or the
213 reboot option will be absent or inoperative, among other problems.
214 </para>
215 </note>
216
217 <para>
218 When shutting down or rebooting, the shutdown messages appear on the vt
219 where X was running. If you wish to see those messages, simultaneously
220 press keys Alt-F7 (assuming that X was running on vt7).
221 </para>
222
223 </sect2>
224
225 <sect2 role="content">
226 <title>Contents</title>
227
228 <segmentedlist>
229 <segtitle>Installed Programs</segtitle>
230 <segtitle>Installed Library</segtitle>
231 <segtitle>Installed Directories</segtitle>
232
233 <seglistitem>
234 <seg>
235 startxfce4,
236 xfce4-session,
237 xfce4-session-logout,
238 xfce4-session-settings, and
239 xflock4
240 </seg>
241 <seg>
242 None
243 </seg>
244 <seg>
245 /usr/lib/xfce4/session
246 </seg>
247 </seglistitem>
248 </segmentedlist>
249
250 <variablelist>
251 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
252 <?dbfo list-presentation="list"?>
253 <?dbhtml list-presentation="table"?>
254
255 <varlistentry id="xfce4-session-prog">
256 <term><command>xfce4-session</command></term>
257 <listitem>
258 <para>
259 starts up the <application>Xfce</application> Desktop Environment.
260 </para>
261 <indexterm zone="xfce4-session xfce4-session-prog">
262 <primary sortas="b-xfce4-session">xfce4-session</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="xfce4-session-logout">
268 <term><command>xfce4-session-logout</command></term>
269 <listitem>
270 <para>
271 logs out from <application>Xfce</application>.
272 </para>
273 <indexterm zone="xfce4-session xfce4-session-logout">
274 <primary sortas="b-xfce4-session-logout">xfce4-session-logout</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="xfce4-session-settings">
280 <term><command>xfce4-session-settings</command></term>
281 <listitem>
282 <para>
283 is a <application>GTK+ 2</application> GUI which allows you to alter
284 your preferences for your <application>Xfce Session</application>.
285 </para>
286 <indexterm zone="xfce4-session xfce4-session-settings">
287 <primary sortas="b-xfce4-session-settings">xfce4-session-settings</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 </variablelist>
293
294 </sect2>
295
296</sect1>
Note: See TracBrowser for help on using the repository browser.