<?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 % Danish "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>
<title
>&karm;-håndbogen</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
>Tester</contrib>
<affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
</othercredit>
&erik.kjaer.pedersen.role; 
</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; holder øje med tiden der bruges til forskellige opgaver.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>karm</keyword>
<keyword
>kdeutils</keyword>
<keyword
>tid</keyword>
<keyword
>sporer</keyword>
<keyword
>projekt</keyword>
</keywordset>

</bookinfo>

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

<para
>&karm; holder øje med tiden som bruges til forskellige opgaver. Den er nyttig til at huske timer som skal beregnes for forskellige kunder eller kun for at holde styr på hvor mange procent af dagen som går med at spille Doom eller læse Slashdot.</para>

<para
>&karm; er oprindelig skrevet af Sirtaj Singh Kang. Ordet <quote
>karm</quote
> betyder <quote
>arbejde</quote
> på forfatterens modersmål Punjabi.</para>

</chapter>


<chapter id="using-Karm">
<title
>Brug af &karm;</title>

<sect1 id="starting">
<title
>Start &karm;</title>

<para
>Skriv <command
>karm</command
> på kommandolinjen eller vælg <guimenuitem
>Personlig tidsmåler</guimenuitem
> fra gruppen <guisubmenu
>Værktøj</guisubmenu
> i <guimenu
>KDE's startmenu</guimenu
>. De almindelige &Qt;- og &kde;-kommandoflag er tilgængelige, og kan ses på en liste ved at skrive <userinput
><command
>karm</command
> <option
>--help</option
></userinput
> på kommandolinjen.</para>

</sect1>

<sect1 id="general-use">
<title
>Generel brug</title>

<para
>Indtast de forskellige opgaver du vil følge.</para>

<para
>For at begynde at tage tid for en opgave, markeres den og der dobbeltklikkes på den, vælg <guimenuitem
>Start</guimenuitem
> i  <guimenu
>Ur</guimenu
> eller tryk på knappen <guiicon
>Start</guiicon
> i værktøjslinjen. For at holde op med at tage tid, dobbeltklikkes på den, vælg <guimenuitem
>Stop</guimenuitem
> i menuen <guimenu
>Ur</guimenu
> eller tryk på knappen <guiicon
>Stop</guiicon
> i værktøjslinjen.</para>

<para
>Flere opgaver kan nu tidsmåles samtidigt.</para>

<para
>Opgaver kan gemmes og genoprettes ved næste brug.</para>

</sect1>

</chapter>

<chapter id="interface">
<title
>&karm;s grænseflade</title>

<para
>Hovedvinduet for &karm; har følgende dele: menulinje, værktøjslinje, opgave/tidsvindue og en statuslinje.</para>

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

<sect1 id="main-window">
<title
>Opgave/tidsvinduet</title>

<para
>De forskellige opgaver vises i dette vindue, sammen med tiden som er gået for hver i den nuværende session og i alt. Opgaver som tidsmåless har et lille ur ved siden af sessionstiden.</para>

<para
>Underopgaver kan laves for hver opgave. Ved at dobbeltklikke på en opgave vises eller gemmes de tilsvarende underopgaver. Den totale tid som gået med en opgave indeholder tiderne for dens underopgaver samt dens egen akkumulerede tid.</para>

</sect1>

<sect1 id="menus">
<title
>&karm;s menulinje</title>
<sect2>
<title
><guimenu
>Fil</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Gem</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Gemmer de nuværende opgaver og underopgaver og deres totale tid.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Udskriv</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Udskriver</action
> &karm;s vindue</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Nulstil sessionstid</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Nulstiller den total tid der er gået for den nuværende session</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fil</guimenu
> <guimenuitem
>Afslut</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Lukker</action
> &karm;</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
><guimenu
>Ur</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycap
>S</keycap
> </shortcut
> <guimenu
>Ur</guimenu
> <guimenuitem
>Start</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Starter</action
> tidsmåling for den markerede opgave</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
><keycap
>&Esc;</keycap
></shortcut
> <guimenu
>Ur</guimenu
> <guimenuitem
>Stop</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Stopper</action
> tidsmåling for den markerede opgave</para
></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title
><guimenu
>Opgave</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Ny</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Tilføjer</action
> en ny opgave</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Ny underopgave</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Tilføjer</action
> en ny underopgave til den markerede opgaven</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycap
>Del</keycap
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Slet</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Sletter</action
> den markerede opgave eller underopgave</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Opgave</guimenu
> <guimenuitem
>Redigér</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Ændrer navn eller total tid</action
> for den nuværende opgave</para
><para
>Der er to måder at ændre tiden: Redigér absolut, hvor sessionstiden og totale tiden kan ændres separat, og Redigér relativt, hvor en vis ændring lægges til eller fjernes både fra sessionstiden og den totale tid.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title
><guimenu
>Opsætnings</guimenu
>menuen</title>
<variablelist>


<varlistentry>
<term>
<menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil genveje</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Åbner</action
> en dialog til at lade brugeren indstille genvejstaster</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil KArm</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Åbner</action
> en dialog til at lade brugeren indstille &karm;</para>

<para
>Dialogen har to faneblade: <guilabel
>Gem</guilabel
>, som indstiller stedet for filen hvor tidsinformation gemmes, om opgaver gemmes automatisk og intervallet mellem at gemme automatisk, og  <guilabel
>Detektion af tomgang</guilabel
> som, når markeret viser en advarsel når ingen opgave er opdaget indenfor en angiven tidsperiode.</para
> </listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
><guimenu
>Hjælpe</guimenu
>menuen</title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="tool-bar">
<title
>Værktøjslinjen</title>
<para
>Værktøjslinjen indeholder ikoner for følgende kommandoer:</para>

<note
><para
>(Alle opfører sig på samme måde som menukommandoen.)</para
></note>

<itemizedlist>
<listitem
><para
><guiicon
>Start</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Stop</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Ny</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Ny underopgave</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Slet</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Redigér</guiicon
></para
></listitem>
</itemizedlist>

</sect1>

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

<para
>Rapporterer den totalt tid der er gået for en session.</para>
</sect1>

</chapter>

<chapter id="credits">

<title
>Medvirkende og licens</title>

<para
>&karm; </para>

<para
>Program ophavsret 1997-2000 Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>

<para
>Bidragydere</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; er inspireret af Harald Tveit Alvestrands meget nyttige værktøj som hedder <application
>titrax</application
>, hvis eneste fejl er at det er baseret på Xt-værktøjskassen.</para>

<para
>Dokumentation ophavsret 2000 Jonathan Singer <email
>jsinger@leeta.net</email
> og Sirtaj Singh Kang <email
>taj@kde.org</email
>.</para>
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-karm">
<title
>Hvordan får man fat på &karm;</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
-->
