<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&karm;">
  <!ENTITY package "kdepim">
  <!ENTITY % Estonian  "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>
<title
>&karm;i käsiraamat</title>

<authorgroup>
<author
><firstname
>Jonathan</firstname
> <surname
>Singer</surname
> <affiliation
> <address
><email
>jsinger@leeta.net</email
></address>
</affiliation>
</author>

<author
><firstname
>Sirtaj</firstname
> <othername
>Singh</othername
> <surname
>Kang</surname
> <affiliation
><address
><email
>taj@kde.org</email
></address
></affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <contrib
>Korrigeerija</contrib>
<affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
</othercredit>
<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@online.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2000-2002</year>
<holder
>Jonathan Singer</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-10-07</date>
<releaseinfo
>1.00.00</releaseinfo>

<abstract
><para
>&karm; jälgib mitmesugustele ülesannetele kuluvat aega.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>karm</keyword>
<keyword
>kdeutils</keyword>
<keyword
>aeg</keyword>
<keyword
>jälgija</keyword>
<keyword
>projekt</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Sissejuhatus</title>

<para
>&karm; jälgib mitmesugustele ülesannetele kuluvat aega. Sellest on kasu näiteks selgitamaks, kui palju aega kulub mingile kliendile või mitu tundi päevas on näiteks pandud Doomi mängimise või Slashdoti lugemise alla.</para>

<para
>&karm;i originaali kirjutas Sirtaj Singh Kang. Sõna <quote
>karm</quote
> tähendab tema emakeeles ehk pandžabi keeles <quote
>töö</quote
>.</para>

</chapter>


<chapter id="using-Karm">
<title
>&karm;i kasutamine</title>

<sect1 id="starting">
<title
>&karm;i käivitamine</title>

<para
>Selleks kirjuta käsureale <command
>karm</command
> või vali <guimenu
>KDE käivitusmenüü</guimenu
>st grupi <guisubmenu
>Utiliidid</guisubmenu
> alt <guimenuitem
>Personaalne ajaarvestus</guimenuitem
>. Käsureal saab kasutada tavalisi &Qt; ja &kde; argumente, millest saab ülevaate käsuga <userinput
><command
>karm</command
> <option
>--help</option
></userinput
>.</para>

</sect1>

<sect1 id="general-use">
<title
>Kasutamisest üldiselt</title>

<para
>Sisesta mistahes ülesanded, millele kuluvat aega soovid jälgida.</para>

<para
>Ülesande ajakulu jälgimise alustamiseks vali see ja tee selle nimel topeltklõps või vali menüüst <guimenu
>Kell</guimenu
> käsk <guimenuitem
>Käivita</guimenuitem
> või klõpsa tööriistaribal ikoonile <guiicon
>Käivita</guiicon
>. Ajaarvestuse peatamiseks tee vajaliku ülesande nimel topeltklõps või vali menüüst <guimenu
>Kell</guimenu
> käsk <guimenuitem
>Stopp</guimenuitem
> või klõpsa tööriistaribal ikoonile <guiicon
>Stopp</guiicon
>.</para>

<para
>Nüüdsest on võimalik jälgida ka mitut ülesannet korraga.</para>

<para
>Ülesandeid on võimalik salvestada ning rakenduse järgmisel kasutamisel taas jälgima asuda.</para>

</sect1>

</chapter>

<chapter id="interface">
<title
>&karm;i kasutajaliides</title>

<para
>&karm;i peaaken koosneb järgmistest elementidest: menüüriba, tööriistariba, ülesande/aja aken ja olekuriba.</para>

<screenshot>
<screeninfo
>&karm;i aken</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="karm.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>&karm;i aken</phrase>
          </textobject>
        </mediaobject>
</screenshot>

<sect1 id="main-window">
<title
>Ülesande/aja aken</title>

<para
>Selles aknas on näha ülesanded ning neile kulunud aeg nii praeguse seansi ajal kui kokku. Jälgitavatel ülesannetel on seansi aega näitavas veerus näha väike kell.</para>

<para
>Igale ülesandele saab luua alamülesandeid. Topeltklõps ülesandel vastavalt kas näitab või varjab alamülesandeid. Ülesande koguaega on arvestatud nii selle enda kui tema alamülesannete aeg.</para>

</sect1>

<sect1 id="menus">
<title
>&karm;i menüüriba</title>
<sect2>
<title
>Menüü <guimenu
>Fail</guimenu
></title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Salvesta</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Salvestab käesolevad ülesanded ja alamülesanded koos nende koguajaga</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Trüki</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Trükib</action
> &karm;i akna</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Nulli seansi aeg</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Muudab käesoleva seansi kulutatud koguaja nulliks</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Lõpetab</action
> &karm;i töö</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Menüü <guimenu
>Kell</guimenu
></title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycap
>S</keycap
></shortcut
> <guimenu
>Kell</guimenu
> <guimenuitem
>Käivita</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Käivitab</action
> valitud ülesande ajaarvestuse</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
><keycap
>&Esc;</keycap
></shortcut
> <guimenu
>Kell</guimenu
> <guimenuitem
>Stopp</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Peatab</action
> valitud ülesande ajaarvestuse</para
></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title
>Menüü <guimenu
>Ülesanne</guimenu
></title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Ülesanne</guimenu
> <guimenuitem
>Uus</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Lisab</action
> uue ülesande</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Ülesanne</guimenu
> <guimenuitem
>Uus alamülesanne</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Lisab</action
> valitud ülesandele uue alamülesande</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycap
>Del</keycap
> </shortcut
> <guimenu
>Ülesanne</guimenu
> <guimenuitem
>Kustuta</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Kustutab</action
> valitud ülesande või alamülesande</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Ülesanne</guimenu
> <guimenuitem
>Muuda</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Muudab valitud ülesande nime või aega</action
></para
><para
>Aja muutmiseks on kaks võimalust: absoluutse aja muutmine, mille korral seansi aega ja koguaega saab muuta eraldi, ning suhteline muutmine, mille puhul teatud hulk aega lisatakse või lahutatakse nii seansi kui koguajalt.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>
<variablelist>


<varlistentry>
<term>
<menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Kiirklahvide seadistamine</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Avab</action
> dialoogi, kus saab määrata või muuta kiirklahve</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>KArmi seadistamine</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Avab</action
> dialoogi, kus saab &karm;i seadistada</para>

<para
>Dialoogil on kaks kaarti: <guilabel
>Salvestamine</guilabel
>, kus saab määrata salvestatava faili asukoha, automaatse salvestamise võimaluse ning selle intervalli, ja <guilabel
>Jõudeoleku avastamine</guilabel
>, kus saab näiteks määrata, et teatud aja jõudeoleku tuvastamisel ilmub teatekast.</para
> </listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Menüü <guimenu
>Abi</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="tool-bar">
<title
>Tööriistariba</title>
<para
>Tööriistariba sisaldab ikoone järgmiste käskudega:</para>

<note
><para
>(Kõik toimivad sarnaselt samanimelistele menüükäskudele.)</para
></note>

<itemizedlist>
<listitem
><para
><guiicon
>Käivita</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Stopp</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Uus</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Uus alamülesanne</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Kustuta</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Muuda</guiicon
></para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="status-bar">
<title
>Olekuriba</title>

<para
>Annab teada seansi ajal kokku kulunud aja.</para>
</sect1>

</chapter>

<chapter id="credits">

<title
>Autorid ja litsents</title>

<para
>&karm; </para>

<para
>Rakenduse autoriõigus 1997-2000: Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>

<para
>Kaasautorid</para>
<itemizedlist>
<listitem
><para
>Espen Sand <email
>espen@kde.org</email
></para
></listitem>
<listitem
><para
>Jesper Pedersen <email
>blackie@ifad.dk</email
></para
></listitem>
<listitem
><para
>Kalle Dalheimer <email
>kalle@kde.org</email
></para
></listitem>
<listitem
><para
>Klar&auml;lvdalens Datakonsult AB</para
></listitem>
<listitem
><para
>Tomas Pospisek <email
>tpo_deb@sourcepole.ch</email
></para
></listitem>
<listitem
><para
>Gioele Barabucci <email
>gioele@gioelebarabucci.com</email
></para
></listitem>
<listitem
><para
>Jan Schaumann <email
>jschauma@netmeister.org</email
></para
></listitem>
</itemizedlist>

<para
>&karm;i idee aluseks oli Harald Tveit Alvestrandi väga kasulik utiliit nimetusega <application
>titrax</application
>, mille ainus häda oli see, et ta põhines Xt tööriistakomplektil.</para>

<para
>Dokumentatsiooni autoriõigus 2000: Jonathan Singer <email
>jsinger@leeta.net</email
> ja Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>

<sect1 id="getting-karm">
<title
>&karm;i hankimine</title>
&install.intro.documentation; &install.compile.documentation; </sect1>

</appendix>

&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
