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

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since fd42347a was fd42347a, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Comment out sddm from systemd version of the book.
Finish all tags.

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

  • Property mode set to 100644
File size: 11.1 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 "f4921fb2e606e74643daf1212263076c">
11 <!ENTITY xfce4-session-size "1.2 MB">
12 <!ENTITY xfce4-session-buildsize "14 MB">
13 <!ENTITY xfce4-session-time "0.2 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 &lfs7a_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="libwnck2"/>,
82 <xref linkend="libxfce4ui"/>,
83 <xref linkend="which"/>, and
84 <xref linkend="xorg7-app"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="desktop-file-utils"/>,
90 <xref linkend="shared-mime-info"/> and
91 <xref linkend="polkit-gnome"/>
92 </para>
93
94 <bridgehead renderas="sect4">Required Runtime</bridgehead>
95 <para role="required runtime">
96 <xref linkend="xfdesktop"/>
97 </para>
98
99 <para condition="html" role="usernotes">
100 User Notes: <ulink url="&blfs-wiki;/xfce4-session"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of Xfce4 Session</title>
106
107 <para>
108 Install <application>Xfce4 Session</application> by running the following
109 commands:
110 </para>
111
112<screen><userinput>./configure --prefix=/usr \
113 --sysconfdir=/etc \
114 --disable-legacy-sm &amp;&amp;
115make</userinput></screen>
116
117 <para>
118 This package does not come with a test suite.
119 </para>
120
121 <para>
122 Now, as the <systemitem class="username">root</systemitem> user:
123 </para>
124
125<screen role="root"><userinput>make install</userinput></screen>
126
127 </sect2>
128
129 <sect2 role="commands">
130 <title>Command Explanations</title>
131
132 <para>
133 <option>--disable-legacy-sm</option>: This switch disables
134 legacy session management which isn't necessary on modern
135 system.
136 </para>
137
138 </sect2>
139
140 <sect2 role="configuration">
141 <title>Configuring Xfce4 Session</title>
142
143 <para>
144 There are several optional run time dependencies for
145 <application>Xfce4</application>:
146 <phrase revision="sysv"><xref linkend="consolekit"/>,</phrase>
147 <xref linkend="dbus"/>,
148 <xref linkend="gnupg2"/>,
149 <xref linkend="hicolor-icon-theme"/> and
150 <xref linkend="openssh"/>
151 </para>
152<!--
153 <para>
154 To launch <application>Xfce4</application> use the command
155 <command>startxfce4</command>. If you have <xref linkend="consolekit"/>
156 installed, use <command>startxfce4 -\-with-ck-launch</command>.
157 <application>ConsoleKit</application> is required to perform any
158 task that requires administrative access, including shut down
159 and reboot.
160 </para>-->
161
162 <para>
163 When building an <application>Xfce4</application> package, some
164 configuration files are installed in <filename class="directory">
165 /usr/share/applications</filename>, <filename class="directory">
166 /usr/share/icons</filename>, and <filename class="directory">
167 /usr/share/mime</filename>. In order to use those files in your
168 <application>Xfce4</application> session, you need to update various
169 databases. Do that by running, as the <systemitem class="username">
170 root</systemitem> user (you need to have the recommended dependencies
171 installed):
172 </para>
173
174<screen role="root"><userinput>update-desktop-database &amp;&amp;
175update-mime-database /usr/share/mime</userinput></screen>
176 </sect2>
177
178 <sect2 role="starting">
179 <title>Starting Xfce4</title>
180
181 <para revision="sysv">
182 You can start <application>Xfce4</application> from runlevel 3, using
183 <xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
184 such as <xref linkend="sddm"/>.
185 </para>
186
187 <para revision="systemd">
188 You can start <application>Xfce4</application> from a TTY using
189 <xref linkend="xinit"/><!--, or from a graphical display manager, such as
190 <xref linkend="sddm"/>-->.
191 </para>
192
193 <para>
194 To start <application>Xfce4</application> using <xref linkend="xinit"/>,
195 run the following commands:
196 </para>
197
198<screen revision="sysv"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
199<literal>ck-launch-session dbus-launch --exit-with-session startxfce4</literal>
200EOF
201
202startx</userinput></screen>
203
204<screen revision="systemd"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
205<literal>dbus-launch --exit-with-session startxfce4</literal>
206EOF
207
208startx</userinput></screen>
209
210 <para>
211 The X session starts on the first unused virtual terminal, normally vt7.
212 You can switch to another vt<emphasis>n</emphasis> simultaneously
213 pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
214 (<emphasis>n</emphasis>=1, 2, ...). To switch back to the X session,
215 normally started at vt7, use Ctrl-Alt-F7. The vt where the command
216 <command>startx</command> was executed will display many messages,
217 including X starting messages, applications automatically started with
218 the session, and eventually, some warning and error messages. You may
219 prefer to redirect those messages to a log file, which not only will keep
220 the initial vt uncluttered, but can also be used for debugging purposes. This
221 can be done starting X with:
222 </para>
223
224 <screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>
225
226 <note revision="sysv">
227 <para>
228 You may wish to drop consolekit and/or dbus-launch, e.g., just using
229 startxfce4 in ~/.xinitrc. However some capabilities such as mounting or
230 umounting file systems from a file manager will not be possible, or the
231 reboot option will be absent or inoperative, among other problems.
232 </para>
233 </note>
234
235 <para>
236 When shutting down or rebooting, the shutdown messages appear on the vt
237 where X was running. If you wish to see those messages, simultaneously
238 press keys Alt-F7 (assuming that X was running on vt7).
239 </para>
240
241 </sect2>
242
243 <sect2 role="content">
244 <title>Contents</title>
245
246 <segmentedlist>
247 <segtitle>Installed Programs</segtitle>
248 <segtitle>Installed Library</segtitle>
249 <segtitle>Installed Directories</segtitle>
250
251 <seglistitem>
252 <seg>
253 xfce4-session,
254 xfce4-session-logout,
255 xfce4-session-settings and
256 xfce4-tips
257 </seg>
258 <seg>
259 libxfsm-4.6.so
260 </seg>
261 <seg>
262 /usr/include/xfce4/xfce4-session-4.6,
263 /usr/share/xfce4/tips and
264 /usr/share/doc/xfce4-session-&xfce4-session-version;
265 </seg>
266 </seglistitem>
267 </segmentedlist>
268
269 <variablelist>
270 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
271 <?dbfo list-presentation="list"?>
272 <?dbhtml list-presentation="table"?>
273
274 <varlistentry id="xfce4-session-prog">
275 <term><command>xfce4-session</command></term>
276 <listitem>
277 <para>
278 starts up the <application>Xfce</application> Desktop Environment.
279 </para>
280 <indexterm zone="xfce4-session xfce4-session-prog">
281 <primary sortas="b-xfce4-session">xfce4-session</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="xfce4-session-logout">
287 <term><command>xfce4-session-logout</command></term>
288 <listitem>
289 <para>
290 logs out from <application>Xfce</application>.
291 </para>
292 <indexterm zone="xfce4-session xfce4-session-logout">
293 <primary sortas="b-xfce4-session-logout">xfce4-session-logout</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="xfce4-session-settings">
299 <term><command>xfce4-session-settings</command></term>
300 <listitem>
301 <para>
302 is a <application>GTK+ 2</application> GUI which allows you to alter
303 your preferences for your <application>Xfce Session</application>.
304 </para>
305 <indexterm zone="xfce4-session xfce4-session-settings">
306 <primary sortas="b-xfce4-session-settings">xfce4-session-settings</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="xfce4-tips">
312 <term><command>xfce4-tips</command></term>
313 <listitem>
314 <para>
315 is a <application>GTK+ 2</application> GUI which displays tips when
316 you log in to an <application>Xfce Session</application>.
317 </para>
318 <indexterm zone="xfce4-session xfce4-tips">
319 <primary sortas="b-xfce4-tips">xfce4-tips</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="libxfsm-4">
325 <term><filename class="libraryfile">libxfsm-4.6.so</filename></term>
326 <listitem>
327 <para>
328 contains the <application>Xfce Session</application> API functions.
329 </para>
330 <indexterm zone="xfce4-session libxfsm-4">
331 <primary sortas="c-libxfsm-4">libxfsm-4.6.so</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 </variablelist>
337
338 </sect2>
339
340</sect1>
Note: See TracBrowser for help on using the repository browser.