summaryrefslogtreecommitdiffstats
path: root/doc/en/index.docbook
diff options
context:
space:
mode:
authortpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2010-02-19 18:17:02 +0000
committertpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2010-02-19 18:17:02 +0000
commitf867212c1762e156553d039319b904a17f7b563d (patch)
tree461c1a743b3ff8291e03360742dbbfb4cc0087e4 /doc/en/index.docbook
downloadknutclient-f867212c1762e156553d039319b904a17f7b563d.tar.gz
knutclient-f867212c1762e156553d039319b904a17f7b563d.zip
Added KDE3 version of knutclient
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/knutclient@1092914 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc/en/index.docbook')
-rwxr-xr-xdoc/en/index.docbook1288
1 files changed, 1288 insertions, 0 deletions
diff --git a/doc/en/index.docbook b/doc/en/index.docbook
new file mode 100755
index 0000000..2b8ac9d
--- /dev/null
+++ b/doc/en/index.docbook
@@ -0,0 +1,1288 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN"
+"dtd/kdex.dtd" [
+ <!ENTITY knutclient '<application>KNutClient</application>'>
+ <!ENTITY kappname "&knutclient;"><!-- replace knutclient here -->
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE"><!-- change language only here -->
+
+ <!-- Do not define any other entities; instead, use the entities
+ from kde-genent.entities and $LANG/user.entities. -->
+]>
+<!-- kdoctemplate v0.8 October 1 1999
+ Minor update to "Credits and Licenses" section on August 24, 2000
+ Removed "Revision history" section on 22 January 2001 -->
+
+<!-- ................................................................ -->
+
+<!-- The language must NOT be changed here. -->
+
+<book lang="&language;">
+
+<!-- This header contains all of the meta-information for the document such
+as Authors, publish date, the abstract, and Keywords -->
+
+<bookinfo>
+<title>The KNutClient Handbook</title>
+
+<authorgroup>
+<author>
+<firstname>Daniel</firstname>
+<othername></othername>
+<surname>Prynych</surname>
+<affiliation>
+<address><email>Daniel@prynych.cz</email></address>
+</affiliation>
+</author>
+</authorgroup>
+
+
+<copyright>
+<year>2001</year>
+<year>2002</year>
+<year>2003</year>
+<year>2004</year>
+<year>2006</year>
+<year>2007</year>
+<year>2008</year>
+<year>2009</year>
+<holder>Daniel Prynych</holder>
+</copyright>
+
+<!-- Translators: put here the copyright notice of the translation -->
+<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook
+ and in the FDL itself on how to use it. -->
+<legalnotice>&FDLNotice;</legalnotice>
+
+<!-- Date and version information of the documentation
+Don't forget to include this last date and this last revision number, we
+need them for translation coordination !
+Please respect the format of the date (DD/MM/YYYY) and of the version
+(V.MM.LL), it could be used by automation scripts.
+Do NOT change these in the translation. -->
+
+<date>15/01/2008</date>
+<releaseinfo>0.12.01</releaseinfo>
+
+<!-- Abstract about this handbook -->
+
+<abstract>
+<para>
+&knutclient; is GUI client for UPS system NUT.
+</para>
+<para>
+This document describes &knutclient; version 0.9.5
+</para>
+</abstract>
+
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdeutils</keyword>
+<keyword>KNutClient</keyword>
+<keyword>NUT</keyword>
+<keyword>UPS</keyword>
+</keywordset>
+
+</bookinfo>
+
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>
+The &knutclient; is the application that watches state of UPS for system NUT.
+</para>
+</chapter>
+
+<chapter id="using-knutclient">
+<title>Using KNutClient</title>
+
+<sect1 id="knutclient-mainwin">
+<title>Main window &knutclient;</title>
+
+
+
+<para>
+Main window applications &knutclient;
+</para>
+<para>
+The &knutclient; is the client graphics application for system NUT
+"Network Ups Tools". It enables to watch the state of UPS and to show
+values of variables which the choice UPS a its driver are supporting.
+</para>
+
+<para>
+From version 0.6.0 &knutclient; supports the running of instant command and
+enables the change of RW variables.
+</para>
+<para>
+From version 0.9.0 &knutclient; doesn't support protocol UDP.
+</para>
+
+<para>
+<screenshot>
+<screeninfo>Main window &knutclient;</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="knutclient-en.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+</screenshot>
+</para>
+<para>
+
+Main window is divided in two parts.
+</para>
+<para>
+The left part "Main panel" includes next dates which show the state of the UPS choice.
+On line, on battery, overload,replace battery,battery low, calibration,runtime.
+There are unchangeable dates in this panel, name of UPS, serial number,
+manufactured. This dates are reading only once, when you UPS choose.
+</para>
+<para>
+The right part includes analog panels. These panels show values of variables like
+input voltage, load UPS, battery charge, UPS temperature, battery voltage.
+</para>
+<para>
+&knutclient; includes toolbar, with standard buttons and button for the UPS choice.
+</para>
+</sect1>
+
+<sect1 id="knutclient-kicker">
+<title>&knutclient; and KDE panel</title>
+
+<para>
+<screenshot>
+<screeninfo>&knutclient; and KDE panel</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="tkicker-en.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+</screenshot>
+</para>
+
+<para>
+From 0.8.0 version &knutclient; docks in KDE panel. His icon is variable and shows
+information about UPS load, runtime and the charge of battery, depending on type of icons is selected.
+
+After moving the pointer of the mouse on the icon, information window "ToolTip" is showes up,
+which includes more information about UPS, Name, UPS name ,Address, State, Runtime ..
+</para>
+</sect1>
+
+
+<sect1 id="knutclient-features">
+<title>More KNutClient features</title>
+<para>
+For connecting with server side of NUT (upsd), &knutclient; uses protocol TCP.
+When UPS is selected in toolbar, &knutclient; tries to read the data. When
+reading fails, reading is repeated. The maximum count of repetitions is five.
+Afterwards &knutclient; reads data in periodical sequences. The first reading
+reads all variables, next reading reads variables that analog panels,
+RUNTIME a state of UPS show only. Variables show UPS name, manufacturer, serial
+number ... are read only once, because their changes aren't probable.
+</para>
+
+<para>
+Errors which arise like answer from user actions are show in their own window.
+</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+
+<sect1 id="knutclient-mainwindow">
+<title>The main KNutClient window</title>
+<para></para>
+
+<sect2>
+<title>The File Menu</title>
+<para>
+<variablelist>
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>File</guimenu>
+ <guimenuitem>Showing Ups variables and commands</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Shows Ups variables for selected Ups
+ </action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>File</guimenu>
+ <guimenuitem>Running instant command</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Runs selected instant command for selected UPS</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>File</guimenu>
+ <guimenuitem>Setting RW variables</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action> Changes selected UPS RW variable</action></para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><menuchoice>
+ <shortcut>
+ <keycombo><keycap>Ctrl</keycap><keycap>q</keycap></keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Quit</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Quits program</action></para></listitem>
+ </varlistentry>
+</variablelist>
+</para>
+</sect2>
+
+
+<sect2>
+<title>Menu Connection</title>
+<para>
+<variablelist>
+ <varlistentry>
+ <term><menuchoice>
+ <shortcut>
+ <keycombo><keycap>F1</keycap></keycombo>
+ </shortcut>
+ <guimenu>Connection</guimenu>
+ <guimenuitem>Reconnect</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Restore connection (reconnect) to UPS server(upsd).
+ </action></para></listitem>
+ </varlistentry>
+</variablelist>
+</para>
+</sect2>
+
+
+
+<sect2>
+<title>Menu Settings</title>
+<para>
+<variablelist>
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Show Toolbar</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Shows/Hides toolbar.</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Show Statusbar</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Shows/Hides statusbar.</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Configure Shortcuts... </guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action>Opens dialog panels for configuration key/action associations.
+ </action></para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Configure &knutclient; </guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action>Opens main configuration dialog panels.
+ </action></para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Using description</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action>Shows/Hides tooltip for showing UPS variables and commands.
+ </action></para>
+ </listitem>
+ </varlistentry>
+
+</variablelist>
+</para>
+</sect2>
+</sect1>
+
+<sect1 id="knutclient-kicker-comm">
+<title>Icon in KDE panel</title>
+
+<para>
+<screenshot>
+<screeninfo>Menu of KDE panel's icon</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="mkicker-cs.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+</screenshot>
+</para>
+
+
+<sect2>
+<title>Menu</title>
+<para>
+<variablelist>
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>UPS</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Using for select Ups.</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Showing Ups variables and commands</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Shows Ups variables for selected Ups.
+ </action></para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Running instant command</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Runs selected instant command for selected UPS.</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Setting RW variables</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action> Changes selected UPS RW variable.</action></para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Reconnect</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Restore connection (reconnect) to UPS server(upsd).
+ </action></para></listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Setting &knutclient; </guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action>Opens configuration dialog panels.
+ </action></para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>About &knutclient;</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action>Shows information about aplication &knutclient;.</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Minimalize</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para><action>Closes main window.</action></para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenuitem>Quit</guimenuitem>
+ </menuchoice></term>
+ <listitem><para><action>Quits program.</action></para></listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+ </sect2>
+ </sect1>
+
+
+<sect1 id="knuclient-show-variables">
+<title>Showing variables</title>
+<para>
+This window shows list of all variables and instant commands, when exist for selected UPS.
+<screenshot>
+<screeninfo>Window of variables and instant commands</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="variables-cs.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+</screenshot>
+</para>
+</sect1>
+
+
+
+ <sect1 id="knuclient-instant-command">
+ <title>Instant commands</title>
+ <para>
+ Instant commands run in UPS, the NUT server puts the command selected driver and
+ driver will run the command in UPS. The control window offers commands, which
+ the driver supports.
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>OK</guilabel></term>
+ <listitem>
+ <para>The button <guibutton>OK</guibutton> runs the selected commands.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Cancel</guilabel></term>
+ <listitem>
+ <para>The Button <guibutton>Cancel</guibutton> closes the window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Command</guilabel></term>
+ <listitem>
+ <para>The command for running is selected here.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect1>
+
+ <sect1 id="knutclient-RW-values">
+ <title>User changed (RW) variables</title>
+ <para>
+ User changed variables are group of variables which can be changed by the user.
+ Majority of them are equal to setting of UPS. There are two types of user
+ changed variables, char or enumerated variables. Char variables are a string of
+ chars with maximal length. Enumerated variables are a list of right values
+ for setting these variables.
+ </para>
+ <para>
+ User changed variable is not changed on server NUT (upsd) but the server
+ puts command for change to driver, it changes the setting immediately. This
+ activity is not instant and it can wait a few seconds.
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>OK</guilabel></term>
+ <listitem>
+ <para>Button<guibutton>OK</guibutton> changes variable.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Cancel</guilabel></term>
+ <listitem>
+ <para>Button <guibutton>Cancel</guibutton> close window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Default</guilabel></term>
+ <listitem>
+ <para>Button <guibutton>Default</guibutton> sets default values
+this variable.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Variable</guilabel></term>
+ <listitem>
+ <para>Variable for changed is selected here.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Value</guilabel></term>
+ <listitem>
+ <para> Values for selected variable are selected here.
+ Array for changed of value is changes on base type of variable.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect1>
+
+
+<sect1 id="knutclient-configuration">
+<title>Setting &knutclient;</title>
+
+<para>
+The window for setting has got five parts Setting, UPS, Panel, Fonts and Analog.
+</para>
+ <sect2>
+ <title>Setting</title>
+ <para>
+ Part Setting is used for setting number of rows, analog panels, background color of the main window,
+ input voltage (120/230)V, frequency of input voltage (50/60)Hz and allowing of Xfer's values (LowXfer and HighXfer)
+ </para>
+ <para>
+ <screenshot>
+ <screeninfo>&knutclient; </screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="msetting-en.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Number of columns</guilabel></term>
+ <listitem>
+ <para>This sets the maximum number of columns for analog panels</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Use custom background color</guilabel></term>
+ <listitem>
+ <para>This allows to use the custom background color of the main window.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Color of Background</guilabel></term>
+ <listitem>
+ <para>This selects the background color.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Use dialog "Are you sure"</guilabel></term>
+ <listitem>
+ <para>
+ This switches on dialog "Are you sure" when you want to end the program.
+ When you don't acknowledge dialog "Are you sure", program doesn't stop.</para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><guilabel>Use Main window when program started</guilabel></term>
+ <listitem>
+ <para>Sets showing main window, when program started.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Show message window, when program reports error</guilabel></term>
+ <listitem>
+ <para>Permits showing message window, what shows description of error. It's useful when docking of program isn't forbided.</para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><guilabel>Nominal Input Voltage</guilabel></term>
+ <listitem>
+ <para> This selects nominal input voltage from 230V or 120V. The selection isn't
+ useless of <guilabel>"Use High-Low XFER"</guilabel> is switched on.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Nominal Input Frequency</guilabel></term>
+ <listitem>
+ <para> This selects nominal input frequency from 50Hz or 60Hz. The selection isn't
+ useless of<guilabel>"Use High-Low XFER"</guilabel> is switched on.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Use High-Low XFER</guilabel></term>
+ <listitem>
+ <para>This sets nominal input voltage and nominal input frequency on based values in variables of NUT LOWXFER and HIGHXFER.
+ These variables determine the range of value input voltage, which UPS can work with.
+ On the basis of thise values &knutclient; sets input voltage and input frequency for analog panels which use them.
+ These panels are input voltage, input frequency and etc.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+</sect2>
+
+<sect2>
+ <title>UPS</title>
+ <para>
+ The part UPS is used for setting the list of UPS and their parameters
+ The left part includes list of UPS. The right part includes buttons for
+ adding, changed parameters and deleting the record of UPS.
+ </para>
+ <para>
+ <screenshot>
+ <screeninfo>&knutclient; </screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="usetting-en.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guibutton>Add</guibutton></term>
+ <listitem>
+ <para>This adds into the list another UPS and sets its parameters.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guibutton>Change</guibutton></term>
+ <listitem>
+ <para>This changes parametric selected UPS.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guibutton>Delete</guibutton></term>
+ <listitem><para>This deletes UPS from list.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <sect3>
+ <title>Setting of parameters</title>
+ <para>
+ This windows is used for setting parameters of UPS.
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="new-en.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Name</guilabel></term>
+ <listitem>
+ <para>This sets the name of UPS for the &knutclient; program.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>UPS address</guilabel></term>
+ <listitem>
+ <para>
+ This sets name of PC. UPS is connected with this PC.
+ This name is UPS address on net.
+ Examples: ns.alo.cz, localhost, 192.168.1.12.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><guilabel>UPS name</guilabel></term>
+ <listitem>
+ <para>
+ This sets name of UPS as it is defined in NUT. When name is not defined
+ program uses the first name of NUT system list on this PC.
+ This is true when minimal version of upsd is 1.3. Look into NUT documentacion.
+ Examples: victron, myups, apc700.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Delay (ms)</guilabel></term>
+ <listitem>
+ <para>
+ This sets the interval between two transmitions of data (reading data) from the NUT system.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Password</guilabel></term>
+ <listitem>
+ <para>This sets the password for the authorization of the user.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Store NUT password in configuration file</guilabel></term>
+ <listitem>
+ <para>
+ When you select this selection, the password will be saved into the configuration file.
+ Password saved in configuration file not crypt. When you don't select this selection,
+ the password will be forgotten, when the program is ended.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>UPS Variables</guilabel></term>
+ <listitem>
+ <para>This selects variables which will show in analog panels
+ in the right part main window.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ Parameters User Name and Password are used for instant command or change of RW variables only.
+ For watching the state of UPS the User name and the Password aren't needed.
+ The Password and The User name have got their equivalents in file upsd.users of the NUT system.
+ </para>
+ </sect3>
+ </sect2>
+
+<sect2>
+ <title>Panel</title>
+ <para>
+ The part Panel is used for selecting which information's parts of the main panel will show.
+ </para>
+ <para>
+ <screenshot>
+ <screeninfo>&knutclient; </screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="psetting-en.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <variablelist>
+
+ <varlistentry>
+ <term><guilabel>Overloading</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing overloading
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>UPS Battery low</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing battery low.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Replace battery</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing that battery needs to be replaced
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Ups calibration</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing UPS calibration.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Manufac. + Model</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing Manufacturer and Model of UPS
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Manufacturer</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing Manufacturer of UPS.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Model</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing Model of UPS.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Serial</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing serial number.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Firm. rev.</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing firmware's revision.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Runtime</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides show the time of the runtime on battery without power.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Use custom background color</guilabel></term>
+ <listitem>
+ <para>This allows to use the custom background color of the main panel.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of background</guilabel></term>
+ <listitem>
+ <para>This selects the background color.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+</sect2>
+
+ <sect2>
+ <title>Fonts</title>
+ <para>
+ The part Fonts is used for selecting used fonts.
+ </para>
+ <para>
+ <screenshot>
+ <screeninfo>&knutclient; </screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="fsetting-en.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Use custom font</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides allows to select custom fonts for the main panel and the analog panels.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Main panel / Analog panels</guilabel></term>
+ <listitem>
+ <para>This selects the panel for which the font is selected.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Font</guilabel></term>
+ <listitem>
+ <para>This selects the font for the selection panel.
+ This is used when select <guilabel>Use custom font</guilabel> is selected.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
+
+
+
+
+<sect2>
+ <title>Analog</title>
+ <para>
+ The part Analog is used for setting color for the analog panels.
+ </para>
+
+ <para>
+ <screenshot>
+ <screeninfo>&knutclient; </screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="asetting-en.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para>
+ <variablelist>
+
+ <varlistentry>
+ <term><guilabel>Use custom background color</guilabel></term>
+ <listitem>
+ <para>This allows to use custom background color for the analog panel.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of background</guilabel></term>
+ <listitem>
+ <para>This selects the background color of analog panel.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Use custom other colors</guilabel></term>
+ <listitem>
+ <para>This allows to select custom color of the analog panel's other parts.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of pointer</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting the color of analog panel's pointer (finger). Default color is black.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of OK range</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting color of range OK for analog panel. Default color is green.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of warning range</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting color of range warning for analog panel. Default color is yellow.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of error range</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting color of range error for analog panel. Default color is red.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of scale</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting color of scale for analog panel. Default color is black.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of font</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting color of font for analog panel. Default color is black.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+
+ <varlistentry>
+ <term><guilabel>Digital processing of pointers</guilabel></term>
+ <listitem>
+ <para>
+ This is used for selecting type of graphics proccessing of pointers.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ </variablelist>
+ </para>
+ </sect2>
+
+ <sect2>
+ <title>Docking</title>
+ <para>
+ The part DOCK is used for setting parameters of docking program.
+ </para>
+ <para>
+ <screenshot>
+ <screeninfo>&knutclient; </screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="ksetting-cs.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+
+ <para>
+ Type of dock's showing (Dock is KDE panel).
+ </para>
+
+ <para>
+ <variablelist>
+
+ <varlistentry>
+ <term><guilabel>Picture</guilabel></term>
+ <listitem>
+ <para>
+ Sets picture type of icon.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>General</guilabel></term>
+ <listitem>
+ <para>
+ Sets general type of icon, for specialist only.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+
+ <para>
+ Items of ToolTip. (ToolTip is bubble help.)
+ </para>
+
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Manufacturer</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing Manufacturer of UPS.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Model</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing Model of UPS.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><guilabel>Serial</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing serial number.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Firm. rev.</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing firmware's revision.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Runtime</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing the time of the runtime on battery without power.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><guilabel>Battery Charge</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing the Battery Charge.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Load UPS</guilabel></term>
+ <listitem>
+ <para>
+ Shows/Hides showing the Load of UPS.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+
+ <varlistentry>
+ <term><guilabel>Use custom background color</guilabel></term>
+ <listitem>
+ <para>This allows to use the custom background color of KDE panel's icon, when type of icon in KDE panel is picture.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel>Color of background</guilabel></term>
+ <listitem>
+ <para>This selects the background color.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+ </sect2>
+
+
+</sect1>
+</chapter>
+
+<chapter id="faq">
+<title>Questions and Answers</title>
+
+&reporting.bugs;
+&updating.documentation;
+
+<qandaset id="faqlist">
+<qandaentry>
+<question>
+<para>
+The &knutclient; isn't working, but the upsc is. What shall I do ?
+</para>
+</question>
+<answer>
+<para>
+See the setting number of port. From version 0.5 (NUT) the number of port is changed.
+</para>
+</answer>
+</qandaentry>
+</qandaset>
+</chapter>
+
+<chapter id="credits">
+
+<title>Credits and License</title>
+
+<para>
+&knutclient;
+</para>
+<para>
+Program copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008 Daniel Prynych <email>Daniel@prynych.cz</email>
+</para>
+<para>
+Documentation copyright 2003, 2004, 2005, 2006, 2007, 2008 Daniel Prynych <email>Daniel@prynych.cz</email>
+</para>
+<para>
+Translations done by:
+<itemizedlist>
+<listitem>
+<para>Daniel Prynych <email>Daniel@prynych.cz</email> Eng</para>
+</listitem>
+</itemizedlist>
+</para>
+
+&underFDL; <!-- FDL: do not remove -->
+&underGPL; <!-- GPL License -->
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="getting-knutclient">
+<title>How to obtain KNutClient</title>
+
+<para>
+&knutclient; is not part of the KDE project
+<ulink url="http://www.kde.org">http://www.kde.org</ulink>.
+&knutclient; can be found on
+<ulink
+url="ftp://ftp.buzuluk.cz/pub/alo/knutclient/">ftp://ftp.buzuluk.cz/pub/alo/knutclient/</ulink>, the
+main ftp site of the A.L.O. </para>
+</sect1>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>
+In order to successfully use &knutclient;, you need KDE 3.x
+</para>
+
+<para>
+You can find a list of changes at <ulink
+url="http://www.knut.noveradsl.cz/knutclient/">http://www.knut.noveradsl.cz/knutclient/</ulink>.
+</para>
+</sect1>
+
+<sect1 id="compilation">
+<title>Compilation and installation</title>
+
+<para>
+In order to compile and install &knutclient; on your system, type the following
+in the base
+directory of.
+<screen width="40">
+<prompt>%</prompt> <userinput>./configure</userinput>
+<prompt>%</prompt> <userinput>make</userinput>
+<prompt>%</prompt> <userinput>make install</userinput>
+</screen>
+</para>
+
+<para>Since KApp uses autoconf and automake you should have not trouble
+compiling it.
+Should you run into problems please report them to the KDE mailing lists.</para>
+</sect1>
+</appendix>
+
+&documentation.index;
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+End:
+-->