From 51175189c6d7313a3b84019e39496f957c4e6164 Mon Sep 17 00:00:00 2001 From: Stefano Karapetsas Date: Sun, 11 Dec 2011 12:55:19 +0100 Subject: moved from Mate-Extra --- help/C/figures/applet-brightness.png | Bin 0 -> 5168 bytes help/C/figures/applet-inhibit.png | Bin 0 -> 5987 bytes help/C/figures/gpm-cell-capacity.png | Bin 0 -> 9312 bytes help/C/figures/gpm-charged.png | Bin 0 -> 16581 bytes help/C/figures/gpm-critical.png | Bin 0 -> 13210 bytes help/C/figures/gpm-low.png | Bin 0 -> 14140 bytes help/C/figures/gpm-prefs-ac.png | Bin 0 -> 34953 bytes help/C/figures/gpm-prefs-battery.png | Bin 0 -> 37518 bytes help/C/figures/gpm-prefs-general.png | Bin 0 -> 40161 bytes help/C/figures/gpm-stats-graph.png | Bin 0 -> 69191 bytes help/C/figures/gpm-suspend-problem.png | Bin 0 -> 16860 bytes help/C/figures/gpm-unplugged.png | Bin 0 -> 11223 bytes help/C/figures/gs-prefs.png | Bin 0 -> 33686 bytes help/C/legal.xml | 76 ++++ help/C/mate-power-manager.xml | 770 +++++++++++++++++++++++++++++++++ 15 files changed, 846 insertions(+) create mode 100644 help/C/figures/applet-brightness.png create mode 100644 help/C/figures/applet-inhibit.png create mode 100644 help/C/figures/gpm-cell-capacity.png create mode 100644 help/C/figures/gpm-charged.png create mode 100644 help/C/figures/gpm-critical.png create mode 100644 help/C/figures/gpm-low.png create mode 100644 help/C/figures/gpm-prefs-ac.png create mode 100644 help/C/figures/gpm-prefs-battery.png create mode 100644 help/C/figures/gpm-prefs-general.png create mode 100644 help/C/figures/gpm-stats-graph.png create mode 100644 help/C/figures/gpm-suspend-problem.png create mode 100644 help/C/figures/gpm-unplugged.png create mode 100644 help/C/figures/gs-prefs.png create mode 100644 help/C/legal.xml create mode 100644 help/C/mate-power-manager.xml (limited to 'help/C') diff --git a/help/C/figures/applet-brightness.png b/help/C/figures/applet-brightness.png new file mode 100644 index 0000000..5c0d0c9 Binary files /dev/null and b/help/C/figures/applet-brightness.png differ diff --git a/help/C/figures/applet-inhibit.png b/help/C/figures/applet-inhibit.png new file mode 100644 index 0000000..241f5c2 Binary files /dev/null and b/help/C/figures/applet-inhibit.png differ diff --git a/help/C/figures/gpm-cell-capacity.png b/help/C/figures/gpm-cell-capacity.png new file mode 100644 index 0000000..a664197 Binary files /dev/null and b/help/C/figures/gpm-cell-capacity.png differ diff --git a/help/C/figures/gpm-charged.png b/help/C/figures/gpm-charged.png new file mode 100644 index 0000000..d28d85c Binary files /dev/null and b/help/C/figures/gpm-charged.png differ diff --git a/help/C/figures/gpm-critical.png b/help/C/figures/gpm-critical.png new file mode 100644 index 0000000..1208536 Binary files /dev/null and b/help/C/figures/gpm-critical.png differ diff --git a/help/C/figures/gpm-low.png b/help/C/figures/gpm-low.png new file mode 100644 index 0000000..b98e3a7 Binary files /dev/null and b/help/C/figures/gpm-low.png differ diff --git a/help/C/figures/gpm-prefs-ac.png b/help/C/figures/gpm-prefs-ac.png new file mode 100644 index 0000000..7fa073d Binary files /dev/null and b/help/C/figures/gpm-prefs-ac.png differ diff --git a/help/C/figures/gpm-prefs-battery.png b/help/C/figures/gpm-prefs-battery.png new file mode 100644 index 0000000..d391073 Binary files /dev/null and b/help/C/figures/gpm-prefs-battery.png differ diff --git a/help/C/figures/gpm-prefs-general.png b/help/C/figures/gpm-prefs-general.png new file mode 100644 index 0000000..7a06735 Binary files /dev/null and b/help/C/figures/gpm-prefs-general.png differ diff --git a/help/C/figures/gpm-stats-graph.png b/help/C/figures/gpm-stats-graph.png new file mode 100644 index 0000000..aa9ae3a Binary files /dev/null and b/help/C/figures/gpm-stats-graph.png differ diff --git a/help/C/figures/gpm-suspend-problem.png b/help/C/figures/gpm-suspend-problem.png new file mode 100644 index 0000000..426ce3c Binary files /dev/null and b/help/C/figures/gpm-suspend-problem.png differ diff --git a/help/C/figures/gpm-unplugged.png b/help/C/figures/gpm-unplugged.png new file mode 100644 index 0000000..4696d70 Binary files /dev/null and b/help/C/figures/gpm-unplugged.png differ diff --git a/help/C/figures/gs-prefs.png b/help/C/figures/gs-prefs.png new file mode 100644 index 0000000..d26193d Binary files /dev/null and b/help/C/figures/gs-prefs.png differ diff --git a/help/C/legal.xml b/help/C/legal.xml new file mode 100644 index 0000000..acb0b40 --- /dev/null +++ b/help/C/legal.xml @@ -0,0 +1,76 @@ + + + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation + License (GFDL), Version 1.1 or any later version published + by the Free Software Foundation with no Invariant Sections, + no Front-Cover Texts, and no Back-Cover Texts. You can find + a copy of the GFDL at this link or in the file COPYING-DOCS + distributed with this manual. + + This manual is part of a collection of MATE manuals + distributed under the GFDL. If you want to distribute this + manual separately from the collection, you can do so by + adding a copy of the license to the manual, as described in + section 6 of the license. + + + + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any MATE documentation, and the members of + the MATE Documentation Project are made aware of those + trademarks, then the names are in capital letters or initial + capital letters. + + + + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED + UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE + WITH THE FURTHER UNDERSTANDING THAT: + + + + DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, + WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR + IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES + THAT THE DOCUMENT OR MODIFIED VERSION OF THE + DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR + A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE + RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE + OF THE DOCUMENT OR MODIFIED VERSION OF THE + DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR + MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, + YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY + CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY + SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER + OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS + LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED + VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER + EXCEPT UNDER THIS DISCLAIMER; AND + + + + UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL + THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), + CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, + INITIAL WRITER, ANY CONTRIBUTOR, OR ANY + DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION + OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH + PARTIES, BE LIABLE TO ANY PERSON FOR ANY + DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR + CONSEQUENTIAL DAMAGES OF ANY CHARACTER + INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS + OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR + MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR + LOSSES ARISING OUT OF OR RELATING TO USE OF THE + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, + EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF + THE POSSIBILITY OF SUCH DAMAGES. + + + + + + diff --git a/help/C/mate-power-manager.xml b/help/C/mate-power-manager.xml new file mode 100644 index 0000000..8a4a7ee --- /dev/null +++ b/help/C/mate-power-manager.xml @@ -0,0 +1,770 @@ + + + + + &app;"> + + +]> + + + +
+ + + + + &application; Manual + + + &application; is a session daemon for the MATE Desktop that + manages the power settings for your laptop or desktop computer. + + + + 2006-2009 + Richard Hughes (richard@hughsie.com) + + + + + + + Richard Hughes + + + &legal; + + + + + Richard + Hughes + richard@hughsie.com + + + + + + + 2.0 + 2006-08-30 + + Richard Hughes + richard@hughsie.com + + Richard Hughes + + + + + + Feedback + + To report a bug or make a suggestion regarding the &app; application or + this manual, follow the directions in the + &application; Contact Page. + + + + + + + &application; + + + mate-power-manager + + + + +
+ Introduction + + + + + &application; + Manual + mate-power-manager + + + + The &app; session daemon is a power management daemon + for the MATE desktop + + +
+ +
+ Usage + + &app; is usually started in MATE startup, but + you can manually start &app; by doing: + + + + Command line + + + Type mate-power-manager --verbose --no-daemon, + then press Return: + + + + +
+ +
+ Notification Messages + + When &application; has started, the following notifications may be displayed. + + +
+ AC Adapter Unplugged +
+ &app; Notification when AC adapter is removed + + + + + + + +
+ + + You can disable this notification by changing the MateConf key + /apps/mate-power-manager/notify/discharging. + + +
+ +
+ Fully Charged +
+ &app; Notification when laptop primary battery is fully charged + + + + + + + +
+ + + You can disable this notification by changing the MateConf key + /apps/mate-power-manager/notify/fully_charged. + + + + + You will only get a repeat notification if your battery percentage charge + drops below 95% and then is again fully charged. + This prevents some machines from showing unwanted repeat notifications + if the battery is incorrectly reporting the charged status. + + +
+ +
+ Power Low + + When the battery is low, you will receive the following notification. + You should consider switching to AC power really soon. + +
+ &app; Notification when battery power is low + + + + + + + +
+ + + You can disable this notification by changing the MateConf key + /apps/mate-power-manager/notify/low_power. + + +
+ +
+ Power Critical + + When the computer has run out of power, it will show this notification + explaining what action is required. + You can change the critical low action using the preferences tool. + +
+ &app; Notification when the system power is critically low + + + + + + + +
+
+ +
+ Suspend Failure + + When a suspend failure occurs you may get this following warning. + The most common reason for this notification is that the current user does + not have permission to suspend or hibernate the computer. + +
+ &app; Notification when suspend failure occurs + + + + + + + +
+ + + You can disable this notification by changing the MateConf key + /apps/mate-power-manager/notify/sleep_failed. + + +
+
+ +
+ Statistics + + The statistics program allows you to visualize the power consumption + of your laptop hardware. + + + + This has been removed from the information window of previous versions of + &app; as the data interface is now using DBUS rather than internal IPC. + This allows other applications to query and display the data if required. + + +
+ Power History going from battery power to AC + + + + + + + +
+ + + You may not see some options or graphs if your computer does not + have the required hardware. + You may also see other hardware not shown here (for example + UPS devices) but these are treated the same way as other devices. + + + +
+ Charge History + + This graph shows the percentage charge available for the composite primary + battery, so if you have a main laptop battery and an auxiliary battery + then only the averaged value will be shown. + A legend is not shown with this graph. + +
+ +
+ Power History + + This graph shows the power history charge used by the composite + primary battery. + This line represents the amount of power that is either being used to + charge the batteries in the system, or the power being used by the system + from the batteries. + You should see the line go up when processor intensive tasks are + performed, and down when the system is at idle, or when the screen is + dimmed. + A legend is shown with this graph when data events have been received. + + + + + You do will not receive rate data from your computer if it is not + charging or discharging, or if the computer is suspended. + This is due to hardware limitations where the rate is only sent from + the battery management chip, rather than the power management chip on + the motherboard. + + +
+ +
+ Estimated Time History + + This graph shows the estimated charge history for the composite primary + battery. + This line represents the amount of time required until charged, or the + amount of time until discharge. + This line should go proportionally up when the rate decreases and down + when the rate increases. + A legend is shown with this graph when data events have been received. + +
+
+ +
+ Preferences + + The preferences window allows you to control: + + + + + The LCD brightness when on AC and battery power + + + + + The idle time for the screen power-down and suspend action + + + + + The actions to perform when the laptop lid is closed + + + + + The notification area icon policy + + + + + + + Some sliders or option boxes may be disabled if the MateConf policy keys are + not writable. + This allows administrators to lock-down the actions that a user can select. + + + +
+ AC Preferences +
+ &app; AC tab + + + + + + + +
+
+ +
+ Battery Preferences +
+ &app; battery tab + + + + + + + +
+ + This allows a powerful computer to reduce the power usage when + idle, or when the full capabilities are not required. + +
+ +
+ General Preferences +
+ &app; general tab + + + + + + + +
+
+ +
+ Session and system idle times + + mate-screensaver is a session daemon that monitors user + input, and if the mouse has not been moved, or the keyboard been pressed then + it starts a timeout. + When the value of this timeout reaches the value set in + mate-screensaver-preferences, then the login is marked + as 'session idle'. + This is when &application; performs all the session idle actions such as + enabling low-power mode and lowering the laptop panel brightness. + + +
+ + Changing the session idle timeout in <command>mate-screensaver-preferences</command> + + + + + + + + +
+ + As soon as the session is marked at idle, &application; starts its own + 'system' timer. + When the timeout set in mate-power-preferences is reached, + and the CPU load is idle, then the idle action is + performed, which is usually to turn off the screen, or to suspend or hibernate. + + + To make this clearer, the sliders in mate-power-preferences + are set to start at the value of the session-timeout + 1 minute, as we cannot + logically trigger before the session is marked as idle. + If you adjust the value of the 'session idle' timeout in + mate-screensaver-preferences then the start of the sliders + in mate-power-preferences will change accordingly. + +
+
+ +
+ Advanced Preferences + +
+ Screen Dim Brightness + + + You can change the idle laptop panel brightness by changing the MateConf key + /apps/mate-power-manager/backlight/idle_brightness. + + +
+ +
+ Screen Locking + + By default, &application; supports a simple locking scheme. + This means that the screen will lock if set to "Lock screen" in + mate-screensaver when the lid is closed, or the system performs a suspend or + hibernate action. + + + There is a complex locking scheme available for power users that allows + locking policy to change for the lid, suspend and hibernate actions. + To enable this complex mode, you will have to disable the MateConf key: + + + + + + /apps/mate-power-manager/lock/use_screensaver_settings + + + + + Then the policy keys can be set to force a mate-screensaver lock and unlock + when the action is performed: + + + + + + /apps/mate-power-manager/lock/blank_screen + + + + + /apps/mate-power-manager/lock/suspend + + + + + /apps/mate-power-manager/lock/hibernate + + + + + + + The lock policy for mate-screensaver is ignored until the simple mode + is re-enabled. + + +
+
+ +
+ MATE Power Applets + +
+ Brightness Applet + + The brightness applet allows the user to change the brightness + temporarily without changing the default policy. + This may be useful if you have got a laptop without brightness + buttons, as you can now change the brightness easily. + +
+ + Brightness applet drop-down. + + + + + + + + +
+ + + You will not get the slider if your hardware is not supported. + + +
+ +
+ Inhibit Applet + + The inhibit applet allows the user to prevent the computer + auto-sleeping when inactive. This may be required with old or + proprietary programs such as VMWare or Matlab. + Just click the icon for the auto-suspend to be inhibited, + and click it again for normal operation. + +
+ + Inhibit applet in inhibited state. + + + + + + + + +
+ + + Don't use this applet if you just use MATE software, instead + file a bug to make the application use the Inhibit() and + UnInhibit() methods as this should 'just work'. + + +
+
+ +
+ Frequently Asked Questions + + These are questions the mailing list gets asked frequently. + +
+ What is battery capacity? + + Capacity is how much charge your battery can store compared to its + manufacturer's guidelines. + +
+ + This graph shows the capacity of a typical lithium ion battery over a + few hundred charge-discharge cycles. + + + + + + + + +
+
+ +
+ What's the difference between suspend and hibernate? + + The Suspend state is a power saving feature which is the lowest level of + power consumption that preserves program data in the computer's memory. + When your computer is in the Suspended state, computation will not be + performed until normal activity is resumed. + It will not resume until signaled by an external event such as a keyboard + button press. + It generally takes a few seconds to suspend and then resume your computer. + + + + You still use a small amount of battery power while suspended, so is + not recommended for the low power action. + If you remove AC power on a desktop, or run out of battery power on a + laptop then you will lose your work. + + + + The Hibernation state saves the complete state of the computer to hard + disk and turns off the power, so that the computer appears to be off. + It will not resume until signaled by an external event such as a + keyboard button press. + This is the lowest power sleeping state available. + If you remove AC power on a desktop, or run out of battery power on a + laptop then work will not be lost. + It can take up to a minute or more to hibernate and wake your computer. + +
+ +
+ + My monitor is broken and treats DPMS standby and off states as + 'no-signal' which leaves the monitor powered on. + + + You have to change the DPMS suspend mode &application; uses. + Open mateconf-editor, and then change the keys + /apps/mate-power-manager/backlight/dpms_method_ac and + /apps/mate-power-manager/backlight/dpms_method_battery + to one of the modes that work, e.g. standby, suspend or off. + +
+ +
+ + My time to discharge is always incorrect due to a faulty battery, what + can I do? + + + You might be able to use the percentage charge for g-p-m to use as the + policy data. + Open mateconf-editor, and then change the key + /apps/mate-power-manager/general/use_time_for_policy to false. + You can do this easily by doing: + + mateconftool-2 --set --type bool + /apps/mate-power-manager/general/use_time_for_policy false + + + + This should get the policy actions working for you, but of course the + time remaining will still be incorrect. + +
+ +
+ + How do I make my application stop the computer auto-suspending? + + + If your application is doing a long operation, you might want to + disable the ability to suspend for a little while. + You should use mate-session if you really don't want the user to be + able to suspend, or for the computer to save power by hibernating + or suspending. + +
+ +
+ + I'm running ACPI. Why do events (such as removing the AC adapter) + take so long to register? + + + One of two things might be the problem. + + + + + HAL might not be running the addon that captures the ACPI event. + + + + + You BIOS could be faulty, and might need a work-around. + Please send a bug report. + + + + + For the first case, try to find the HAL processes that are running: + ps -eaf | grep hal + + + And check for the process hald-addon-acpi. + If it is not being run, then please make sure that HAL is being run + with the --retain-privileges option in the + haldaemon initscript. + An alternative to this is to use acpid, rather than the kernel proc file. + +
+ +
+ +
+ About + + &app; was written by Richard Hughes richard@hughsie.com. + To find more information about &app;, please visit the + + &application; web page. + + + To report a bug or make a suggestion regarding this application or + this manual, follow the directions at the + + &application; Bug Page. + + 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. A copy of this license can be found at this + link, or in the file + COPYING included with the source code of this program. + +
+ +
-- cgit v1.2.1