# &karm;i käsiraamat

## Sissejuhatus

&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.

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

## &karm;i kasutamine

### &karm;i käivitamine

Selleks kirjuta käsureale `karm` või vali KDE käivitusmenüüst grupi Utiliidid alt Personaalne ajaarvestus. Käsureal saab kasutada tavalisi &Qt; ja &kde; argumente, millest saab ülevaate käsuga ``karm` `--help``.

### Kasutamisest üldiselt

Sisesta mistahes ülesanded, millele kuluvat aega soovid jälgida.

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

Nüüdsest on võimalik jälgida ka mitut ülesannet korraga.

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

## &karm;i kasutajaliides

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

&karm;i aken &karm;i aken

### Ülesande/aja aken

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.

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.

### &karm;i menüüriba

#### Menüü Fail

&Ctrl;S Fail Salvesta

- Salvestab käesolevad ülesanded ja alamülesanded koos nende koguajaga

&Ctrl;P Fail Trüki

- Trükib &karm;i akna

&Ctrl;R Fail Nulli seansi aeg

- Muudab käesoleva seansi kulutatud koguaja nulliks

&Ctrl;Q Fail Välju

- Lõpetab &karm;i töö

#### Menüü Kell

S Kell Käivita

- Käivitab valitud ülesande ajaarvestuse

&Esc; Kell Stopp

- Peatab valitud ülesande ajaarvestuse

#### Menüü Ülesanne

&Ctrl;N Ülesanne Uus

- Lisab uue ülesande

&Ctrl;&Alt;N Ülesanne Uus alamülesanne

- Lisab valitud ülesandele uue alamülesande

Del Ülesanne Kustuta

- Kustutab valitud ülesande või alamülesande

&Ctrl;E Ülesanne Muuda

- Muudab valitud ülesande nime või aega

  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.

#### Menüü Seadistused

Seadistused Kiirklahvide seadistamine

- Avab dialoogi, kus saab määrata või muuta kiirklahve

Seadistused KArmi seadistamine

- Avab dialoogi, kus saab &karm;i seadistada

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

#### Menüü Abi

&help.menu.documentation;

### Tööriistariba

Tööriistariba sisaldab ikoone järgmiste käskudega:

(Kõik toimivad sarnaselt samanimelistele menüükäskudele.)

- Käivita

- Stopp

- Uus

- Uus alamülesanne

- Kustuta

- Muuda

### Olekuriba

Annab teada seansi ajal kokku kulunud aja.

## Autorid ja litsents

&karm;

Rakenduse autoriõigus 1997-2000: Sirtaj Singh Kang taj@kde.org.

Kaasautorid

- Espen Sand espen@kde.org

- Jesper Pedersen blackie@ifad.dk

- Kalle Dalheimer kalle@kde.org

- Klarälvdalens Datakonsult AB

- Tomas Pospisek tpo_deb@sourcepole.ch

- Gioele Barabucci gioele@gioelebarabucci.com

- Jan Schaumann jschauma@netmeister.org

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

Dokumentatsiooni autoriõigus 2000: Jonathan Singer jsinger@leeta.net ja Sirtaj Singh Kang taj@kde.org.

&underFDL; &underGPL;

## Paigaldamine

### &karm;i hankimine

&install.intro.documentation; &install.compile.documentation;
&documentation.index;