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

<!-- The language must NOT be changed here. -->

<book lang="&language;">

<bookinfo>
<title
>Handbok &kalarm;</title>

<authorgroup>
<author
> <firstname
>David</firstname
> <othername
></othername
> <surname
>Jarvie</surname
> <affiliation
> <address
><email
>software@astrojar.org.uk</email
></address
> </affiliation
> </author>
</authorgroup>

<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@telia.com</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit>

<copyright>
<year
>2001</year
><year
>2002</year>
<holder
>David Jarvie</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>2002-01-29</date>
<releaseinfo
>0.05.00</releaseinfo>

<abstract>
<para
>&kalarm; är en schemaläggare av alarm/påminnelsemeddelanden för &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarm</keyword>
<keyword
>påminnelse</keyword>
</keywordset>

</bookinfo>


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

<para
>&kalarm; är en schemaläggare av alarm/påminnelsemeddelanden. Den låter dig ställa in personliga alarm/påminnelsemeddelanden som dyker upp på skärmen vid tidpunkter som du anger.</para>

<para
>I sitt normala grafiska läge, visar &kalarm; en lista med pågående alarm, med tider och meddelandetexter. Du kan skapa nya alarm, eller alternativt kan du välja befintliga alarm för att ändra eller ta bort dem.</para>

<para
>När du ställer in eller ändrar ett alarm, kan du antingen skriva in texten för alarmmeddelandet, eller ange en textfil som ska visas. Du kan också välja färgen för alarmmeddelandet, om det ska repeteras, om ett hörbart alarm ska ljuda och om alarmet ska avbrytas om det inte kan visas vid den schemalagda tiden.</para>

<para
>Alarm kan också schemaläggas på kommandoraden, eller via &DCOP;-anrop från andra program.</para>

<para
>När ett alarmmeddelande ska visas, syns det på alla &kde;-skrivbord för att vara säker på att du inte missar det om du skulle byta skrivbord vid just det ögonblicket. Meddelandefönstret visar tiden då alarmet var schemalagt, vilket kan vara användbart att veta om det visades sent eller om du inte var vid datorn när det dök upp. Det har oftast ett alternativ som anger att det ska skjutas upp, och visas igen senare. Ett exempel på ett alarmmeddelande:</para>

<screenshot
> <screeninfo
>Skärmbild av &kalarm;s meddelandefönster</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="alarmmessage.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Alarmmeddelande</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>&kalarm; kan köra i ett av två lägen: <quote
>kontinuerligt</quote
> (det normala) då det kör i &kde;:s systembricka, eller <quote
>på begäran</quote
> då det kör när det behövs (med möjligheten att visa en oberoende ikon i systembrickan).</para>

<para
>Det här dokumentet refererar på olika ställen till <application
>alarmdemonen</application
>. Det är ett program som kör i bakgrunden, kontrollerar pågående alarm och talar om för &kalarm; att de ska visas när de inträffar.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Att använda &kalarm;</title>

<sect1 id="graphmode">
<title
>Grafiskt läge</title>

<para
>När det körs utan kommandoradsväljare, startar &kalarm; i grafiskt läge. Det visar den nuvarande listan med pågående alarm, med tider, antal upprepningar, färger och meddelandetexter eller namn på filer som ska visas.</para>

<screenshot
> <screeninfo
>Skärmbild av &kalarm;s huvudfönster</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Huvudfönster</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>För ett upprepat alarm, visar listan nästa gång det är schemalagt att visas och antalet gånger som det ska upprepas därefter.</para>

<para
>Alarmen kan sorteras efter datum/tid, antal upprepningar, färg eller meddelandetext genom att klicka på rubriken för lämplig kolumn. För att vända sorteringsordning, klicka på kolumnens rubrik en gång till.</para>

<para
>När &kalarm; startar i grafiskt läge, kontrolleras om <application
>alarmdemonen</application
> kör. Om den inte redan kör, så startar &kalarm; den.</para>

<sect2>
<title
>Att lägga till ett nytt alarm</title>

<para
>För att lägga till ett nytt alarmmeddelande, välj <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Ny</guimenuitem
></menuchoice
>. Detta visar redigeringsfönstret för alarmmeddelanden:</para>

<screenshot
> <screeninfo
>Skärmbild av alarmredigeringsfönstret</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="editwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Alarmredigeringsfönstret</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>I rutan <guilabel
>Meddelande</guilabel
> välj antingen <guilabel
>Text</guilabel
> för att skriva in meddelandetexten (som kan bestå av flera rader) i redigeringsrutan, eller <guilabel
>Fil</guilabel
> för att skriva in namnet eller webbadressen för en textfil vars innehåll ska visas i alarmmeddelandet. När <guilabel
>Fil</guilabel
> är valt kan <guibutton
>Bläddra...</guibutton
>användas för att visa en filvalsdialogruta.</para>

<para
>Välj <guilabel
>Vid datum/tid</guilabel
> I rutan <guilabel
>Tid</guilabel
>, för att skriva in datum och tid när meddelandet ska visas, eller välj <guilabel
>Tid från nu</guilabel
> för att skriva in hur mycket senare (i timmar och minuter) som meddelandet ska visas.</para>

<para
>Om du vill att alarmet ska upprepas, skriv in antalet upprepningar (efter den första gången) i rutan <guilabel
>Upprepning</guilabel
> och intervallet (i timmar och minuter, med intervallet från 1 minut till 99 timmar) mellan upprepningarna. Markera <guilabel
>Upprepa vid inloggning</guilabel
> om du vill att alarmet ska visas så fort du loggar in, förutom de andra schemalagda tidpunkterna. (Observera att ett alarm som upprepas vid inloggning också visas så fort du startar om eller återställer alarmdemonen.)</para>

<para
>Kryssrutan <guilabel
>Ställ in om sent</guilabel
> avgör vad som händer om alarmet inte kan visas vid sin schemalagda tid. Markera den här rutan för att avbryta alarmet om det inte kan visas inom 1 minut efter den riktiga tiden. Lämna rutan omarkerad för att visa alarmet vid det första möjliga tillfället efter den schemalagda tiden.</para>

<note
><para
>Ett alarm kan bara visas medan du är inloggad, och medan både X och <application
>alarmdemonen</application
> kör.</para
></note>

<para
>Markera kryssrutan <guilabel
>Ljudsignal</guilabel
> om du vill att ett hörbart alarm ska ljuda när alarmmeddelandet visas.</para>

<para
>Välj bakgrundsfärg för alarmmeddelandefönstret.</para>

<para
>Tryck på knappen <guibutton
>Ställ in alarm</guibutton
> när alla uppgifter är riktiga, för att lägga till alarmet i listan på schemalagda alarm.</para>

</sect2>

<sect2>
<title
>Ändra ett befintligt alarm.</title>

<para
>För att ändra ett befintligt alarmmeddelande, gör något av följande:</para>

<itemizedlist
> <listitem
> <para
>Välj det genom att klicka på posten i alarmlistan. Välj sedan <menuchoice
> <guimenu
>Åtgärder</guimenu
> <guimenuitem
>Ändra</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
><mousebutton
>Höger</mousebutton
>klicka på posten i alarmlistan och välj <menuchoice
><guimenuitem
>Ta bort</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para
> </listitem
> </itemizedlist>

<para
>Det här visar redigeringsfönstret för alarmmeddelanden som beskrivs ovan.</para>

</sect2>

<sect2>
<title
>Att ta bort ett befintligt alarm</title>

<para
>För att ta bort ett befintligt alarm, gör något av följande:</para>

<itemizedlist
> <listitem
> <para
>Välj det genom att klicka på posten i alarmlistan. Välj sedan <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Ta bort</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
><mousebutton
>Höger</mousebutton
>klicka på posten i alarmlistan och välj <menuchoice
><guimenuitem
>Ta bort</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
>Bekräfta ett alarm</title>

<para
>När ett fönster med ett alarmmeddelande visas, gör något av följande:</para>

<itemizedlist
> <listitem
> <para
>Bekräfta det genom att klicka på knappen <guibutton
>Ok</guibutton
>.</para
> </listitem
> <listitem
> <para
>Visa alternativ för att skjuta upp alarmet genom att klicka på knappen <guibutton
>Skjut upp...</guibutton
>. Välj sedan <guilabel
>Skjut upp till datum/tid</guilabel
> för att skriva in datum och tid när meddelandet ska visas igen, eller välj <guilabel
>Skjut upp under tidsintervall</guilabel
> för att skriva in hur mycket senare (i timmar och minuter) som meddelandet ska visas igen. Klicka sedan på <guibutton
>Skjut upp</guibutton
> för att skjuta upp alarmmeddelandet.</para
> <note
><para
>Knappen <guibutton
>Skjut upp...</guibutton
> är inte tillgänglig för alarm som visas vid inloggning beroende på att alternativet <guilabel
>Upprepa vid inloggning</guilabel
> markerades.</para
></note
> </listitem
> </itemizedlist>

<para
>Knappen med <guiicon
>&kalarm;</guiicon
>-ikonen tillhandahåller ett bekvämt sätt att aktivera &kalarm;. Att klicka på den har ingen effekt på fönstret med alarmmeddelandet.</para>

</sect2>

<sect2>
<title
>Att visa &kalarm; i systembrickan</title>

<para
>Du måste köra &kde;-skrivbordet för att visa &kalarm; i systembrickan. Om &kalarm; kör i <quote
>kontinuerligt</quote
> läge, visas ikonen i systembrickan alltid. De här anvisningarna gäller bara läget <quote
>på begäran</quote
>. (Se <link linkend="preferences"
>Anpassa förvalda alternativ</link
> för en beskrivning av körlägen.)</para>

<para
>För att visa &kalarm; i &kde;:s  systembricka, välj <menuchoice
> <guimenu
>Visa</guimenu
><guimenuitem
>Visa i systembricka</guimenuitem
> </menuchoice
>.</para>

<para
>För att ta bort &kalarm; från &kde;:s systembricka, gör något av följande:</para>

<itemizedlist
> <listitem
> <para
>Välj <menuchoice
> <guimenu
>Visa</guimenu
><guimenuitem
>Dölj från systembrickan</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para
> </listitem
> </itemizedlist>

<para
>Användning av ikonen i systembrickan beskrivs <link linkend="system-tray"
>nedan</link
>.</para>

</sect2>

<sect2 id="enable-disable">
<title
>Aktivera/stänga av alarmbevakning</title>

<sect3>
<title
>Aktivera alarmbevakning</title>

<para
>Först, om &kalarm;s körläge är <quote
>kontinuerligt</quote
> och du har valt <guilabel
>Inaktivera alarm när programmet inte är startat</guilabel
> i inställningsdialogrutan, måste du försäkra dig om att &kalarm; kör för att alarmbevakning ska ske.</para>

<para
>Därefter, om bevakning för närvarande är avstängd, gör något av följande:</para>

<itemizedlist
> <listitem
> <para
>Välj <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Aktivera alarm</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Aktivera alarm</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para
> </listitem
> </itemizedlist>

<para
><application
>Alarmdemonen</application
> startas om det behövs, och alarm bevakas så att de kan visas när det är dags.</para>

<warning
><para
>När <application
>alarmdemonen</application
> startas, påverkar det alla andra program som använder <application
>alarmdemonen</application
>.</para
></warning>

</sect3>

<sect3>
<title
>Stänga av alarmbevakning</title>

<para
>För att stänga av alarmbevakning när den för närvarande är aktiverad, gör något av följande:</para>

<itemizedlist
> <listitem
> <para
>Välj <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Alarm aktiverade</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Alarm aktiverade</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para
> </listitem
> <listitem
> <para
>Om &kalarm;s körläge är 'kontinuerligt' och du har valt <guilabel
>Inaktivera alarm när programmet inte är startat</guilabel
> i inställningsdialogrutan, avsluta &kalarm;.</para
> </listitem
> </itemizedlist>

<para
><application
>Alarmdemonen</application
> slutar bevaka &kalarm;s alarm. &kalarm; kommer inte att visa några ytterligare alarm till alarm aktiveras igen.</para>

<note
><para
><application
>Alarmdemonen</application
> stoppas inte av den här åtgärden: den slutar bara helt enkelt bevaka &kalarm;s alarm. Så detta får ingen effekt på funktionen för alla andra program som använder <application
>alarmdemonen</application
>.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Återställa alarmdemonen</title>

<para
>För att återställa <application
>alarmdemonen</application
>, välj <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Återställ demon</guimenuitem
> </menuchoice
>.</para>

<para
>Se avsnittet <link linkend="daemon-reset"
>Alarmdemonen</link
> för en beskrivning om hur <application
>alarmdemonen</application
> kan återställas.</para>

</sect2>

<sect2 id="preferences">
<title
>Anpassa förvalda alternativ</title>

<para
>För att ställa in förvalda alternativ för &kalarm;, välj <menuchoice
><guimenu
>Inställningar</guimenu
><guimenuitem
>Anpassa &kalarm;...</guimenuitem
> </menuchoice
>. Det här visar inställningsdialogrutan. Här kan du:</para>

<itemizedlist
> <listitem
><para
>Anger &kalarm;s körläge. Du kan välja att antingen köra det kontinuerligt i &kde;:s systembricka, eller att bara göra det på begäran. Det här valet påverkar inte visning av alarm när de inträffar, eftersom det är <application
>alarmdemonen</application
> och inte &kalarm; som bevakar alarmlistan. Att köra &kalarm; i systembrickan gör programmet mer lättillgängligt och visar en indikation att alarm är aktiverade, men att köra ett program hela tiden använder en del systemresurser. Så om systemprestanda är viktigt, kan alternativet <quote
>på begäran</quote
> vara att föredra.</para
> <para
>När läget <quote
>på begäran</quote
> används, kan ikonen i systembrickan fortfarande visas. Den huvudsakliga skillnaden i användning mellan de två lägena är effekten då ikonen i systembrickan stängs. Vid läget <quote
>på begäran</quote
>, har detta inte någon effekt på &kalarm;s fönster, medan vid <quote
>kontinuerligt</quote
> läge, stängs också alla &kalarm;s huvudfönster.</para
> </listitem
> <listitem
><para
>Om du anger att &kalarm; ska köra i <quote
>kontinuerligt</quote
> läge, kan du stänga av alla alarm som ska visas medan &kalarm; inte kör.</para
> </listitem
> <listitem
><para
>Ange att &kalarm;s ikon i systembrickan ska visas vid inloggning till en &kde; session.</para
> </listitem
> <listitem
><para
>Ställer in frekvensen som &kalarm;s ikon i systembrickan uppdateras för att visa om alarm bevakas för närvarande. Det här omfattar en kontroll av att <application
>alarmdemonen</application
> kör.</para
> </listitem
> <listitem
><para
>Välja förvalt teckensnitt och bakgrundsfärg att använda för visning av alarmmeddelanden.</para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
>Anpassa alarmdemonen</title>

<para
>För att ställa in alternativ för <application
>alarmdemonen</application
>, välj <menuchoice
><guimenu
>Inställningar</guimenu
><guimenuitem
>Anpassa alarmdemon...</guimenuitem
> </menuchoice
>. Det här visar alarmdemonens inställningsdialogruta.</para>

</sect2>

<sect2>
<title
>Avsluta programmet</title>

<para
>Avsluta &kalarm; genom att stänga alla fönster och ikonen i systembrickan, eller vid 'kontinuerligt' körläge, genom att stänga alla meddelandefönster och välja <menuchoice
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn för ikonen i systembrickan.</para>

<para
><menuchoice
><guimenu
>Arkiv</guimenu
><guimenuitem
>Avsluta</guimenuitem
> </menuchoice
> stänger bara själva fönstret. Effekten för menyalternativet <menuchoice
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn för systembrickans ikon beror på körläget: för läget <quote
>på begäran</quote
> göms systembrickans ikon, medan i <quote
>kontinuerligt</quote
> läge avslutas programmet.</para>

<tip
><para
>Att avsluta &kalarm; har ingen effekt på alarmdemonen,  som om den redan är aktiv, fortsätter att bevaka schemalagda alarm och begära att de visas när de inträffar (om du inte har valt <guilabel
>Inaktivera alarm när programmet inte är startat</guilabel
> i inställningsdialogrutan).</para
></tip>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Ikonen i systembrickan</title>

<para
>&kalarm; kan köras som en ikon i &kde;:s systembricka. Den här ikonen möjliggör aktivering av &kalarm; med ett klick, och ger både styrning och statusindikering av alarmbevakning. En normal &kalarm;-ikon anger att alarm bevakas, medan ett rött kors genom ikonen anger att alarm inte bevakas.</para>

<para
><mousebutton
>Vänster</mousebutton
>klicka på ikonen i systembrickan för att välja att visa eller gömma &kalarm;s huvudfönster.</para>

<para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan för att visa den sammanhangsberoende menyn.</para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Aktivera alarm</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Aktiverar bevakning av alarm.</action
></para
> <para
>Se <link linkend="enable-disable"
>Aktivera/stänga av alarmbevakning</link
> för detaljer.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Alarm aktiverade</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Stänger av bevakning av alarm.</action
></para
> <para
>Se <link linkend="enable-disable"
>Aktivera/stänga av alarmbevakning</link
> för detaljer.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Anpassa &kalarm;...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Visar &kalarm;s inställningsdialogruta.</action
></para
> <para
>Inställningsdialogrutan beskrivs under <link linkend="preferences"
>Anpassa förvalda alternativ</link
>. Den innehåller också alternativ som har att göra med  &kalarm;s ikon i systembrickan.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Anpassa alarmdemonen...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Visar alarmdemonens inställningsdialogruta.</action
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Återställ/minimera</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Återställer eller minimerar &kalarm;s huvudfönster.</action
></para
> <para
>Det här alternativet är bara tillgängligt i 'kontinuerligt' körläge. (Se <link linkend="preferences"
>Anpassa förvalda alternativ</link
> för en beskrivning av körlägen.)</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Stänger &kalarm;s ikon i systembrickan.</action
></para
> <para
>Bara i <quote
>kontinuerligt</quote
> körläge, stängs också alla &kalarm;s huvudfönster. Det har ingen effekt på bevakningen av alarm av alarmdemonen (om du inte har valt <guilabel
>Inaktivera alarm när programmet inte är startat</guilabel
> i inställningsdialogrutan).</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="cmdline-operation">
<title
>Kommandoradsväljare</title>

<para
>När kommandoradsväljare anges, visar inte &kalarm; listan med schemalagda alarm som beskrivs ovan för <link linkend="graphmode"
>grafiskt läge</link
>. Speciella kommandoradsväljare för &kalarm; kan användas för att utföra följande operationer:</para>

<itemizedlist
> <listitem
><para
>schemalägg ett nytt alarmmeddelande</para
> </listitem
> <listitem
><para
>styr alarmdemonen</para
> </listitem
> <listitem
><para
>styr &kalarm;s visningsläge</para
> </listitem
> <listitem
><para
>skaffa hjälp</para
> </listitem
> </itemizedlist>

<para
>Ytterligare kommandoradsväljare är tillgängliga främst för att låta andra program arbeta ihop med &kalarm;. De beskrivs i kapitlet <link linkend="cmdline-interface"
>Utvecklingsguide för &kalarm;</link
>.</para>

<para
>Kommandoraden får bara innehålla väljare för en &kalarm; operation. Om du vill utföra flera operationer, måste du anropa &kalarm; flera gånger, med en enda uppsättning väljare varje gång.</para>

<sect2 id="cmdline-schedule">
<title
>Schemalägg ett nytt alarmmeddelande</title>

<para
>Följande väljare används för att schemalägga ett alarmmeddelande att visas av &kalarm;:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Alternativ</entry
> <entry
>Beskrivning</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>-b</option
>, <option
>--beep</option
></entry
> <entry
>Avge ett hörbart ljud när meddelandet visas.</entry
> </row
> <row
> <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>färg</replaceable
></option
></entry
> <entry
>Visa meddelandet med bakgrundsfärgen enligt det angivna &Qt;-färgnamnet eller hexadecimala koden 0xRRGGBB.</entry
> </row
> <row
> <entry
><option
>-f</option
>, <option
>--file <replaceable
>webbadress</replaceable
></option
></entry
> <entry
>Ange namnet eller webbadressen för en textfil vars innehåll ska användas som alarmmeddelande. Om den här väljaren anges får inte <replaceable
>meddelande</replaceable
> finnas.</entry
> </row
> <row
> <entry
><option
>-i</option
>, <option
>--interval <replaceable
>minuter</replaceable
></option
></entry
> <entry
>Ange intervallet mellan upprepning av alarmet till det angivna antalet minuter. Nödvändigt om <option
>--repeat</option
> anges.</entry
> </row
> <row
> <entry
><option
>-l</option
>, <option
>--late-cancel</option
></entry
> <entry
>Avbryt meddelandet om det inte kan visas vid den riktiga tiden.</entry
> </row
> <row
> <entry
><option
>-L</option
>, <option
>--login</option
></entry
> <entry
>Visa meddelandet varje gång du loggar in.</entry
> </row
> <row
> <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>minuter</replaceable
></option
></entry
> <entry
>Antal gånger som alarmet ska upprepas, efter det först visats. Nödvändigt om <option
>--interval</option
> anges.</entry
> </row
> <row
> <entry
><option
>-t</option
>, <option
>--time <replaceable
>tid</replaceable
></option
></entry
> <entry
>Visa meddelandet vid 'tiden' [[[åååå-]mm-]dd-]tt:mm (normalvärdet är omedelbart).</entry
> </row
> <row
> <entry
><replaceable
>meddelande</replaceable
></entry
> <entry
>Meddelandetext som visas.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Antingen en meddelandetext eller <option
>--file</option
> måste anges. Annars är alla väljare valfria, utom där annat anges.</para>

<para
>Två olika exempel som visar ett meddelande med flera rader, med röd bakgrund vid klockan 20:00 den 27:de innevarande månad, är:</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Kom ihåg att \nSTOPPA"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Kom ihåg att\nSTOPPA"</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Övriga alternativ</title>

<para
>Följande alternativ används för att återställa eller stanna alarmdemonen, eller styra &kalarm;s visningsläge.</para>

<para
>Se avsnittet <link linkend="daemon-reset"
>Alarmdemonen</link
> för en beskrivning om hur alarmdemonen återställs och stoppas.</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Alternativ</entry
> <entry
>Beskrivning</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--reset</option
></entry
> <entry
>Att återställa alarmdemonen.</entry
> </row
> <row
> <entry
><option
>--stop</option
></entry
> <entry
>Stoppar alarmdemonen.</entry
> </row
> <row
> <entry
><option
>--tray</option
></entry
> <entry
>Visar &kalarm; som en ikon i &kde;:s systembricka.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Till exempel, för att återställa alarmdemonen.</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--reset</option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Hjälpalternativ</title>

<para
>Följande hjälpalternativ är gemensamma för alla &kde;-program:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Alternativ</entry
> <entry
>Beskrivning</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--help</option
></entry
> <entry
>Visar en kortfattad hjälptext för väljare.</entry
> </row
> <row
> <entry
><option
>--help-qt</option
></entry
> <entry
>Visar talrika generella &Qt;-specifika väljare.</entry
> </row
> <row
> <entry
><option
>--help-kde</option
></entry
> <entry
>Visar talrika generella &kde;-specifika väljare.</entry
> </row
> <row
> <entry
><option
>--help-all</option
></entry
> <entry
>Visar alla alternativ.</entry
> </row
> <row
> <entry
><option
>--author</option
></entry
> <entry
>Visar namn och e-postadresser för &kalarm;s upphovsmän.</entry
> </row
> <row
> <entry
><option
>-v</option
>, <option
>--version</option
></entry
> <entry
>Visar de versioner av &Qt;-biblioteket, &kde; och &kalarm; som kör.</entry
> </row
> <row
> <entry
><option
>--license</option
></entry
> <entry
>Visar licensinformation.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

</sect2>
</sect1>

<sect1 id="daemon">
<title
>Alarmdemon</title>

<para
>Alarmdemonen, &kalarmd;, bevakar &kalarm;s kalenderfil för alarm som inträffar. När den avgör att ett alarm har gått ut, talar den om för &kalarm; att visa det, eller att avbryta det om det är sent och sen visning inte valts för alarmmeddelandet.</para>

<para
>Med &kde;3, kan alarmdemonen kan också användas av andra program, inklusive Korganizer.</para>

<para
>Alarmdemonen kör i bakgrunden, utan användargränssnitt. Dess inställningsdialogruta kan kommas åt antingen via &kde;:s inställningscentral, eller via &kalarm;s menyalternativ <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa alarmdemon...</guimenuitem
> </menuchoice
>.</para>

<sect2>
<title
>Starta, återställa och stoppa alarmdemonen</title>

<para
>Alarmdemonen startas normalt vid inloggning till &kde;-sessionen (om du inte använde inställningsdialogrutan för att stänga av automatisk start), och kör hela tiden till utloggning. Om den av någon anledning inte kör, sker ingen bevakning av alarm och  &kalarm; visar inga alarm.</para>

<sect3>
<title
>Att starta alarmdemonen</title>
<para
>För att starta alarmdemonen kan du antingen köra &kalarm; med det förvalda grafiska läget (dvs. utan några kommandoradsväljare), aktivera alarm i menyn för &kalarm;s ikon i systembrickan, återställa demonen som beskrivs <link linkend="daemon-reset"
>nedan</link
>, eller köra alarmdemonen direkt från kommandoraden:</para>

<screen width="40">
<prompt
>%</prompt
> <userinput
><command
>kalarmd</command
></userinput>
</screen>

</sect3>

<sect3 id="daemon-reset">
<title
>Återställa alarmdemonen</title>

<para
>Det är också möjligt att återställa alarmdemonen utan att stoppa den. En återställning gör att alarmdemonen läser om listan på schemalagda meddelanden från kalenderfilen och initierar om data relaterad till &kalarm;.</para>

<para
>Varför skulle du vilja återställa alarmdemonen? Det är inte en särskilt trolig händelse, men om &kalarm; av någon anledning inte kunde köra när alarmdemonen bad det om att visa ett meddelande, så visas aldrig det meddelandet om inte alarmdemonen antingen återställs eller startas om. Att återställa är att föredra framför att stoppa alarmdemonen och starta om den, eftersom att återställa demonen inte påverkar något annat program som använder alarmdemonen.</para>

<tip
><para
>Att återställa startar alarmdemonen om den inte kör för närvarande.</para
></tip>

<para
>För att återställa alarmdemonen, använd antingen menykommandot <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Återställ demon</guimenuitem
></menuchoice
>, eller skriv in följande kommando:</para>

<screen width="40">
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--reset</option
></userinput>
</screen>

</sect3>

<sect3>
<title
>Att stoppa alarmdemonen</title>

<para
>Att stoppa alarmdemonen förhindrar all fortsatt bevakning av schemalagda alarmmeddelanden till demonen startas om.</para>

<warning
><para
>Att stoppa den påverkar funktionen för alla andra program som också använder alarmdemonen. Fundera på att återställa demonen istället.</para
></warning>

<para
>För att stoppa alarmdemonen, skriv in följande kommando:</para>

<screen width="40">
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--stop</option
></userinput>
</screen>
</sect3>

</sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>Utvecklingsguide för &kalarm;</title>

<para
>&kalarm; tillhandahåller ett gränssnitt som låter andra program begära följande funktioner:</para>

<itemizedlist
> <listitem
><para
>schemalägg ett nytt alarmmeddelande</para
></listitem
> <listitem
><para
>visa eller avbryt ett redan schemalagt alarmmeddelande</para
></listitem
> <listitem
><para
>avbryt ett redan schemalagt alarmmeddelande</para
></listitem
> <listitem
><para
>visa ett redan schemalagt alarmmeddelande</para
></listitem
> </itemizedlist>

<para
>Var och en av de ovannämnda funktionerna implementeras både som ett &DCOP;-anrop och via kommandoraden. &DCOP;-anrop är att föredra om &kalarm; redan kör.</para>

<sect1 id="dcop-interface">
<title
>&DCOP;-gränssnitt</title>

<refentry id="cancelMessage">
<refmeta>
<refentrytitle
>cancelMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelMessage</refname>
<refpurpose
>cancel an already scheduled alarm message.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void cancelMessage(const QString&amp; <replaceable
>kalenderfil</replaceable
>, const QString&amp; <replaceable
>händelse-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist
> <varlistentry
> <term
><parameter
>kalenderfil</parameter
></term
> <listitem
> <para
>Anger webbadressen för kalenderfilen som innehåller händelsen som ska avbrytas.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>händelse-ID</parameter
></term
> <listitem
> <para
>Anger ett unikt ID för händelsen som ska avbrytas, som är lagrad i <replaceable
>kalenderfil</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>cancelMessage()</function
> är ett &DCOP;-anrop för att avbryta det angivna alarmmeddelandet. &kalarm; tar bort alarmmeddelandet från kalenderfilen utan att visa det.</para>

<note
><para
>Väljaren <replaceable
>kalenderfil</replaceable
> används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.</para
></note>

</refsect1>
</refentry>

<refentry id="displayMessage">
<refmeta>
<refentrytitle
>displayMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>displayMessage</refname>
<refpurpose
>display an already scheduled alarm message.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void displayMessage(const QString&amp; <replaceable
>kalenderfil</replaceable
>, const QString&amp; <replaceable
>händelse-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist
> <varlistentry
> <term
><parameter
>kalenderfil</parameter
></term
> <listitem
> <para
>Anger webbadressen för kalenderfilen som innehåller händelsen som ska visas.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>händelse-ID</parameter
></term
> <listitem
> <para
>Anger ett unikt ID för händelsen som ska visas, som är lagrad i <replaceable
>kalenderfil</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>displayMessage()</function
> är ett &DCOP;-anrop för att visa det angivna alarmmeddelandet. &kalarm; hämtar alarmmeddelandet från kalenderfilen och visar det.</para>

<para
>Om inga upprepningar av alarmet är schemalagda, tar &kalarm; därefter bort alarmmeddelandet från kalenderfilen.</para>

<note
><para
>Väljaren <replaceable
>kalenderfil</replaceable
> används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.</para
></note>

</refsect1>
</refentry>

<refentry id="handleEvent">
<refmeta>
<refentrytitle
>handleEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>handleEvent</refname>
<refpurpose
>display or cancel an already scheduled alarm message.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void handleEvent(const QString&amp; <replaceable
>kalenderfil</replaceable
>, const QString&amp; <replaceable
>händelse-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist
> <varlistentry
> <term
><parameter
>kalenderfil</parameter
></term
> <listitem
> <para
>Anger webbadressen för kalenderfilen som innehåller händelsen som ska visas eller avbrytas.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>händelse-ID</parameter
></term
> <listitem
> <para
>Anger ett unikt ID för händelsen som ska visas eller avbrytas, som är lagrad i <replaceable
>kalenderfil</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>handleEvent()</function
> är ett &DCOP;-anrop för att visa eller avbryta det angivna alarmmeddelandet. &kalarm; hämtar alarmmeddelandet från kalenderfilen och avgör sedan vilken åtgärd som ska utföras. Om flaggan för att avbryta sena alarm är satt och alarmet är sent, dvs. den schemalagda tiden för att visa det var mer än en minut tidigare, visar inte &kalarm; meddelandet, annars visar &kalarm; alarmmeddelandet. Om inga upprepningar av alarmet fortfarande är schemalagda, tar &kalarm; sedan bort alarmmeddelandet från kalenderfilen.</para>

<note
><para
>Väljaren <replaceable
>kalenderfil</replaceable
> används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.</para
></note>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>schedule a new alarm message.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>meddelande</replaceable
>, const QDateTime* <replaceable
>datum_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flaggor</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>meddelande</replaceable
>, const QDateTime* <replaceable
>datum_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flaggor</replaceable
>, int <replaceable
>antal_upprepningar</replaceable
>, int <replaceable
>intervall</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist
> <varlistentry
> <term
><parameter
>meddelande</parameter
></term
> <listitem
> <para
>Anger texten för meddelandet som ska schemaläggas.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>datum_tid</parameter
></term
> <listitem
> <para
>Anger det schemalagda datumet och tiden då meddelandet ska visas.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Anger bakgrundsfärgen för att visa meddelandet.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flaggor</parameter
></term
> <listitem
> <para
>Anger logiskt eller av de önskade flaggorna för alarmmeddelandet. Flaggbitarna är definierade i <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>antal_upprepningar</parameter
></term
> <listitem
> <para
>Anger antalet gånger som alarmmeddelandet ska upprepas, efter det visats för första gången.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>intervall</parameter
></term
> <listitem
> <para
>Anger intervallet i minuter mellan upprepningar av alarmmeddelandet.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beskrivning</title>
<para
><function
>scheduleMessage()</function
> är ett &DCOP;-anrop för att schemalägga det angivna alarmmeddelandet för visning vid det angivna datumet och tiden. Det har två former: en för alarm som inte upprepas, och en annan för alarm som upprepas.</para>

<para
>Om den schemalagda tiden (inklusive eventuella upprepningar) redan har gått ut, visar  &kalarm; omedelbart meddelandet, eller ignorerar begäran om flaggan LATE_CANCEL är satt. Om den schemalagda tiden är i framtiden, lägger &kalarm; till alarmmeddelandet i kalenderfilen för att visas senare.</para>

<para
>Använd en kodsekvens som liknar den följande för att ange data för parametrarna i &DCOP;-anropet till <function
>scheduleMessage()</function
> för ett alarm som inte upprepas:</para>

<screen>
QString message;
QDateTime dateTime;
QColor bgColour;
Q_UINT32 flags;
. . .
QByteArray data;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt;  message;
arg.writeRawBytes((char*)&amp;dateTime, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColour, sizeof(QColor));
arg &lt;&lt; flags;
</screen>

<para
>Använd en kodsekvens som liknar den följande för att ange data för parametrarna i &DCOP;-anropet till <function
>scheduleMessage()</function
> för ett alarm som upprepas:</para>

<screen>
QString message;
QDateTime dateTime;
QColor bgColour;
Q_UINT32 flags;
Q_INT32 repeatCount, repeatInterval;
. . .
QByteArray data;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt; message;
arg.writeRawBytes((char*)&amp;dateTime, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColour, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; repeatCount &lt;&lt; repeatInterval;
</screen>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>schedule a new alarm message which displays the contents
of a text file.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>webbadress</replaceable
>, const QDateTime* <replaceable
>datum_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flaggor</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>webbadress</replaceable
>, const QDateTime* <replaceable
>datum_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flaggor</replaceable
>, int <replaceable
>antal_upprepningar</replaceable
>, int <replaceable
>intervall</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist
> <varlistentry
> <term
><parameter
>webbadress</parameter
></term
> <listitem
> <para
>Anger namn eller webbadressen för textfilen vars innehåll ska visas i meddelandet som schemaläggs.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>datum_tid</parameter
></term
> <listitem
> <para
>Anger det schemalagda datumet och tiden då meddelandet ska visas.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Anger bakgrundsfärgen för att visa meddelandet.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flaggor</parameter
></term
> <listitem
> <para
>Anger logiskt eller av de önskade flaggorna för alarmmeddelandet. Flaggbitarna är definierade i <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>antal_upprepningar</parameter
></term
> <listitem
> <para
>Anger antalet gånger som alarmmeddelandet ska upprepas, efter det visats för första gången.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>intervall</parameter
></term
> <listitem
> <para
>Anger intervallet i minuter mellan upprepningar av alarmmeddelandet.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>
<para
><function
>scheduleFile()</function
> är ett &DCOP;-anrop för att schemalägga en angiven textfil för visning vid det angivna datumet och tiden. Utom att ange ett filnamn eller webbadress, är användningen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivningen av den funktionen för ytterligare detaljer.</para>
</refsect1>
</refentry>
</sect1>

<sect1 id="cmdline-interface">
<title
>Kommandoradsgränssnitt</title>

<para
>Kommandoradsväljare tillhandahålls för att göra det möjligt för andra program (som alarmdemonen) att starta &kalarm; om det inte redan kör, för att visa eller avbryta schemalagda meddelanden, eller schemalägga nya meddelanden. Orsaken att kommandoradsväljare används för detta syfte är att om &kalarm; startades utan kommandoradsväljare och &DCOP;-anrop sedan skickades, skulle det starta i det förvalda grafiska läget, vilket helt klart inte är önskvärt för en begäran mellan program.</para>

<note
><para
>Program bör först kontrollera om &kalarm; redan kör. Om detta är fallet, bör de istället använda &DCOP;-anrop för att begära de här åtgärderna.</para
></note>

<para
>Kommandoradsväljarna för att schemalägga ett nytt alarmmeddelande beskrivs i kapitlet <link linkend="cmdline-operation"
>Att använda &kalarm;</link
>. Alternativen för att visa och avbryta schemalagda meddelanden är följande:</para>

<note
><para
>Normala användare kan också, om de så önskar, använda de här kommandoradsväljarna (med antagandet att de kan ange den nödvändiga väljarinformationen).</para
></note>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Alternativ</entry
> <entry
>Beskrivning</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--calendarURL <replaceable
>webbadress</replaceable
></option
></entry
> <entry
>Använd kalenderfilen med angiven webbadress. Det här alternativet används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.</entry
> </row
> <row
> <entry
><option
>--cancelEvent <replaceable
>händelse-ID</replaceable
></option
></entry
> <entry
>Avbryt händelsen med med angivet händelse-ID.</entry
> </row
> <row
> <entry
><option
>--displayEvent <replaceable
>händelse-ID</replaceable
></option
></entry
> <entry
>Visa händelsen med med angivet händelse-ID.</entry
> </row
> <row
> <entry
><option
>--handleEvent <replaceable
>händelse-ID</replaceable
></option
></entry
> <entry
>Visa eller avbryt händelsen med angivet händelse-ID. &kalarm; avgör vilken åtgärd som behövs på samma sätt som för <link linkend="handleEvent"
>handleEvent()</link
>  &DCOP;-anropet.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
><option
>--cancelEvent</option
>, <option
>--displayEvent</option
> och <option
>--handleEvent</option
> är ömsesidigt uteslutande. <option
>--calendarURL</option
> är valfri, men kan bara användas med en av de andra tre väljarna.</para>

<para
>Några exempel:</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--displayEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
> <option
>--calendarURL <replaceable
>file:/home/zaphod/hydra.ics</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299.793</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Vanliga frågor</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Vilka konfigurationsfiler använder &kalarm;?</para>
</question>
<answer>
<para
>Filen <filename
>~/.kde/share/config/kalarmrc</filename
> innehåller &kalarm;s inställningar.</para>

<para
>Kalenderfilen som lagrar dina schemalagda alarmmeddelanden heter <filename
>~/.kde/share/apps/kalarm/calendar.ics</filename
>, om inte en annan kalenderfil anges i inställningsfilen.</para>

<note
><para
>Om du byter kalenderfil in inställningsfilen, måste du också redigera alarmdemonens konfigurationsfil <filename
>clients</filename
> för att ta bort referensen till den gamla kalenderfilen. Det här ska göras när alarmdemonen inte kör, för att undvika att din ändring skrivs över.</para
></note>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Vilka konfigurationsfiler använder alarmdemonen?</para>
</question>
<answer>
<para
>Filen <filename
>~/.kde/share/config/kalarmdrc</filename
> innehåller alarmdemonens inställningar.</para>

<para
>Filen <filename
>~/.kde/share/apps/kalarmd/clients</filename
> innehåller värden för klientprogram som tidigare har registrerats hos alarmdemonen, och deras kalenderfiler.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Vad är programnamnen för &kalarm; och alarmdemonen?</para>
</question>
<answer>
<para
>&kalarm;s programnamn är <command
>kalarm</command
> och alarmdemonens programnamn är <command
>kalarmd</command
>. Dessutom, men bara i &kde;2-versionen, finns det ett litet program som heter <application
>kalarmautostart</application
>, vars funktion är att starta &kalarm;s ikon i systembrickan vid inloggning.</para>
</answer>
</qandaentry>

<!-- 
<qandaentry>
<question>
<para
>Why doesn't &kalarm; work since I installed &package; 2.2.x?</para>
</question>
<answer>
<para
>&kalarm; uses a slightly updated version of the &package; 2.2.x
library <filename
>libkcal</filename
>. &package; will work happily with
&kalarm;'s version, but the reverse is not true. To cure this problem,
simply reinstall &kalarm;.</para>
</answer>
</qandaentry>
-->

</qandaset>
</chapter>


<chapter id="credits">

<title
>Tack till och licens</title>

<para
> &kalarm; </para>
<para
> Program copyright 2001, 2002 David Jarvie <email
>software@astrojar.org.uk</email
> </para>
<para
> Upphovsmän till alarmdemonen: <itemizedlist
> <listitem
><para
>Preston Brown <email
>pbrown@kde.org</email
></para
> </listitem
> <listitem
><para
>David Jarvie <email
>software@astrojar.org.uk</email
></para
> </listitem
> <listitem
><para
>Cornelius Schumacher <email
>schumacher@kde.org</email
></para
> </listitem
> </itemizedlist
> </para>

<para
> Dokumentation copyright 2001, 2002 David Jarvie <email
>software@astrojar.org.uk</email
> </para>

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@telia.com</email
></para>

<para
>Tack till upphovsmannen för programmet KAlarm för &kde; 1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, som vänligen gick med på att det här &kde;2/&kde;3 programmet fick använda namnet &kalarm;. </para>

&underFDL;               <!-- FDL: do not remove -->

&underGPL;        	 <!-- GPL License -->

</chapter>

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

<sect1 id="getting-kalarm">
<title
>Hur man skaffar &kalarm;</title>

&install.intro.documentation;

<para
>&kalarm; är tillgängligt för &kde;2 och som ett fristående paket för &kde;3 från <ulink url="http://www.astrojar.org.uk/linux"
>http://www.astrojar.org.uk/linux</ulink
> </para>

</sect1>

<sect1 id="requirements">
<title
>Krav</title>

<para
> &kalarm; kräver biblioteken <filename
>libkcal</filename
>, <filename
>libical</filename
> och <filename
>libicalss</filename
> från &kde;:s paket &package;.</para>

<itemizedlist
> <listitem
> <para
>Om du installerar en version av &package; som innehåller &kalarm;, så hanteras krav för &kalarm; automatiskt.</para
> </listitem
> <listitem
> <para
>För den fristående versionen av &kalarm;, måste du köra &kde; 2.0 eller senare. &kalarm; levereras i olika fristående versioner som innehåller den lämpliga uppsättningen med &package; bibliotek beroende på vilken version, om någon, av &package; som du har installerat. De fristående versionerna av &kalarm; 0.5 innehåller kopior av biblioteken från &package; 2.2.2 (inklusive en något uppdaterad <filename
>libkcal</filename
>).</para
> </listitem
> </itemizedlist>

<para
>&kalarm; använder ungefär 12 Mibyte och alarmdemonen använder ungefär 2,5 Mibyte minne för att köra, men detta kan variera beroende på plattform och inställningar.</para>

<para
>Du hittar en lista på ändringar i filen <filename
>ChangeLog</filename
>, eller på <ulink url="http://www.astrojar.org.uk/linux/kalarm.html"
>http://www.astrojar.org.uk/linux/kalarm.html</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Kompilering och installation</title>

<para
>Om du inte kan hitta ett lämpligt förkompilerat binärpaket, måste du kompilera &kalarm; själv från källkodsfiler. Hämta källkodspaketet <filename
>kdepim-x.x.tar.gz</filename
> eller <filename
>kalarm-x.x.tar.gz</filename
> (eller liknande), beroende på om du vill installera &package; eller bara &kalarm;. Packa upp det i en ny katalog med kommandot <userinput
><command
>tar</command
> <option
>xvfz <replaceable
>paket.tar.gz</replaceable
></option
></userinput
> och byt till katalogen som har skapats.</para>

&install.compile.documentation;

<note
><para
>Om du har mer än en version av &kde; installerad (t.ex &kde;1 och &kde;2), kan &kalarm; möjligen installeras i fel &kde;-katalog. Om det behövs kan du ange &kde;-katalogen som en parameter till <userinput
><command
>./configure</command
></userinput
> . Om du till exempel har installerat &kde; i <filename
>/opt/kde2</filename
>:</para
> <para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para
> </note>

<important
><para
>Om du installerar &kalarm; som ett fristående paket tillsammans med &package; 2.2.x, måste du installera &package; först och &kalarm; sist för att försäkra dig om att de riktiga versionerna av bibliotek installeras.</para
></important>
</sect1>

<sect1 id="configuration">
<title
>Anpassning</title>

<para
>Ingen särskild anpassning krävs för att ställa in &kalarm; för att köra på &kde;-skrivbordet. Så fort du har kört &kalarm; första gången, startas alarmdemonen varje gång du loggar in, för att bevaka schemalagda alarm.</para>

<para
>För att köra &kalarm; på ett annat skrivbord än &kde;, är det viktigaste kravet att försäkra sig om att alarmdemonen körs automatiskt så fort du loggar in. Mer detaljerade instruktioner finns i filen <filename
>INSTALL</filename
> som distribueras med &kalarm;.</para>

</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:
-->

