source: xfce/core/xfce4-session.xml

trunk
Last change on this file was f0922fc9, checked in by Thomas Trepl (Moody) <thomas@…>, 2 months ago

Tags

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