source: xfce/core/xfce4-session.xml@ 640ece9

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 640ece9 was 640ece9, checked in by Ken Moffat <ken@…>, 14 months ago

Tags: basic qt and webengine, laxappearance, most of xfce (no audio on this machine, nor blank CDs).

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

  • Property mode set to 100644
File size: 10.4 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 "5ad23062fd08ef5f5ad9b4389c7b54c6">
11 <!ENTITY xfce4-session-size "824 KB">
12 <!ENTITY xfce4-session-buildsize "15 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 &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"/>,
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">
96 <xref role="runtime" 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 <parameter>--disable-legacy-sm</parameter>: 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 <xref linkend="dbus"/>,
147 <xref linkend="gnupg2"/>,
148 <xref linkend="hicolor-icon-theme"/> and
149 <xref linkend="openssh"/>
150 </para>
151
152 <para>
153 When building an <application>Xfce4</application> package, some
154 configuration files are installed in <filename class="directory">
155 /usr/share/applications</filename>, <filename class="directory">
156 /usr/share/icons</filename>, and <filename class="directory">
157 /usr/share/mime</filename>. In order to use those files in your
158 <application>Xfce4</application> session, you need to update various
159 databases. Do that by running, as the <systemitem class="username">
160 root</systemitem> user (you need to have the recommended dependencies
161 installed):
162 </para>
163
164<screen role="root"><userinput>update-desktop-database &amp;&amp;
165update-mime-database /usr/share/mime</userinput></screen>
166 </sect2>
167
168 <sect2 role="starting">
169 <title>Starting Xfce4</title>
170
171 <para revision="sysv">
172 You can start <application>Xfce4</application> from runlevel 3, using
173 <xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
174 such as <xref linkend="lightdm"/>.
175 </para>
176
177 <para revision="systemd">
178 You can start <application>Xfce4</application> from a TTY using
179 <xref linkend="xinit"/>, or from a graphical display manager, such as
180 <xref linkend="lightdm"/>.
181 </para>
182
183 <para>
184 To start <application>Xfce4</application> using <xref linkend="xinit"/>,
185 run the following commands:
186 </para>
187
188<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
189<literal>dbus-launch --exit-with-session startxfce4</literal>
190EOF
191
192startx</userinput></screen>
193
194 <para>
195 The X session starts on the first unused virtual terminal, normally vt7.
196 You can switch to another vt<emphasis>n</emphasis> simultaneously
197 pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
198 (<emphasis>n</emphasis>=1, 2, ...). To switch back to the X session,
199 normally started at vt7, use Ctrl-Alt-F7. The vt where the command
200 <command>startx</command> was executed will display many messages,
201 including X starting messages, applications automatically started with
202 the session, and eventually, some warning and error messages. You may
203 prefer to redirect those messages to a log file, which not only will keep
204 the initial vt uncluttered, but can also be used for debugging purposes. This
205 can be done starting X with:
206 </para>
207
208 <screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>
209
210 <note revision="sysv">
211 <para>
212 You may wish to drop dbus-launch, e.g., just using
213 startxfce4 in ~/.xinitrc. However some capabilities such as mounting or
214 umounting file systems from a file manager will not be possible, or the
215 reboot option will be absent or inoperative, among other problems.
216 </para>
217 </note>
218
219 <para>
220 When shutting down or rebooting, the shutdown messages appear on the vt
221 where X was running. If you wish to see those messages, simultaneously
222 press keys Alt-F7 (assuming that X was running on vt7).
223 </para>
224
225 </sect2>
226
227 <sect2 role="content">
228 <title>Contents</title>
229
230 <segmentedlist>
231 <segtitle>Installed Programs</segtitle>
232 <segtitle>Installed Library</segtitle>
233 <segtitle>Installed Directories</segtitle>
234
235 <seglistitem>
236 <seg>
237 xfce4-session,
238 xfce4-session-logout,
239 xfce4-session-settings and
240 xfce4-tips
241 </seg>
242 <seg>
243 libxfsm-4.6.so
244 </seg>
245 <seg>
246 /usr/include/xfce4/xfce4-session-4.6,
247 /usr/share/xfce4/tips and
248 /usr/share/doc/xfce4-session-&xfce4-session-version;
249 </seg>
250 </seglistitem>
251 </segmentedlist>
252
253 <variablelist>
254 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
255 <?dbfo list-presentation="list"?>
256 <?dbhtml list-presentation="table"?>
257
258 <varlistentry id="xfce4-session-prog">
259 <term><command>xfce4-session</command></term>
260 <listitem>
261 <para>
262 starts up the <application>Xfce</application> Desktop Environment.
263 </para>
264 <indexterm zone="xfce4-session xfce4-session-prog">
265 <primary sortas="b-xfce4-session">xfce4-session</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="xfce4-session-logout">
271 <term><command>xfce4-session-logout</command></term>
272 <listitem>
273 <para>
274 logs out from <application>Xfce</application>.
275 </para>
276 <indexterm zone="xfce4-session xfce4-session-logout">
277 <primary sortas="b-xfce4-session-logout">xfce4-session-logout</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="xfce4-session-settings">
283 <term><command>xfce4-session-settings</command></term>
284 <listitem>
285 <para>
286 is a <application>GTK+ 2</application> GUI which allows you to alter
287 your preferences for your <application>Xfce Session</application>.
288 </para>
289 <indexterm zone="xfce4-session xfce4-session-settings">
290 <primary sortas="b-xfce4-session-settings">xfce4-session-settings</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="xfce4-tips">
296 <term><command>xfce4-tips</command></term>
297 <listitem>
298 <para>
299 is a <application>GTK+ 2</application> GUI which displays tips when
300 you log in to an <application>Xfce Session</application>.
301 </para>
302 <indexterm zone="xfce4-session xfce4-tips">
303 <primary sortas="b-xfce4-tips">xfce4-tips</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="libxfsm-4">
309 <term><filename class="libraryfile">libxfsm-4.6.so</filename></term>
310 <listitem>
311 <para>
312 contains the <application>Xfce Session</application> API functions.
313 </para>
314 <indexterm zone="xfce4-session libxfsm-4">
315 <primary sortas="c-libxfsm-4">libxfsm-4.6.so</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 </variablelist>
321
322 </sect2>
323
324</sect1>
Note: See TracBrowser for help on using the repository browser.