<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "gnome-power-preferences">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="gnome-power-preferences-1">

<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">18 Feb 2008</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>

gnome power preferences GUI</primary></indexterm>

<refnamediv id="gnome-power-preferences-1-name"><refname>&cmd;</refname>

<refpurpose>gnome power preferences GUI</refpurpose></refnamediv>

<refsynopsisdiv id="gnome-power-preferences-1-synp"><title>&synp-tt;</title>

<cmdsynopsis><command>&cmd;</command>

<arg choice="opt"><option>-help</option></arg>

<arg choice="opt"><option>-verbose</option></arg>

</cmdsynopsis></refsynopsisdiv>

<refsect1 id="gnome-power-preferences-1-desc"><title>&desc-tt;</title>

<para>&cmd; is a GUI configuration program. It enables you to configure your

preferred desktop power management policies, e.g. blank screen when lid is

closed, hibernate system when battery power is low, suspend system when power

button is pressed, or let CPU frequency dynamically adjust based on process

load. Then, these policies are enforced by

<citerefentry><refentrytitle>gnome-power-manager</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

</para>

</refsect1>

<refsect1 id="gnome-power-preferences-1-opts"><title>&opts-tt;</title>

<para>This program follows the usual &gnu; command line syntax,

with long options starting with two dashes (`-'). A summary of

options is included below.</para>

<variablelist termlength="narrow">

<varlistentry>

<term><option>-help</option></term>

<listitem><para>

Show summary of options.

</para>

</listitem></varlistentry>

<varlistentry>

<term><option>-verbose</option></term>

<listitem><para>

Show extra debugging.

</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-power-preferences-1-exam"><title>&exam-tt;</title>

<example role="example">

<title>Launching &cmd; with the display of extra debugging messages.

</title>

<para><screen>example% <userinput>&cmd; --verbose

</userinput></screen></para>

</example>

</refsect1>

<refsect1 id="gnome-power-preferences-1-exit"><title>&exit-tt;</title>

<para>The following exit values are returned:</para>

<variablelist termlength="xtranarrow">

<varlistentry><term><returnvalue>0</returnvalue></term><listitem><para>Application

exited successfully</para>

</listitem></varlistentry>

<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application

exited with failure</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-power-preferences-1-file"><title>&file-tt;</title>

<para>The following files are used by this application:</para>

<variablelist termlength="wholeline">

<varlistentry><term><filename>/usr/bin/&cmd;</filename></term><listitem><para></para><para>

Executable for gnome power preferences GUI</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gnome-power-preferences-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5">

<citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry><entry><para>gnome/gnome-power-manager

</para></entry></row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="gnome-power-preferences-1-also"><title>&also-tt;</title>

<citerefentry><refentrytitle>gnome-power-manager</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-power-statistics</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</citerefentry></para>

</refsect1>

<refsect1 id="gnome-power-preferences-1-note"><title>&note-tt;</title>

<para>This manual page was written by Oliver Grawert <email>ogra@ubuntu.com</email>

for the Debian system.

</para>

</para>

<para>Updated by Simon Zheng, Sun Microsystems Inc., 2008.</para>

</refsect1>

</refentry>