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

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

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &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
>Frank</firstname
><surname
>Schütte</surname
><affiliation
><address
><email
>f.schuette@t-online.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit>

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

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2003-01-13</date>
<releaseinfo
>0.09.01</releaseinfo>

<abstract>
<para
></para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>Alarm</keyword>
<keyword
>Erinnerung</keyword>
</keywordset>

</bookinfo>


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

<para
></para>

<para
></para>

<para
></para>

<para
>Alarme können auch über eine Befehlszeile oder von anderen Programmen via &DCOP; eingegeben werden.</para>

<para
>Wenn eine Alarmzeit erreicht ist, wird die Alarmnachricht auf jeder &kde;-Arbeitsfläche angezeigt, damit sie nicht beim Umschalten zwischen den Arbeitsflächen übersehen werden kann. Die festgelegt Alarmzeit wird mit angezeigt. Das ist nützlich, falls die Nachricht zu spät angezeigt wird oder man selbst einige Zeit nicht am Rechner gewesen ist. Standardmäßig hat die Nachricht eine Option zum Verschieben der Anzeige auf einen späteren Zeitpunkt. Im Folgenden wird ein Beispiel einer Nachricht gezeigt:</para>

<screenshot
> <screeninfo
>Bilschirmphoto eines &kalarm; Nachrichtenfensters</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="alarmmessage.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Alarm-Nachricht</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
></para>

<para
>&kalarm; kann in zwei verschiedenen Modi betrieben werden: <quote
>ständig</quote
> (der Standardwert) in der &kde;-Kontrollleiste oder <quote
>auf Anforderung</quote
> von Fall zu Fall gestartet (mit der Option, ein unabhängiges Symbol in der Kontrollleiste anzuzeigen).</para>

<para
>Dieses Handbuch bezieht sich mehrfach auf den <application
>Alarmdämon</application
>. Dieses Programm ist im Hintergrund aktiv, überwacht festgelegt Alarmzeiten und veranlasst &kalarm;, zum entsprechenden Zeitpunkt Nachrichten anzuzeigen.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Verwendung von &kalarm;</title>

<sect1 id="graphmode">
<title
>Graphischer Modus</title>

<para
></para>

<para
>Falls beim Start von &kalarm; im graphischen Modus der <application
>Alarmdämon</application
> nicht aktiv ist, wird er durch &kalarm; gestartet.</para>

<tip
><para
></para
></tip>

<sect2>
<title
></title>

<para
></para>

<screenshot
> <screeninfo
>Bilschirmphoto des &kalarm; Hauptfensters</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Hauptfenster</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
></para>

<para
>Die Liste der Alarme kann durch Klicken auf die entsprechende Titelleiste nach der gewünschten Spalte geordnet werden. Um die Sortierung umzukehren, klickt man ein zweites Mal auf der Spaltentitel.</para>

<para
></para>

</sect2>

<sect2>
<title
>Einen neuen Alarm hinzufügen</title>

<para
>Um eine neue Alarmnachricht hinzuzufügen, wählt man <menuchoice
> <guimenu
>Aktionen</guimenu
><guimenuitem
>Neu</guimenuitem
></menuchoice
> aus dem Menü. Dadurch wird das Bearbeitungsfenster angezeigt:</para>

<para
></para>

<para
></para>

</sect2>

<sect2 id="edit-alarm">
<title
>Einen Alarm ändern</title>

<para
></para>

<itemizedlist
> <listitem
> <para
>Man klickt doppelt auf den Eintrag in der Alarmliste.</para
> </listitem
> <listitem
> <para
>Man wählt den Alarm durch Klicken in die Alarmliste aus. Dann wählt man <menuchoice
><guimenu
>Aktionen</guimenu
> <guimenuitem
>Ändern...</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Man klickt mit der <mousebutton
>rechten</mousebutton
> Maustaste auf den gewünschten Eintrag und wählt im Kontextmenü <menuchoice
><guimenuitem
>Ändern</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

<para
>Es wird das Nachrichtenbearbeitungsfenster geöffnet.</para>

<screenshot
> <screeninfo
>Bildschirmphoto des Alarmbearbeitungsdialogs</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="editwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Alarmbearbeitungsdialog</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
></para>

<itemizedlist
> <listitem
> <para
></para
> <itemizedlist
> <listitem
> <para
>Das Ankreuzfeld <guilabel
>Bei Bestätigungen nachfragen</guilabel
> steuert, ob man beim Schließen einer Alarmnachricht um Bestätigung gebeten wird. Das dient als Sicherung gegen versehentlich geschlossene Alarmnachrichten.</para
> </listitem
> <listitem
> <para
>Wählt man das Ankreuzfeld <guilabel
>Klänge</guilabel
>, so wird ein akustisches Signal zusammen mit der Alarmnachricht ertönen. Standardmäßig handelt es sich um einen Piepton, es kann aber auch eine Audiodatei zur Wiedergabe ausgewählt werden. Um zu einem Piepton zurückzukehren, muss man erneut auf den Knopf klicken. Um die aktuellen Klangeinstellungen zu sehen, muss man lediglich den Mauszeiger auf den Knopf bewegen, bis ein Kurzinfo erscheint.</para
> </listitem
> <listitem
> <para
></para
> </listitem
> <listitem
> <para
>Hier kann man die Hintergrundfarbe des Nachrichtenfensters einstellen.</para
> </listitem
> </itemizedlist
> </listitem
> <listitem
> <para
></para
> </listitem
> <listitem
> <para
></para
> </listitem
> <listitem
> <para
></para
> <itemizedlist
> <listitem
> <para
></para
> </listitem
> </itemizedlist
> </listitem
> </itemizedlist>


<para
>Falls es sich beim Alarm um einen wiederkehrenden Alarm handelt, der bei seinem letzten Auftreten verschoben wurde, zeigt das Listenfeld <guilabel
>Verschobene Termin-Erinnerungen</guilabel
> die verschobene Alarmzeit an. Mit Hilfe von <guibutton
>Ändern...</guibutton
> kann man die verschobene Zeit ändern oder die Verschiebung aufheben.</para>

<para
>Im Listenfeld <guilabel
>Zeit</guilabel
> kann man Verschiedenes auswählen:</para>

<itemizedlist
> <listitem
> <para
><guilabel
>Zeitpunkt</guilabel
>, um Datum und Zeit einzutragen, zu der der Alarm ausgelöst werden soll. Falls man lediglich ein Datum festlegen will, sollte man noch das Ankreuzfeld <guilabel
>Keine Zeit festgelegt</guilabel
> markieren. Der Alarm wird dann bei der ersten Gelegenheit nach dem eingestellten Tagesbeginn ausgelöst. (Die Einrichtung des Tagesbeginns wird beschrieben unter <link linkend="preferences"
>Einrichtung der Standardoptionen</link
>.)</para
> </listitem
> <listitem
> <para
><guilabel
>Zeit ab jetzt</guilabel
>, um einzutragen nach welchem Zeitintervall vom Augenblick (in Stunden und Minuten) der Alarm ausgelöst werden soll.</para
> </listitem
> </itemizedlist>

<para
>Ob und wie der Alarm wiederholgt werden soll, wird im Abschnitt <guilabel
>Wiederholung</guilabel
> festgelegt.</para>

<itemizedlist
> <listitem
><para
>Um den Alarm nur einmal auszulösen, wählt man <guilabel
>Keine Wiederholung</guilabel
>.</para
></listitem
> <listitem
><para
>Man wählt <guilabel
>Wiederholung beim Anmelden</guilabel
>, um den Alarm bei jeder Anmeldung bis zum festgelegten Zeitpunkt zu wiederholen. (Ein solcher Alarm wird auch jedesmal dann ausgelöst, wenn man Alarme aktivert oder den <application
>Alarmdämon</application
> neustartet.)</para
></listitem
> <listitem
><para
>Man wählt <guilabel
>Wiederholen</guilabel
>, um den Alarm in regelmäßigen Intervallen zu wiederholen. Man muss die Wiederholungsparameter auf der Karteikarte <guilabel
>Wiederholen</guilabel
> festlegen.</para
> <para
>Im Abschnitt <guilabel
>Wiederholungsregeln</guilabel
> kann man die Wiederholungszeit  festlegen, indem man eine der Zeitintervalltypen auswählt und in dem Feld <guilabel
>Wiederholung alle:</guilabel
> angibt, wie viele der gewählten Zeitperioden zwischen dem Auftreten des Alarms verstreichen sollen. Um zum Beispiel einen Alarm alle 14 Tage zu haben, kann man entweder <guilabel
>Täglich</guilabel
> auswählen und 14 eintragen oder <guilabel
>Wöchentlich</guilabel
> auswählen und 2 eintragen. Abhängig von der gewählten Zeitperiode gibt es weitere Optionen:</para
> <itemizedlist
> <listitem
> <para
>Bei einer wöchentlichen Wiederholung kann man einstellen, an welchen Tagen der Woche der Alarm auftreten soll.</para
> </listitem
> <listitem
> <para
>Bei einer monatlichen Wiederholung kann man entweder ein festes Datum oder eine Position (&zb; der zweite Dienstag) angeben.</para
> </listitem
> <listitem
> <para
>Bei einer jährlichen Wiederholung kann man entweder ein festes Datum im Jahr oder eine feste Position in einem Monat (&zb; der letzte Samstag im Mai) angeben.</para
> </listitem
> </itemizedlist
> <para
>Im Abschnitt <guilabel
>Ende der Wiederholung</guilabel
> wird die gesamte Zeitspanne, über die eine Wiederholung erfolgen soll, angegeben:</para
> <itemizedlist
> <listitem
><para
>Man wählt <guilabel
>Kein Ende</guilabel
> für nicht endende Wiederholungen.</para
></listitem
> <listitem
><para
>Man wählt <guilabel
>Ende nach:</guilabel
>, um die Gesamtanzahl von Alarmen anzugeben.</para
></listitem
> <listitem
><para
>Man wählt <guilabel
>Ende durch:</guilabel
>, um einen festen Zeitpunkt anzugeben, zu dem die Wiederholung enden soll.</para
></listitem
> </itemizedlist
> </listitem
> </itemizedlist>

<para
>Im Ankreuzfeld <guilabel
>Bei Verspätung abbrechen</guilabel
> kann man festlegen, was mit einer Alarmnachricht passiert, die nicht zum festgesetzten Zeitpunkt angezeigt werden kann. Markiert man dieses Feld, so wird die Alarmnachricht verworfen, falls sie nicht spätestens 1 Minute nach dem festgesetzten Zeitpunkt angezeigt werden kann. Um die Nachricht bei erster Gelegenheit nach dem festgesetzten Zeitpunkt anzeigen zu lassen, muss man dieses Ankreuzfeld deaktivieren. Bei Alarmen, für die nur ein Datum festgelegt wurde, also bei gewählter Option <guilabel
>Keine festgelegte Zeit</guilabel
>, wird der Alarm nur verworfen, falls er nicht innerhalb von 24 Stunden nach Tagesbeginn angezeigt werden kann.</para>

<note
><para
>Eine Alarmnachricht kann nur dann angezeigt werden, wenn man angemeldet ist und sowohl X als auch der <application
>Alarmdämon</application
> aktiv sind.</para
></note>

<para
>Durch Klicken auf <guibutton
>OK</guibutton
> wird der Alarm zur Liste der festgelegten Alarme hinzugefügt.</para>

</sect2>

<sect2>
<title
></title>

<para
>Einen Alarm kann man auf folgende Arten entfernen:</para>

<itemizedlist
> <listitem
> <para
>Man klickt auf den gewünschten Eintrag in der Alarmliste. Dann wählt man im Menü <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Löschen</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Man klickt mit der <mousebutton
>rechten</mousebutton
> Maustaste auf den gewünschten Listeneintrag und wählt im Kontextmenü <menuchoice
><guimenuitem
>Löschen</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
></title>

<para
></para>

<itemizedlist
> <listitem
> <para
></para
> </listitem
> <listitem
> <para
></para
> </listitem
> </itemizedlist>

<para
></para>

</sect2>

<sect2>
<title
>Eine Alarm bestätigen</title>

<para
>Zur Bestätigung von Alarmen siehe unter <link linkend="message-window"
>Alarmnachrichtendialog</link
>.</para>

</sect2>

<sect2 id="birthdays">
<title
></title>

<para
></para>

<itemizedlist
> <listitem
> <para
></para
> <note
><para
></para
></note
> </listitem
> <listitem
> <para
></para
> </listitem
> <listitem
> <para
></para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
>&kalarm; in der Kontrollleiste anzeigen</title>

<para
>Um &kalarm; in der Kontrollleiste anzeigen zu lassen, muss die &kde;-Arbeitsoberfläche aktiv sein. Falls &kalarm; <quote
>ständig</quote
> läuft, wird das Symbol in der Kontrollleiste immer angezeigt. Die folgenden Instruktionen gelten nur für den <quote
>Bei Bedarf</quote
>-Modus. (Siehe auch <link linkend="preferences"
>Standardeinstellungen</link
> für eine Beschreibung der Modi.)</para>

<para
>Um &kalarm; in der &kde;-Kontrollleiste anzeigen zu lassen, wählt man im Menü <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Im Systemtablett anzeigen</guimenuitem
></menuchoice
>.</para>

<para
>&kalarm; kann auf folgende Arten wieder aus der Kontrollleiste entfernt werden:</para>

<itemizedlist
> <listitem
> <para
>Man wählt im Menü <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Aus dem Systemtablett entfernen</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Man klickt mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol in der Kontrollleiste und wählt aus dem Kontextmenü <menuchoice
><guimenuitem
>Beenden</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

<para
>Die Verwendung des Symbols in der Kontrollleiste wird <link linkend="system-tray"
>weiter unten</link
> beschrieben.</para>

</sect2>

<sect2 id="enable-disable">
<title
>Erinnerungsfunktion aktivieren/deaktivieren</title>

<sect3>
<title
>Aktivieren der Erinnerungsfunktion</title>

<para
>Falls &kalarm; sich im <quote
>ständigen</quote
> Modus befindet und man <guilabel
>Alarme nur bei laufendem Programm aktiv</guilabel
> im Einrichtungsdialog ausgewählt hat, muss man sicherstellen, dass &kalarm; läuft, damit die Erinnerungsfunktion aktiv ist.</para>

<para
>Wenn die Erinnerungsfunktion deaktiviert ist, kann man folgendes zur Aktivierung tun:</para>

<itemizedlist
> <listitem
> <para
>Man wählt im Menü <menuchoice
><guimenu
>Aktionen</guimenu
> <guimenuitem
>Erinnerungsfunktion aktiviert</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Man klickt mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol in der Kontrollleiste und wählt im Kontextmenü <menuchoice
><guimenuitem
>Erinnerungsfunktion aktiviert</guimenuitem
></menuchoice
>.</para
> </listitem
> </itemizedlist>

<para
>Dadurch wird der <application
>Alarmdämon</application
> gestartet und von nun an wird die Liste der festgelegten Alarme überwacht.</para>

<warning
><para
>Der Start des <application
>Alarmdämon</application
> hat einen Einfluss auf alle anderen Programme, die den <application
>Alarmdämon</application
> verwenden.</para
></warning>

</sect3>

<sect3>
<title
>Erinnerungsfunktion deaktivieren</title>

<para
>Die Überwachung von Alarmen kann auf verschiedene Arten deaktiviert werden. Dadurch wird &kalarm; bis zur Reaktivierung daran gehindert, weitere Alarmnachrichten anzuzeigen, oder - falls der <application
>Alarmdämon</application
> beim Anmelden gestartet wird - bis zur nächsten Anmeldung.</para>

<para
>Um Alarme zu deaktiviern, ohne den <application
>Alarmdämon</application
> zu stoppen (das Stoppen des <application
>Alarmdämon</application
> hat einen Einfluss auf alle anderen Programme, die den <application
>Alarmdämon</application
> verwenden), kann man eine der folgenden Möglichkeiten nutzen:</para>

<itemizedlist
> <listitem
> <para
>Man wählt im Menü <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Erinnerungsfunktion aktiviert</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Man klickt mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol in der Kontrollleiste und wählt im Kontextmenü <menuchoice
><guimenuitem
>Erinnerungsfunktion aktiviert</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Falls &kalarm;s Modus <quote
>ständig</quote
> ist und man <guilabel
>Alarme nur bei laufendem Programm aktiv</guilabel
> gewählt hat, kann man einfach &kalarm; beenden.</para
> </listitem
> </itemizedlist>

<para
>Deaktivierung von Alarmen durch Stoppen des <application
>Alarmdämons</application
>:</para>

<itemizedlist
> <listitem
> <para
>Man wählt <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Alarmdämon einrichten..</guimenuitem
></menuchoice
>. Es wird der Dialog Service-Verwaltung angezeigt, der die Möglichkeit zum Starten und Stoppen des <application
>Alarmdämons</application
> bietet.</para
> </listitem
> </itemizedlist>

<warning
><para
>Dadurch werden alle anderen Programme beeinflusst, die den <application
>Alarmdämon</application
> verwenden.</para
></warning>

</sect3>
</sect2>

<sect2>
<title
>Erinnerungsdaten zurücksetzen</title>

<para
>Falls das Ereignis eintritt, dass der Alarm nicht ausgelöst wurde, obwohl der Zeitpunkt da ist, kann man die Alarmliste erneuern und alle fehlenden Alarme auslösen, indem man<menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Erinnerungsdaten zurücksetzen</guimenuitem
></menuchoice
> auswählt.</para>

<para
>Beim zurücksetzen des <application
>Alarmdämons</application
> löst &kalarm; alle fehlenden Alarme neu aus. Das wird im Abschnitt <link linkend="daemon-reset"
>Alarmdämon</link
> genauer erklärt.</para>

</sect2>

<sect2>
<title
>Den <application
>Alarmdämon</application
> steuern</title>

<para
>Um den <application
>Alarmdämon</application
> einzurichten, wählt man im Menü <menuchoice
><guimenu
>Einstellungen </guimenu
><guimenuitem
>Alarmdämon kontrollieren...</guimenuitem
></menuchoice
>. Die Service-Verwaltung, die es ermöglicht, den <application
>Alarmdämon</application
> zu starten und zu stoppen, wird angezeigt. Außerdem kann hier festgelegt werden, ob er automatisch beim Anmelden gestartet wird. Siehe auch <link linkend="daemon-control"
>Steuerung des Alarmdämons mit der Service-Verwaltung</link
>.</para>

</sect2>

<sect2>
<title
>Beenden des Programms</title>

<para
>Man beendet &kalarm;, in dem man alle Fenster und das Kontrollleistensymbol schließt. Falls das Programm im <quote
>ständigen</quote
> Modus ausgeführt wird, dagegen indem man alle Nachrichtenfenster schließt und im Kontextmenü des Kontrollleistensymbols <menuchoice
><guimenuitem
>Beenden</guimenuitem
></menuchoice
> auswählt.</para>

<para
>Der Menüeintrag <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Beenden</guimenuitem
></menuchoice
> schließt nur das aktuelle Fenster. Die Auswirkung des Kontextmenüeintrags <menuchoice
><guimenuitem
>Beenden</guimenuitem
></menuchoice
> beim Kontrollleistensymbol hängt vom Programm-Modus ab: im Modus <quote
>Bei Bedarf</quote
> wird das Kontrollleistensymbol versteckt, im Modus <quote
>ständig</quote
> wird das Programm beendet.</para>

<tip
><para
></para
></tip>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Alarm-Nachricht</title>

<para
></para>

<para
>Bei einem wiederholten Alarm, falls also ein Bestätigungsfenster von einem früheren Auftreten noch geöffnet ist, wird das existierende Fenster lediglich nach vorn geschoben, wenn der Alarm wiederholt wird. Damit wird verhindert, dass man mehrere Fenster zur gleichen Alarmnachricht schließen muss.</para>

<para
>Wenn eine Alarmnachricht angezeigt wird, hat man folgende Möglichkeiten:</para>

<itemizedlist
> <listitem
> <para
>Man bestätigt durch Klicken auf den Knopf <guibutton
>Schließen</guibutton
>. Damit wird das Fenster geschlossen (nach einer Nachfrage, falls man das unter <guilabel
>Bei Bestätigung nachfragen</guilabel
> so eingestellt hat).</para
> </listitem
> <listitem
> <para
>Man klickt auf <guibutton
>Verschieben...</guibutton
>, um die Optionen zur Verschiebung anzeigen zu lassen. Dann wählt man <guilabel
>Verschieben auf Zeitpunkt</guilabel
>, um Datum und Uhrzeit des neuen Zeitpunktes eingeben zu können, oder man wählt <guilabel
>Verschieben um Zeitintervall:</guilabel
>, um das Zeitintervall vom jetzigen Zeitpunkt (in Stunden und Minuten) einzugeben, um das der Alarm verschoeben werden soll. Dann klickt man auf <guibutton
>Verschieben</guibutton
>, um die Verschiebung durchführen zu lassen.</para
> <note
><para
></para
></note
> <note
><para
>Der Knopf <guibutton
>Verschieben...</guibutton
> ist nicht verfügbar für Alarmnachrichten, die wegen der Option <guilabel
>Wiederholung beim Anmelden</guilabel
> bei der Anmeldung angezeigt werden.</para
></note
> </listitem
> </itemizedlist>

<para
>Der Knopf mit dem Symbol <guiicon
>&kalarm;</guiicon
> ist zur bequemen Aktivierung von &kalarm; vorhanden. Klicken hat keinen Effekt auf das Alarmnachrichtenfenster.</para>

</sect1>

<sect1 id="system-tray">
<title
>Kontrollleistensymbol</title>

<para
>&kalarm; kann als Symbol in der &kde;-Kontrollleiste ausgeführt werden. Dieses Symbol erlaubt die Aktivierung von &kalarm; mit einem Mausklick und bietet sowohl eine Kontrolle als auch eine Statusanzeige für die Erinnerungsfunktion. Das normale &kalarm;-Symbol zeigt an, dass die Erinnerungsfunktion aktiv ist, während ein rot durchgekreuztes Symbol die Deaktivierung der Erinnerungsfunktion anzeigt.</para>

<para
>Man klickt mit der <mousebutton
>linken</mousebutton
> Maustaste auf das Kontrollleistensymbol, um das &kalarm;-Hauptfenster ein- und auszublenden.</para>

<para
>Man klickt mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Kontrollleitsensymbol, um das Kontextmenü aufzurufen.</para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Alarme aktivieren</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Die Überwachung von Alarmen aktivieren.</action
></para
> <para
>Siehe auch <link linkend="enable-disable"
>Deaktivieren/Aktivieren der Alarm-Überwachung</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Alarme aktiviert</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Deaktiviert die Überwachung von Alarmen.</action
></para
> <para
>Siehe auch <link linkend="enable-disable"
>Deaktivieren/Aktivieren der Alarm-Überwachung</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>&kalarm; einrichten...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Zeigt den Einrichtungsdialog von &kalarm; an.</action
></para
> <para
>Der Einrichtungsdialog wird unter <link linkend="preferences"
>Standardeinstellungen ändern</link
> beschrieben. Er enthält auch Einstellmöglichkeiten für das &kalarm;-Kontrollleistensymbol.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Kontrolle der Erinnerungsfunktion...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Zeigt den Dialog Service-Verwaltung an, der die Steuerung des Alarmdämons ermöglicht.</action
></para
> <para
>Siehe auch <link linkend="daemon-control"
>Den Alarmdämon über die Service-Verwaltung steuern</link
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Wiederherstellen / Minimieren</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Stellt das Hauptfenster von &kalarm; wieder her bzw. minimiert es.</action
></para
> <para
>Diese Einstellung ist nur im Modus 'ständig' verfügbar. (Eine Erläuterung der Programm-Modi findet man unter <link linkend="preferences"
>Standardeinstellungen verändern</link
>.)</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Beenden</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Schließt das &kalarm;-Kontrollleistensymbol.</action
></para
> <para
></para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="preferences">
<title
>Standardeinstellungen</title>

<para
>Um die Standardeinstellungen für &kalarm; festzulegen, wählt man im Menü <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>&kalarm; einrichten...</guimenuitem
></menuchoice
>. Auf der Karteikarte <guilabel
>Allgemein</guilabel
> des angezeigten Einrichtungsdialogs kann man das Verhalten von &kalarm; einrichten:</para>

<itemizedlist
> <listitem
><para
></para
> <itemizedlist
> <listitem
><para
></para
> <itemizedlist
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> </itemizedlist
> <para
></para
> </listitem
> <listitem
><para
></para
> <itemizedlist
> <listitem
><para
></para
> </listitem
> </itemizedlist
> </listitem
> </itemizedlist
> </listitem
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> <listitem
> <para
></para
> <itemizedlist
> <listitem
> <para
></para
> <itemizedlist
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> </itemizedlist
> </listitem
> <listitem
> <para
></para
> </listitem
> </itemizedlist
> </listitem
> <listitem
><para
></para
> <itemizedlist
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> </itemizedlist
> </listitem
> </itemizedlist>

<para
></para>
<itemizedlist
> <listitem
><para
>Man legt den Standardzeichensatz und die Hintergrundfarbe für die Anzeige von Alarmnachrichten fest.</para
> </listitem
> <listitem
><para
></para
> </listitem
> <listitem
><para
>Den Piepton als Standardoption für <guilabel
>Klänge</guilabel
> festlegen.</para
> </listitem
> <listitem
><para
>Die Standardzeitperiode für wiederkehrende Alarme festlegen.</para
> </listitem
> <listitem
><para
></para
> </listitem
> <listitem
><para
></para
> </listitem
> </itemizedlist>

</sect1>

<sect1 id="cmdline-operation">
<title
>Befehlszeilenoptionen</title>

<para
>Wenn Befehlszeilenoptionen angegeben wurden, zeigt &kalarm; nicht die unter <link linkend="graphmode"
>Graphischer Modus</link
> beschriebene Liste der festgesetzten Alarme an. Für folgende Aktionen von &kalarm; gibt es Befehlszeilenoptionen:</para>

<itemizedlist
> <listitem
><para
>Eine neue Alarmnachricht festlegen</para
> </listitem
> <listitem
><para
>Den <application
>Alarmdämon</application
> steuern</para
> </listitem
> <listitem
><para
>&kalarm;s Anzeigemodus steuern</para
> </listitem
> <listitem
><para
>Hilfe anfordern</para
> </listitem
> </itemizedlist>

<para
>Weitere Befehlszeilenoptionen dienen in erster Linie der Zusammenarbeit von anderen Programmen mit &kalarm;. Sie werden im Kapitel <link linkend="cmdline-interface"
>Entwicklungshandbuch zu &kalarm;</link
> beschrieben.</para>

<para
>Die Befehlszeile darf nur Optionen für eine &kalarm;-Aktion enthalten. Falls man mehrere Aktionen durchführen will, muss man &kalarm; mehrfach mit jeweils einer Aktion aufrufen.</para>

<sect2 id="cmdline-schedule">
<title
>Eine neue Alarmnachricht festlegen</title>

<para
>Die folgenden Optionen werden zur Festlegung einer neuen Alarmnachricht verwendet:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Beschreibung</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry
> <entry
>Nachfragen, falls die Alarmnachricht bestätigt wird.</entry
> </row
> <row
> <entry
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-b</option
>, <option
>--beep</option
></entry
> <entry
>Einen hörbaren Piepton ausgeben, wenn die Nachricht angezeigt wird. Dazu muss die Option <option
>--sound</option
> nicht ausgewählt werden.</entry
> </row
> <row
> <entry
><option
></option
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>Farbe</replaceable
></option
></entry
> <entry
>Setzt die Hintergrundfarbe mit einem in &Qt; festgelegten Farbnamen oder durch die hexadezimale Kennnummer der Form 0xRRGGBB.</entry
> </row
> <row
> <entry
><option
>-e</option
>, <option
>--exec <replaceable
>Befehlzeile</replaceable
></option
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-i</option
>, <option
>--interval <replaceable
>Periode</replaceable
></option
></entry
> <entry
>Legt das Intervall zwischen Wiederholungen des Alarms fest. Stunden/Minuten müssen im angegebenen Format <replaceable
>nHnM</replaceable
> sein, wobei <replaceable
>n</replaceable
> jeweils für eine Zahl, &zb; 3H30M, steht. Andere Zeitperioden können im Format <replaceable
>nX</replaceable
>, wobei <replaceable
>n</replaceable
> für eine Zahl steht und <replaceable
>X</replaceable
> einer der Buchstaben Y (Jahre), M (Monate), W (Wochen), D (Tage) ist. Das ist zwingend, falls die Option <option
>--repeat</option
> oder <option
>--until</option
> angegeben sind.</entry
> </row
> <row
> <entry
><option
>-l</option
>, <option
>--late-cancel</option
></entry
> <entry
>Die Nachricht wird verworfen, falls sie nicht rechtzeitig angezeigt werden kann.</entry
> </row
> <row
> <entry
><option
>-L</option
>, <option
>--login</option
></entry
> <entry
>Der Alarm wird bei jedem Anmelden ausgelöst. Die Optionen <option
>--interval</option
>, <option
>--repeat</option
> und <option
>--until</option
> können hiermit nicht verwendet werden.</entry
> </row
> <row
> <entry
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>Anzahl</replaceable
></option
></entry
> <entry
></entry
> </row
> <row
> <entry
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-s</option
>, <option
>--sound <replaceable
>URL</replaceable
></option
></entry
> <entry
>Legt den Namen oder die &URL; einer Textdatei fest, deren Inhalt in der Alarmnachricht angezeigt wird. <option
>--beep</option
> darf nicht zusammen mit dieser Option verwendet werden.</entry
> </row
> <row
> <entry
></entry
> <entry
></entry
> </row
> <row
> <entry
><option
>-t</option
>, <option
>--time <replaceable
>Datum/Zeit</replaceable
></option
></entry
> <entry
>Löst den Alarm am angegebenen Datum oder zum angegebenen Zeitpunkt aus. Man gibt entweder ein Datum ohne Zeit im Format <replaceable
>jjjj-mm-dd</replaceable
> an oder gibt Datum und Zeit im Format <replaceable
>[[[jjjj-]mm-]dd-]hh:mm</replaceable
> an (fehlende Angaben werden auf den heutigen Tag gesetzt).</entry
> </row
> <row
> <entry
><option
>-u</option
>, <option
>--until <replaceable
>Datum/Zeit</replaceable
></option
></entry
> <entry
>Wiederholt den Alarm bis zum angegebenen Zeitpunkt. Man kann entweder ein Datum ohne Zeit oder einen kompletten Zeitpunkt wie unter <option
>--time</option
> beschrieben angeben. <option
>--interval</option
> muss vorhanden sein, <option
>--repeat</option
> darf nicht vorhanden sein.</entry
> </row
> <row
> <entry
><replaceable
>Nachricht</replaceable
></entry
> <entry
></entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Es muss entweder ein Nachrichtentext oder die Option <option
>--file</option
> oder <option
>--exec</option
>  angegeben werden. Alle anderen Optionen sind nicht zwingend notwendig.</para>

<para
>Es werden zwei Beispiele für die Anzeige einer mehrzeiligen Nachricht mit rotem Hintergrund um 22:00 am 27. des aktuellen Monats angegeben:</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
>"Denke daran,\nanzhalten"</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
>"Denke daran,\nanzuhalten"</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Andere Optionen</title>

<para
>Die folgenden Optionen werden verwendet, um den <application
>Alarmdämon</application
> anzuhalten oder zu starten, oder die Anzeige von &kalarm; zu steuern.</para>

<para
>Im Abschnitt <link linkend="daemon-reset"
>Alarmdämon</link
> werden die Auswirkungen eines <application
>Alarmdämon</application
>-Neustarts beschrieben.</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Beschreibung</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--reset</option
></entry
> <entry
>Startet den <application
>Alarmdämon</application
> neu.</entry
> </row
> <row
> <entry
><option
>--stop</option
></entry
> <entry
>Hält den <application
>Alarmdämon</application
> an.</entry
> </row
> <row
> <entry
><option
>--tray</option
></entry
> <entry
>Zeigt &kalarm; als Symbol in der &kde;-Kontrollleiste an.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Ein Beispiel zum Neustart des <application
>Alarmdämons</application
>:</para>

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

</sect2>

<sect2>
<title
>Hilfeoptionen</title>

<para
>Die folgenden Optionen sind allen &kde;-Programmen gemeinsam:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Beschreibung</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--help</option
></entry
> <entry
>Zeigt einen kurzen Hilfetext zu den Optionen.</entry
> </row
> <row
> <entry
><option
>--help-qt</option
></entry
> <entry
>Zeit verschiedene &Qt;-spezifische Optionen an.</entry
> </row
> <row
> <entry
><option
>--help-kde</option
></entry
> <entry
>Zeigt verschiedene &kde;-spezifische Optionen an.</entry
> </row
> <row
> <entry
><option
>--help-all</option
></entry
> <entry
>Zeigt alle Optionen an.</entry
> </row
> <row
> <entry
><option
>--author</option
></entry
> <entry
>Zeigt Namen und Adressen der Autoren von &kalarm;.</entry
> </row
> <row
> <entry
><option
>-v</option
>, <option
>--version</option
></entry
> <entry
>Zeigt die Versionen der &Qt;-Bibliothek, von &kde; und von &kalarm;.</entry
> </row
> <row
> <entry
><option
>--license</option
></entry
> <entry
>Zeigt Lizenzbestimmungen an.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

</sect2>
</sect1>

<sect1 id="daemon">
<title
>Alarmdämon</title>

<para
>Der <application
>Alarmdämon</application
>, &kalarmd;, überwacht die Kalenderdatei von &kalarm;. Wenn eine festgesetzte Alarmzeit erreicht ist, veranlasst er &kalarm;, eine Alarmnachricht anzuzeigen oder die Nachricht zu verwerfen, falls die Alarmzeit abgelaufen und die Option zur Anzeige der abgelaufenen Nachricht nicht ausgewählt wurde.</para>

<para
>Unter &kde; 3 kann der <application
>Alarmdämon</application
> auch von anderen Programmen, z.B. KOrganizer, verwendet werden.</para>

<para
>Dadurch wird der <application
>Alarmdämon</application
> im Hintergrund ohne Benutzeroberfläche gestartet. Er wird wie weiter unten beschrieben gesteuert.</para>

<sect2>
<title
>Starten, neustarten und stoppen des <application
>Alarmdämons</application
></title>

<para
>Der <application
>Alarmdämon</application
> wird üblicherweise bei der Anmeldung an &kde; gestartet (falls man nicht den Autostart im Dialog Service-Verwaltung abgeschaltet hat) und läuft ständig bis zur Abmeldung. Falls aus irgend einem Grund der Dämon nicht aktiv ist, werden die festgelegten Alarme nicht überwacht und &kalarm; zeigt keine Alarmnachrichten an.</para>

<sect3>
<title
>Den <application
>Alarmdämon</application
> starten</title>

<para
>Um den <application
>Alarmdämon</application
> zu starten kann man entweder &kalarm; im graphischen Modus starten (also ohne irgendwelche Befehlszeilenoptionen), Alarme mit Hilfe von &kalarm;s Kontrollleistensymbolmenü aktivieren, den Dämon nach der <link linkend="daemon-reset"
>weiter unten</link
> gegebenen Beschreibung neu starten, man kann den Alarmdämon im Dialog Service-Verwaltung starten (siehe auch <link linkend="daemon-control"
>Steuerung des Alarmdämons über die Service-Verwaltung</link
>), oder man kann den <application
>Alarmdämon</application
> direkt von der Befehlszeile starten.</para>

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

</sect3>

<sect3 id="daemon-reset">
<title
>Neustarten des <application
>Alarmdämons</application
></title>

<para
>Es ist möglich, den <application
>Alarmdämon</application
> neu zu starten, ohne ihn vorher anzuhalten. Der Neustart veranlasst den <application
>Alarmdämon</application
>, die Liste der festgesetzten Alarme aus der Kalenderdatei neu einzulesen und die Daten von &kalarm; neu zu initialisieren.</para>

<para
>Warum sollte man den <application
>Alarmdämon</application
> neu starten? Es ist nicht wahrscheinlich, aber es kann passieren, das &kalarm; zum Zeitpunkt, als eine Nachricht angezeigt werden sollte, nicht gestartet werden konnte. Dadurch wird diese Nachricht nicht angezeigt, solange der <application
>Alarmdämon</application
> nicht neu gestartet wird. Der Neustart des <application
>Alarmdämons</application
> ist besser als das Anhalten und anschließende neustarten, da den <application
>Alarmdämon</application
> verwendende Programme davon nicht betroffen sind.</para>

<tip
><para
>Neustarten startet den <application
>Alarmdämon</application
>, falls er bisher nocht nicht lief.</para
></tip>

<para
>Um den <application
>Alarmdämon</application
> neu zu starten, kann man entweder den Menübefehl <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Dämon neustarten</guimenuitem
></menuchoice
> verwenden oder den folgenden Befehl eingeben:</para>

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

</sect3>

<sect3>
<title
>Den <application
>Alarmdämon</application
> stoppen</title>

<para
>Das Stoppen des <application
>Alarmdämons</application
> beendet jede Überwachung der Liste mit den festgelegten Alarmen bis der Dämon wieder gestartet wird.</para>

<warning
><para
>Das Stoppen beeinträchtigt alle Programme, die den <application
>Alarmdämon</application
> verwenden. Stattdessen sollte man den Dämon neustarten.</para
></warning>

<para
>Um den <application
>Alarmdämon</application
> neu zu starten, kann man entweder den Dialog Service-Verwaltung (siehe <link linkend="daemon-control"
>Steuerung des Alarmdämons über die Service-Verwaltung</link
>) verwenden oder den folgenden Befehl eingeben:</para>

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

</sect2>

<sect2 id="daemon-control">
<title
>den <application
>Alarmdämon</application
> über die Service-Verwaltung steuern</title>

<para
>Der Dialog Service-verwaltung erlaubt eine Einrichtung und Steuerung des <application
>Alarmdämons</application
>. Man kann:</para>

<itemizedlist
> <listitem
> <para
>Festlegen, ober er automatisch beim Anmelden gestartet wird.</para
> <warning
><para
>Falls aus irgend einem Grund der <application
>Alarmdämon</application
> nicht aktiv ist, werden die festgelegten Alarme nicht überwacht und &kalarm; zeigt keine Alarmnachrichten an.</para
></warning
> </listitem
> <listitem
> <para
>Hält den <application
>Alarmdämon</application
> an.</para
> <warning
><para
>Das Starten oder Stoppen des <application
>Alarmdämon</application
> hat einen Einfluss auf alle anderen Programme, die den <application
>Alarmdämon</application
> verwenden.</para
></warning
> </listitem
> </itemizedlist>

<para
>Die Service-Verwaltung wird entweder über das Menü <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Kontrolle des Alarmdämons...</guimenuitem
></menuchoice
> oder über das Kontrollzentrum von &kde; aufgerufen.</para>

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

<chapter id="developers">
<title
>Entwicklerhandbuch zu &kalarm;(in englisch)</title>

<para
>&kalarm; provides an interface to allow other applications to request the following functions:</para>

<itemizedlist
> <listitem
><para
>Eine neue Alarmnachricht festlegen</para
></listitem
> <listitem
><para
>auslösen oder abbrechen eines festgelegten Alarmes</para
></listitem
> <listitem
><para
>abbrechen eines bereits festgelegten Alarmes</para
></listitem
> <listitem
><para
>auslösen eines bereits festgelegten Alarmes</para
></listitem
> </itemizedlist>

<para
>Each of the above functions is implemented both by a &DCOP; call and by the command line. &DCOP; calls should be used in preference if &kalarm; is already running.</para>

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

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>cancel an already scheduled alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void cancelEvent(const QString&amp; <replaceable
>calendarFile</replaceable
>, const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Specifies the &URL; of the calendar file containing the event to be cancelled.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Specifies the unique ID of the event to be cancelled, as stored in <replaceable
>calendarFile</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>cancelEvent()</function
> is a &DCOP; call to cancel the specified alarm. &kalarm; deletes the alarm from the calendar file without displaying or executing it.</para>

<note
><para
>The <replaceable
>calendarFile</replaceable
> parameter is only used for integrity checking: if the &URL; does not specify &kalarm;'s current default calendar file, the request will be ignored.</para
></note>

<note
><para
>The old name for this function, <function
>cancelMessage</function
>, has been retained for compatibility, but all new applications should use <function
>cancelEvent</function
>.</para
></note>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>trigger an already scheduled alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void triggerEvent(const QString&amp; <replaceable
>calendarFile</replaceable
>, const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Specifies the &URL; of the calendar file containing the event to be triggered.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Specifies the unique ID of the event to be triggered, as stored in <replaceable
>calendarFile</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>triggerEvent()</function
> is a &DCOP; call to trigger the immediate display or execution of the specified alarm (regardless of what time it is scheduled for). &kalarm; retrieves the alarm from the calendar file and then displays or executes it.</para>

<para
>If the alarm is already due, &kalarm; then deletes all scheduled occurrences of the alarm up to the current time, and if no repetitions of the alarm still remain, the alarm is deleted from the calendar file. If the alarm is not due yet, its scheduled occurrences are left unchanged.</para>

<note
><para
>The <replaceable
>calendarFile</replaceable
> parameter is only used for integrity checking: if the &URL; does not specify &kalarm;'s current default calendar file, the request will be ignored.</para
></note>

<note
><para
>The old name for this function, <function
>displayMessage</function
>, has been retained for compatibility, but all new applications should use <function
>triggerEvent</function
>.</para
></note>

</refsect1>
</refentry>

<refentry id="handleEvent">
<refmeta>
<refentrytitle
>handleEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>handleEvent</refname>
<refpurpose
>trigger or cancel an already scheduled alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
void handleEvent(const QString&amp; <replaceable
>calendarFile</replaceable
>, const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Specifies the &URL; of the calendar file containing the event to be displayed/executed or cancelled.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Specifies the unique ID of the event to be displayed/executed or cancelled, as stored in <replaceable
>calendarFile</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>handleEvent()</function
> is a &DCOP; call to display/execute or cancel the specified alarm. &kalarm; retrieves the alarm from the calendar file and then determines what action to take depending on when the alarm is due.</para>

<itemizedlist
> <listitem
><para
>If the alarm is not yet due, nothing happens.</para
> </listitem
> <listitem
><para
></para
> </listitem
> </itemizedlist>

<note
><para
>The <replaceable
>calendarFile</replaceable
> parameter is only used for integrity checking: if the &URL; does not specify &kalarm;'s current default calendar file, the request will be ignored.</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>

</synopsis>
<synopsis>

</synopsis>
<synopsis>

</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
>Nachricht</parameter
></term
> <listitem
> <para
>Specifies the text of the message to be scheduled.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Specifies the scheduled date and time at which the message should be displayed.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Specifies the background colour for displaying the message.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Specifies the logical OR of the desired alarm message flags. The flag bits are those defined in class KAlarmEvent in <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>audioURL</parameter
></term
> <listitem
> <para
>Specifies the name or &URL; of an audio file which is to be played when the message is displayed.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Erinnerung</parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm message.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Specifies the number of times that the alarm message should be displayed. Specify -1 to repeat the alarm indefinitely.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beschreibung</title>
<para
><function
>scheduleMessage()</function
> is a &DCOP; call to schedule the specified alarm message for display at the specified date and time. It has three forms: one for a non-repeating alarm, one for a repeating alarm with a repetition count, and one for a repeating alarm with an end time.</para>

<para
>If the scheduled time (including any repetitions) has already passed, &kalarm; immediately displays the message or, if the LATE_CANCEL flag bit is set, ignores the request. If the scheduled time (or a repetition) is in the future, &kalarm; adds the alarm message to the calendar file for later display.</para>

<para
>Use a code sequence similar to the following to set up the parameter data for the &DCOP; call to <function
>scheduleMessage()</function
> for a non-repeating alarm:</para>

<screen>

</screen>

<para
>Use a code sequence similar to the following to set up the parameter data for the &DCOP; call to <function
>scheduleMessage()</function
> for a repeating alarm:</para>

<screen>

</screen>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>schedule a new alarm which displays the contents of a
text file.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>

</synopsis>
<synopsis>

</synopsis>
<synopsis>

</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
>URL</parameter
></term
> <listitem
> <para
>Specifies the name or &URL; of a text file whose contents are to be displayed in the message to be scheduled.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Specifies the scheduled date and time at which the file should be displayed.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Specifies the background colour for displaying the file.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAlarmEvent in <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>audioURL</parameter
></term
> <listitem
> <para
>Specifies the name or &URL; of an audio file which is to be played when the message is displayed.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Erinnerung</parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Specifies the number of times that the file should be displayed. Specify -1 to repeat the alarm indefinitely.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
><function
>scheduleFile()</function
> is a &DCOP; call to schedule the specified text file for display at the specified date and time. Apart from specifying a file name or &URL;, its usage is identical to <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - see the description of that function for further details.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>schedule a new alarm which executes a shell
command.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>)
</synopsis>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>repeatCount</replaceable
>)
</synopsis>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, int <replaceable
>flags</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
>commandLine</parameter
></term
> <listitem
> <para
>Specifies the shell command line whose execution is to be scheduled.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Specifies the scheduled date and time at which the command should be executed.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAlarmEvent in <filename
>msgevent.h</filename
> except that the BEEP flag bit is ignored.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
><function
>scheduleCommand()</function
> is a &DCOP; call to schedule the specified shell command line for execution at the specified date and time. Apart from specifying a command line and omitting the message colour and audio file parameters, its usage is identical to <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - see the description of that function for further details.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>schedule a new alarm which sends an email.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>

</synopsis>
<synopsis>

</synopsis>
<synopsis>

</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist
> <varlistentry
> <term
><parameter
></parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
></parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Nachricht</parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
></parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>flags</parameter
></term
> <listitem
> <para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAlarmEvent in <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
></para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
></para>
</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Command line interface</title>

<para
>Command line options are provided to enable other programs (such as the <application
>alarm daemon</application
>) to start up &kalarm; if it is not already running, in order to trigger or cancel scheduled alarms, or schedule new alarms. The reason for using command line options for this purpose is that if &kalarm; were started without any command line parameters and then sent &DCOP; requests, it would start in its default graphical mode, which is clearly undesirable for an inter-program request.</para>

<note
><para
>Programs should first check whether &kalarm; is already running; if it is, they should instead use &DCOP; calls to request these operations.</para
></note>

<para
>The command line options for scheduling a new alarm are as described in the chapter <link linkend="cmdline-operation"
>Using &kalarm;</link
>. The options for triggering and cancelling scheduled alarms are as follows:</para>

<note
><para
>Normal users may also if they wish use these command line options (assuming that they can supply the necessary parameter information).</para
></note>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Beschreibung</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--calendarURL <replaceable
>url</replaceable
></option
></entry
> <entry
>Use the calendar file with the specified &URL;. This option is only used for integrity checking: if the &URL; doesn't specify &kalarm;'s current default calendar file, the request will be ignored.</entry
> </row
> <row
> <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Cancel the event with the specified event ID.</entry
> </row
> <row
> <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Trigger the event with the specified event ID. The action taken is the same as for the <link linkend="triggerEvent"
>triggerEvent()</link
> &DCOP; call.</entry
> </row
> <row
> <entry
><option
>--handleEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Trigger or cancel the event with the specified event ID. &kalarm; determines which action to take in the same way as for the <link linkend="handleEvent"
>handleEvent()</link
> &DCOP; call.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
><option
>--cancelEvent</option
>, <option
>--triggerEvent</option
> and <option
>--handleEvent</option
> are mutually exclusive. <option
>--calendarURL</option
> is optional, but can only be used with one of the other three options.</para>

<para
>Examples are:</para>

<informalexample
><screen>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <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
>Fragen und Antworten</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Wie heißen die Konfigurationsdateien von &kalarm;?</para>
</question>
<answer>
<para
>The file <filename
>$KDEHOME/share/config/kalarmrc</filename
> holds your &kalarm; preferences.</para>

<para
></para>

<note
><para
></para
></note>

<para
></para>

<para
></para>

</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Wie heißen die Konfigurationsdateien des <application
>Alarmdämons</application
>?</para>
</question>
<answer>
<para
>Die Einstellungen des <application
>Alarmdämons</application
> befinden sich in <filename
>$KDEHOME/share/config/kalarmdrc</filename
>.</para>

<para
>In der Datei <filename
>$KDEHOME/share/apps/kalarmd/clients</filename
> befinden sich Angaben über Programme und deren Kalenderdateien, die sich beim <application
>Alarmdämon</application
> registriert haben.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Wie sind die Programmnamen von &kalarm; und dem <application
>Alarmdämon</application
>?</para>
</question>
<answer>
<para
>Der Programmname von &kalarm; lautet <application
>kalarm</application
> und der <application
>Alarmdämon</application
> heisst <application
>kalarmd</application
>. In &kde;-Versionen vor 3.1 gibt es zusätzlich ein kleines Programm namens <application
>kalarmautostart</application
>, welches bei der Anmeldung das Kontrollleistensymbol von &kalarm; startet.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Mitwirkende und Lizenz</title>

<para
> &kalarm; </para>
<para
>  </para>
<para
> Autoren des Alarmdämons: <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
>  </para>

<para
>Übersetzung: Frank Schütte <email
>F.Schuette@t-online.de</email
></para>

<para
>Vielen Dank an den Autor des &kde;1-Alarmprogramms, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, der den Namen &kalarm; für dieses &kde;2-/&kde;3-Programm freigegeben hat. </para>

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

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

</chapter>

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

<sect1 id="getting-kalarm">
<title
>Wie bekommt man &kalarm;?</title>

&install.intro.documentation;

<para
> </para>

</sect1>

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

<para
></para>

<para
>&kalarm; benötigt etwa 12 MB und der <application
>Alarmdämon</application
> noch einmal 2,5 MB Arbeitsspeicher. Diese Anforderungen können abhängig von der Plattform und Konfiguration allerdings variieren.</para>

<para
>Eine Liste der Änderungen findet man in der Datei <filename
>ChangeLog</filename
> oder unter <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
>Kompilierung und Installation</title>

<para
>Falls man kein geeignetes vorkompiliertes binäres Paket findet, muss man &kalarm; selbst aus den Quelldateien kompilieren. Dazu benötigt man die Dateien <filename
>kdepim-x.x.tar.bz2</filename
> oder <filename
>kalarm-x.x.tar.bz2</filename
> (oder ähnlich), abhängig davon, ob man das gesamte &package; oder nur &kalarm; installieren möchte. Die Datei muss in einem neuen Unterverzeichnis entpackt werden. Das kann durch <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>Paket.tar.bz2</replaceable
></option
></userinput
> erfolgen. Dann wechselt man in das erzeugte Unterverzeichnis.</para>

&install.compile.documentation;

<note
><para
>Falls man mehrere Versionen von &kde; installiert hat (z.B. &kde;2 und &kde;3), könnte &kalarm; irrtümlich im falschen &kde;-Verzeichnis installiert werden. Falls nötig, kann man das richtige &kde;-Verzeichnis als Parameter für den Befehl <userinput
><command
>./configure</command
></userinput
> angeben. Für das &kde;-Verzeichnis <filename
>/opt/kde2</filename
> lautet der Befehl zum Beispiel:</para
> <para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para
> </note>
</sect1>

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

<para
>Für den Start von &kalarm; müssen keine besonderen Konfigurationen der &kde;-Arbeitsfläche vorgenommen werden. Nachdem man &kalarm; das erste Mal gestartet hat, wird der <application
>Alarmdämon</application
> bei jeder Anmeldung gestartet, um die festgelegten Alarme zu überwachen.</para>

<para
>Um &kalarm; bei einer Nicht-&kde;-Arbeitsfläche zu verwenden, muss man selbst sicherstellen, dass der <application
>Alarmdämon</application
> bei jeder Anmeldung automatisch gestartet wird. Genauere Hinweise kann man der Datei <filename
>INSTALL</filename
> aus der &kalarm;-Distribution entnehmen.</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:
-->

