[Goodies-commits] r5747 - in xfce4-power-manager/trunk/doc/C: . images
Ali Abdallah
aliov at xfce.org
Wed Oct 22 21:46:13 CEST 2008
Author: aliov
Date: 2008-10-22 19:46:13 +0000 (Wed, 22 Oct 2008)
New Revision: 5747
Added:
xfce4-power-manager/trunk/doc/C/images/battery-settings.png
xfce4-power-manager/trunk/doc/C/images/button-settings.png
xfce4-power-manager/trunk/doc/C/images/cpu-settings.png
xfce4-power-manager/trunk/doc/C/images/general-settings.png
xfce4-power-manager/trunk/doc/C/images/monitor-settings.png
Modified:
xfce4-power-manager/trunk/doc/C/images/Makefile.am
xfce4-power-manager/trunk/doc/C/xfce4-power-manager.html
xfce4-power-manager/trunk/doc/C/xfce4-power-manager.xml
Log:
Update documentation
Modified: xfce4-power-manager/trunk/doc/C/images/Makefile.am
===================================================================
--- xfce4-power-manager/trunk/doc/C/images/Makefile.am 2008-10-22 17:22:15 UTC (rev 5746)
+++ xfce4-power-manager/trunk/doc/C/images/Makefile.am 2008-10-22 19:46:13 UTC (rev 5747)
@@ -1,6 +1,10 @@
imagesdir = $(datadir)/xfce4/doc/C/images
-images_DATA =
+images_DATA = cpu-settings.png \
+ general-settings.png \
+ battery-settings.png \
+ monitor-settings.png \
+ button-settings.png
EXTRA_DIST = $(images_DATA)
Added: xfce4-power-manager/trunk/doc/C/images/battery-settings.png
===================================================================
(Binary files differ)
Property changes on: xfce4-power-manager/trunk/doc/C/images/battery-settings.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: xfce4-power-manager/trunk/doc/C/images/button-settings.png
===================================================================
(Binary files differ)
Property changes on: xfce4-power-manager/trunk/doc/C/images/button-settings.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: xfce4-power-manager/trunk/doc/C/images/cpu-settings.png
===================================================================
(Binary files differ)
Property changes on: xfce4-power-manager/trunk/doc/C/images/cpu-settings.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: xfce4-power-manager/trunk/doc/C/images/general-settings.png
===================================================================
(Binary files differ)
Property changes on: xfce4-power-manager/trunk/doc/C/images/general-settings.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: xfce4-power-manager/trunk/doc/C/images/monitor-settings.png
===================================================================
(Binary files differ)
Property changes on: xfce4-power-manager/trunk/doc/C/images/monitor-settings.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: xfce4-power-manager/trunk/doc/C/xfce4-power-manager.html
===================================================================
--- xfce4-power-manager/trunk/doc/C/xfce4-power-manager.html 2008-10-22 17:22:15 UTC (rev 5746)
+++ xfce4-power-manager/trunk/doc/C/xfce4-power-manager.html 2008-10-22 19:46:13 UTC (rev 5747)
@@ -1,5 +1,90 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Xfce 4 Power Manager</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="#xfce4-power-manager" title="Xfce 4 Power Manager"><link rel="next" href="#xfpm-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><h2 class="title"><a name="xfce4-power-manager"></a>Xfce 4 Power Manager</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Ali</span> <span class="surname">Abdallah</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:ali.slackware at gmail.com">ali.slackware at gmail.com</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.
w3.org/TR/xhtml1/transitional" class="releaseinfo">This manual describes <strong xmlns="" class="application"><code>xfce4-power-manager</code></strong> version 0.6.0
-<br></br></span></div><div><p class="copyright">Copyright © 2008 Ali Abdallah</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#xfpm-intro">Introduction</a></span></dt><dt><span class="sect1"><a href="#xfpm-using">Using <strong class="application"><code>xfce4-power-manager</code></strong></a></span></dt><dt><span class="sect1"><a href="#xfpm-configuration">Power Manager Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-cpu">CPU settings</a></span></dt><dt><span class="sect2"><a href="#xfpm-battery">Battery settings</a></span></dt><dt><span class="sect2"><a href="#xfpm-button">Keyboard shortcuts</a></span></dt><dt><span class="sect2"><a href="#xfpm-monitor">Monitor settings</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm-faq">FAQ</a></span></dt><dt><span class="sect1"><a href="#xfpm-about">About <strong class="application"><code>xfce4-power-manager</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="xfpm-intro"></a>Introduction</h2></div></div></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-using"></a>Using <strong class="application"><code>xfce4-power-manager</code></strong></h2></div></div></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-configuration"></a>Power Manager Configuration</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-cpu"></a>CPU settings</h3></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-battery"></a>Battery settings</h3></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><di
v><div><h3 class="title"><a name="xfpm-button"></a>Keyboard shortcuts</h3></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-monitor"></a>Monitor settings</h3></div></div></div></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-faq"></a>FAQ</h2></div></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-about"></a>About <strong class="application"><code>xfce4-power-manager</code></strong></h2></div></div></div></div><p> </p><p> </p><p> This program is distributed under the terms of the
+<br></br></span></div><div><p class="copyright">Copyright © 2008 Ali Abdallah</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#xfpm-intro">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-started">Getting Started</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm-configuration">Power Manager Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-general">General Settings</a></span></dt><dt><span class="sect2"><a href="#xfpm-cpu">CPU Settings</a></span></dt><dt><span class="sect2"><a href="#xfpm-battery">Battery settings</a></span></dt><dt><span class="sect2"><a href="#xfpm-button">Keyboard shortcuts</a></span></dt><dt><span class="sect2"><a href="#xfpm-monitor">Monitor settings</a></span></dt><dt><span class="sect2"><a href="#xfpm-systray">System Tray Icon</a></span></dt><dt><span class="sect2"><a href="#xfpm-notify">Notification</a></span></dt></dl>
</dd><dt><span class="sect1"><a href="#xfpm-faq">FAQ</a></span></dt><dt><span class="sect1"><a href="#xfpm-about">About <strong class="application"><code>xfce4-power-manager</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="xfpm-intro"></a>Introduction</h2></div></div></div>
+ The Xfce4 power manager is a part of the Xfce goodies project and features cpu frequency control,
+ battery monitoring, monitor DPMS control, LCD brightness control, lid sleep and power buttons control.
+ All those features can be controlled from the user interface settings dialog.
+ <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-started"></a>Getting Started</h3></div></div></div><p>To launch the Power Manager you need to run the following command <strong class="application"><code>xfce4-power-manager</code></strong> -r you can do from the xfce run
+ command by pressing ALT-F2, or you go to the Xfce settings manager and you click on the Power Manager item
+ , a popup should be displayed only if the power manager isn't already running to ask you if you want to.
+ Once the power manager is launched for the first time, it'll place a autostart desktop file in you .config/autostart
+ so like that it gets launched automatically second time you log into your Xfce desktop.
+ </p></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-configuration"></a>Power Manager Configuration</h2></div></div></div><p>
+ Almost all the <strong class="application"><code>xfce4-power-manager</code></strong> items are configurable from the configuration window, laptop users can set up
+ a power profile for two different modes “on battery power” and “on ac power”, desktop users still can change
+ DPMS settings and CPU frequency.
+ </p><p>
+ The settings dialog differs from one system to another depends on the computer (PC,laptop,...) and on
+ the available manageabale interfaces.
+ </p><p>
+ In this section we will describe the possible configuration for the power manager.
+ </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-general"></a>General Settings</h3></div></div></div><div class="figure"><a name="id2532398"></a><p class="title"><b>Figure 1. General settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/general-settings.png" alt="General settings"></div></div></div></div><p><br class="figure-break"></p><p>
+ Here you can select the configuration of the system tray icon, enable/disable cpu frequency and DPMS controls,
+ typical reason to disable DPMS control for example if you are watching a movie.
+ </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-cpu"></a>CPU Settings</h3></div></div></div><div class="figure"><a name="id2529126"></a><p class="title"><b>Figure 2. CPU Linux governors</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/cpu-settings.png" alt="CPU Linux governors"></div></div></div></div><p><br class="figure-break"></p><p>
+ The linux governors found in the system are listed for choice as a radio buttons,
+ if the acpi_cpufreq module is not loaded in the kernel or the cpu itself doesn't support
+ changes in it's frequency these options might not be shown.
+ </p><p>Here's a brief descritption on linux cpu governors</p><div class="variablelist"><dl><dt><span class="term">Performance:</span></dt><dd><p> Set the CPU to it's maximum frequency. will consume more power,
+ and it's not ideal when running on battery.
+ </p></dd><dt><span class="term">Powersave:</span></dt><dd><p>
+ Set the CPU to it's minimum frequency, ideal when running on battery power.
+ </p></dd><dt><span class="term">Userspace:</span></dt><dd><p> In this governor, allows the user, or any userspace
+ program running with UID "root", to set the CPU to a specific frequency.
+ </p></dd><dt><span class="term">Ondemand:</span></dt><dd><p> What you want is what you get. sets the CPU depending on the
+ current usage.
+ </p></dd><dt><span class="term">Conservative:</span></dt><dd><p>
+ Same as Ondemand but differs in behaviour in that it gracefully increases and decreases
+ the CPU speed rather than jumping to max speed the moment there is any load on the CPU.
+ </p></dd></dl></div><p>
+NOTE:In <strong class="application"><code>xfce4-power-manager</code></strong> version 0.6.0 only Linux is supported for changing the cpu frequency.
+</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-battery"></a>Battery settings</h3></div></div></div><div class="figure"><a name="id2547097"></a><p class="title"><b>Figure 3. Battery settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/battery-settings.png" alt="Battery settings"></div></div></div></div><p><br class="figure-break"></p><p>
+ The user can select the percentage of the battery to be considered as critical, usually this is for a laptop
+ battery or UPS, this option is important as for a broken battery for example, the battery when it is 10% charged
+ can last 5 minutes, so the user can increase the level at wish the battery charge will be considered critical.
+ </p><p>
+ The user can define an action to be taken by the power manager in case the battery wish is giving the main power
+ for the computer reaches a critical charge level is.
+ </p>
+ The battery notification is a way to notify the user when the battery state changes ( ex: battery charge is full )
+ <p>
+
+ </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-button"></a>Keyboard shortcuts</h3></div></div></div><div class="figure"><a name="id2537238"></a><p class="title"><b>Figure 4. button control</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/button-settings.png" alt="button control"></div></div></div></div><p><br class="figure-break"></p>
+ For those buttons you can define an action to be taken by the power manager when happen to press one of them,
+ for example when you close the laptop screen.
+
+ </div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-monitor"></a>Monitor settings</h3></div></div></div><div class="figure"><a name="id2549006"></a><p class="title"><b>Figure 5. Monitor DPMS and lcd brightness</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/monitor-settings.png" alt="Monitor DPMS and lcd brightness"></div></div></div></div><p><br class="figure-break"></p><p>
+ DPMS is an old X extension that allows standby/suspend/turn off options of the monitor, usually the timeouts
+ have to be succesitive, so stansby timeout less than suspend timeout and so on, but one always can disable any option.
+ </p><p>
+ For a laptop users by clicking on the checkbox allows the power manager to reduce the screen luminosity when
+ it detects that system in running on battery power and set it again to the maximum value when system is running
+ on AC power.
+ </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-systray"></a>System Tray Icon</h3></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-notify"></a>Notification</h3></div></div></div></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-faq"></a>FAQ</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">Q: Why the icons look very similar to the icon of gnome power manager</span></dt><dd><p>A: No, they are not similar, they are the same, just there is no point of re-drawing icons,
+ gnome power manager icons are good enough. not all of them are used.
+ </p></dd><dt><span class="term">Q: What is the difference between suspend and hibernate</span></dt><dd><p>A: Suspend if a power save feature, when suspending the computer is still using power,
+ since the running applications are kept in the memory, but is the lowest power level the computer
+ can use.
+ Hibernate saves the system state on the hard drive and turns off the power, when you start up your computer
+ again those data will be loaded and the system comes up.
+ </p></dd><dt><span class="term">Q: Why the options of suspend/hibernate are not there or i can't select them</span></dt><dd><p>A: Many possible reasons, for example your kernel doesn't or it's not compiled with suspend/hibernate options.
+ Another possible reason is the fact that you are not allowed to use them.
+ </p></dd><dt><span class="term">Q: How the power manager actually suspend or hibernate my system</span></dt><dd><p>A: The power manager checks if the user is allowed to, then send a DBus message to HAL asking to suspend
+ /hibernate, usually the methods used to suspend or hibernate it's located in /usr/lib/hal/scripts/YourOs.
+ </p></dd><dt><span class="term">Q: If the power manager puts the computer in hibernate because my battery charge is critical what will happen
+ if i turn it on again without plugging my adapter</span></dt><dd><p>A: Nothing actually, the power manager had take the action defined by the user already and understands
+ that the user insist of using the laptop so in the best cases it'll display a popup with options that you can do.
+ </p></dd><dt><span class="term">Q: I select the option of the lcd brightness control but i don't see the brightness changing when i switch
+ from AC adapter to battery power</span></dt><dd><p>A: You kernel doesn't have the right driver, or the driver isn't loaded.
+ </p></dd></dl></div></div><p> </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-about"></a>About <strong class="application"><code>xfce4-power-manager</code></strong></h2></div></div></div><p>
+ This power manager was written following the philosophy of Xfce, having leight weight application that does
+ what the user expect for it.
+ </p><p>To report a bug or make a suggestion regarding this application or
+ this manual, use the bug tracking system at <a class="ulink" 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 class="ulink" href="http://lunar-linux.org/mailman/listinfo/xfce" target="_top">xfce</a> mailing list. Development discussion takes
+ place on the <a class="ulink" href="http://lunar-linux.org/mailman/listinfo/xfce4-dev" target="_top">xfce4-dev</a> mailing list
+ or on <a class="ulink" href="http://lunar-linux.org/mailman/listinfo/xfce4-goodies-dev" target="_top">xfce4-goodies-dev</a> mailing list.
+ </p></div><p> </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
Modified: xfce4-power-manager/trunk/doc/C/xfce4-power-manager.xml
===================================================================
--- xfce4-power-manager/trunk/doc/C/xfce4-power-manager.xml 2008-10-22 17:22:15 UTC (rev 5746)
+++ xfce4-power-manager/trunk/doc/C/xfce4-power-manager.xml 2008-10-22 19:46:13 UTC (rev 5747)
@@ -50,54 +50,315 @@
<sect1 id="xfpm-intro">
<title>Introduction</title>
+ The Xfce4 power manager is a part of the Xfce goodies project and features cpu frequency control,
+ battery monitoring, monitor DPMS control, LCD brightness control, lid sleep and power buttons control.
+ All those features can be controlled from the user interface settings dialog.
+ <sect2 id="xfpm-started">
+ <title>Getting Started</title>
+ <para>To launch the Power Manager you need to run the following command &app; -r you can do from the xfce run
+ command by pressing ALT-F2, or you go to the Xfce settings manager and you click on the Power Manager item
+ , a popup should be displayed only if the power manager isn't already running to ask you if you want to.
+ Once the power manager is launched for the first time, it'll place a autostart desktop file in you .config/autostart
+ so like that it gets launched automatically second time you log into your Xfce desktop.
+ </para>
+ </sect2>
</sect1>
<!-- extra space -->
<para> </para>
-
-<sect1 id="xfpm-using">
- <title>Using &app;</title>
-</sect1>
-
-<!-- extra space -->
- <para> </para>
-
+
<sect1 id="xfpm-configuration">
<title>Power Manager Configuration</title>
+ <para>
+ Almost all the &app; items are configurable from the configuration window, laptop users can set up
+ a power profile for two different modes “on battery power” and “on ac power”, desktop users still can change
+ DPMS settings and CPU frequency.
+ </para>
+ <para>
+ The settings dialog differs from one system to another depends on the computer (PC,laptop,...) and on
+ the available manageabale interfaces.
+ </para>
+ <para>
+ In this section we will describe the possible configuration for the power manager.
+ </para>
+ <sect2 id="xfpm-general">
+ <title>General Settings</title>
+ <para><figure float="0">
+ <title>General settings</title>
+ <screenshot><mediaobject>
+ <imageobject>
+ <imagedata fileref="images/general-settings.png" format="png"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject></screenshot>
+ </figure></para>
+ <para>
+ Here you can select the configuration of the system tray icon, enable/disable cpu frequency and DPMS controls,
+ typical reason to disable DPMS control for example if you are watching a movie.
+ </para>
+ </sect2>
+
<sect2 id="xfpm-cpu">
- <title>CPU settings</title>
- </sect2>
+ <title>CPU Settings</title>
+ <para><figure float="0">
+ <title>CPU Linux governors</title>
+ <screenshot><mediaobject>
+ <imageobject>
+ <imagedata fileref="images/cpu-settings.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject></screenshot>
+ </figure></para>
+ <para>
+ The linux governors found in the system are listed for choice as a radio buttons,
+ if the acpi_cpufreq module is not loaded in the kernel or the cpu itself doesn't support
+ changes in it's frequency these options might not be shown.
+ </para>
+ <para>Here's a brief descritption on linux cpu governors</para>
+
+<variablelist>
+
+ <varlistentry>
+ <term>Performance:</term>
+ <listitem>
+ <para> Set the CPU to it's maximum frequency. will consume more power,
+ and it's not ideal when running on battery.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Powersave:</term>
+ <listitem>
+ <para>
+ Set the CPU to it's minimum frequency, ideal when running on battery power.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Userspace:</term>
+ <listitem>
+ <para> In this governor, allows the user, or any userspace
+ program running with UID "root", to set the CPU to a specific frequency.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Ondemand:</term>
+ <listitem>
+ <para> What you want is what you get. sets the CPU depending on the
+ current usage.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Conservative:</term>
+ <listitem>
+ <para>
+ Same as Ondemand but differs in behaviour in that it gracefully increases and decreases
+ the CPU speed rather than jumping to max speed the moment there is any load on the CPU.
+ </para>
+ </listitem>
+ </varlistentry>
+
+</variablelist>
+<para>
+NOTE:In &app; version &appversion; only Linux is supported for changing the cpu frequency.
+</para>
+
+</sect2>
<sect2 id="xfpm-battery">
<title>Battery settings</title>
+ <para><figure float="0">
+ <title>Battery settings</title>
+ <screenshot><mediaobject>
+ <imageobject>
+ <imagedata fileref="images/battery-settings.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject></screenshot>
+</figure></para>
+ <para>
+ The user can select the percentage of the battery to be considered as critical, usually this is for a laptop
+ battery or UPS, this option is important as for a broken battery for example, the battery when it is 10% charged
+ can last 5 minutes, so the user can increase the level at wish the battery charge will be considered critical.
+ </para>
+ <para>
+ The user can define an action to be taken by the power manager in case the battery wish is giving the main power
+ for the computer reaches a critical charge level is.
+ </para>
+ The battery notification is a way to notify the user when the battery state changes ( ex: battery charge is full )
+ <para>
+
+ </para>
</sect2>
<sect2 id="xfpm-button">
<title>Keyboard shortcuts</title>
+ <para><figure float="0">
+ <title>button control</title>
+ <screenshot><mediaobject>
+ <imageobject>
+ <imagedata fileref="images/button-settings.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject></screenshot>
+</figure></para>
+ For those buttons you can define an action to be taken by the power manager when happen to press one of them,
+ for example when you close the laptop screen.
+
</sect2>
<sect2 id="xfpm-monitor">
- <title>Monitor settings</title>
+ <title>Monitor settings</title>
+ <para><figure float="0">
+ <title>Monitor DPMS and lcd brightness</title>
+ <screenshot><mediaobject>
+ <imageobject>
+ <imagedata fileref="images/monitor-settings.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject></screenshot>
+</figure></para>
+ <para>
+ DPMS is an old X extension that allows standby/suspend/turn off options of the monitor, usually the timeouts
+ have to be succesitive, so stansby timeout less than suspend timeout and so on, but one always can disable any option.
+ </para>
+ <para>
+ For a laptop users by clicking on the checkbox allows the power manager to reduce the screen luminosity when
+ it detects that system in running on battery power and set it again to the maximum value when system is running
+ on AC power.
+ </para>
+
</sect2>
+
+ <sect2 id="xfpm-systray">
+ <title>System Tray Icon</title>
+
+
+ </sect2>
+
+ <sect2 id="xfpm-notify">
+ <title>Notification</title>
+
+
+ </sect2>
+
</sect1>
-
<!-- extra space -->
<para> </para>
<sect1 id="xfpm-faq">
<title>FAQ</title>
+ <variablelist>
+
+ <varlistentry>
+ <term>Q: Why the icons look very similar to the icon of gnome power manager</term>
+ <listitem>
+ <para>A: No, they are not similar, they are the same, just there is no point of re-drawing icons,
+ gnome power manager icons are good enough. not all of them are used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Q: What is the difference between suspend and hibernate</term>
+ <listitem>
+ <para>A: Suspend if a power save feature, when suspending the computer is still using power,
+ since the running applications are kept in the memory, but is the lowest power level the computer
+ can use.
+ Hibernate saves the system state on the hard drive and turns off the power, when you start up your computer
+ again those data will be loaded and the system comes up.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Q: Why the options of suspend/hibernate are not there or i can't select them</term>
+ <listitem>
+ <para>A: Many possible reasons, for example your kernel doesn't or it's not compiled with suspend/hibernate options.
+ Another possible reason is the fact that you are not allowed to use them.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Q: How the power manager actually suspend or hibernate my system</term>
+ <listitem>
+ <para>A: The power manager checks if the user is allowed to, then send a DBus message to HAL asking to suspend
+ /hibernate, usually the methods used to suspend or hibernate it's located in /usr/lib/hal/scripts/YourOs.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Q: If the power manager puts the computer in hibernate because my battery charge is critical what will happen
+ if i turn it on again without plugging my adapter</term>
+ <listitem>
+ <para>A: Nothing actually, the power manager had take the action defined by the user already and understands
+ that the user insist of using the laptop so in the best cases it'll display a popup with options that you can do.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Q: I select the option of the lcd brightness control but i don't see the brightness changing when i switch
+ from AC adapter to battery power</term>
+ <listitem>
+ <para>A: You kernel doesn't have the right driver, or the driver isn't loaded.
+ </para>
+ </listitem>
+ </varlistentry>
+
+</variablelist>
</sect1>
+ <!-- extra space -->
+ <para> </para>
<sect1 id="xfpm-about">
<title>About &app;</title>
+ <para>
+ This power manager was written following the philosophy of Xfce, having leight weight application that does
+ what the user expect for it.
+ </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
+ or on <ulink
+ url="http://lunar-linux.org/mailman/listinfo/xfce4-goodies-dev"
+ type="http">xfce4-goodies-dev</ulink> mailing list.
+ </para>
+
</sect1>
<!-- extra space -->
<para> </para>
-
- <!-- extra space -->
- <para> </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.
More information about the Goodies-commits
mailing list