summaryrefslogtreecommitdiff
path: root/cpufreq/help/C
diff options
context:
space:
mode:
authorPerberos <[email protected]>2011-11-14 18:24:48 -0300
committerPerberos <[email protected]>2011-11-14 18:24:48 -0300
commit312ba610a1e98fc656fb58178227d7d45a64494e (patch)
tree54a3c2b6084c80e63fb0526c6e7b8e01627acbd7 /cpufreq/help/C
downloadmate-applets-312ba610a1e98fc656fb58178227d7d45a64494e.tar.bz2
mate-applets-312ba610a1e98fc656fb58178227d7d45a64494e.tar.xz
initial
Diffstat (limited to 'cpufreq/help/C')
-rw-r--r--cpufreq/help/C/cpufreq-applet.xml372
-rw-r--r--cpufreq/help/C/figures/cpufreq-100.pngbin0 -> 1057 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-25.pngbin0 -> 942 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-50.pngbin0 -> 988 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-75.pngbin0 -> 1014 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-applet-preferences-smp.pngbin0 -> 9428 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-applet-preferences.pngbin0 -> 26188 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-applet-selector-both.pngbin0 -> 7739 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-applet-selector.pngbin0 -> 8836 bytes
-rw-r--r--cpufreq/help/C/figures/cpufreq-applet.pngbin0 -> 2183 bytes
-rw-r--r--cpufreq/help/C/legal.xml76
11 files changed, 448 insertions, 0 deletions
diff --git a/cpufreq/help/C/cpufreq-applet.xml b/cpufreq/help/C/cpufreq-applet.xml
new file mode 100644
index 00000000..1ac8ea80
--- /dev/null
+++ b/cpufreq/help/C/cpufreq-applet.xml
@@ -0,0 +1,372 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+ <!ENTITY legal SYSTEM "legal.xml">
+ <!ENTITY appletversion "2.12.0">
+ <!ENTITY applet "CPU Frequency Scaling Monitor">
+]>
+<!--
+ (Do not remove this comment block.)
+ Maintained by the MATE Documentation Project
+ http://developer.mate.org/projects/gdp
+ Template version: 2.0 beta
+ Template last modified Feb 06, 2003
+-->
+<!-- =============Document Header ============================= -->
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to -->
+<!-- appropriate code -->
+ <articleinfo>
+ <title>&applet; Manual</title>
+ <abstract role="description">
+ <para>&applet; shows the current clock speed of the CPU and provides an
+ interface to change the clock speed if the CPU supports it.</para>
+ </abstract>
+ <copyright>
+ <year>2005</year>
+ <holder>Davyd Madeley</holder>
+ </copyright>
+ <copyright>
+ <year>2004</year>
+ <holder>MATE Foundation</holder>
+ </copyright>
+
+<!-- translators: uncomment this:
+ <copyright>
+ <year>2003</year>
+ <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+ </copyright>
+ -->
+
+ <publisher role="maintainer">
+ <publishername>MATE Documentation Project</publishername>
+ </publisher>
+
+&legal;
+<!-- This file contains link to license for the documentation (GNU FDL), and
+ other legal stuff such as "NO WARRANTY" statement. Please do not change
+ any of this. -->
+
+ <authorgroup>
+ <author>
+ <firstname>Carlos</firstname>
+ <surname>Garcia Campos</surname>
+ <affiliation>
+ <orgname>MATE Project</orgname>
+ <address><email>[email protected]</email></address>
+ </affiliation>
+ </author>
+ <author>
+ <firstname>Davyd</firstname>
+ <surname>Madeley</surname>
+ <affiliation>
+ <orgname>MATE Project</orgname>
+ <address><email>[email protected]</email></address>
+ </affiliation>
+ </author>
+ <!-- This is appropriate place for other contributors: translators,
+ maintainers, etc. Commented out by default.
+ <othercredit role="translator">
+ <firstname>Latin</firstname>
+ <surname>Translator 1</surname>
+ <affiliation>
+ <orgname>Latin Translation Team</orgname>
+ <address> <email>[email protected]</email> </address>
+ </affiliation>
+ <contrib>Latin translation</contrib>
+ </othercredit>
+-->
+ </authorgroup>
+
+ <releaseinfo revision="2.26" role="review"/>
+
+ <revhistory>
+ <revision>
+ <revnumber>MATE 2.12</revnumber>
+ <date>August 2005</date>
+ <revdescription>
+ <para role="author">Davyd Madeley</para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>MATE 2.10</revnumber>
+ <date>March 2005</date>
+ <revdescription>
+ <para role="author">Davyd Madeley</para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>&applet; Applet Manual V0.3</revnumber>
+ <date>October 2004</date>
+ <revdescription>
+ <para role="author">Carlos Garcia Campos</para>
+ <para role="publisher">MATE Documentation Project</para>
+ </revdescription>
+ </revision>
+ </revhistory>
+
+ <releaseinfo>This manual describes version &appletversion; of &applet;.
+ </releaseinfo>
+
+ <legalnotice>
+ <title>Feedback</title>
+ <para>
+ To report a bug or make a suggestion regarding the &applet; applet or
+ this manual, follow the directions in the <ulink url="ghelp:mate-feedback"
+ type="help">MATE Feedback Page</ulink>.
+ </para>
+ </legalnotice>
+
+ </articleinfo>
+
+ <indexterm zone="index">
+ <primary>CPU Frequency Scaling Monitor</primary>
+ </indexterm>
+<!-- ============= Document Body ============================= -->
+<!-- ============= Introduction ============================== -->
+<sect1 id="cpufreq-applet-introduction">
+ <title>Introduction</title>
+ <figure id="cpufreq-applet-figure">
+ <title>&applet;</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/cpufreq-applet.png"
+ format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <!-- ==== End of Figure ======================================= -->
+ <para>The <application>&applet;</application> provides a convenient way to monitor the CPU Frequency Scaling for each CPU.
+ </para>
+ <para>To add <application>&applet;</application> to a panel, right-click on the panel to open the panel popup menu, then choose
+ <menuchoice>
+ <guimenu>Add to Panel</guimenu>
+ <guimenuitem>CPU Frequency Scaling Monitor</guimenuitem>
+ </menuchoice>.</para>
+
+ <note><para>
+ Unfortunately, CPU frequency scaling can currently only be monitored on
+ Linux machines that have support in the kernel. It can however, support the
+ several generations of frequency scaling interfaces in the kernel.
+ </para></note>
+
+ <para>When there is no CPU frequency scaling support in the system, the &applet; only displays the current CPU frequency.</para>
+ <para>When CPU frequency scaling is supported in the system, the &applet; displays the CPU icon with a progress bar. The state of the progress bar represents the current CPU frequency with respect to the maximum frequency.</para>
+ <para>By default the &applet; displays the current CPU frequency as a value
+ in Hertz (the standard measure of frequency), but can be configured to
+ display a percentage instead. For more information on how to configure &applet; see <xref linkend="cpufreq-applet-prefs"/>.</para>
+ <para>Each instance of &applet; can monitor only one CPU. You must start an
+ instance of &applet; for each CPU that you want to monitor if you are in a
+ multiprocessor (SMP) system.</para>
+
+ <sect2 id="mate-cpufreq-icons">
+ <title>Understanding the Icons</title>
+ <para>
+ The &applet; has a series of icons that graphically represent the current
+ scaling level of the processor you are monitoring. They are:
+ </para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50*"/>
+ <colspec colname="COLSPEC1" colwidth="50*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Icon</para></entry>
+ <entry colname="COLSPEC1">
+ <para>Description</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para><inlinemediaobject><imageobject>
+ <imagedata fileref="figures/cpufreq-100.png"
+ format="PNG"/>
+ </imageobject><textobject>
+ <phrase>100% Power</phrase>
+ </textobject></inlinemediaobject></para></entry>
+ <entry><para>
+ The CPU is running at, or close to, 100% throughput
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para><inlinemediaobject><imageobject>
+ <imagedata fileref="figures/cpufreq-75.png"
+ format="PNG"/>
+ </imageobject><textobject>
+ <phrase>75% Power</phrase>
+ </textobject></inlinemediaobject></para></entry>
+ <entry><para>
+ The CPU is running at, or close to, 75% throughput</para>
+ </entry>
+ </row>
+ <row valign="top">
+ <entry><para><inlinemediaobject><imageobject>
+ <imagedata fileref="figures/cpufreq-50.png"
+ format="PNG"/>
+ </imageobject><textobject>
+ <phrase>50% Power</phrase>
+ </textobject></inlinemediaobject></para></entry>
+ <entry><para>
+ The CPU is running at, or close to, 50% throughput
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para><inlinemediaobject><imageobject>
+ <imagedata fileref="figures/cpufreq-25.png"
+ format="PNG"/>
+ </imageobject><textobject>
+ <phrase>25% Power</phrase>
+ </textobject></inlinemediaobject></para></entry>
+ <entry><para>
+ The CPU is running at, or close to, 25% throughput
+ </para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </sect2>
+
+ <sect2 id="mate-cpufreq-selector">
+ <title>Frequency and Governor Selector</title>
+ <warning><para>The Frequency Selector functionality may not be available
+ on your MATE Desktop by default. Please consult your system
+ administrator, vendor documentation, or the documentation that came with
+ this software.</para></warning>
+ <para>
+ To set the CPU frequency, (left-)click on the monitor and a menu
+ will be shown. This menu will offer you a list of available frequencies
+ and/or frequency governors for your machine.
+ </para>
+ <tip><para>
+ You can choose whether you want to show available frequencies or
+ governors in the <guilabel>Preferences</guilabel>.
+ See <xref linkend="cpufreq-applet-prefs"/> for more information.
+ </para></tip>
+
+ <figure id="cpufreq-applet-selector-img">
+ <title>Frequency selector showing just frequencies</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/cpufreq-applet-selector.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure id="cpufreq-applet-selector-both-img">
+ <title>Frequency selector showing both frequencies and governors</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/cpufreq-applet-selector-both.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </sect2>
+</sect1>
+
+<!-- ============= Customization ============================= -->
+<!-- Use this section to describe how to customize the applet. -->
+<sect1 id="cpufreq-applet-prefs">
+ <title>Preferences</title>
+ <para>To configure the <application>&applet;</application>, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem> from the popup menu.</para>
+ <para>The <guimenuitem>Preferences</guimenuitem> dialog contains the following components: </para>
+ <figure id="cpufreq-applet-preferences">
+ <title>&applet; Preferences Dialog</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/cpufreq-applet-preferences.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&applet; preferences dialog</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Monitored CPU (only in multiprocessor systems)</guilabel></term>
+ <listitem>
+ <para>Use this drop-down list to select the CPU that you want to monitor.</para>
+ <figure id="cpufreq-applet-preferences-smp">
+ <title>Selecting the CPU to monitor</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/cpufreq-applet-preferences-smp.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>&applet; preferences dialog CPU selector</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <note><para>
+ The <guilabel>Monitored CPU</guilabel> option will only appear on
+ multiprocessor (SMP) systems.
+ </para></note>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Show in Mode</guilabel></term>
+ <listitem>
+ <para>Use this drop-down list to select the mode in which you want to display the applet.
+ Available modes are: Graphic, Text and both (Graphic and Text)
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Show CPU frequency as frequency</guilabel></term>
+ <listitem>
+ <para>Select this option to display the current CPU frequency.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Show frequency units</guilabel></term>
+ <listitem>
+ <para>Select this option to display or not the frequency units in the frequency mode.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Show CPU frequency as percentage</guilabel></term>
+ <listitem>
+ <para>Select this option to display the current CPU frequency as a percentage.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry><term><guilabel>Show menu</guilabel></term>
+ <listitem>
+ <para>
+ This option allows you to choose how much information is shown in
+ the frequency selector dropdown
+ (see <xref linkend="mate-cpufreq-selector"/>). You can select to
+ display <guilabel>Frequencies</guilabel>,
+ <guilabel>Governors</guilabel> or both <guilabel>Frequencies and
+ Governors</guilabel>.
+ <figure id="cpufreq-applet-selector-both-2">
+ <title>The selector configured to Frequencies and Governors</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject><imagedata fileref="figures/cpufreq-applet-selector-both.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>CPU governors selector</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ </para>
+ </listitem></varlistentry>
+ </variablelist>
+ </sect1>
+
+</article>
diff --git a/cpufreq/help/C/figures/cpufreq-100.png b/cpufreq/help/C/figures/cpufreq-100.png
new file mode 100644
index 00000000..6b63453a
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-100.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-25.png b/cpufreq/help/C/figures/cpufreq-25.png
new file mode 100644
index 00000000..ae2acf6c
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-25.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-50.png b/cpufreq/help/C/figures/cpufreq-50.png
new file mode 100644
index 00000000..03ab5e3b
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-50.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-75.png b/cpufreq/help/C/figures/cpufreq-75.png
new file mode 100644
index 00000000..49e9342d
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-75.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-applet-preferences-smp.png b/cpufreq/help/C/figures/cpufreq-applet-preferences-smp.png
new file mode 100644
index 00000000..f0105a2c
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-applet-preferences-smp.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-applet-preferences.png b/cpufreq/help/C/figures/cpufreq-applet-preferences.png
new file mode 100644
index 00000000..4e211c34
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-applet-preferences.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-applet-selector-both.png b/cpufreq/help/C/figures/cpufreq-applet-selector-both.png
new file mode 100644
index 00000000..e7799490
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-applet-selector-both.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-applet-selector.png b/cpufreq/help/C/figures/cpufreq-applet-selector.png
new file mode 100644
index 00000000..2c962a52
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-applet-selector.png
Binary files differ
diff --git a/cpufreq/help/C/figures/cpufreq-applet.png b/cpufreq/help/C/figures/cpufreq-applet.png
new file mode 100644
index 00000000..159ba28a
--- /dev/null
+++ b/cpufreq/help/C/figures/cpufreq-applet.png
Binary files differ
diff --git a/cpufreq/help/C/legal.xml b/cpufreq/help/C/legal.xml
new file mode 100644
index 00000000..acb0b403
--- /dev/null
+++ b/cpufreq/help/C/legal.xml
@@ -0,0 +1,76 @@
+ <legalnotice id="legalnotice">
+ <para>
+ 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 <ulink type="help"
+ url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+ distributed with this manual.
+ </para>
+ <para> 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.
+ </para>
+
+ <para>
+ 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.
+ </para>
+
+ <para>
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+ UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+ WITH THE FURTHER UNDERSTANDING THAT:
+
+ <orderedlist>
+ <listitem>
+ <para>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
+ </para>
+ </listitem>
+ <listitem>
+ <para>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.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </legalnotice>
+