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

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 f1ce80b was f1ce80b, checked in by DJ Lucas <dj@…>, 5 years ago

[systemd-merge] - Section II layout

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

  • Property mode set to 100644
File size: 10.6 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 &lfs79_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>
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>
188 To start <application>Xfce4</application> using <xref linkend="xinit"/>,
189 run the following commands:
190 </para>
191
192<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
193<literal>ck-launch-session dbus-launch --exit-with-session startxfce4</literal>
194EOF
195
196startx</userinput></screen>
197
198 <para>
199 The X session starts on the first unused virtual terminal, normally vt7.
200 You can switch to another vt<emphasis>n</emphasis> simultaneously
201 pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
202 (<emphasis>n</emphasis>=1, 2, ...). To switch back to the X session,
203 normally started at vt7, use Ctrl-Alt-F7. The vt where the command
204 <command>startx</command> was executed will display many messages,
205 including X starting messages, applications automatically started with
206 the session, and eventually, some warning and error messages. You may
207 prefer to redirect those messages to a log file, which not only will keep
208 the initial vt uncluttered, but can also be used for debugging purposes. This
209 can be done starting X with:
210 </para>
211
212 <screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>
213
214 <note>
215 <para>
216 You may wish to drop consolekit and/or dbus-launch, e.g., just using
217 startxfce4 in ~/.xinitrc. However some capabilities such as mounting or
218 umounting file systems from a file manager will not be possible, or the
219 reboot option will be absent or inoperative, among other problems.
220 </para>
221 </note>
222
223 <para>
224 When shutting down or rebooting, the shutdown messages appear on the vt
225 where X was running. If you wish to see those messages, simultaneously
226 press keys Alt-F7 (assuming that X was running on vt7).
227 </para>
228
229 </sect2>
230
231 <sect2 role="content">
232 <title>Contents</title>
233
234 <segmentedlist>
235 <segtitle>Installed Programs</segtitle>
236 <segtitle>Installed Library</segtitle>
237 <segtitle>Installed Directories</segtitle>
238
239 <seglistitem>
240 <seg>
241 xfce4-session,
242 xfce4-session-logout,
243 xfce4-session-settings and
244 xfce4-tips
245 </seg>
246 <seg>
247 libxfsm-4.6.so
248 </seg>
249 <seg>
250 /usr/include/xfce4/xfce4-session-4.6,
251 /usr/share/xfce4/tips and
252 /usr/share/doc/xfce4-session-&xfce4-session-version;
253 </seg>
254 </seglistitem>
255 </segmentedlist>
256
257 <variablelist>
258 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
259 <?dbfo list-presentation="list"?>
260 <?dbhtml list-presentation="table"?>
261
262 <varlistentry id="xfce4-session-prog">
263 <term><command>xfce4-session</command></term>
264 <listitem>
265 <para>
266 starts up the <application>Xfce</application> Desktop Environment.
267 </para>
268 <indexterm zone="xfce4-session xfce4-session-prog">
269 <primary sortas="b-xfce4-session">xfce4-session</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="xfce4-session-logout">
275 <term><command>xfce4-session-logout</command></term>
276 <listitem>
277 <para>
278 logs out from <application>Xfce</application>.
279 </para>
280 <indexterm zone="xfce4-session xfce4-session-logout">
281 <primary sortas="b-xfce4-session-logout">xfce4-session-logout</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="xfce4-session-settings">
287 <term><command>xfce4-session-settings</command></term>
288 <listitem>
289 <para>
290 is a <application>GTK+ 2</application> GUI which allows you to alter
291 your preferences for your <application>Xfce Session</application>.
292 </para>
293 <indexterm zone="xfce4-session xfce4-session-settings">
294 <primary sortas="b-xfce4-session-settings">xfce4-session-settings</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="xfce4-tips">
300 <term><command>xfce4-tips</command></term>
301 <listitem>
302 <para>
303 is a <application>GTK+ 2</application> GUI which displays tips when
304 you log in to an <application>Xfce Session</application>.
305 </para>
306 <indexterm zone="xfce4-session xfce4-tips">
307 <primary sortas="b-xfce4-tips">xfce4-tips</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="libxfsm-4">
313 <term><filename class="libraryfile">libxfsm-4.6.so</filename></term>
314 <listitem>
315 <para>
316 contains the <application>Xfce Session</application> API functions.
317 </para>
318 <indexterm zone="xfce4-session libxfsm-4">
319 <primary sortas="c-libxfsm-4">libxfsm-4.6.so</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 </variablelist>
325
326 </sect2>
327
328</sect1>
Note: See TracBrowser for help on using the repository browser.