source: xfce/core/xfce4-power-manager.xml@ 17bcb81

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY xfce4-power-manager-download-http
    "http://archive.xfce.org/src/xfce/xfce4-power-manager/1.2/xfce4-power-manager-&xfce4-power-manager-version;.tar.bz2">
  <!ENTITY xfce4-power-manager-download-ftp  " ">
  <!ENTITY xfce4-power-manager-md5sum        "935599b7114b0a4b0e2c9a5d6c72524c">
  <!ENTITY xfce4-power-manager-size          "1 MB">
  <!ENTITY xfce4-power-manager-buildsize     "19 MB">
  <!ENTITY xfce4-power-manager-time          "0.2 SBU">
]>

<sect1 id="xfce4-power-manager" xreflabel="xfce4-power-manager-&xfce4-power-manager-version;">
  <?dbhtml filename="xfce4-power-manager.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>xfce4-power-manager-&xfce4-power-manager-version;</title>

  <indexterm zone="xfce4-power-manager">
    <primary sortas="a-xfce4-power-manager">xfce4-power-manager</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Xfce4 Power Manager</title>

    <para>
      The <application>Xfce4 Power Manager</application> is a power manager for
      the <application>Xfce</application> desktop, <application>Xfce power
      manager</application> manages the power sources on the computer and the
      devices that can be controlled to reduce their power consumption (such as
      LCD brightness level, monitor sleep, CPU frequency scaling). In addition,
      <application>Xfce4 Power Manager</application> provides a set of
      freedesktop-compliant <application>DBus</application> interfaces to 
      inform other applications about current power level so that they can
      adjust their power consumption.
    </para>

    &lfs71_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&xfce4-power-manager-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&xfce4-power-manager-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &xfce4-power-manager-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &xfce4-power-manager-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &xfce4-power-manager-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &xfce4-power-manager-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Xfce4 Power Manager Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="libnotify"/> and
      <xref linkend="xfce4-panel"/>
    </para>

    <para condition="html" role="usernotes">
      User Notes: <ulink url="&blfs-wiki;/xfce4-power-manager"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Xfce4 Power Manager</title>

    <para>
      Install <application>Xfce4 Power Manager</application> by running the
      following commands:
    </para>

<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make docdir=/usr/share/doc/xfce4-power-manager-&xfce4-power-manager-version; \
  imagesdir=/usr/share/doc/xfce4-power-manager-&xfce4-power-manager-version;/images install</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <parameter>docdir=/usr/share/doc/xfce4-power-manager-&xfce4-power-manager-version;</parameter>
      and
      <parameter>imagesdir=/usr/share/doc/xfce4-power-manager-&xfce4-power-manager-version;/images</parameter>:
      These parameters put a html file and some images in a versioned directory
      in <filename class="directory">/usr/share/doc</filename>.
    </para>
  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>

      <seglistitem>
        <seg>
          xfce4-power-information,
          xfce4-power-manager,
          xfce4-power-manager-settings and
          xfpm-power-backlight-helper.
        </seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="xfce4-power-information">
        <term><command>xfce4-power-information</command></term>
        <listitem>
          <para>
            is a <application>Gtk 2</application> application that displays
            information about installed devices. It uses
            <application>DBus</application> to comunicate with
            <application>UPower</application> which is required at runtime for
            <command>xfce4-power-information</command> to give any meaningful
            output.
          </para>
          <indexterm zone="xfce4-power-manager xfce4-power-information">
            <primary sortas="b-xfce4-power-information">xfce4-power-information</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xfce4-power-manager-prog">
        <term><command>xfce4-power-manager</command></term>
        <listitem>
          <para>
            is the <application>Xfce</application> power manager.
          </para>
          <indexterm zone="xfce4-power-manager xfce4-power-manager-prog">
            <primary sortas="b-xfce4-power-manager">xfce4-power-manager</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xfce4-power-manager-settings">
        <term><command>xfce4-power-manager-settings</command></term>
        <listitem>
          <para>
            is a utility that  comes  with  the  <application>Xfce</application>
            power manager to access/change its configuration.
          </para>
          <indexterm zone="xfce4-power-manager xfce4-power-manager-settings">
            <primary sortas="b-xfce4-power-manager-settings">xfce4-power-manager-settings</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xfpm-power-backlight-helper">
        <term><command>xfpm-power-backlight-helper</command></term>
        <listitem>
          <para>
            is a command line utility to get or set the brightness of your
            screen.
          </para>
          <indexterm zone="xfce4-power-manager xfpm-power-backlight-helper">
            <primary sortas="b-xfpm-power-backlight-helper">xfpm-power-backlight-helper</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
</sect1>