User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.8.1.14) Gecko/20080404 Iceweasel/2.0.0.14 (Debian-2.0.0.14-2) Build Identifier: The documentation of the xfce-mcs-manager is not html-valid. Even a doctype was missing Reproducible: Always Steps to Reproduce: Steps to Reproduce: 1. go to http://validator.w3.org/#validate_by_input 2. copy the content of the file /usr/share/xfce4/doc/C/xfce-mcs-manager.html into the white field 3. press "check" Actual Results: The validator says: This page is not Valid (no Doctype found)! Result: Failed validation, 4 Errors Expected Results: The validator should have said: "This Page Is Valid XHTML 1.0 Strict! Result: Passed validation" I made a patch: xfce-ms-manager.html: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/> <title>Xfce 4 Settings Manager</title> <link rel="stylesheet" href="../xfce.css" type="text/css"/> <meta name="generator" content="Bluefish 1.0.7"/> <link rel="start" href="#xfce-mcs-manager" title="Xfce 4 Settings Manager"/> <link rel="next" href="#manager-intro" title="Introduction"/> </head> <body> <div class="article" lang="en"> <div class="titlepage"> <div> <div> <h1 class="title"><a name="xfce-mcs-manager"></a>Xfce 4 Settings Manager</h1> </div> <div> <div class="authorgroup"> <div class="author"> <h3 class="author"><span class="firstname">François</span> <span class="surname">Le Clainche</span></h3> <div class="affiliation"> <div class="address"> <p><code class="email"><<a href="mailto:fleclainche@wanadoo.fr">fleclainche@wanadoo.fr</a>></code></p> </div> </div> </div> <div class="author"> <h3 class="author"><span class="firstname">Jasper</span> <span class="surname">Huijsmans</span></h3> <div class="affiliation"> <div class="address"> <p><code class="email"><<a href="mailto:huysmans@users.sourceforge.net">huysmans@users.sourceforge.net</a>></code></p> </div> </div> </div> </div> </div> <div> <span class="releaseinfo">This manual describes <strong class="application"><code>xfce-mcs-manager</code></strong> version 4.1.x<br></br></span> </div> <div> <p class="copyright">Copyright © 2004 François Le Clainche</p> </div> <div> <p class="copyright">Copyright © 2004 Jasper Huijsmans</p> </div> </div> <hr /> </div> <div class="toc"> <p><b>Table of Contents</b></p> <dl> <dt> <span class="sect1"><a href="#manager-intro">Introduction</a></span> </dt> <dt> <span class="sect1"><a href="#manager-dialog">Settings Manager Dialog</a></span> </dt> <dd> <dl> <dt> <span class="sect2"><a href="#id2490498">Opening the dialog</a></span> </dt> <dt> <span class="sect2"><a href="#id2490633">Using the dialog</a></span> </dt> </dl> </dd> <dt> <span class="sect1"><a href="#manager-backend">Settings Manager Backend</a></span> </dt> <dt> <span class="sect1"><a href="#manager-copyright">About Xfce 4 Settings Manager</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="manager-intro"></a>Introduction</h2> </div> </div> </div> <p>The Xfce 4 settings manager provides access to the settings of all Xfce 4 components. The application consists of two parts. The settings manager dialog, which is the only part a user should need to know about, and the settings manager backend that <span class="emphasis"><em>talks</em></span> to the Xfce 4 programs and informs them of changes to the preferences. </p> <p>On a technical note, the settings manager backend uses an the XSETTINGS protocol as defined on freedesktop.org, adapted to allow multiple channels, so a module can listen only to changes it is interested in; The mcs in the name stands for <span class="emphasis"><em>multichannel settings</em></span>. </p> </div> <p> </p> <div class="sect1" lang="en"> <div class="titlepage"> <div> <div> <h2 class="title" style="clear: both"><a name="manager-dialog"></a>Settings Manager Dialog</h2> </div> </div> </div> <div class="sect2" lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a name="id2490498"></a>Opening the dialog</h3> </div> </div> </div> <p>There are several ways to open the settings manager dialog.</p> <p>First of all, you can open it from the Xfce 4 panel. There is a launcher on the panel in the default configuration. If you want you can also add a special setup button that is part of the Systemsbuttons item. </p> <div class="figure"> <a name="smgr-setup-button-fig"></a> <p class="title"><b>Figure 1. Setup button on Xfce 4 panel</b></p> <div class="screenshot"> <div class="mediaobject"> <img src="images/smgr_from_setup_button.png" alt="Shows setup button on Xfce 4 panel, used to open the settings manager dialog." /> </div> </div> </div> <p>The root window menu provided by the Xfce 4 Desktop Manager (<strong class="application"><code>xfdesktop</code></strong>) contains an entry to open the settings manager dialog. Right-click on the desktop background and choose <span><strong class="guibutton">Xfce 4 Settings Manager</strong></span> in the <span><strong class="guibutton">Settings</strong></span> sub-menu. </p> <div class="figure"> <a name="smgr-root-menu-fig"></a> <p class="title"><b>Figure 2. Root window mouse menu</b></p> <div class="screenshot"> <div class="mediaobject"> <img src="images/smgr_from_root_menu.png" alt="Shows root window mouse menu, used to open the settings manager dialog."/> </div> </div> </div> <p>Finally, you can open the settings manager dialog by running <strong class="application"><code>xfce-setting-show</code></strong>. </p> </div> <div class="sect2" lang="en"> <div class="titlepage"> <div> <div> <h3 class="title"><a name="id2490633"></a>Using the dialog</h3> </div> </div> </div> <p>The Xfce 4 Settings Manager dialog provides centralized access to the preferences of all installed Xfce 4 components. They don't necessarily have to be running. </p> <div class="figure"> <a name="smgr-dialog-fig"></a> <p class="title"><b>Figure 3. Settings Manager Dialog</b></p> <div class="screenshot"> <div class="mediaobject"> <img src="images/settings_manager.png" alt="Shows settings manager dialog."/> </div> </div> </div> <p>Just click on the button corresponding to the module that you want to configure. This action will open a new properties dialog. Usually, all modifications will have an immediate effect on the behaviour of the selected module (<span class="emphasis"><em>instant apply</em></span>). Once you have finished changing the options, you can close the dialog by clicking on the <span><strong class="guibutton">Close</strong></span> button. Note that there is no <span><strong class="guibutton">Cancel</strong></span>; if you change your mind about a setting you will manually have to change it back. </p> <p>Please refer to the <a href="index.html">manuals</a> of the different Xfce 4 components to learn more about their configuration options. </p> </div> </div> <p> </p> <div class="sect1" lang="en"> <div class="titlepage"> <div> <div> <h2 class="title" style="clear: both"><a name="manager-backend"></a>Settings Manager Backend</h2> </div> </div> </div> <p>The <strong class="application"><code>xfce-mcs-manager</code></strong> application should be started before the other Xfce 4 components. In fact, the panel and the windowmanager both will try to run the manager if it is not already running. </p> <p>The <strong class="application"><code>startxfce4</code></strong> script provided with Xfce 4 (part of the <span class="emphasis"><em>xfce-utils</em></span> package) takes care of running it at the start of an X session. If you don't use that add it to your <code class="filename">~/.xinitrc</code> file. The manager will run in the background after it has initialized, so there is no need to add an '&' after the command. </p> <p>After installing a new package that provides a settings dialog, you can make the manager reread its configuration by sending a SIGUSR1 signal: </p> <pre class="programlisting"> $ killall -USR1 xfce-mcs-manager</pre> </div> <p> </p> <div class="sect1" lang="en"> <div class="titlepage"> <div> <div> <h2 class="title" style="clear: both"><a name="manager-copyright"></a>About Xfce 4 Settings Manager</h2> </div> </div> </div> <p>This package was written by Olivier Fourdan (<code class="email"><<a href="mailto:fourdan@xfce.org">fourdan@xfce.org</a>></code>), Jasper Huijsmans (<code class="email"><<a href="mailto:jasper@xfce.org">jasper@xfce.org</a>></code>) and 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">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/">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">xfce</a> mailing list. Development discussion takes place on the <a href="http://lunar-linux.org/mailman/listinfo/xfce4-dev">xfce4-dev</a> mailing list. </p><p> This program is distributed under the terms of the GNU Lesser 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 Lesser 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>
Close bugs in products that are not active anymore.