diff options
author | Daichi Kawahata <daichi.k@aioros.ocn.ne.jp> | 2005-10-04 15:25:00 +0000 |
---|---|---|
committer | Daichi Kawahata <daichi.k@aioros.ocn.ne.jp> | 2005-10-04 15:25:00 +0000 |
commit | 619628ea47f29660c589ac727c527f706ac33972 (patch) | |
tree | 4c5b147327ee04e625b4e9684e9a4d251744e421 /doc | |
parent | 3b9c8ad44d2e76b3f08413b25f4e137bfaacdf2a (diff) | |
download | xfce4-session-619628ea47f29660c589ac727c527f706ac33972.tar.gz |
Layout change.
(Old svn revision: 17984)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/.cvsignore | 1 | ||||
-rw-r--r-- | doc/C/.cvsignore | 1 | ||||
-rw-r--r-- | doc/C/Makefile.am | 17 | ||||
-rw-r--r-- | doc/C/images/.cvsignore | 1 | ||||
-rw-r--r-- | doc/C/images/Makefile.am | 7 | ||||
-rw-r--r-- | doc/C/images/xfsm-advanced.png | bin | 0 -> 24131 bytes | |||
-rw-r--r-- | doc/C/images/xfsm-general.png | bin | 0 -> 18114 bytes | |||
-rw-r--r-- | doc/C/images/xfsm-splash.png | bin | 0 -> 79996 bytes | |||
-rw-r--r-- | doc/C/xfce4-session.html | 140 | ||||
-rw-r--r-- | doc/C/xfce4-session.xml | 509 | ||||
-rw-r--r-- | doc/FAQ | 28 | ||||
-rw-r--r-- | doc/Makefile.am | 17 | ||||
-rw-r--r-- | doc/NEWS.pre-4.3 | 136 | ||||
-rw-r--r-- | doc/README.Kiosk | 40 | ||||
-rw-r--r-- | doc/fr/.cvsignore | 1 | ||||
-rw-r--r-- | doc/fr/Makefile.am | 17 | ||||
-rw-r--r-- | doc/fr/images/.cvsignore | 1 | ||||
-rw-r--r-- | doc/fr/images/Makefile.am | 7 | ||||
-rw-r--r-- | doc/fr/images/xfsm-advanced.png | bin | 0 -> 28318 bytes | |||
-rw-r--r-- | doc/fr/images/xfsm-general.png | bin | 0 -> 23536 bytes | |||
-rw-r--r-- | doc/fr/images/xfsm-splash.png | bin | 0 -> 30339 bytes | |||
-rw-r--r-- | doc/fr/xfce4-session.html | 105 | ||||
-rw-r--r-- | doc/fr/xfce4-session.xml | 468 | ||||
-rw-r--r-- | doc/xfce-nochunk.xsl | 270 |
24 files changed, 1766 insertions, 0 deletions
diff --git a/doc/.cvsignore b/doc/.cvsignore new file mode 100644 index 00000000..f3c7a7c5 --- /dev/null +++ b/doc/.cvsignore @@ -0,0 +1 @@ +Makefile diff --git a/doc/C/.cvsignore b/doc/C/.cvsignore new file mode 100644 index 00000000..f3c7a7c5 --- /dev/null +++ b/doc/C/.cvsignore @@ -0,0 +1 @@ +Makefile diff --git a/doc/C/Makefile.am b/doc/C/Makefile.am new file mode 100644 index 00000000..54c52e11 --- /dev/null +++ b/doc/C/Makefile.am @@ -0,0 +1,17 @@ +SUBDIRS = \ + images + +noinst_DATA = \ + xfce4-session.xml + +docdir = $(datadir)/xfce4/doc/C +doc_DATA = \ + xfce4-session.html + +EXTRA_DIST = \ + $(noinst_DATA) \ + $(doc_DATA) + +html: $(srcdir)/xfce4-session.xml + xsltproc $(top_srcdir)/docs/xfce-nochunk.xsl \ + $(srcdir)/xfce4-session.xml diff --git a/doc/C/images/.cvsignore b/doc/C/images/.cvsignore new file mode 100644 index 00000000..f3c7a7c5 --- /dev/null +++ b/doc/C/images/.cvsignore @@ -0,0 +1 @@ +Makefile diff --git a/doc/C/images/Makefile.am b/doc/C/images/Makefile.am new file mode 100644 index 00000000..855026e5 --- /dev/null +++ b/doc/C/images/Makefile.am @@ -0,0 +1,7 @@ +imagesdir = $(datadir)/xfce4/doc/C/images +images_DATA = \ + xfsm-advanced.png \ + xfsm-general.png \ + xfsm-splash.png + +EXTRA_DIST = $(images_DATA) diff --git a/doc/C/images/xfsm-advanced.png b/doc/C/images/xfsm-advanced.png Binary files differnew file mode 100644 index 00000000..746de907 --- /dev/null +++ b/doc/C/images/xfsm-advanced.png diff --git a/doc/C/images/xfsm-general.png b/doc/C/images/xfsm-general.png Binary files differnew file mode 100644 index 00000000..58d3ff71 --- /dev/null +++ b/doc/C/images/xfsm-general.png diff --git a/doc/C/images/xfsm-splash.png b/doc/C/images/xfsm-splash.png Binary files differnew file mode 100644 index 00000000..edf70076 --- /dev/null +++ b/doc/C/images/xfsm-splash.png diff --git a/doc/C/xfce4-session.html b/doc/C/xfce4-session.html new file mode 100644 index 00000000..a358e321 --- /dev/null +++ b/doc/C/xfce4-session.html @@ -0,0 +1,140 @@ +<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Session Manager</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="#xfce4-session" title="Xfce 4 Session Manager"><link rel="next" href="#xfsm-intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="xfce4-session"></a>Xfce 4 Session Manager</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Benedikt</span> <span class="surname">Meurer</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:benny@xfce.org">benny@xfce.org</a>></code></p></div><span class="orgname">os-cillation<br></span><span class="orgdiv">System development<br></span><span class="jobtitle">Software developer<br></span></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo"> + This manual describes the <strong xmlns="" class="application"><code>xfce4-session</code></strong> package, version 4.3. + <br></br></span></div><div><p class="copyright">Copyright © 2003, 2004, 2005 Benedikt Meurer</p></div><div><div class="legalnotice"><a name="legalnotice"></a><p> + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.1 or + any later version published by the Free Software Foundation; with no + Invariant Sections, with no Front-Cover Texts, and with no Back-Cover + Texts. The complete license text is available from the <a href="http://www.gnu.org/" target="_top">Free Software Foundation</a>. + </p></div></div><div><p class="pubdate">July 2005</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#xfsm-intro">Introduction</a></span></dt><dt><span class="sect1"><a href="#xfce4-session-settings">Session Manager settings</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfsm-general-settings">General preferences</a></span></dt><dt><span class="sect2"><a href="#xfsm-advanced%20settings">Advanced preferences</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfsm-customize">Customizing the Session Manager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfsm-engines">Splash screen settings</a></span></dt><dt><span class="sect2"><a href="#xfsm-shutdown">Shutdown/reboot options</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfsm-advanced">Advanced</a></span></dt><dd><dl><dt><span class="sect2"><a href="#files-and-env-vars">Files and Environment Variables</a></span></dt><dt><span class="sect2"><a href="#xfsm-kiosk-mode">Kiosk Mode</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfsm-copyright">About <strong class="application"><code>xfce4-session</code></strong></a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-intro"></a>Introduction</h2></div></div></div><p><strong class="application"><code>xfce4-session</code></strong> is a session manager for Xfce 4. Its task is to save the state of + your desktop (opened applications and their location) and restore it during a next + startup. You can create several different sessions and choose one of them on + startup. + </p><p><strong class="application"><code>xfce4-session</code></strong> provides session management for both X11R6 and + legacy X11R5 protocols. If you don't need legacy session management + support, you can disable it at compile time, giving + --disable-legacy-sm to ./configure. Do <span class="emphasis"><em>NOT EVER</em></span> run <strong class="application"><code>smproxy</code></strong> in + session that is managed by <strong class="application"><code>xfce4-session</code></strong>, or weird things will happen. + The included legacy session management does everything that <strong class="application"><code>smproxy</code></strong> + would do, and besides that, it also supports multiscreen display.</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfce4-session-settings"></a>Session Manager settings</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-general-settings"></a>General preferences</h3></div></div></div><div class="figure"><a name="xfsm-general-fig"></a><p class="title"><b>Figure 1. <code class="application">xfce4-session</code> general preferences</b></p><div class="screenshot"><div class="mediaobject"><img src="images/xfsm-general.png" alt="Shows the General tab of the xfce4-session settings dialog."></div></div></div><div class="variablelist"><dl><dt><span class="term">Display chooser on login</span></dt><dd><p>If set, the session manager will ask you to choose a session every + time you log in to Xfce.</p></dd><dt><span class="term">Automatically save session on logout</span></dt><dd><p>This option instructs the session manager to save the current + session automatically when you log out. If you don't select this option + you'll be prompted whether you want to save the current session on + each logout.</p></dd><dt><span class="term">Prompt on logout</span></dt><dd><p>This option disables the logout confirmation dialog. Whether + the session will be saved or not depends on whether you enabled the + automatic saving of sessions on logout or not.</p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-advanced%20settings"></a>Advanced preferences</h3></div></div></div><div class="figure"><a name="xfsm-advanced-fig"></a><p class="title"><b>Figure 2. <code class="application">xfce4-session</code> advanced preferences</b></p><div class="screenshot"><div class="mediaobject"><img src="images/xfsm-advanced.png" alt="Shows Advanced tab of the xfce4-session settings dialog."></div></div></div><div class="variablelist"><dl><dt><span class="term">Launch Gnome services on startup</span></dt><dd><p>Enable this option if you need the GNOME keyring daemon to be run + on startup. This option also instructs <strong class="application"><code>xfce4-session</code></strong> to bring up the GNOME assistive + technologies at startup (if enabled in the GNOME control center). See the + GNOME documentation for more information on this topic.</p></dd><dt><span class="term">Launch KDE services on startup</span></dt><dd><p>Enable this option if you plan to run KDE applications as part of + your Xfce Desktop session. This will notably increase the startup time, + but on the other hand, KDE applications will startup faster. Some KDE + applications may not work at all if you don't enable this option.</p></dd><dt><span class="term">Manage remote applications</span></dt><dd><p>Allow the session manager to manage applications running on + remote hosts. Since this option may constitute a security risk, by listening to + a TCP port on your system, do not enable it unless you know what you are + doing.</p><p>System administrators may want to disable this option globally using the + session managers <a href="#xfsm-kiosk-mode" target="_top">KIOSK + capabilities</a>.</p></dd></dl></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-customize"></a>Customizing the Session Manager</h2></div></div></div><p>You can customize the splash-screen that <strong class="application"><code>xfce4-session</code></strong> will use when you log in to + Xfce 4. There is a dedicated dialog available from the <span class="emphasis"><em>Xfce 4 + Settings Manager</em></span>.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-engines"></a>Splash screen settings</h3></div></div></div><div class="figure"><a name="splash-screen-settings-fig"></a><p class="title"><b>Figure 3. Splash screen settings dialog</b></p><div class="screenshot"><div class="mediaobject"><img src="images/xfsm-splash.png" alt="Shows the xfce4-session splash screen settings dialog."></div></div></div><p>On the left, the dialog shows a list of all installed engines. + Select an engine, and you will see, if available, a preview and + information about it. You can click on the <span><strong class="guibutton">Test</strong></span> + button to see a demonstration of the selected splash screen + engine.</p><p><strong class="application"><code>xfce4-session</code></strong> provides three Splash themes engines by default. Their + respective configuration options - if any - are available from the + <span><strong class="guibutton">Configure</strong></span> button.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-shutdown"></a>Shutdown/reboot options</h3></div></div></div><p><strong class="application"><code>xfce4-session</code></strong> supports shutting down your computer when you log out + of your desktop session. To be able to shutdown the computer, you + have to be listed in the systems <code class="filename">sudoers</code> file, + in particular, you must be allowed to execute the command + <code class="filename">${libexecdir}/xfsm-shutdown-helper</code> + (<code class="filename">/usr/sbin/xfsm-shutdown-helper</code> on Debian GNU/Linux) + as user root (where <code class="filename">${libexecdir}</code> is the <code class="filename">libexec</code> sub directory in the prefix you + installed <strong class="application"><code>xfce4-session</code></strong>, for example + <code class="filename">/usr/local/libexec</code>).</p><p>For example, lets say, you installed <strong class="application"><code>xfce4-session</code></strong> into <code class="filename">/usr/local</code>, your hostname is <span class="emphasis"><em>myhost</em></span> + and your user account is named <span class="emphasis"><em>myuser</em></span>, then you + would have to add the following line to your <code class="filename">sudoers</code> + file (remember to use <strong class="application"><code>visudo</code></strong> to edit + that file):</p><pre class="programlisting"> +myuser myhost=/usr/local/libexec/xfsm-shutdown-helper +</pre></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-advanced"></a>Advanced</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="files-and-env-vars"></a>Files and Environment Variables</h3></div></div></div><p>Xfce now uses the Basedir Specification as defined on <a href="http://freedesktop.org/" target="_top">Freedesktop.org</a> to + locate its data and configuration files. This means that file locations + will be specified as a path relative to the directories described in + the specification.</p><div class="variablelist"><dl><dt><span class="term">${XDG_CONFIG_HOME}</span></dt><dd><p>The first base directory to look for configuration + files. By default this is set to <code class="filename">~/.config/</code>.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}</span></dt><dd><p>A list of system directories that contain configuration + data. By default the panel will look in <code class="filename">${sysconfdir}/xdg/</code> and + <code class="filename">/etc/xdg/</code>. The value of + ${sysconfdir} depends on how the program was build and will often be + <code class="filename">/etc/</code> for binary + packages.</p></dd><dt><span class="term">${XDG_CACHE_HOME}</span></dt><dd><p>Specifies the root for all user-specific cache data. If + this environment variable is unset, it defaults to <code class="filename">~/.cache</code>.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}/autostart/</span></dt><dd><p>This is the location where the list of applications that + should be automatically run on login is stored. Each autostarted + application is represented by a <code class="filename">.desktop</code> + file (see the <a href="http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html" target="_top">Desktop + Entry Specification</a> for details).</p><p>Prior to Xfce 4.3, the list of autostarted applications + was stored in <code class="filename">~/Desktop/Autostart</code>, + which contained scripts and symbolic links to applications. If + you run <strong class="application"><code>xfce4-session</code></strong> 4.3 or above for the first time, it will + automatically migrate the autostart items from the old location + to the standard location and place a <code class="filename">LOCATION-CHANGED.txt</code> + file in the old directory, that describes the location change.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}/xfce4-session/xfce4-session.rc</span></dt><dd><p>This is the location of the configuration file that + includes the various settings for <strong class="application"><code>xfce4-session</code></strong>, which can be changed + from the settings dialog.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}/xfce4-session/xfce4-splash.rc</span></dt><dd><p>This is the location of the configuration file that + includes the configuration for the splash screen, which + can be changed from the settings dialog.</p></dd><dt><span class="term">${XDG_CACHE_HOME}/sessions/</span></dt><dd><p>The directory where <strong class="application"><code>xfce4-session</code></strong> and <strong class="application"><code>xfwm4</code></strong> + store the session data to.</p></dd><dt><span class="term">${sysconfdir}/xdg/xfce4/kiosk/kioskrc</span></dt><dd><p>Kiosk mode configuration file. See <a href="#xfsm-kiosk-mode" target="_top">next + section</a> for an explanation.</p></dd></dl></div><p>None of the configuration files, except the <code class="filename">kioskrc</code>, + are designed to be edited by hand during a Xfce session; in fact, the changes will + be overwritten if you edit them while the session manager or the settings managers + are running.</p><p>System administrators might want to customize the file + <code class="filename">${sysconfdir}/xdg/xfce4-session/xfce4-session.rc</code> to change + the default applications that are run on Xfce startup. For example, if you want to + start the <strong class="application"><code>xfce4-iconbox</code></strong> instead of the + <strong class="application"><code>xftaskbar4</code></strong>, you would change the <span class="emphasis"><em>[Failsafe + Session]</em></span> section like to something like this:</p><pre class="programlisting"> +[Failsafe Session] +Count=4 +Client0_Command=xfwm4 +Client0_PerScreen=False +Client1_Command=xfce4-panel +Client1_PerScreen=True +Client2_Command=xfce4-iconbox +Client2_PerScreen=True +Client3_Command=xfdesktop +Client3_PerScreen=False +</pre></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-kiosk-mode"></a>Kiosk Mode</h3></div></div></div><p>The session manager offers support for the Kiosk Mode, that helps to + prevent users from making changes to their session settings. To use it you + have to edit or create the file + <code class="filename">${sysconfdir}/xdg/xfce4/kiosk/kioskrc</code>.</p><p>The way to explain the format of this file is by using an example. The + xfce4-session section of your <code class="filename">kioskrc</code> might look like + this:</p><pre class="programlisting"> +[xfce4-session] +CustomizeSplash=ALL +CustomizeChooser=ALL +CustomizeLogout=ALL +CustomizeCompatibility=%wheel +Shutdown=%wheel +CustomizeSecurity=NONE +</pre><p>This allows all users to change their splash, chooser and logout settings, + but allows only users in the group <span class="emphasis"><em>wheel</em></span> to customize the + compatibility settings and shutdown the system. No one will be allowed to adjust + the security settings.</p><p>The session manager supports the following KIOSK capabilities:</p><div class="variablelist"><dl><dt><span class="term">CustomizeSplash</span></dt><dd><p>Whether or not the user is allowed to customize the splash screen.</p></dd><dt><span class="term">CustomizeChooser</span></dt><dd><p>Whether or not the user is allowed to customize the session chooser settings.</p></dd><dt><span class="term">CustomizeLogout</span></dt><dd><p>Whether or not the user is allowed to customize the logout settings.</p></dd><dt><span class="term">CustomizeCompatibility</span></dt><dd><p>Whether or not the user is allowed to customize the compatibility + settings (KDE/Gnome compat)</p></dd><dt><span class="term">CustomizeSecurity</span></dt><dd><p>Whether or not the user is allowed to customize the security settings. + This is one of the most <span class="emphasis"><em>IMPORTANT</em></span> settings, since it + prevents users (actually <code class="filename">libICE</code>) from binding to a TCP port.</p></dd><dt><span class="term">Shutdown</span></dt><dd><p>Whether or not the user is allowed to shutdown (reboot or poweroff) the system. + If a user lacks this capability the reboot and poweroff options in the shutdown + dialog will be greyed out.</p></dd></dl></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-copyright"></a>About <strong class="application"><code>xfce4-session</code></strong></h2></div></div></div><p><strong class="application"><code>xfce4-session</code></strong> was written by Benedikt Meurer + (<code class="email"><<a href="mailto:benny@xfce.org">benny@xfce.org</a>></code>). + To find more information, please visit the + <a href="http://www.xfce.org" target="_top">Xfce web site</a>. + </p><p>To report a bug or make a suggestion regarding this application or + this manual, use the bug tracking system at <a href="http://bugzilla.xfce.org/" target="_top">http://bugzilla.xfce.org/</a>. + </p><p>If you have questions about the use or installation of this package, + please ask on the <a href="http://lunar-linux.org/mailman/listinfo/xfce" target="_top">xfce</a> mailing list. Development discussion takes + place on the <a href="http://lunar-linux.org/mailman/listinfo/xfce4-dev" target="_top">xfce4-dev</a> mailing list. + </p><p> This program is distributed under the terms of the + GNU General Public License as published by the Free Software Foundation; + either version 2 of the License, or (at your option) any later version. + </p><p>You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + </p></div></div></body></html> diff --git a/doc/C/xfce4-session.xml b/doc/C/xfce4-session.xml new file mode 100644 index 00000000..33faad35 --- /dev/null +++ b/doc/C/xfce4-session.xml @@ -0,0 +1,509 @@ +<?xml version='1.0'?> +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ + <!ENTITY date "July 2005"> + <!ENTITY appversion "4.3"> + <!ENTITY app "<application>xfce4-session</application>"> +]> + +<article id="xfce4-session" lang="en"> + +<!-- Header --> +<articleinfo> + + <title>Xfce 4 Session Manager</title> + + <copyright> + <year>2003</year> + <year>2004</year> + <year>2005</year> + <holder>Benedikt Meurer</holder> + </copyright> + +<!-- translators: uncomment this: + + <copyright> + <year>2002</year> <holder>ME-THE-TRANSLATOR (Latin + translation)</holder> + </copyright> + + --> + + <legalnotice id="legalnotice"> + <para> + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.1 or + any later version published by the Free Software Foundation; with no + Invariant Sections, with no Front-Cover Texts, and with no Back-Cover + Texts. The complete license text is available from the <ulink + type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>. + </para> + </legalnotice> + + <authorgroup> + <author> + <firstname>Benedikt</firstname> + <surname>Meurer</surname> + <affiliation> + <address><email>benny@xfce.org</email></address> + <orgname>os-cillation</orgname> + <orgdiv>System development</orgdiv> + <jobtitle>Software developer</jobtitle> + </affiliation> + </author> + +<!-- This is appropriate place for other contributors: translators, +maintainers, etc. Commented out by default. + + <othercredit role="translator"> + <firstname>Latin</firstname> <surname>Translator 1</surname> + <affiliation> + <orgname>Latin Translation Team</orgname> + <address><email>translator@gnome.org</email> </address> + </affiliation> <contrib>Latin translation</contrib> + </othercredit> +--> + + </authorgroup> + + <releaseinfo> + This manual describes the &app; package, version &appversion;. + </releaseinfo> + + <pubdate>&date;</pubdate> + +</articleinfo> + +<sect1 id="xfsm-intro"> + <title>Introduction</title> + + <para>&app; is a session manager for Xfce 4. Its task is to save the state of + your desktop (opened applications and their location) and restore it during a next + startup. You can create several different sessions and choose one of them on + startup. + </para> + + <para>&app; provides session management for both X11R6 and + legacy X11R5 protocols. If you don't need legacy session management + support, you can disable it at compile time, giving + --disable-legacy-sm to ./configure. Do <emphasis>NOT EVER</emphasis> run <application>smproxy</application> in + session that is managed by &app;, or weird things will happen. + The included legacy session management does everything that <application>smproxy</application> + would do, and besides that, it also supports multiscreen display.</para> + +</sect1> + +<sect1 id="xfce4-session-settings"> + <title>Session Manager settings</title> + + <sect2 id="xfsm-general-settings"> + <title>General preferences</title> + + <figure id="xfsm-general-fig"> + <title>&app; general preferences</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="images/xfsm-general.png" format="PNG" /> + </imageobject> + + <textobject> + <phrase>Shows the General tab of the &app; settings dialog.</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + + <variablelist> + <varlistentry> + <term>Display chooser on login</term> + <listitem> + <para>If set, the session manager will ask you to choose a session every + time you log in to Xfce.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Automatically save session on logout</term> + <listitem> + <para>This option instructs the session manager to save the current + session automatically when you log out. If you don't select this option + you'll be prompted whether you want to save the current session on + each logout.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Prompt on logout</term> + <listitem> + <para>This option disables the logout confirmation dialog. Whether + the session will be saved or not depends on whether you enabled the + automatic saving of sessions on logout or not.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="xfsm-advanced settings"> + <title>Advanced preferences</title> + + <figure id="xfsm-advanced-fig"> + <title>&app; advanced preferences</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="images/xfsm-advanced.png" format="PNG" /> + </imageobject> + + <textobject> + <phrase>Shows Advanced tab of the &app; settings dialog.</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + + <variablelist> + <varlistentry> + <term>Launch Gnome services on startup</term> + <listitem> + <para>Enable this option if you need the GNOME keyring daemon to be run + on startup. This option also instructs &app; to bring up the GNOME assistive + technologies at startup (if enabled in the GNOME control center). See the + GNOME documentation for more information on this topic.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Launch KDE services on startup</term> + <listitem> + <para>Enable this option if you plan to run KDE applications as part of + your Xfce Desktop session. This will notably increase the startup time, + but on the other hand, KDE applications will startup faster. Some KDE + applications may not work at all if you don't enable this option.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Manage remote applications</term> + <listitem> + <para>Allow the session manager to manage applications running on + remote hosts. Since this option may constitute a security risk, by listening to + a TCP port on your system, do not enable it unless you know what you are + doing.</para> + <para>System administrators may want to disable this option globally using the + session managers <ulink url="#xfsm-kiosk-mode" type="html">KIOSK + capabilities</ulink>.</para> + </listitem> + </varlistentry> + </variablelist> + + </sect2> +</sect1> + +<sect1 id="xfsm-customize"> + <title>Customizing the Session Manager</title> + + <para>You can customize the splash-screen that &app; will use when you log in to + Xfce 4. There is a dedicated dialog available from the <emphasis>Xfce 4 + Settings Manager</emphasis>.</para> + + <sect2 id="xfsm-engines"> + <title>Splash screen settings</title> + + <figure id="splash-screen-settings-fig"> + <title>Splash screen settings dialog</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="images/xfsm-splash.png" format="PNG" /> + </imageobject> + + <textobject> + <phrase>Shows the &app; splash screen settings dialog.</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + + <para>On the left, the dialog shows a list of all installed engines. + Select an engine, and you will see, if available, a preview and + information about it. You can click on the <guibutton>Test</guibutton> + button to see a demonstration of the selected splash screen + engine.</para> + + <para>&app; provides three Splash themes engines by default. Their + respective configuration options - if any - are available from the + <guibutton>Configure</guibutton> button.</para> + </sect2> + + <sect2 id="xfsm-shutdown"> + <title>Shutdown/reboot options</title> + + <para>&app; supports shutting down your computer when you log out + of your desktop session. To be able to shutdown the computer, you + have to be listed in the systems <filename>sudoers</filename> file, + in particular, you must be allowed to execute the command + <filename>${libexecdir}/xfsm-shutdown-helper</filename> + (<filename>/usr/sbin/xfsm-shutdown-helper</filename> on Debian GNU/Linux) + as user root (where <filename>${libexecdir}</filename> is the <filename + role="directory">libexec</filename> sub directory in the prefix you + installed &app;, for example + <filename role="directory">/usr/local/libexec</filename>).</para> + + <para>For example, lets say, you installed &app; into <filename + role="directory">/usr/local</filename>, your hostname is <emphasis>myhost</emphasis> + and your user account is named <emphasis>myuser</emphasis>, then you + would have to add the following line to your <filename>sudoers</filename> + file (remember to use <application>visudo</application> to edit + that file):</para> + +<programlisting> +myuser myhost=/usr/local/libexec/xfsm-shutdown-helper +</programlisting> + </sect2> + +</sect1> + +<sect1 id="xfsm-advanced"> + <title>Advanced</title> + + <sect2 id="files-and-env-vars"> + <title>Files and Environment Variables</title> + + <para>Xfce now uses the Basedir Specification as defined on <ulink + url="http://freedesktop.org/" type="http">Freedesktop.org</ulink> to + locate its data and configuration files. This means that file locations + will be specified as a path relative to the directories described in + the specification.</para> + + <variablelist> + <varlistentry> + <term>${XDG_CONFIG_HOME}</term> + <listitem> + <para>The first base directory to look for configuration + files. By default this is set to <filename + role="directory">~/.config/</filename>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}</term> + <listitem> + <para>A list of system directories that contain configuration + data. By default the panel will look in <filename + role="directory">${sysconfdir}/xdg/</filename> and + <filename role="directory">/etc/xdg/</filename>. The value of + ${sysconfdir} depends on how the program was build and will often be + <filename role="directory">/etc/</filename> for binary + packages.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CACHE_HOME}</term> + <listitem> + <para>Specifies the root for all user-specific cache data. If + this environment variable is unset, it defaults to <filename + role="directory">~/.cache</filename>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}/autostart/</term> + <listitem> + <para>This is the location where the list of applications that + should be automatically run on login is stored. Each autostarted + application is represented by a <filename>.desktop</filename> + file (see the <ulink type="http" + url="http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html">Desktop + Entry Specification</ulink> for details).</para> + <para>Prior to Xfce 4.3, the list of autostarted applications + was stored in <filename role="directory">~/Desktop/Autostart</filename>, + which contained scripts and symbolic links to applications. If + you run &app; &appversion; or above for the first time, it will + automatically migrate the autostart items from the old location + to the standard location and place a <filename>LOCATION-CHANGED.txt</filename> + file in the old directory, that describes the location change.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}/xfce4-session/xfce4-session.rc</term> + <listitem> + <para>This is the location of the configuration file that + includes the various settings for &app;, which can be changed + from the settings dialog.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}/xfce4-session/xfce4-splash.rc</term> + <listitem> + <para>This is the location of the configuration file that + includes the configuration for the splash screen, which + can be changed from the settings dialog.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CACHE_HOME}/sessions/</term> + <listitem> + <para>The directory where &app; and <application>xfwm4</application> + store the session data to.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${sysconfdir}/xdg/xfce4/kiosk/kioskrc</term> + <listitem> + <para>Kiosk mode configuration file. See <ulink url="#xfsm-kiosk-mode">next + section</ulink> for an explanation.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>None of the configuration files, except the <filename>kioskrc</filename>, + are designed to be edited by hand during a Xfce session; in fact, the changes will + be overwritten if you edit them while the session manager or the settings managers + are running.</para> + + <para>System administrators might want to customize the file + <filename>${sysconfdir}/xdg/xfce4-session/xfce4-session.rc</filename> to change + the default applications that are run on Xfce startup. For example, if you want to + start the <application>xfce4-iconbox</application> instead of the + <application>xftaskbar4</application>, you would change the <emphasis>[Failsafe + Session]</emphasis> section like to something like this:</para> + +<programlisting> +[Failsafe Session] +Count=4 +Client0_Command=xfwm4 +Client0_PerScreen=False +Client1_Command=xfce4-panel +Client1_PerScreen=True +Client2_Command=xfce4-iconbox +Client2_PerScreen=True +Client3_Command=xfdesktop +Client3_PerScreen=False +</programlisting> + </sect2> + + <sect2 id="xfsm-kiosk-mode"> + <title>Kiosk Mode</title> + + <para>The session manager offers support for the Kiosk Mode, that helps to + prevent users from making changes to their session settings. To use it you + have to edit or create the file + <filename>${sysconfdir}/xdg/xfce4/kiosk/kioskrc</filename>.</para> + + <para>The way to explain the format of this file is by using an example. The + xfce4-session section of your <filename>kioskrc</filename> might look like + this:</para> + +<programlisting> +[xfce4-session] +CustomizeSplash=ALL +CustomizeChooser=ALL +CustomizeLogout=ALL +CustomizeCompatibility=%wheel +Shutdown=%wheel +CustomizeSecurity=NONE +</programlisting> + + <para>This allows all users to change their splash, chooser and logout settings, + but allows only users in the group <emphasis>wheel</emphasis> to customize the + compatibility settings and shutdown the system. No one will be allowed to adjust + the security settings.</para> + + <para>The session manager supports the following KIOSK capabilities:</para> + + <variablelist> + <varlistentry> + <term>CustomizeSplash</term> + <listitem> + <para>Whether or not the user is allowed to customize the splash screen.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeChooser</term> + <listitem> + <para>Whether or not the user is allowed to customize the session chooser settings.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeLogout</term> + <listitem> + <para>Whether or not the user is allowed to customize the logout settings.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeCompatibility</term> + <listitem> + <para>Whether or not the user is allowed to customize the compatibility + settings (KDE/Gnome compat)</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeSecurity</term> + <listitem> + <para>Whether or not the user is allowed to customize the security settings. + This is one of the most <emphasis>IMPORTANT</emphasis> settings, since it + prevents users (actually <filename>libICE</filename>) from binding to a TCP port.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Shutdown</term> + <listitem> + <para>Whether or not the user is allowed to shutdown (reboot or poweroff) the system. + If a user lacks this capability the reboot and poweroff options in the shutdown + dialog will be greyed out.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> +</sect1> + +<sect1 id="xfsm-copyright"> + <title>About &app;</title> + + <para>&app; was written by Benedikt Meurer + (<email>benny@xfce.org</email>). + To find more information, please visit the + <ulink url="http://www.xfce.org" type="http">Xfce web site</ulink>. + </para> + + <para>To report a bug or make a suggestion regarding this application or + this manual, use the bug tracking system at <ulink + url="http://bugzilla.xfce.org/" + type="http">http://bugzilla.xfce.org/</ulink>. + </para> + + <para>If you have questions about the use or installation of this package, + please ask on the <ulink + url="http://lunar-linux.org/mailman/listinfo/xfce" + type="http">xfce</ulink> mailing list. Development discussion takes + place on the <ulink + url="http://lunar-linux.org/mailman/listinfo/xfce4-dev" + type="http">xfce4-dev</ulink> mailing list. + </para> + + <para> This program is distributed under the terms of the + GNU General Public License as published by the Free Software Foundation; + either version 2 of the License, or (at your option) any later version. + </para> + + <para>You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + </para> + +</sect1> + +</article> + diff --git a/doc/FAQ b/doc/FAQ new file mode 100644 index 00000000..b5b81f4a --- /dev/null +++ b/doc/FAQ @@ -0,0 +1,28 @@ +Session manager FAQ: +-------------------- + +1) Question: + xfce4-session complains about /tmp/.ICE-unix should be set to root. What + should I do? + + Answer: + This is just a security warning. You can either ignore, or change the + owner of /tmp/.ICE-unix to root. For example, I execute the following + commands on system startup: + + test -d /tmp/.ICE-unix || mkdir /tmp/.ICE-unix + chown root /tmp/.ICE-unix + chmod 1777 /tmp/.ICE-unix + + +2) Question: + What do I need to do in order to use xfce4-session as session manager + with Xfce4? + + Answer: + If you have a recent xfce-utils (post 20030708) then xfce4-session + is automatically started by startxfce4 as long as you don't have + a file ~/.xfce4/xinitrc in your home directory. Alternatively you + can copy the file $sysconfdir/xfce4/xinitrc.xfce4-session to + ~/.xfce4/xinitrc and start your X session using the startxfce4 script. + diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 00000000..3eb4c993 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,17 @@ +@SET_MAKE@ + +SUBDIRS = \ + C \ + fr + +noinst_DATA = \ + FAQ \ + NEWS.pre-4.3 \ + README.Kiosk + +EXTRA_DIST = \ + $(noinst_DATA) + +html: + (cd C && $(MAKE) $(AM_MAKEFLAGS) html) + (cd fr && $(MAKE) $(AM_MAKEFLAGS) html) diff --git a/doc/NEWS.pre-4.3 b/doc/NEWS.pre-4.3 new file mode 100644 index 00000000..3a5785ad --- /dev/null +++ b/doc/NEWS.pre-4.3 @@ -0,0 +1,136 @@ + $Id: NEWS.pre-4.3 16227 2005-07-14 16:06:25Z benny $ + +20040924: +--------- + + * Version 4.1.16 + * Don't grab the display on logout, as it doesn't work well with + compositors. + +20040203: +--------- + + * Version 4.1.2 + * Icon changes in the tray icon menu (the session control icon) + * Added about dialog now that XfceAboutDialog is in libxfcegui4. + +20040129: +--------- + + * Version 4.1.1 (big jump indeed, but need to catch up with the rest + of the desktop :-)) + * Finally moved xfce_setenv()/xfce_putenv() to libxfce4util and + we are now secured from stupid native implementations of both + functions. + * Some autotools and copyright updates. + +20040125: +--------- + * Version 0.2.1 + * Updated the xfce4-session manual page to reflect the latest + changes. + +20040113: +--------- + * Added --disable-tcp option to disable binding to TCP ports. This + is no new configure option, but a runtime option, that is, it can + be supplied to xfce4-session at startup. + +20040110: +--------- + * Version 0.2.0 + * Added support for user defined poweroff/halt/reboot commands, + and some cleanups, thanks to Brian Tarricone. + * Various fixes in the meantime, too bad I have no spare time for + xfce :-( + +20030721: +--------- + * Fix problem with Xrandr MCS plugin and splash screen not using + the new screen height/width. + +20030716: +--------- + * XfceTrayIcon now both provides "clicked" (a single left button + click) and "double_clicked" (double left button click) signals + * XfceTrayIcon no longer autoconnects, you'll need to call + xfce_tray_icon_connect() explicitly + +20030715: +--------- + * Version 0.1.1 + * Make "session control" sticky again, since the xfwm4 problem with + sticky windows seems to be fixed + * Many improvements on the XfceTrayIcon class (will be moved to + libxfcegui4 soon) + * Session managers tray icon can now be enabled/disabled from + the settings dialog + * Added more helpful tooltips to the settings dialog (translations + needs to be updated) + +20030713: +--------- + * Version 0.1.0 + * Fixed problem with SaveYourself Phase2 being aborted (that + should also correct the xfwm4 save problem). + * Fixed problem with "session control" window beeing undecorated + * Fix problem with users splash themes directory not being created + when installing new themes + * Skip the splash screen window in tasklists and pagers (Gdk >= 2.2 + only for now, a netk version is on the way, see util.c) + +20030712: +--------- + * Fixed tray icon problem + * New tray icon wrapper XfceTrayIcon, will be moved to libxfcegui4 + later + +20030710: +--------- + * Added spec file + * Two Solaris fixes + * State is now displayed in "session control" + * added "Quit session" and "Save session" to the tray menu + (GtkImageMenuItem's now working btw.) + * Fixed bug in SaveYourselfDone code (manager does not entered + IDLE state after a succesfull checkpoint) + * Added UNIX signals support: SIGUSR1 saves current session, SIGINT + quits current session + * Added security check to xfce4-shutdown (shutdown.allow is only used + if owned by root) + * Honor fast SaveYourself requests + +20030708: +--------- + * startxfce4 in xfce-utils was altered to automatically use + xfce4-session by default if installed. + * Added "session control" dialog and tray icon. Made several + improvements. Now requires libxfcegui4 >= 3.92.2 + * smproxy now works with xfce4-session, that says, X11R5 session + apps are now managed by the session manager as well (e.g. xcalc, + xedit, xbiff or even apps like gimp and gqview) + +20030707: +--------- + * Splash screen themes can now be selected from the settings plugin, + and in addition, you can also install new themes from the settings + plugin. + * Added docs/FAQ file. + +20030706: +--------- + * the session manager now takes care of starting files in + ~/Desktop/Autostart/ after all session aware apps are restarted. + This should make live easier, esp. with apps that depend on + the window manager already running. + * the splash screen is now themable. See docs/SplashThemes.txt for + further information. In addition, the splash screen also appears + when starting a default session, and not only when restoring a + previously saved session. + +20030702: +--------- + * session file naming scheme has changed from + ~/.xfce4/sessions/session-<hostname> + to + ~/.xfce4/sessions/xfsm-<hostname> diff --git a/doc/README.Kiosk b/doc/README.Kiosk new file mode 100644 index 00000000..e760d1f1 --- /dev/null +++ b/doc/README.Kiosk @@ -0,0 +1,40 @@ +The Xfce session manager supports the KIOSK mode introduced with libxfce4util +4.1.13. It provides the following KIOSK capabilities: + + CustomizeSplash whether or not the user is allowed to customize + the splash screen. + + CustomizeChooser whether or not the user is allowed to customize + the session chooser settings + + CustomizeLogout whether or not the user is allowed to customize + the logout settings + + CustomizeCompatibility whether or not the user is allowed to customize + the compatibility settings (KDE/Gnome compat) + + CustomizeSecurity whether or not the user is allowed to customize + the security settings. This is one of the most + IMPORTANT settings, since it prevents users + (actually libICE) from binding to a TCP port. + + Shutdown whether or not the user is allowed to shutdown + (reboot or poweroff) the system. If a user lacks + this capability the reboot and poweroff options + in the shutdown dialog will be greyed out. + +So a sample xfce4-session section in your kioskrc might look like this: + +--- snip --- +[xfce4-session] +CustomizeSplash=ALL +CustomizeChooser=ALL +CustomizeLogout=ALL +CustomizeCompatibility=%wheel +CustomizeSecurity=NONE +Shutdown=%wheel +--- snip --- + +This allows all users to change their splash, chooser and logout settings, but +allows only users in the group wheel to customize the compatibility settings +and shutdown the system. No one will be allowed to adjust the security settings. diff --git a/doc/fr/.cvsignore b/doc/fr/.cvsignore new file mode 100644 index 00000000..f3c7a7c5 --- /dev/null +++ b/doc/fr/.cvsignore @@ -0,0 +1 @@ +Makefile diff --git a/doc/fr/Makefile.am b/doc/fr/Makefile.am new file mode 100644 index 00000000..e6d8ea94 --- /dev/null +++ b/doc/fr/Makefile.am @@ -0,0 +1,17 @@ +SUBDIRS = \ + images + +noinst_DATA = \ + xfce4-session.xml + +docdir = $(datadir)/xfce4/doc/fr +doc_DATA = \ + xfce4-session.html + +EXTRA_DIST = \ + $(noinst_DATA) \ + $(doc_DATA) + +html: $(srcdir)/xfce4-session.xml + xsltproc $(top_srcdir)/docs/xfce-nochunk.xsl \ + $(srcdir)/xfce4-session.xml diff --git a/doc/fr/images/.cvsignore b/doc/fr/images/.cvsignore new file mode 100644 index 00000000..f3c7a7c5 --- /dev/null +++ b/doc/fr/images/.cvsignore @@ -0,0 +1 @@ +Makefile diff --git a/doc/fr/images/Makefile.am b/doc/fr/images/Makefile.am new file mode 100644 index 00000000..0f3c7284 --- /dev/null +++ b/doc/fr/images/Makefile.am @@ -0,0 +1,7 @@ +imagesdir = $(datadir)/xfce4/doc/fr/images +images_DATA = \ + xfsm-advanced.png \ + xfsm-general.png \ + xfsm-splash.png + +EXTRA_DIST = $(images_DATA) diff --git a/doc/fr/images/xfsm-advanced.png b/doc/fr/images/xfsm-advanced.png Binary files differnew file mode 100644 index 00000000..a61857db --- /dev/null +++ b/doc/fr/images/xfsm-advanced.png diff --git a/doc/fr/images/xfsm-general.png b/doc/fr/images/xfsm-general.png Binary files differnew file mode 100644 index 00000000..035b2cdb --- /dev/null +++ b/doc/fr/images/xfsm-general.png diff --git a/doc/fr/images/xfsm-splash.png b/doc/fr/images/xfsm-splash.png Binary files differnew file mode 100644 index 00000000..34abc0af --- /dev/null +++ b/doc/fr/images/xfsm-splash.png diff --git a/doc/fr/xfce4-session.html b/doc/fr/xfce4-session.html new file mode 100644 index 00000000..6356d7a7 --- /dev/null +++ b/doc/fr/xfce4-session.html @@ -0,0 +1,105 @@ +<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Session Manager</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="#xfce4-session" title="Xfce 4 Session Manager"><link rel="next" href="#xfsm-intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="xfce4-session"></a>Xfce 4 Session Manager</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Benedikt</span> <span class="surname">Meurer</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:benny@xfce.org">benny@xfce.org</a>></code></p></div><span class="orgname">os-cillation<br></span><span class="orgdiv">System development<br></span><span class="jobtitle">Software developer<br></span></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo"> + <p xmlns=""> </p> + Ce manuel décrit la version 4.2 de <strong xmlns="" class="application"><code>xfce4-session</code></strong>. Dernière mise à jour: November 2004 + <br></br></span></div><div><p class="copyright">Copyright © 2003, 2004 Benedikt Meurer</p></div><div><p class="copyright">Copyright © 2005 François Le Clainche (French + translation)</p></div><div><div class="legalnotice"><a name="legalnotice"></a><p> + This document is provided under the terms of the GNU GPL, version + 2 or (at your option) any later version. + </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#xfsm-intro">Introduction</a></span></dt><dt><span class="sect1"><a href="#xfce4-session-settings">Préférences du gestionnaire de session</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfsm-general-settings">Préférences générales</a></span></dt><dt><span class="sect2"><a href="#xfsm-advanced%20settings">Préférences avancées</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfsm-customize">Personnaliser le gestionnaire de session</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfsm-engines">Paramètres de l'écran de démarrage</a></span></dt><dt><span class="sect2"><a href="#xfsm-shutdown">Les options d'arrêt/redémarrage</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfsm-advanced">Avancé</a></span></dt><dd><dl><dt><span class="sect2"><a href="#files-and-env-vars">Fichiers et variables d'environnement</a></span></dt><dt><span class="sect2"><a href="#xfsm-kiosk-mode">Le mode Kiosk</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfsm-copyright">À propos de <strong class="application"><code>xfce4-session</code></strong></a></span></dt></dl></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-intro"></a>Introduction</h2></div></div></div><p><strong class="application"><code>xfce4-session</code></strong> est un gestionnaire de session pour Xfce 4. Son rôle est de sauvegarder l'état de votre environnement + (les applications ouvertes et leur position) afin de les restaurer lors de la session suivante. Vous pouvez créer plusieurs + sessions et choisir parmi elles au démarrage. + </p><p><strong class="application"><code>xfce4-session</code></strong> offre la gestion de session pour le protocole X11R6 ainsi que pour l'ancien protocole X11R5. + Si vous n'avez pas besoin du second, vous pouvez le désactiver au moment de la compilation en passant l'option + de configuration --disable-legacy-sm à ./configure. Ne lancez <span class="emphasis"><em>JAMAIS</em></span> <strong class="application"><code>smproxy</code></strong> au cours d'une session gérée par <strong class="application"><code>xfce4-session</code></strong>, sinon des choses bizarres + se produiront. La gestion de session selon le protocole X11R5 inclut tout ce que <strong class="application"><code>smproxy</code></strong> + ferait, avec en plus le support de l'affichage sur plusieurs moniteurs.</p></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfce4-session-settings"></a>Préférences du gestionnaire de session</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-general-settings"></a>Préférences générales</h3></div></div></div><div class="figure"><a name="xfsm-general-fig"></a><p class="title"><b>Figure 1. Préférences générales de <code class="application">xfce4-session</code></b></p><div class="screenshot"><div class="mediaobject"><img src="images/xfsm-general.png" alt="Montre l'onglet des préférences générales de xfce4-session"></div></div></div><div class="variablelist"><dl><dt><span class="term">Afficher le sélecteur de session à chaque connexion</span></dt><dd><p>Si cette option est sélectionnée, le gestionnaire de session vous demandera de choisir une session + à chacune des connexions à Xfce.</p></dd><dt><span class="term">Enregistrer automatiquement la session lors de la fermeture</span></dt><dd><p>Cette option indique au gestionnaire de session de sauvegarder automatiquement la session lors de + la déconnexion. Si vous ne sélectionnez pas cette option, la question vous sera posée à chaque fois.</p></dd><dt><span class="term">Demander à la déconnexion</span></dt><dd><p>Cette option désactive la fenêtre de confirmation de la déconnexion. La sauvegarde de la session + dépend alors du choix de l'option de sauvegarde automatique de la session.</p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-advanced settings"></a>Préférences avancées</h3></div></div></div><div class="figure"><a name="xfsm-advanced-fig"></a><p class="title"><b>Figure 2. Préférences avancées de <code class="application">xfce4-session</code></b></p><div class="screenshot"><div class="mediaobject"><img src="images/xfsm-advanced.png" alt="Montre l'onglet des préférences avancées de xfce4-session."></div></div></div><div class="variablelist"><dl><dt><span class="term">Charger les services Gnome au démarrage</span></dt><dd><p>Activer cette option si vous avez besoin d'exécuer le démon GNOME keyring au démarrage. Cette + option indique également à <strong class="application"><code>xfce4-session</code></strong> de lancer les technologies d'assistance de GNOME au démarrage (si elles + sont activées dans le centre de contrôle de GNOME). Consultez la documentation de GNOME pour plus + d'informations à ce sujet.</p></dd><dt><span class="term">Charger les services KDE au démarrage</span></dt><dd><p>Activez cette option si vous prévoyer de lancer des applications KDE au sein de votre session Xfce. + Cela augmentera sensiblement le temps de démarrage de Xfce, mais d'un autre côté, les applications KDE + démarreront plus rapidement. Certaines applications KDE peuvent ne pas fonctionner du tout si vous + n'activez pas cette option.</p></dd><dt><span class="term">Gérer le applications distantes</span></dt><dd><p>Autorise le gestionnaire de session à gérer les applications en cours de fonctionnement sur des + hôtes distants. Cette option peut représenter un risque en termes de sécurité, en activant un port TCP sur + votre système. Ne l'activez pas sans savoir ce que vous faites.</p><p>Les administrateurs système qui souhaitent désactiver cette option globalement peuvent pour cela + utiliser le mode <a href="#xfsm-kiosk-mode" target="_top">KIOSK</a>.</p></dd></dl></div></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-customize"></a>Personnaliser le gestionnaire de session</h2></div></div></div><p>Vous pouvez personnaliser l'écran démarrage que <strong class="application"><code>xfce4-session</code></strong> affichera lors de la connexion à Xfce 4. Une fenêtre + de configuration dédiée est disponible depuis le <span class="emphasis"><em>gestionnaire de paramètres de Xfce 4</em></span>.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-engines"></a>Paramètres de l'écran de démarrage</h3></div></div></div><div class="figure"><a name="splash-screen-settings-fig"></a><p class="title"><b>Figure 3. La fenêtre de paramétrage de l'écran de démarrage</b></p><div class="screenshot"><div class="mediaobject"><img src="images/xfsm-splash.png" alt="Montre la fenêtre de paramétrage de l'écran de démarrage de xfce4-session "></div></div></div><p>Sur la gauche, la fenêtre montre une liste de tous les moteurs de thème installés. Sélectionnez un moteur, + et vous verrez, si elle est disponible, une prévisualisation et des informations le concernant. Vous pouvez cliquer sur + le bouton <span><strong class="guibutton">Tester</strong></span> pour voir une démonstration du thème d'écran de démarrage + sélectionné.</p><p><strong class="application"><code>xfce4-session</code></strong> fournit par défaut trois moteurs de thème d'écran de démarrage. Leurs options de configuration + respectives - si disponibles - sont disponibles en cliquant sur le bouton <span><strong class="guibutton">Configurer</strong></span>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-shutdown"></a>Les options d'arrêt/redémarrage</h3></div></div></div><p><strong class="application"><code>xfce4-session</code></strong> supporte l'arrêt de votre ordinateur lors de la déconnexion de la session. Pour cela, vous devez + être listé dans le fichier <code class="filename">sudoers</code> du système, et vous devez en particulier être autorisé + à exécuter la commande <code class="filename">${libexecdir}/xfsm-shutdown-helper</code> + (<code class="filename">/usr/sbin/xfsm-shutdown-helper</code> sous Debian GNU/Linux) + en tant qu'utilisateur root (où <code class="filename">${libexecdir}</code> est le sous répertoire <code class="filename">libexec</code> selon le préfixe utilisé pour installer <strong class="application"><code>xfce4-session</code></strong>, par exemple + <code class="filename">/usr/local/libexec</code>).</p><p>pas exemple, si vous avez installé <strong class="application"><code>xfce4-session</code></strong> dans <code class="filename">/usr/local</code>, que votre nom d'hôte est <span class="emphasis"><em>myhost</em></span> + et que votre compte utilisateur est nommé<span class="emphasis"><em>myuser</em></span>, alors vous devez ajouter la ligne + suivante au fichier <code class="filename">sudoers</code> (souvenez-vous d'utiliser <strong class="application"><code>visudo</code></strong> + pour éditer ce fichier):</p><pre class="programlisting"> +myuser myhost=/usr/local/libexec/xfsm-shutdown-helper +</pre></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-advanced"></a>Avancé</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="files-and-env-vars"></a>Fichiers et variables d'environnement</h3></div></div></div><p>Xfce utilise maintenant la spécification Basedir telle que définie sur <a href="http://freedesktop.org/" target="_top">Freedesktop.org</a> pour chercher ses données et ses fichiers de + configuration. Cela signifie que les emplacements de ces fichiers seront indiqués selon un chemin relatif aux + répertoires décrits dans cette spécification.</p><div class="variablelist"><dl><dt><span class="term">${XDG_CONFIG_HOME}</span></dt><dd><p>Le premier répertoire où il faut rechercher les fichiers de configuration. Par défaut, c'est + <code class="filename">~/.config/</code>.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}</span></dt><dd><p>Une liste des répertoires contenant des données de configuration. Par défaut, le panneau cherchera + dans <code class="filename">${sysconfdir}/xdg/</code> et + <code class="filename">/etc/xdg/</code>. La valeur de ${sysconfdir} dépend de la façon suivant + laquelle le programme a été compilé et sera souvent <code class="filename">/etc/</code> + pour les paquets binaires. + packages.</p></dd><dt><span class="term">${XDG_CACHE_HOME}</span></dt><dd><p>Indique la racine de toutes les données en cache des utilisateurs. Si cette variable d'environnement + n'est pas renseignée, elle correspond par défaut à <code class="filename">~/.cache</code>.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}/xfce4-session/xfce4-session.rc</span></dt><dd><p>Ceci est l'emplacement du fichier de configuration qui contient les différents paramètres de <strong class="application"><code>xfce4-session</code></strong>, + qui peuvent être modifiés depuis le gestionnaire de paramètres.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}/xfce4-session/xfce4-splash.rc</span></dt><dd><p>Ceci est l'emplacement du fichier de configuration de l'écran de démarrage, qui peut être modifié depuis + le gestionnaire de paramètres.</p></dd><dt><span class="term">${XDG_CACHE_HOME}/sessions/</span></dt><dd><p>Le répertoire dans lequel <strong class="application"><code>xfce4-session</code></strong> et <strong class="application"><code>xfwm4</code></strong> enregistrent le données sur + les sessions.</p></dd><dt><span class="term">${sysconfdir}/xdg/xfce4/kiosk/kioskrc</span></dt><dd><p>Le fichier de configuration du mode Kiosk. Consultez <a href="#xfsm-kiosk-mode" target="_top">la section + suivante</a> pour une explication.</p></dd></dl></div><p>Aucun fichier de configuration, excepté le <code class="filename">kioskrc</code>, + ne sont conçus pour être édités à la main au cours d'une session Xfce; en fait, les changement apportés seraient + écrasés par le gestionnaire de session ou le gestionnaire de paramètres s'ils sont en cours de fonctionnement.</p><p>les administrateurs système sont susceptibles de vouloir personnaliser le fichier + <code class="filename">${sysconfdir}/xdg/xfce4-session/xfce4-session.rc</code> afin de changer les applications lancées + par défaut au démarrage de Xfce. Par exemple, si vous souhautez lancer <strong class="application"><code>xfce4-iconbox</code></strong> + au lieu de <strong class="application"><code>xftaskbar4</code></strong>, vous devrez modifier la section <span class="emphasis"><em>[Failsafe + Session]</em></span> pour qu'elle ressemble à cela:</p><pre class="programlisting"> +[Failsafe Session] +Count=4 +Client0_Command=xfwm4 +Client0_PerScreen=False +Client1_Command=xfce4-panel +Client1_PerScreen=True +Client2_Command=xfce4-iconbox +Client2_PerScreen=True +Client3_Command=xfdesktop +Client3_PerScreen=False +</pre></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfsm-kiosk-mode"></a>Le mode Kiosk</h3></div></div></div><p>Le gestionnaire de session supporte le mode Kiosk qui peut empêcher les utilisateurs de modifier les + paramètres de session. Pour l'utiliser, vous devez éditer ou créer le fichier + <code class="filename">${sysconfdir}/xdg/xfce4/kiosk/kioskrc</code>.</p><p>Le meilleur moyen d'expliquer le format utilisé dans ce fichier est de fournir un exemple. La section + xfce4-session de votre <code class="filename">kioskrc</code> peut ressembler à cela:</p><pre class="programlisting"> +[xfce4-session] +CustomizeSplash=ALL +CustomizeChooser=ALL +CustomizeLogout=ALL +CustomizeCompatibility=%wheel +Shutdown=%wheel +CustomizeSecurity=NONE +</pre><p>Cela autorise tous les utilisateurs à modifier leur écran de démarrage, les paramètres du sélecteur de session + et de la fenêtre de déconnexion, mais n'autorise que les utilisateurs appartenant au goupe <span class="emphasis"><em>wheel</em></span> à modifier les paramètres de compatibilité et d'arrêt du système. Personne ne sera autorisé à modifier + les paramètres de sécurité.</p><p>Le gestionnaire de session supporte les fonctionnalités KIOSK suivantes:</p><div class="variablelist"><dl><dt><span class="term">CustomizeSplash</span></dt><dd><p>Détermine si l'utilisateur est autorisé à personnaliser l'écran de démarrage.</p></dd><dt><span class="term">CustomizeChooser</span></dt><dd><p>Détermine si l'utilisateur est autorisé à personnaliser les paramètres du sélecteur de session.</p></dd><dt><span class="term">CustomizeLogout</span></dt><dd><p>Détermine si l'utilisateur est autorisé à modifier les paramètres de déconnexion.</p></dd><dt><span class="term">CustomizeCompatibility</span></dt><dd><p>Détermine si l'utilisateur est autorisé à modifier les paramètres de compatibilité + (avec KDE/Gnome)</p></dd><dt><span class="term">CustomizeSecurity</span></dt><dd><p>Détermine si l'utilisateur est autorisé à modifier les paramètres de sécurité. + Ceci est l'un des paramètres les plus <span class="emphasis"><em>IMPORTANTS</em></span>, puisqu'il empêche + les utilisateurs (en fait, <code class="filename">libICE</code>) à ouvrir un port TCP.</p></dd><dt><span class="term">Shutdown</span></dt><dd><p>Détermine si l'utilisateur est autorisé à éteindre (ou redémarrer) le système. Si un utilisateur n'y est + pas autorisé, les options correspondantes seront grisées dans sa fenêtre de déconnexion.</p></dd></dl></div></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfsm-copyright"></a>À propos de <strong class="application"><code>xfce4-session</code></strong></h2></div></div></div><p><strong class="application"><code>xfce4-session</code></strong> a été écrit par Benedikt Meurer + (<code class="email"><<a href="mailto:benny@xfce.org">benny@xfce.org</a>></code>). + Pour obtenir plus d'informations, visitez le + <a href="http://www.xfce.org" target="_top">site officiel de Xfce</a>. + </p><p>Pour signaler un bogue ou faire une suggestion concernant cette application ou ce manuel, utilisez le + gestionnaire de bogues à l'adresse suivante <a href="http://bugzilla.xfce.org/" target="_top">http://bugzilla.xfce.org/</a>. + </p><p>Si vous avez des questions à propos de l'installation ou de l'utilisation de ce programme, merci de les poser + sur la liste de diffusion de <a href="http://lunar-linux.org/mailman/listinfo/xfce" target="_top">xfce</a>. Les discussions sur le développement de Xfce ont lieu sur la liste de diffusion + <a href="http://lunar-linux.org/mailman/listinfo/xfce4-dev" target="_top">xfce4-dev</a>. + </p><p> This program is distributed under the terms of the + GNU General Public License as published by the Free Software Foundation; + either version 2 of the License, or (at your option) any later version. + </p><p>You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + </p></div></div></body></html> diff --git a/doc/fr/xfce4-session.xml b/doc/fr/xfce4-session.xml new file mode 100644 index 00000000..a553839e --- /dev/null +++ b/doc/fr/xfce4-session.xml @@ -0,0 +1,468 @@ +<?xml version='1.0'?> +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ + <!ENTITY date "November 2004"> + <!ENTITY appversion "4.2"> + <!ENTITY app "<application>xfce4-session</application>"> +]> + +<article id="xfce4-session" lang="en"> + +<!-- Header --> +<articleinfo> + + <title>Xfce 4 Session Manager</title> + + <copyright> + <year>2003</year> + <year>2004</year> + <holder>Benedikt Meurer</holder> + </copyright> + + + + <copyright> + <year>2005</year> <holder>François Le Clainche (French + translation)</holder> + </copyright> + + + + <legalnotice id="legalnotice"> + <para> + This document is provided under the terms of the GNU GPL, version + 2 or (at your option) any later version. + </para> + </legalnotice> + + <authorgroup> + <author> + <firstname>Benedikt</firstname> + <surname>Meurer</surname> + <affiliation> + <address><email>benny@xfce.org</email></address> + <orgname>os-cillation</orgname> + <orgdiv>System development</orgdiv> + <jobtitle>Software developer</jobtitle> + </affiliation> + </author> + +<!-- This is appropriate place for other contributors: translators, +maintainers, etc. Commented out by default. + + <othercredit role="translator"> + <firstname>Latin</firstname> <surname>Translator 1</surname> + <affiliation> + <orgname>Latin Translation Team</orgname> + <address><email>translator@gnome.org</email> </address> + </affiliation> <contrib>Latin translation</contrib> + </othercredit> +--> + + </authorgroup> + + <releaseinfo> + <para> </para> + Ce manuel décrit la version &appversion; de &app;. Dernière mise à jour: &date; + </releaseinfo> + +</articleinfo> + +<para> </para> + +<sect1 id="xfsm-intro"> + <title>Introduction</title> + + <para>&app; est un gestionnaire de session pour Xfce 4. Son rôle est de sauvegarder l'état de votre environnement + (les applications ouvertes et leur position) afin de les restaurer lors de la session suivante. Vous pouvez créer plusieurs + sessions et choisir parmi elles au démarrage. + </para> + + <para>&app; offre la gestion de session pour le protocole X11R6 ainsi que pour l'ancien protocole X11R5. + Si vous n'avez pas besoin du second, vous pouvez le désactiver au moment de la compilation en passant l'option + de configuration --disable-legacy-sm à ./configure. Ne lancez <emphasis>JAMAIS</emphasis> <application>smproxy</application> au cours d'une session gérée par &app;, sinon des choses bizarres + se produiront. La gestion de session selon le protocole X11R5 inclut tout ce que <application>smproxy</application> + ferait, avec en plus le support de l'affichage sur plusieurs moniteurs.</para> + +</sect1> + +<para> </para> + +<sect1 id="xfce4-session-settings"> + <title>Préférences du gestionnaire de session</title> + + <sect2 id="xfsm-general-settings"> + <title>Préférences générales</title> + + <figure id="xfsm-general-fig"> + <title>Préférences générales de &app;</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="images/xfsm-general.png" format="PNG" /> + </imageobject> + + <textobject> + <phrase>Montre l'onglet des préférences générales de &app;</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + + <variablelist> + <varlistentry> + <term>Afficher le sélecteur de session à chaque connexion</term> + <listitem> + <para>Si cette option est sélectionnée, le gestionnaire de session vous demandera de choisir une session + à chacune des connexions à Xfce.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Enregistrer automatiquement la session lors de la fermeture</term> + <listitem> + <para>Cette option indique au gestionnaire de session de sauvegarder automatiquement la session lors de + la déconnexion. Si vous ne sélectionnez pas cette option, la question vous sera posée à chaque fois.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Demander à la déconnexion</term> + <listitem> + <para>Cette option désactive la fenêtre de confirmation de la déconnexion. La sauvegarde de la session + dépend alors du choix de l'option de sauvegarde automatique de la session.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + + <sect2 id="xfsm-advanced settings"> + <title>Préférences avancées</title> + + <figure id="xfsm-advanced-fig"> + <title>Préférences avancées de &app;</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="images/xfsm-advanced.png" format="PNG" /> + </imageobject> + + <textobject> + <phrase>Montre l'onglet des préférences avancées de &app;.</phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + + <variablelist> + <varlistentry> + <term>Charger les services Gnome au démarrage</term> + <listitem> + <para>Activer cette option si vous avez besoin d'exécuer le démon GNOME keyring au démarrage. Cette + option indique également à &app; de lancer les technologies d'assistance de GNOME au démarrage (si elles + sont activées dans le centre de contrôle de GNOME). Consultez la documentation de GNOME pour plus + d'informations à ce sujet.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Charger les services KDE au démarrage</term> + <listitem> + <para>Activez cette option si vous prévoyer de lancer des applications KDE au sein de votre session Xfce. + Cela augmentera sensiblement le temps de démarrage de Xfce, mais d'un autre côté, les applications KDE + démarreront plus rapidement. Certaines applications KDE peuvent ne pas fonctionner du tout si vous + n'activez pas cette option.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Gérer le applications distantes</term> + <listitem> + <para>Autorise le gestionnaire de session à gérer les applications en cours de fonctionnement sur des + hôtes distants. Cette option peut représenter un risque en termes de sécurité, en activant un port TCP sur + votre système. Ne l'activez pas sans savoir ce que vous faites.</para> + <para>Les administrateurs système qui souhaitent désactiver cette option globalement peuvent pour cela + utiliser le mode <ulink url="#xfsm-kiosk-mode" type="html">KIOSK</ulink>.</para> + </listitem> + </varlistentry> + </variablelist> + + </sect2> +</sect1> + +<para> </para> + +<sect1 id="xfsm-customize"> + <title>Personnaliser le gestionnaire de session</title> + + <para>Vous pouvez personnaliser l'écran démarrage que &app; affichera lors de la connexion à Xfce 4. Une fenêtre + de configuration dédiée est disponible depuis le <emphasis>gestionnaire de paramètres de Xfce 4</emphasis>.</para> + + <sect2 id="xfsm-engines"> + <title>Paramètres de l'écran de démarrage</title> + + <figure id="splash-screen-settings-fig"> + <title>La fenêtre de paramétrage de l'écran de démarrage</title> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="images/xfsm-splash.png" format="PNG" /> + </imageobject> + + <textobject> + <phrase>Montre la fenêtre de paramétrage de l'écran de démarrage de &app; </phrase> + </textobject> + </mediaobject> + </screenshot> + </figure> + + <para>Sur la gauche, la fenêtre montre une liste de tous les moteurs de thème installés. Sélectionnez un moteur, + et vous verrez, si elle est disponible, une prévisualisation et des informations le concernant. Vous pouvez cliquer sur + le bouton <guibutton>Tester</guibutton> pour voir une démonstration du thème d'écran de démarrage + sélectionné.</para> + + <para>&app; fournit par défaut trois moteurs de thème d'écran de démarrage. Leurs options de configuration + respectives - si disponibles - sont disponibles en cliquant sur le bouton <guibutton>Configurer</guibutton>.</para> + </sect2> + + <sect2 id="xfsm-shutdown"> + <title>Les options d'arrêt/redémarrage</title> + + <para>&app; supporte l'arrêt de votre ordinateur lors de la déconnexion de la session. Pour cela, vous devez + être listé dans le fichier <filename>sudoers</filename> du système, et vous devez en particulier être autorisé + à exécuter la commande <filename>${libexecdir}/xfsm-shutdown-helper</filename> + (<filename>/usr/sbin/xfsm-shutdown-helper</filename> sous Debian GNU/Linux) + en tant qu'utilisateur root (où <filename>${libexecdir}</filename> est le sous répertoire <filename + role="directory">libexec</filename> selon le préfixe utilisé pour installer &app;, par exemple + <filename role="directory">/usr/local/libexec</filename>).</para> + + <para>pas exemple, si vous avez installé &app; dans <filename + role="directory">/usr/local</filename>, que votre nom d'hôte est <emphasis>myhost</emphasis> + et que votre compte utilisateur est nommé<emphasis>myuser</emphasis>, alors vous devez ajouter la ligne + suivante au fichier <filename>sudoers</filename> (souvenez-vous d'utiliser <application>visudo</application> + pour éditer ce fichier):</para> + +<programlisting> +myuser myhost=/usr/local/libexec/xfsm-shutdown-helper +</programlisting> + </sect2> + +</sect1> + +<para> </para> + +<sect1 id="xfsm-advanced"> + <title>Avancé</title> + + <sect2 id="files-and-env-vars"> + <title>Fichiers et variables d'environnement</title> + + <para>Xfce utilise maintenant la spécification Basedir telle que définie sur <ulink + url="http://freedesktop.org/" type="http">Freedesktop.org</ulink> pour chercher ses données et ses fichiers de + configuration. Cela signifie que les emplacements de ces fichiers seront indiqués selon un chemin relatif aux + répertoires décrits dans cette spécification.</para> + + <variablelist> + <varlistentry> + <term>${XDG_CONFIG_HOME}</term> + <listitem> + <para>Le premier répertoire où il faut rechercher les fichiers de configuration. Par défaut, c'est + <filename role="directory">~/.config/</filename>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}</term> + <listitem> + <para>Une liste des répertoires contenant des données de configuration. Par défaut, le panneau cherchera + dans <filename role="directory">${sysconfdir}/xdg/</filename> et + <filename role="directory">/etc/xdg/</filename>. La valeur de ${sysconfdir} dépend de la façon suivant + laquelle le programme a été compilé et sera souvent <filename role="directory">/etc/</filename> + pour les paquets binaires. + packages.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CACHE_HOME}</term> + <listitem> + <para>Indique la racine de toutes les données en cache des utilisateurs. Si cette variable d'environnement + n'est pas renseignée, elle correspond par défaut à <filename + role="directory">~/.cache</filename>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}/xfce4-session/xfce4-session.rc</term> + <listitem> + <para>Ceci est l'emplacement du fichier de configuration qui contient les différents paramètres de &app;, + qui peuvent être modifiés depuis le gestionnaire de paramètres.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CONFIG_DIRS}/xfce4-session/xfce4-splash.rc</term> + <listitem> + <para>Ceci est l'emplacement du fichier de configuration de l'écran de démarrage, qui peut être modifié depuis + le gestionnaire de paramètres.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${XDG_CACHE_HOME}/sessions/</term> + <listitem> + <para>Le répertoire dans lequel &app; et <application>xfwm4</application> enregistrent le données sur + les sessions.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>${sysconfdir}/xdg/xfce4/kiosk/kioskrc</term> + <listitem> + <para>Le fichier de configuration du mode Kiosk. Consultez <ulink url="#xfsm-kiosk-mode">la section + suivante</ulink> pour une explication.</para> + </listitem> + </varlistentry> + </variablelist> + + <para>Aucun fichier de configuration, excepté le <filename>kioskrc</filename>, + ne sont conçus pour être édités à la main au cours d'une session Xfce; en fait, les changement apportés seraient + écrasés par le gestionnaire de session ou le gestionnaire de paramètres s'ils sont en cours de fonctionnement.</para> + + <para>les administrateurs système sont susceptibles de vouloir personnaliser le fichier + <filename>${sysconfdir}/xdg/xfce4-session/xfce4-session.rc</filename> afin de changer les applications lancées + par défaut au démarrage de Xfce. Par exemple, si vous souhautez lancer <application>xfce4-iconbox</application> + au lieu de <application>xftaskbar4</application>, vous devrez modifier la section <emphasis>[Failsafe + Session]</emphasis> pour qu'elle ressemble à cela:</para> + +<programlisting> +[Failsafe Session] +Count=4 +Client0_Command=xfwm4 +Client0_PerScreen=False +Client1_Command=xfce4-panel +Client1_PerScreen=True +Client2_Command=xfce4-iconbox +Client2_PerScreen=True +Client3_Command=xfdesktop +Client3_PerScreen=False +</programlisting> + </sect2> + + <sect2 id="xfsm-kiosk-mode"> + <title>Le mode Kiosk</title> + + <para>Le gestionnaire de session supporte le mode Kiosk qui peut empêcher les utilisateurs de modifier les + paramètres de session. Pour l'utiliser, vous devez éditer ou créer le fichier + <filename>${sysconfdir}/xdg/xfce4/kiosk/kioskrc</filename>.</para> + + <para>Le meilleur moyen d'expliquer le format utilisé dans ce fichier est de fournir un exemple. La section + xfce4-session de votre <filename>kioskrc</filename> peut ressembler à cela:</para> + +<programlisting> +[xfce4-session] +CustomizeSplash=ALL +CustomizeChooser=ALL +CustomizeLogout=ALL +CustomizeCompatibility=%wheel +Shutdown=%wheel +CustomizeSecurity=NONE +</programlisting> + + <para>Cela autorise tous les utilisateurs à modifier leur écran de démarrage, les paramètres du sélecteur de session + et de la fenêtre de déconnexion, mais n'autorise que les utilisateurs appartenant au goupe <emphasis>wheel</emphasis> à modifier les paramètres de compatibilité et d'arrêt du système. Personne ne sera autorisé à modifier + les paramètres de sécurité.</para> + + <para>Le gestionnaire de session supporte les fonctionnalités KIOSK suivantes:</para> + + <variablelist> + <varlistentry> + <term>CustomizeSplash</term> + <listitem> + <para>Détermine si l'utilisateur est autorisé à personnaliser l'écran de démarrage.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeChooser</term> + <listitem> + <para>Détermine si l'utilisateur est autorisé à personnaliser les paramètres du sélecteur de session.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeLogout</term> + <listitem> + <para>Détermine si l'utilisateur est autorisé à modifier les paramètres de déconnexion.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeCompatibility</term> + <listitem> + <para>Détermine si l'utilisateur est autorisé à modifier les paramètres de compatibilité + (avec KDE/Gnome)</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>CustomizeSecurity</term> + <listitem> + <para>Détermine si l'utilisateur est autorisé à modifier les paramètres de sécurité. + Ceci est l'un des paramètres les plus <emphasis>IMPORTANTS</emphasis>, puisqu'il empêche + les utilisateurs (en fait, <filename>libICE</filename>) à ouvrir un port TCP.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Shutdown</term> + <listitem> + <para>Détermine si l'utilisateur est autorisé à éteindre (ou redémarrer) le système. Si un utilisateur n'y est + pas autorisé, les options correspondantes seront grisées dans sa fenêtre de déconnexion.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> +</sect1> + +<para> </para> + +<sect1 id="xfsm-copyright"> + <title>À propos de &app;</title> + + <para>&app; a été écrit par Benedikt Meurer + (<email>benny@xfce.org</email>). + Pour obtenir plus d'informations, visitez le + <ulink url="http://www.xfce.org" type="http">site officiel de Xfce</ulink>. + </para> + + <para>Pour signaler un bogue ou faire une suggestion concernant cette application ou ce manuel, utilisez le + gestionnaire de bogues à l'adresse suivante <ulink + url="http://bugzilla.xfce.org/" + type="http">http://bugzilla.xfce.org/</ulink>. + </para> + + <para>Si vous avez des questions à propos de l'installation ou de l'utilisation de ce programme, merci de les poser + sur la liste de diffusion de <ulink + url="http://lunar-linux.org/mailman/listinfo/xfce" + type="http">xfce</ulink>. Les discussions sur le développement de Xfce ont lieu sur la liste de diffusion + <ulink + url="http://lunar-linux.org/mailman/listinfo/xfce4-dev" + type="http">xfce4-dev</ulink>. + </para> + + <para> This program is distributed under the terms of the + GNU General Public License as published by the Free Software Foundation; + either version 2 of the License, or (at your option) any later version. + </para> + + <para>You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, + USA. + </para> + +</sect1> + +</article> + diff --git a/doc/xfce-nochunk.xsl b/doc/xfce-nochunk.xsl new file mode 100644 index 00000000..3dae476e --- /dev/null +++ b/doc/xfce-nochunk.xsl @@ -0,0 +1,270 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0' + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<!-- Load onechunk.xsl stylesheet + TODO: how can I put a location independent link here? +This should work. The url can be translated to a local one in the catalog +file" +--> +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/onechunk.xsl"/> + +<xsl:param name="suppress.navigation">1</xsl:param> + +<!-- Use stylesheet --> +<xsl:param name="html.stylesheet" select="'../xfce.css'"/> + +<!-- labels and numbering --> +<xsl:param name="autotoc.label.separator" select="'. '"/> +<xsl:param name="chapter.autolabel" select="1"/> + +<!-- Don't force the use of index.html as root filename --> +<xsl:param name="root.filename" select="''"/> + +<!-- Use element id (if present) as file name --> +<xsl:variable name="use.id.as.filename">1</xsl:variable> + +<xsl:template match="releaseinfo" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<!-- Use graphics in admonitions (note, warning, etc) --> +<xsl:variable name="admon.graphics">0</xsl:variable> + +<xsl:param name="admon.style"> + <xsl:text>text-align: left;</xsl:text></xsl:param> + +<xsl:variable name="admon.graphics.path">stylesheet-images/</xsl:variable> + +<xsl:variable name="admon.graphics.extension">.gif</xsl:variable> + +<xsl:param name="table.border.thickness" select="'0.2pt'"/> + +<xsl:param name="graphic.default.extension" select="png"/> + +<xsl:attribute-set name="shade.verbatim.style"> + <xsl:attribute name="border">0</xsl:attribute> + <xsl:attribute name="bgcolor">#F3F4F8</xsl:attribute> + <xsl:attribute name="width">100%</xsl:attribute> +</xsl:attribute-set> + +<!-- Addition by Jasper Huijsmans to be able to set background color --> +<!-- and cell attributes. --> +<!-- This requires an adapted template for tgroup (see end of stylesheet) --> +<xsl:attribute-set name="table.style"> + <xsl:attribute name="bgcolor">#F8F9FD</xsl:attribute> + <xsl:attribute name="cellspacing">0</xsl:attribute> + <xsl:attribute name="cellpadding">4</xsl:attribute> +</xsl:attribute-set> + + +<xsl:param name="generate.legalnotice.link" select="0"/> + +<xsl:param name="shade.verbatim" select="1"/> + +<!-- set font styles for various tags --> +<xsl:template match="guibutton"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="guiicon"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="guilabel"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="guimenu"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="guimenuitem"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="guisubmenu"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="application"> +<xsl:call-template name="inline.boldmonoseq"/> +</xsl:template> + +<xsl:template match="caption"> +<xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<!-- Adapted template for tgroup. The only change is the addition of --> +<!-- table.style attributes --> +<xsl:template match="tgroup"> + <table xsl:use-attribute-sets="table.style"> + <xsl:choose> + <!-- If there's a <?dbhtml table-summary="foo"?> PI, use it for + the HTML table summary attribute --> + <xsl:when test="processing-instruction('dbhtml')"> + <xsl:variable name="summary"> + <xsl:call-template name="dbhtml-attribute"> + <xsl:with-param name="pis" + select="processing-instruction('dbhtml')[1]"/> + <xsl:with-param name="attribute" select="'table-summary'"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="$summary != ''"> + <xsl:attribute name="summary"> + <xsl:value-of select="$summary"/> + </xsl:attribute> + </xsl:if> + </xsl:when> + <!-- Otherwise, if there's a title, use that --> + <xsl:when test="../title"> + <xsl:attribute name="summary"> + <xsl:value-of select="string(../title)"/> + </xsl:attribute> + </xsl:when> + <!-- Otherwise, forget the whole idea --> + <xsl:otherwise><!-- nevermind --></xsl:otherwise> + </xsl:choose> + + <xsl:if test="../@pgwide=1"> + <xsl:attribute name="width">100%</xsl:attribute> + </xsl:if> + + <xsl:choose> + <xsl:when test="../@frame='none'"> + <xsl:attribute name="border">0</xsl:attribute> + </xsl:when> + <xsl:when test="$table.borders.with.css != 0"> + <xsl:attribute name="border">0</xsl:attribute> + <xsl:choose> + <xsl:when test="../@frame='topbot' or ../@frame='top'"> + <xsl:attribute name="style"> + <xsl:call-template name="border"> + <xsl:with-param name="side" select="'top'"/> + </xsl:call-template> + </xsl:attribute> + </xsl:when> + <xsl:when test="../@frame='sides'"> + <xsl:attribute name="style"> + <xsl:call-template name="border"> + <xsl:with-param name="side" select="'left'"/> + </xsl:call-template> + <xsl:call-template name="border"> + <xsl:with-param name="side" select="'right'"/> + </xsl:call-template> + </xsl:attribute> + </xsl:when> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="border">1</xsl:attribute> + </xsl:otherwise> + </xsl:choose> + + <xsl:variable name="colgroup"> + <colgroup> + <xsl:call-template name="generate.colgroup"> + <xsl:with-param name="cols" select="@cols"/> + </xsl:call-template> + </colgroup> + </xsl:variable> + + <xsl:variable name="explicit.table.width"> + <xsl:call-template name="dbhtml-attribute"> + <xsl:with-param name="pis" + select="../processing-instruction('dbhtml')[1]"/> + <xsl:with-param name="attribute" select="'table-width'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="table.width"> + <xsl:choose> + <xsl:when test="$explicit.table.width != ''"> + <xsl:value-of select="$explicit.table.width"/> + </xsl:when> + <xsl:when test="$default.table.width = ''"> + <xsl:text>100%</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$default.table.width"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:if test="$default.table.width != '' + or $explicit.table.width != ''"> + <xsl:attribute name="width"> + <xsl:choose> + <xsl:when test="contains($table.width, '%')"> + <xsl:value-of select="$table.width"/> + </xsl:when> + <xsl:when test="$use.extensions != 0 + and $tablecolumns.extension != 0"> + <xsl:choose> + <xsl:when test="function-available('stbl:convertLength')"> + <xsl:value-of select="stbl:convertLength($table.width)"/> + </xsl:when> + <xsl:when test="function-available('xtbl:convertLength')"> + <xsl:value-of select="xtbl:convertLength($table.width)"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>No convertLength function available.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$table.width"/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </xsl:if> + + <xsl:choose> + <xsl:when test="$use.extensions != 0 + and $tablecolumns.extension != 0"> + <xsl:choose> + <xsl:when test="function-available('stbl:adjustColumnWidths')"> + <xsl:copy-of select="stbl:adjustColumnWidths($colgroup)"/> + </xsl:when> + <xsl:when test="function-available('xtbl:adjustColumnWidths')"> + <xsl:copy-of select="xtbl:adjustColumnWidths($colgroup)"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>No adjustColumnWidths function available.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$colgroup"/> + </xsl:otherwise> + </xsl:choose> + + <xsl:apply-templates select="thead"/> + <xsl:apply-templates select="tbody"/> + <xsl:apply-templates select="tfoot"/> + + <xsl:if test=".//footnote"> + <tbody class="footnotes"> + <tr> + <td colspan="{@cols}"> + <xsl:apply-templates select=".//footnote" + mode="table.footnote.mode"/> + </td> + </tr> + </tbody> + </xsl:if> + </table> +</xsl:template> + + +</xsl:stylesheet> + |