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

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

<book lang="&language;">

<bookinfo>
<title
>Manuel de &kalarm;</title>

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

&traducteurEricBischoff; &traducteurLudovicGrossard;

<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-10-04</date>
<releaseinfo
>0.08.01</releaseinfo>

<abstract>
<para
>&kalarm; est un programmateur personnel de messages de réveil-matin/pense-bête et de commandes pour &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarme</keyword>
<keyword
>pense-bête</keyword>
</keywordset>

</bookinfo>


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

<para
>&kalarm; est un programmateur personnel de messages d'alarme et de commandes. Il vous permet de planifier des messages de réveil-matin ou de pense-bête personnels qui surgissent sur l'écran à l'heure prévue, ou de paramétrer des commandes à exécuter.</para>

<para
>S'il est lancé dans son mode graphique par défaut, &kalarm; affiche une liste d'alarmes planifiées, avec leur heure et leurs caractéristiques. Vous pouvez créer de nouvelles alarmes, ou sélectionner des alarmes existantes afin de les modifier ou de les annuler.</para>

<para
>Lorsque vous mettez en place ou modifiez une alarme, vous pouvez soit saisir le texte de l'alarme, soit indiquer un fichier de texte à afficher, ou alors indiquer une commande à exécuter. Vous pouvez également choisir la couleur du message d'alarme, indiquer s'il doit se répéter, indiquer s'il doit jouer un son, et indiquer si l'alarme doit être annulée si le message n'a pas pu être déclenché à l'heure prévue.</para>

<para
>Les alarmes peuvent également être planifiées depuis la ligne de commande ou par le moyen d'appels &DCOP; depuis d'autres programmes.</para>

<para
>Quand un message d'alarme est déclenché, il s'affiche sur chaque bureau virtuel de &kde; afin de s'assurer que vous ne le manquerez pas. La fenêtre de message affiche l'heure à laquelle le message était prévu. Il propose en général une option de remise à plus tard permettant de demander à l'alarme de se réafficher plus tard. Voici un exemple de message d'alarme&nbsp;:</para>

<screenshot
> <screeninfo
>Copie d'écran de la fenêtre de message de &kalarm;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="alarmmessage.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Message d'alarme</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Quand l'alarme indique une commande à exécuter, &kalarm; n'affiche rien.</para>

<para
>&kalarm; peut fonctionner de deux manières différentes&nbsp;: <quote
>en continu</quote
> (par défaut), où il fonctionne depuis la boîte à miniatures de &kde;, ou <quote
>à la demande</quote
> où il est exécuté quand c'est nécessaire (avec la possibilité d'afficher une icône indépendante dans la boîte à miniatures).</para>

<para
>Ce document évoque souvent le <application
>démon d'alarme</application
>. Il s'agit d'une application qui tourne en arrière-plan, en vérifiant les alarmes en attente et en indiquant à &kalarm; de les afficher quand elles arrivent à échéance.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Utilisation de &kalarm;</title>

<sect1 id="graphmode">
<title
>Mode graphique</title>

<para
>Lorsqu'il est lancé sans arguments de ligne de commande, &kalarm; démarre en mode graphique. Il affiche la liste actuelle des alarmes en attente, avec pour chacune l'heure, l'intervalle de répétition, la couleur, ainsi que le texte du message, le nom du fichier à afficher ou de la commande à exécuter. (L'heure affichée pour une alarme à répétition est celle du prochain déclenchement prévu). Une icône à gauche de chaque alarme (texte/fichier/commande) indique le type d'alarme.</para>

<screenshot
> <screeninfo
>Copie d'écran de la fenêtre principale de &kalarm;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Fenêtre principale</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Pour les alarmes à répétition, la liste affiche la prochaine heure de déclenchement prévue ainsi que le nombre de fois que l'alarme doit se répéter ensuite.</para>

<para
>Les alarmes peuvent être triées par date et heure, par intervalle de répétition, par couleur, ou par texte en cliquant dans la barre de titre sur la colonne appropriée. Pour inverser l'ordre de tri, cliquez une seconde fois dans la barre de titre.</para>

<para
>Lorsque &kalarm; démarre en mode graphique, il vérifie que le <application
>démon d'alarme</application
> est en cours d'exécution. Si ce n'est pas le cas, &kalarm; le lance.</para>

<sect2>
<title
>Comment ajouter une nouvelle alarme</title>

<para
>Pour ajouter une nouvelle alarme, choisissez <menuchoice
> <guimenu
>Actions</guimenu
><guimenuitem
>Nouveau...</guimenuitem
></menuchoice
>. Cela affiche la boîte de dialogue de paramétrage de l'alarme décrite ci-dessous.</para>

</sect2>

<sect2>
<title
>Comment modifier une alarme existante</title>

<para
>Pour modifier une alarme existante, utilisez une des méthodes ci-dessous&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>Double-cliquez sur sa ligne dans la liste des alarmes.</para
> </listitem
> <listitem
> <para
>Sélectionnez-la en cliquant sur sa ligne dans la liste des alarmes. Choisissez alors <menuchoice
><guimenu
>Actions</guimenu
> <guimenuitem
>Modifier...</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Cliquez avec le &BDS; sur sa ligne dans la liste d'alarmes et choisissez <menuchoice
><guimenuitem
>Modifier..</guimenuitem
></menuchoice
> dans le menu contextuel.</para
> </listitem
> </itemizedlist>

<para
>Cela affiche la boîte de dialogue de paramétrage de l'alarme&nbsp;:</para>

<screenshot
> <screeninfo
>Copie d'écran de la boîte de dialogue de modification d'une alarme</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="editwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Boîte de dialogue de modification d'une alarme</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Dans le groupe d'options <guilabel
>Action</guilabel
>, choisissez soit <guilabel
>Texte</guilabel
> pour saisir le texte du message (qui peut comprendre des sauts de lignes) dans la zone de saisie, soit <guilabel
>Fichier</guilabel
> pour saisir le nom ou l'&URL; d'un fichier de texte dont le contenu s'affichera dans le message d'alarme, soit <guilabel
>Commande</guilabel
> pour saisir une commande de l'interpréteur à exécuter. Lorsque <guilabel
>Fichier</guilabel
> est choisi, le bouton à droite de la zone de saisie peut être utilisé pour afficher la boîte de dialogue de sélection de fichier.</para>

<para
>Si l'alarme est une alarme à répétition et si elle a été différée après son dernier affichage, le groupe d'options <guilabel
>Alarme différée</guilabel
> affiche l'heure à laquelle l'alarme différée doit se déclencher. Le bouton <guibutton
>Modifier...</guibutton
> affiche une boîte de dialogue qui vous permet de modifier l'heure différée ou d'annuler le report à plus tard.</para>

<para
>Dans le groupe d'options <guilabel
>Heure</guilabel
>, choisissez soit</para>

<itemizedlist
> <listitem
> <para
><guilabel
>À la date et l'heure&nbsp;:</guilabel
> pour saisir la date et l'heure auxquelles l'alarme doit se déclencher. Cochez la case <guilabel
>N'importe quand</guilabel
> si vous désirez n'indiquer qu'une date pour l'alarme. Dans ce cas, l'alarme sera affichée à cette date à la première occasion à partir de l'heure de début de la journée telle qu'elle a été configurée. La section <link linkend="preferences"
>Comment configurer les options par défaut</link
> indique comment régler l'heure de début de la journée.</para
> </listitem
> <listitem
> <para
><guilabel
>Durée à partir de maintenant&nbsp;:</guilabel
> pour indiquer dans combien de temps (en nombre d'heures et de minutes) l'alarme doit se déclencher.</para
> </listitem
> </itemizedlist>

<para
>Indiquez si et comment l'alarme doit se répéter dans le groupe d'options <guilabel
>Répétition</guilabel
>.</para>

<itemizedlist
> <listitem
><para
>Pour que l'alarme ne se déclenche qu'une fois, choisissez <guilabel
>Pas de répétition</guilabel
>.</para
></listitem
> <listitem
><para
>Choisissez <guilabel
>Répéter à la connexion</guilabel
> pour déclencher l'alarme à chaque fois que vous vous connectez jusqu'à l'heure prévue. Il convient de remarquer qu'une alarme répétée à la connexion sera également déclenchée chaque fois que vous activez les alarmes, ou que vous redémarrez ou réinitialisez le <application
>démon d'alarme</application
>.</para
></listitem
> <listitem
><para
>Choisissez <guilabel
>Répétition</guilabel
> pour déclencher l'alarme à intervalles réguliers. Il vous faut alors indiquer les paramètres de répétition dans l'onglet <guilabel
>Répétition</guilabel
>.</para
> <para
>Dans le groupe d'options <guilabel
>Règles de répétition</guilabel
>, réglez l'intervalle de répétition en choisissant un des types d'intervalles et en saisissant dans <guilabel
>répéter tous / toutes les&nbsp;:</guilabel
> combien d'intervalles de temps doivent écouler entre les répétitions. Par exemple, pour répéter chaque quinzaine, vous pouvez choisir <guilabel
>Jours</guilabel
> et saisir une valeur de 14, ou choisir <guilabel
>Semaines</guilabel
> et saisir une valeur de 2. Des options additionnelles sont proposées en fonction de l'intervalle de temps&nbsp;:</para
> <itemizedlist
> <listitem
> <para
>pour une répétition hebdomadaire, cochez chaque jour de la semaine où vous souhaitez que l'alarme se déclenche,</para
> </listitem
> <listitem
> <para
>pour une répétition mensuelle, vous pouvez choisir soit une date fixe, soit une position dans le mois, comme le second mardi du mois,</para
> </listitem
> <listitem
> <para
>pour une répétition annuelle, vous pouvez choisir soit une date fixe dans l'année, soit une position dans un mois (&pex; le dernier samedi de mai).</para
> </listitem
> </itemizedlist
> <para
>Dans le groupe d'options <guilabel
>Fin de la répétition</guilabel
>, réglez la période globale de répétition de la manière suivante&nbsp;:</para
> <itemizedlist
> <listitem
><para
>choisissez <guilabel
>Pas de fin</guilabel
> pour continuer les répétitions indéfiniment,</para
></listitem
> <listitem
><para
>choisissez <guilabel
>Arrêter après&nbsp;:</guilabel
> pour indiquer le nombre total d'occurrences de l'alarme,</para
></listitem
> <listitem
><para
>choisissez <guilabel
>Finir le&nbsp;:</guilabel
> pour indiquer jusqu'à quelle date et quelle heure l'alarme se répétera.</para
></listitem
> </itemizedlist
> </listitem
> </itemizedlist>

<para
>La case à cocher <guilabel
>Annuler si trop tard</guilabel
> détermine ce qui se passe lorsque l'alarme ne peut pas se déclencher à l'heure prévue. Cochez cette case si elle ne peut pas être déclenchée pendant la minute qui suit le moment prévu. Laissez cette case non cochée pour déclencher l'alarme à la première occasion suivant le moment prévu. Les alarmes basées sur la date seulement, &cad; celles pour qui l'option <guilabel
>N'importe quand</guilabel
> est activée, seront annulées si elles ne peuvent pas s'afficher pendant les 24 heures qui suivent le début de la journée correspondant à la date prévue.</para>

<note
><para
>Une alarme ne peut se déclencher que si vous êtes connecté, et que lorsque X et le <application
>démon d'alarme</application
> sont tous les deux en cours d'exécution.</para
></note>

<para
>La case à cocher <guilabel
>Demande de confirmation de la réception</guilabel
> vous permet de préciser si vous souhaitez vous voir demander une confirmation lorsque vous fermez la fenêtre d'alarme. Cette option peut être utilisée préventivement contre une confirmation accidentelle des alarmes.</para>

<para
>Cochez la case <guilabel
>Son</guilabel
> si vous souhaitez qu'une sonnerie audible accompagne le message d'alarme lorsqu'il s'affiche. Par défaut on entend un bip sonore&nbsp;; utilisez le bouton de droite pour choisir un fichier audio à jouer. Pour revenir au bip, cliquez une seconde fois sur le bouton. Pour voir quel est le son actuellement choisi, survolez le bouton avec le curseur de la souris jusqu'à ce qu'une bulle d'aide apparaisse.</para>

<para
>Choisissez la couleur de fond pour la fenêtre du message d'alarme.</para>

<para
>Appuyez sur le bouton <guibutton
>OK</guibutton
> quand tous les détails sont correctement réglés afin d'ajouter l'alarme à la liste des alarmes prévues.</para>

</sect2>

<sect2>
<title
>Comment détruire une alarme existante</title>

<para
>Pour annuler une alarme existante, choisissez une des méthodes suivantes&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>Choisissez-la en cliquant sur sa ligne dans la liste des alarmes. Choisissez ensuite <menuchoice
> <guimenu
>Actions</guimenu
><guimenuitem
>Supprimer</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
>Cliquez avec le &BDS; sur sa ligne dans la liste des alarmes et choisissez <menuchoice
><guimenuitem
>Supprimer</guimenuitem
></menuchoice
> dans le menu contextuel qui apparaît.</para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
>Comment confirmer la réception d'une alarme</title>

<para
>Reportez-vous à la section sur <link linkend="message-window"
>la fenêtre de message d'alarme</link
> pour savoir comment confirmer la réception d'une alarme.</para>

</sect2>

<sect2>
<title
>Comment afficher &kalarm; dans la boîte à miniatures</title>

<para
>Vous devez utiliser le bureau &kde; pour afficher &kalarm; dans la boîte à miniatures. Si &kalarm; fonctionne en mode <quote
>continu</quote
>, la miniature est affichée en permanence. Les instructions qui suivent s'appliquent uniquement au mode <quote
>à la demande</quote
>. (Reportez-vous à <link linkend="preferences"
>Comment régler les options par défaut</link
> pour une description des différents modes d'exécution).</para>

<para
>Pour afficher &kalarm; dans la boîte à miniatures de &kde;, choisissez <menuchoice
> <guimenu
>Affichage</guimenu
><guimenuitem
>Afficher la miniature dans la boîte à miniatures</guimenuitem
> </menuchoice
>.</para>

<para
>Pour retirer &kalarm; de la boîte à miniatures &kde;, utilisez l'une des méthodes suivantes&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>choisissez <menuchoice
><guimenu
>Affichage</guimenu
> <guimenuitem
>Retirer la miniature de la boîte à miniatures</guimenuitem
></menuchoice
>,</para
> </listitem
> <listitem
> <para
>cliquez avec le &BDS; sur la miniature et choisissez <menuchoice
><guimenuitem
>Quitter</guimenuitem
></menuchoice
> dans le menu contextuel qui apparaît.</para
> </listitem
> </itemizedlist>

<para
>L'utilisation de la miniature est décrite <link linkend="system-tray"
>ci-dessous</link
>.</para>

</sect2>

<sect2 id="enable-disable">
<title
>Comment activer ou désactiver la surveillance des alarmes</title>

<sect3>
<title
>Comment activer la surveillance des alarmes</title>

<para
>Tout d'abord, si &kalarm; fonctionne en mode <quote
>continu</quote
> et si vous avez choisi <guilabel
>Désactiver les alarmes lorsqu'il ne fonctionne pas</guilabel
> dans la boîte de dialogue de configuration, vous devez vous assurer que &kalarm; fonctionne pour que la surveillance des alarmes soit assurée.</para>

<para
>Ensuite, si la gestion des alarmes est actuellement désactivée, utilisez une des méthodes suivantes&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>Choisissez <menuchoice
><guimenu
>Actions</guimenu
> <guimenuitem
>Alarmes activées</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Cliquez avec le &BDS; sur la miniature et choisissez <menuchoice
><guimenuitem
>Activer les alarmes</guimenuitem
></menuchoice
> dans le menu contextuel qui apparaît.</para
> </listitem
> </itemizedlist>

<para
>Le <application
>démon d'alarme</application
> est lancé quand c'est nécessaire, et les alarmes seront surveillées de façon à se déclencher au moment opportun.</para>

<warning
><para
>Le lancement du <application
>démon d'alarme</application
> affectera toutes les autres applications qui utilisent le <application
>démon d'alarme</application
>.</para
></warning>

</sect3>

<sect3>
<title
>Comment activer la surveillance des alarmes</title>

<para
>Il y a plusieurs façons de désactiver la surveillance des alarmes, ce qui empêche &kalarm; d'afficher des alarmes jusqu'à ce que vous les réactiviez, ou, dans le cas où le <application
>démon d'alarme</application
> est réglé pour se lancer à la connexion, jusqu'à ce que vous vous reconnectiez.</para>

<para
>Pour désactiver les alarmes sans arrêter le <application
>démon d'alarme</application
> (et ainsi sans affecter les autres applications qui utilisent ce <application
>démon d'alarme</application
>), utilisez une des méthodes suivantes&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>choisissez <menuchoice
><guimenu
>Actions</guimenu
> <guimenuitem
>Alarmes Activées</guimenuitem
></menuchoice
>,</para
> </listitem
> <listitem
> <para
>cliquez avec le &BDS; sur la miniature et choisissez <menuchoice
><guimenuitem
>Alarmes activées</guimenuitem
></menuchoice
> dans le menu contextuel qui apparaît,</para
> </listitem
> <listitem
> <para
>si &kalarm; s'exécute en mode <quote
>continu</quote
> et si vous avez coché <guilabel
>Désactiver les alarmes lorsqu'il ne fonctionne pas</guilabel
> dans la boîte de dialogue de configuration, sortez de &kalarm;.</para
> </listitem
> </itemizedlist>

<para
>Pour désactiver les alarmes en arrêtant le <application
>démon d'alarme</application
>&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>choisissez <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Contrôler le démon d'alarme...</guimenuitem
></menuchoice
>. Cela affiche la boîte de dialogue du gestionnaire de services, ce qui vous permet d'arrêter le <application
>démon d'alarme</application
>.</para
> </listitem
> </itemizedlist>

<warning
><para
>Cela affectera toute autre application qui utiliserait le <application
>démon d'alarme</application
>.</para
></warning>

</sect3>
</sect2>

<sect2>
<title
>Comment rafraîchir les alarmes</title>

<para
>Dans le cas improbable où une alarme n'aurait pas été déclenchée alors qu'elle aurait dû l'être, vous pouvez rafraîchir la liste des alarmes et déclencher les alarmes manquées en choisissant <menuchoice
> <guimenu
>Actions</guimenu
><guimenuitem
>Rafraîchir les alarmes</guimenuitem
> </menuchoice
>.</para>

<para
>&kalarm; redéclenche les alarmes manquées en réinitialisant le <application
>démon d'alarme</application
>, ceci est décrit dans la section sur le <link linkend="daemon-reset"
>démon d'alarme</link
>.</para>

</sect2>

<sect2>
<title
>Comment contrôler le <application
>démon d'alarme</application
></title>

<para
>Pour agir sur le <application
>démon d'alarme</application
>, choisissez <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Contrôler le démon d'alarme...</guimenuitem
></menuchoice
>. Cela affiche la boîte de dialogue du gestionnaire de services, qui vous permet de démarrer ou d'arrêter le <application
>démon d'alarme</application
> et de déterminer s'il se lance automatiquement à la connexion. Reportez-vous à <link linkend="daemon-control"
>Comment contrôler le démon d'alarme avec le gestionnaire de services</link
> pour plus de détails.</para>

</sect2>

<sect2>
<title
>Comment sortir du programme</title>

<para
>Quittez &kalarm; en fermant toutes ses fenêtres et l'icône dans la boîte à miniatures, ou s'il fonctionne en mode <quote
>continu</quote
>, en fermant toutes les fenêtres de messages et en choissant <menuchoice
><guimenuitem
>Quitter</guimenuitem
></menuchoice
> dans le menu contextuel de l'icône.</para>

<para
><menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Quitter</guimenuitem
> </menuchoice
> ne ferme que la fenêtre concernée. L'effet de l'élément <menuchoice
><guimenuitem
>Quitter</guimenuitem
></menuchoice
> du menu contextuel de la miniature dépend, lui, du mode d'exécution. En mode <quote
>à la demande</quote
>, il cache la miniature, alors qu'en mode <quote
>continu</quote
> il sort du programme.</para>

<tip
><para
>Le fait de sortir de &kalarm; n'a pas d'effet sur le <application
>démon d'alarme</application
>, qui, s'il est déjà actif, continuera a surveiller les alarmes prévues, et demandera leur affichage quand elles arriveront à échéance (à moins que vous n'ayez choisi <guilabel
>Désactiver les alarmes lorsqu'il ne fonctionne pas</guilabel
> dans la boîte de dialogue des préférences).</para
></tip>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>La fenêtre des messages d'alarme</title>

<para
>Lorsqu'un message d'alarme arrive à échéance, il est affiché sur chaque bureau de &kde; et ne peut pas être recouvert par des fenêtres ordinaires, afin d'être sûr que vous le voyez bien. La fenêtre de message affiche l'heure à laquelle l'alarme était programmée, de façon que vous puissiez voir quand elle est apparue si vous étiez parti à ce moment là.</para>

<para
>Dans le cas d'une alarme répétitive, si une fenêtre de message reste non validée d'une occurrence prédécente de l'alarme, la fenêtre existante est simplement réaffichée lorsque l'alarme se produit. Cela évite de devoir accuser réception de plusieurs exemplaires du même message, dans le cas où ne voudriez ou ne pourriez pas accuser réception d'un message au moment où il apparaît.</para>

<para
>Quand une fenêtre de message d'alarme est affichée, utilisez une des méthodes suivantes&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>Accusez réception en actionnant le bouton <guibutton
>Fermer</guibutton
>. Cela fermera la fenêtre (après une demande de confirmation, si vous avez choisi <guilabel
>Demande de confirmation de la réception</guilabel
>).</para
> </listitem
> <listitem
> <para
>Affichez les options pour différer l'alarme en cliquant sur le bouton <guibutton
>Différer...</guibutton
>. Sélectionnez ensuite <guilabel
>Différer à (date / heure)</guilabel
> pour saisir la date et l'heure à laquelle le message doit être réaffiché, ou sélectionnez <guilabel
>Différer (durée)</guilabel
> pour saisir le temps au bout duquel le message doit être réaffiché (en heures et minutes). Cliquez ensuite sur <guibutton
>OK</guibutton
> pour différer le message d'alarme.</para
> <note
><para
>Si l'alarme se répète régulièrement, l'heure à laquelle elle est reportée doit être plus antérieure que l'heure de la prochaine répétition prévue.</para
></note
> <note
><para
>Le bouton <guibutton
>Différer...</guibutton
> n'est pas disponible lorsqu'une alarme est affichéee à la reconnexion, suite à l'activation de l'option <guilabel
>Répéter à la connexion</guilabel
>.</para
></note
> </listitem
> </itemizedlist>

<para
>Le bouton affichant l'icône de <guiicon
>&kalarm;</guiicon
> permet d'appeler &kalarm; aisément. Le fait de cliquer dessus n'a pas d'effet sur la fenêtre de l'alarme.</para>

</sect1>

<sect1 id="system-tray">
<title
>L'icône de la boîte à miniatures</title>

<para
>&kalarm; peut être exécuté comme icône dans la boîte à miniatures de &kde;. Cette icône permet d'activer &kalarm; en un seul clic, et fournit à la fois le contrôle et des indications d'état de la surveillance des alarmes. Une icône normale de &kalarm; indique que les alarmes sont surveillées, alors qu'une croix rouge sur l'icône indique que les alarmes ne le sont pas.</para>

<para
>Cliquez avec le &BGS; sur la miniature pour cacher ou au contraire afficher la fenêtre principale de &kalarm;.</para>

<para
>Cliquez avec le &BDS; sur la miniature pour afficher son menu contextuel&nbsp;:</para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Activer les alarmes</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Active la surveillance des alarmes.</action
></para
> <para
>voir <link linkend="enable-disable"
>Activer/désactiver la surveillance des alarmes</link
> pour plus d'informations.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Alarmes activées</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Désactive la surveillance des alarmes</action
></para
> <para
>voir <link linkend="enable-disable"
>Activer/désactiver la surveillance des alarmes</link
> pour plus d'informations.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Configurer &kalarm;...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Affiche la boîte de dialogue de configuration de &kalarm;.</action
></para
> <para
>La boîte de dialogue de configuration est décrite dans <link linkend="preferences"
>Configurer les options par défaut</link
>. Elle inclut des options relatives à l'icône de la boîte à miniatures de &kalarm;.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Contrôler le démon d'alarme...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Affiche la boîte de dialogue du gestionnaire de services qui vous permet de contrôler le démon d'alarme.</action
></para
> <para
>Voir <link linkend="daemon-control"
>Contrôler le démon d'alarme avec le gestionnaire de services</link
> pour plus d'informations.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Réduire / restaurer</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Restaure ou minimise la fenêtre principale de &kalarm;.</action
></para
> <para
>Cette option n'est disponible si le mode de fonctionnenent est <quote
>continu</quote
> (voir <link linkend="preferences"
>Configurer les options par défaut</link
> pour une description des modes de fonctionnement).</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Quitter</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Ferme l'icône de &kalarm; dans la boîte à miniatures.</action
></para
> <para
>En mode de fonctionnement <quote
>continu</quote
>, ceci ferme également toutes les fenêtres principales de &kalarm;. Ça n'a aucun effet sur la surveillance des alarmes par le <application
>démon d'alarmes</application
> (à moins que vous n'ayez sélectionné <guilabel
>Désactiver les alarmes lorsqu'il ne fonctionne pas</guilabel
> dans la boîte de dialogue de configuration).</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="preferences">
<title
>Comment configurer les options par défaut</title>

<para
>Pour régler les options par défaut de &kalarm;, sélectionnez <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer &kalarm;</guimenuitem
></menuchoice
>. Ceci affiche la boîte de dialogue de configuration. La section <guilabel
>Général</guilabel
> vous permet de contrôler le comportement global de &kalarm;&nbsp;:</para>

<itemizedlist
> <listitem
><para
>Spécifiez le mode de fonctionnement. Vous pouvez choisir soit de fonctionner en continu dans la boîte à miniatures de &kde;, soit de fonctionner uniquement à la demande. Cette sélection n'affecte pas l'affichage des alarmes lorsqu'elles arrivent à échéance, puisque c'est le <application
>démon d'alarmes</application
> et pas &kalarm; qui surveille la liste des alarmes. Faire fonctionner &kalarm; dans la boîte à miniatures rend l'application plus accessible et affiche une indication sur l'activation ou non des alarmes, mais faire fonctionner une application en continu consomme plus de ressources système. Donc si les performances de votre système sont une priorité, l'option <quote
>À la demande</quote
> est préférable.</para
> <para
>Lorsque le fonctionnement est <quote
>à la demande</quote
>, l'icône dans la boîte à miniatures peut tout de même être affichée. La différence principale entre les deux modes de fonctionnement est que lorsque vous fermez l'icône en mode <quote
>à la demande</quote
>, ceci n'a aucun effet sur les fenêtres de &kalarm;, tandis qu'en mode <quote
>continu</quote
>, fermer l'icône ferme également toutes le fenêtres principales de &kalarm;.</para
> </listitem
> <listitem
><para
>Si vous spécifiez que &kalarm; soit fonctionner en mode <quote
>continu</quote
>, vous pouvez désactiver toutes les alarmes à venir alors que &kalarm; ne fonctionne pas.</para
> </listitem
> <listitem
><para
>Spécifiez si l'icône de &kalarm; dans la boîte à miniatures doit être affichée à la connexion.</para
> </listitem
> <listitem
><para
>Configurez l'intervalle de rafraîchissement de l'icône de &kalarm; dans la boîte à miniatures pour refléter si les alarmes sont actuellement surveillées ou non. Ceci implique la vérification du fonctionnement du <application
>démon d'alarmes</application
>.</para
> </listitem
> <listitem
><para
>Réglez la date de démarrage pour les alarmes ne s'activant qu'avec la date, &cad; celles pour lesquelles l'option <guilabel
>n'importe quand</guilabel
> a été sélectionnée. À la date d'échéance, de telles alarmes seront déclenchées à la première opportunité durant les 24 heures à partir de la date de démarrage.</para
> </listitem
> <listitem
><para
>Spécifiez si on doit vous demander confirmation chaque fois que vous supprimez une alarme.</para
> </listitem
> </itemizedlist>

<para
>Les sections <guilabel
>Options par défaut</guilabel
> et <guilabel
>Apparence</guilabel
> vous permettent de choisir les valeurs par défaut pour les options dans la boîte de dialogue d'édition des alarmes&nbsp;:</para>
<itemizedlist
> <listitem
><para
>réglez la police par défaut et la couleur de fond à utiliser pour les messages d'alarme,</para
> </listitem
> <listitem
><para
>réglez l'état par défaut des cases à cocher <guilabel
>Annuler si trop tard</guilabel
> et <guilabel
>Demande la confirmation de la réception</guilabel
>,</para
> </listitem
> <listitem
><para
>réglez le bip par défaut pour l'option <guilabel
>son</guilabel
>,</para
> </listitem
> <listitem
><para
>réglez la période de répétition par défaut pour les alarmes répétitives.</para
> </listitem
> </itemizedlist>

</sect1>

<sect1 id="cmdline-operation">
<title
>Opération en ligne de commande</title>

<para
>Lorsque des paramètres en ligne de commande sont fournis, &kalarm; n'affiche pas la liste des alarmes programmées comme décrit dans <link linkend="graphmode"
>le mode graphique</link
> ci-dessus. Les options en ligne de commande spécifiques à &kalarm; peuvent être utilisées pour réaliser les opérations suivantes&nbsp;:</para>

<itemizedlist
> <listitem
><para
>programmer une nouvelle alarme,</para
> </listitem
> <listitem
><para
>contrôler le <application
>démon d'alarmes</application
>,</para
> </listitem
> <listitem
><para
>contrôler les modes d'affichage de &kalarm;,</para
> </listitem
> <listitem
><para
>obtenir de l'aide.</para
> </listitem
> </itemizedlist>

<para
>Des options en ligne de commande supplémentaires sous fournies principalement pour permettre à d'autres programmes d'être interfacés avec &kalarm;. Elles sont décrites dans le chapitre <link linkend="cmdline-interface"
>Guide du développeur de &kalarm;</link
>.</para>

<para
>La ligne de commande ne doit contenir que des options applicables à une des opérations de &kalarm;. Si vous voulez effectuer des opérations multiples, vous devez invoquer &kalarm; plusieurs fois avec une seule option à chaque fois.</para>

<sect2 id="cmdline-schedule">
<title
>Programmer une nouvelle alarme</title>

<para
>Les options suivantes sont utilisées pour programmer une nouvelle alarme&nbsp;:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Description</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry
> <entry
>Demande une confirmation lorsque le message d'alarme est accusé réception.</entry
> </row
> <row
> <entry
><option
>-b</option
>, <option
>--beep</option
></entry
> <entry
>Émet un bip lorsque le message est affiché. <option
>--sound</option
> ne doit pas être présent su cette option est spécifiée.</entry
> </row
> <row
> <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>couleur</replaceable
></option
></entry
> <entry
>Règle la couleur de fond du message à la couleur &Qt; spécifiée ou son code hexadécimal 0xRRGGBB.</entry
> </row
> <row
> <entry
><option
>-e</option
>, <option
>--exec <replaceable
>ligne_de_commande</replaceable
></option
></entry
> <entry
>Spécifie une ligne de commande shell à exécuter. Si spécifiée, cette option doit être la dernière option de &kalarm; dans la ligne de commande de &kalarm; Tous les autres paramètres de commande et options suivantes sont interprétés comme formant la ligne de commande à exécuter. <option
>--file</option
> ne peut pas être spécifié avec cette option.  <option
>--ack-confirm</option
>, <option
>--beep</option
> et <option
>--color</option
> sont ignorées avec cette option.</entry
> </row
> <row
> <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry
> <entry
>Spécifie le nom, l'&URL; ou le fichier texte dont le contenu doit former le message d'alarme.  <replaceable
>message</replaceable
> ne doit pas être présent si cette option est spécifiée.</entry
> </row
> <row
> <entry
><option
>-i</option
>, <option
>--interval <replaceable
>period</replaceable
></option
></entry
> <entry
>Règle l'intervalle de répétition de l'alarme. Heures/minutes sont spécifiées dans le format <replaceable
>nHnM</replaceable
>, où <replaceable
>n</replaceable
> est un nombre, &pex; 3H30M. Les autres périodes de temps sont spécifiées dans le format <replaceable
>nX</replaceable
>, où <replaceable
>n</replaceable
> est un nombre et <replaceable
>X</replaceable
> est une des lettres suivantes&nbsp;: Y (années), M (mois), W (semaines), D (jours). Obligatoire si <option
>--repeat</option
> ou <option
>--until</option
> est spécifié.</entry
> </row
> <row
> <entry
><option
>-l</option
>, <option
>--late-cancel</option
></entry
> <entry
>Annule l'alarme si elle ne peut pas être déclenchée à l'heure correcte.</entry
> </row
> <row
> <entry
><option
>-L</option
>, <option
>--login</option
></entry
> <entry
>Déclenche l'alarme chaque fois que vous vous connectez. <option
>--interval</option
>, <option
>--repeat</option
> et <option
>--until</option
> ne peuvent pas être spécifiés avec cette option.</entry
> </row
> <row
> <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>count</replaceable
></option
></entry
> <entry
>Nombre de fois que l'alarme doit être déclenchée. Spécifiez -1 pour répéter l'alarme indéfiniment.  <option
>--interval</option
> doit être spécifié avec cette option, et <option
>--until</option
> ne peut pas l'être.</entry
> </row
> <row
> <entry
><option
>-s</option
>, <option
>--sound <replaceable
>URL</replaceable
></option
></entry
> <entry
>Spécifie le nom, l'&URL; ou le fichier audio à jouer lorsque le message d'alarme est affiché.  <option
>--beep</option
> ne doit pas être présent si cette option est spécifiée.</entry
> </row
> <row
> <entry
><option
>-t</option
>, <option
>--time <replaceable
>date/time</replaceable
></option
></entry
> <entry
>Déclenche l'alarme à la date ou à la date et à l'heure spécifiées. Spécifiez une date sans heure dans le format <replaceable
>yyyy-mm-dd</replaceable
>&nbsp;; spécifiez une date et une heure avec <replaceable
>[[[yyyy-]mm-]dd-]hh:mm</replaceable
> (dans laquelle les champs de date omis prendront par défaut les valeurs du jour).</entry
> </row
> <row
> <entry
><option
>-u</option
>, <option
>--until <replaceable
>date/time</replaceable
></option
></entry
> <entry
>Répète l'alarme jusqu'à une date ou une date et heure spécifiée. Spécifiez une date sans heure dans le même format que pour <option
>--time</option
>. <option
>--interval</option
> doit être spécifié avec cette option, et  <option
>--repeat</option
> ne doit pas apparaître.</entry
> </row
> <row
> <entry
><replaceable
>message</replaceable
></entry
> <entry
>Texte du message à afficher.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Soit un texte de message, soit <option
>--file</option
> ou <option
>--exec</option
> doivent être spécifiés, sauf comme mentionné ci-dessus, toutes les options sont facultatives.</para>

<para
>Deux autres exemples qui affichent un message sur plusieurs lignes avec un fond rouge à 10 heures pm le 27 de ce mois sont&nbsp;:</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
>"Penser à\ns'arrêter"</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
>"Penser à\ns'arrêter"</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Autres options</title>

<para
>Les options suivantes sont utilisées pour réinitialiser ou arrêter le <application
>démon d'alarmes</application
>, ou pour contrôler les modes d'affichage de &kalarm;.</para>

<para
>Voir la section <link linkend="daemon-reset"
>démon d'alarmes</link
> pour une dscussion sur la réinitialisation et l'arrêt du <application
>démon d'alarmes</application
>.</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Description</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--reset</option
></entry
> <entry
>Réinitialise le <application
>démon d'alarmes</application
>.</entry
> </row
> <row
> <entry
><option
>--stop</option
></entry
> <entry
>Arrête le <application
>démon d'alarmes</application
>.</entry
> </row
> <row
> <entry
><option
>--tray</option
></entry
> <entry
>Affiche &kalarm; sour forme d'icône dans la boîte à miniatures de &kde;.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Par exemple, pour réinitialiser le <application
>démon d'alarmes</application
>&nbsp;:</para>

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

</sect2>

<sect2>
<title
>Options d'aide</title>

<para
>Les options d'aide suivantes sont communes à tous les programmes &kde;&nbsp;:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Description</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--help</option
></entry
> <entry
>Affiche un bref texte d'aide sur les options.</entry
> </row
> <row
> <entry
><option
>--help-qt</option
></entry
> <entry
>Montre plusieurs options spécifiques à &Qt;.</entry
> </row
> <row
> <entry
><option
>--help-kde</option
></entry
> <entry
>Montre plusieurs options spécifiques à &kde;.</entry
> </row
> <row
> <entry
><option
>--help-all</option
></entry
> <entry
>Affiche toutes les options.</entry
> </row
> <row
> <entry
><option
>--author</option
></entry
> <entry
>Affiche les noms et les adresses électroniques des auteurs de &kalarm;.</entry
> </row
> <row
> <entry
><option
>-v</option
>, <option
>--version</option
></entry
> <entry
>Affiche les versions actuelles de la bibliothèque &Qt;, de &kde; et de &kalarm;.</entry
> </row
> <row
> <entry
><option
>--license</option
></entry
> <entry
>Affiche des informations sur la licence.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

</sect2>
</sect1>

<sect1 id="daemon">
<title
>Le démon d'alarmes</title>

<para
>Le <application
>démon d'alarmes</application
>, &kalarmd;, surveille le fichier de calendrier de &kalarm; contenant lealarmes. Lorsqu'il détermine qu'une alarme arrive à échéance, il demande à &kalarm; de l'afficher, de l'exécuter ou de l'annuler s'il est trop tard et que l'activation avec retard n'a pas été sélectionnée pour cette alarme.</para>

<para
>Sous &kde;3, le <application
>démon d'alarme</application
> peut être également utilisé par d'autres applications, y-compris KOrganizer.</para>

<para
>Le <application
>démon d'alarme</application
> fonctionne en tache de ond, sanserface utilisateur. Il peut être contrôlé comme décrit ci-dessous&nbsp;:</para>

<sect2>
<title
>Démarrer réinitialiser  et arrêter le <application
>démon d'alarmes</application
></title>

<para
>Le <application
>démon d'alarmes</application
> est normalement démarré dès la connexion à &kde; (à moins que vous n'ayez utilisé la boîte de dialogue de gestion des services pour désactiver le démarrage automatique), et fonctionne en continu jusqu'à la déconnexion. Si pour une raison quelconque il ne fonctionne pas, la surveillance des alarmes ne se fera pas et &kalarm; n'affichera ou n'exécutera pas les alarmes.</para>

<sect3>
<title
>Démarrage du <application
>démon de alarmes</application
></title>

<para
>Pour démarrer le <application
>démon d'alarmes</application
>, vous pouvez soit exécuter &kalarm; avec son mode graphique par défaut (&cad; sans paramètres en ligne de commande), activer les alarmes en utilisant le menu de l'icône de &kalarm; dans la boîte à miniatures, réinitialiser le démon comme décrit <link linkend="daemon-reset"
>ci-dessous</link
>, le démarrer en utilisant la boîte de dialogue de gestion des services (voir <link linkend="daemon-control"
>Contrôler le démon d'alarmes avec le gestionnaire de services</link
> soit exécuter le <application
>démon d'alarmes</application
> directement depuis la ligne de commande.</para>

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

</sect3>

<sect3 id="daemon-reset">
<title
>Réinitialisation du <application
>démon d'alarmes</application
></title>

<para
>Il est également possible de réinitialiser le <application
>démon d'alarmes</application
> sans l'arrêter. La réinitialisation implique une relecture de la liste des messages dans le fichier de calendrier par <application
>le démon d'alarmes</application
> et réinitialise les données relatives à &kalarm;.</para>

<para
>Pourquoi vouloir réinitialiser le <application
>démon d'alarme</application
>&nbsp;? Ceci n'arrive pas souvent, mais si pour une raison quelconque &kalarm; n'était pas capable de démarrer lorsque le <application
>démon d'alarmes</application
> lui demande d'activer une alarme, l'alarme ne sera jamais affichée ou exécutée jusqu'à ce que le <application
>démon d'alarme</application
> soit réinitialisé ou redémarré. La réinitialisation est préférable à l'arrêt et le redémarrage du <application
>démon d'alarme</application
>, puisqu'une réinitialisation n'affectera pas les autres applications qui utilisent le <application
>démon d'alarme</application
>.</para>

<tip
><para
>La réinitialisation démarre le <application
>démon d'alarme</application
> s'il ne fonctionnait pas.</para
></tip>

<para
>Pour réinitialiser le <application
>démon d'alarme</application
>, utilisez soit la commande de menu <menuchoice
><guimenu
>Actions</guimenu
><guimenuitem
>Rafraîchir les alarmes</guimenuitem
></menuchoice
> ou saisissez la commande suivante&nbsp;:</para>

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

</sect3>

<sect3>
<title
>Arrêt du <application
>démon d'alarmes</application
></title>

<para
>En arrêtant le <application
>démon d'alarmes</application
>, toutes les alarmes suivantes ne seront plus surveillées jusqu'à ce que le démon soit redémarré.</para>

<warning
><para
>L'arrêt affectera le fonctionnement de toutes les applications qui utilisent également le <application
>démon d'alarme</application
>. Préférez plutôt une réinitialisation.</para
></warning>

<para
>Pour arrêter le <application
>démon d'alarmes</application
>, utilisez la boîte de dialogue de gestion des services (voir <link linkend="daemon-control"
>Contrôler le démon d'alarme avec le gestionnaire de services</link
>), ou saisissez la commande suivante&nbsp;:</para>

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

</sect2>

<sect2 id="daemon-control">
<title
>Contrôler le <application
>démon d'alarme</application
> avec le gestionnaire de services</title>

<para
>La boîte de dialogue de gestion des services vous permettent de configurer et de contrôler le <application
>démon d'alarmes</application
>. Vous pouvez&nbsp;:</para>

<itemizedlist
> <listitem
> <para
>configurer s'il fonctionne automatiquement à la connexion.</para
> <warning
><para
>Si ni le <application
>démon d'alarmes</application
> ni &kalarm; ne sont configurée pour fonctionner à la connexion, la surveillance des alarmes ne se produira pas et &kalarm; n'affichera ou n'exécutera pas les alarmes.</para
></warning
> </listitem
> <listitem
> <para
>l'arrêter et le démarrer.</para
> <warning
><para
>Le démarrage ou l'arrêt du <application
>démon d'alarmes</application
> affectera toutes les autres applications qui l'utilisent.</para
></warning
> </listitem
> </itemizedlist>

<para
>Vous pouvez accéder à la boîte de dialogue de gestion des services via l'option de menu <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Contrôler le démon d'alarmes</guimenuitem
></menuchoice
>, ou via le centre de configuration de &kde;.</para>

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

<chapter id="developers">
<title
>Guide du développeur de &kalarm;</title>

<para
>&kalarm; fournit une interface pour pemettre à d'autres applications de demander les fonctions suivantes&nbsp;:</para>

<itemizedlist
> <listitem
><para
>programmer une nouvelle alarme,</para
></listitem
> <listitem
><para
>déclencher ou annuler une alarme déjà programmée,</para
></listitem
> <listitem
><para
>annuler une alarme déjà programmée,</para
></listitem
> <listitem
><para
>déclencher une alarme déjà activée.</para
></listitem
> </itemizedlist>

<para
>Chacune des fonctions ci-dessus est implémentée à la fois par un appel &DCOP; et par la ligne de commande. Les appels &DCOP; doivent être préférés si &kalarm; fonctionne déjà.</para>

<sect1 id="dcop-interface">
<title
>Interface &DCOP;</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
>Paramètres</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Spécifie l'&URL; d'un fichier calendrier contenant des événements à annuler.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Spécifie l'identificateur unique de l'événement devant être annulé, comme enregistré dans <replaceable
>calendarFile</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Description</title>

<para
><function
>cancelEvent()</function
> est un appel &DCOP; pour annuler l'alarme spécifiée. &kalarm; supprime l'alarme dans le fichier de calendrier sans l'afficher ou sans l'exécuter.</para>

<note
><para
>Le paramètre <replaceable
>calendarFile</replaceable
> n'est utilisé que pour des test d'intégrité&nbsp;: si l'&URL; ne spécifie pas le fichier de calendrier par défaut actuel de &kalarm;, la requête sera ignorée.</para
></note>

<note
><para
>L'ancien nom pour cette fonction, <function
>cancelMessage</function
>, a été conservé pour la compatibilité, mais toutes les nouvelles applications devraient utiliser <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
>Paramètres</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Spécifie l'&URL; ou le fichier de calendrier contenant l'événement à activer.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Spécifie l'identificateur unique à déclencher, comme stocké dans <replaceable
>calendarFile</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Description</title>

<para
><function
>triggerEvent()</function
> est un appel &DCOP; pour déclencher l'affichage immédiat ou l'exécution d'une alarme spécifiée (en fonction de l'heure à laquelle elle est programmé). &kalarm; retrouve l'alarme dans le fichier de calendrier et ensuite l'affiche ou l'exécute.</para>

<para
>Si l'alarme est déjà arrivée à échéance, &kalarm; supprime alors les occurrences de l'alarme jusqu'à l'heure courante, et s'il n'y a pas d'alarmes répétitives, l'alarme est supprimée du fichier de calendrier. Si l'alarme n'est pas encore arrivée à échéance, ses occurrences sont inchangées.</para>

<note
><para
>Le paramètre <replaceable
>calendarFile</replaceable
> n'est utilisé que pour des test d'intégrité&nbsp;: si l'&URL; ne spécifie pas le fichier de calendrier par défaut actuel de &kalarm;, la requête sera ignorée.</para
></note>

<note
><para
>L'ancien nom pour cette fonction, <function
>displayMessage</function
>, a été conservé pour la compatibilité, mais toutes les nouvelles applications devraient utiliser <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
>Paramètres</title>
<variablelist
> <varlistentry
> <term
><parameter
>calendarFile</parameter
></term
> <listitem
> <para
>Spécifie l'&URL; du fichier du fichier de calendrier contenant l'événement à afficher/exécuter ou annuler.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>eventID</parameter
></term
> <listitem
> <para
>Spécifie l'identificateur unique de l'événement à afficher/exécuter ou annuler, comme stocké dans <replaceable
>calendarFile</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Description</title>

<para
><function
>handleEvent()</function
> est un appel &DCOP; pour afficher/exécuter ou annuler l'alarme spécifiée. &kalarm; retrouve l'alarme dans le fichier de calendrier et ensuite détermine quelle mesure prendre en fonction de l'échéance de l'alarme.</para>

<itemizedlist
> <listitem
><para
>Si l'alarme n'est pas encore arrivée à échéance, rien ne se passe.</para
> </listitem
> <listitem
><para
>Si l'alarme est arrivée à échéance, la chose suivante se produit&nbsp;: si le drapeau late-cancel est positionné et que l'alarme est en retard, &cad; l'heure de déclenchement programmé est dépassée depuis plus d'une minute, &kalarm; n'affiche pas ou n'exécute pas l'alarme. Sinon, &kalarm; affiche ou exécute l'alarme. S'il n'y a plus aucune alarme répétitive programmée, alors il supprime l'alarme du fichier de calendrier.</para
> </listitem
> </itemizedlist>

<note
><para
>Le paramètre <replaceable
>calendarFile</replaceable
> n'est utilisé que pour des test d'intégrité&nbsp;: si l'&URL; ne spécifie pas le fichier de calendrier par défaut actuel de &kalarm;, la requête sera ignorée.</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
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>repeatCount</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>message</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Paramètres</title>
<variablelist
> <varlistentry
> <term
><parameter
>message</parameter
></term
> <listitem
> <para
>Spécifie le texte du message à programmer.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Spécifie la date et l'heure à laquelle le message devra être affiché.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Spécifie la couleur de fond pour afficher le message.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>drapeaux</parameter
></term
> <listitem
> <para
>Spécifie le OU logique des drapeaux du message d'alarme désiré. Les bits du drapeau sont ceux définis dans la classe KAlarmEvent dans <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>audioURL</parameter
></term
> <listitem
> <para
>Spécifie le nom ou l'&URL; d'un fichier audio à jouer lorsque le message est affiché.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Spécifie le type de récurrence de l'alarme. Les valeurs admises sont MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. Elles sont définies dans la classe KAlarmEvent dans <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Spécifie la période (minutes/jours/semaines/mois/années) entre la répétition d'un message d'alarme.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Spécifie le nombre de fois que le message d'alarme doit être affiché. Spécifiez -1 pour répéter l'alarme indéfiniment.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Description</title>
<para
><function
>scheduleMessage()</function
> est un appel &DCOP; pour programmer le message d'alarme à afficher à la date et à l'heure spécifiée. Il a trois formes&nbsp;: une pour l'alarme non répétitive, une pour l'alarme répétitive avec un compteur de répétition, et une pour une alarme répétitive avec une heure de fin.</para>

<para
>Si l'heure programmée (y-compris les répétitions) est déjà passée, &kalarm; affiche immédiatement le message ou, si le bit du drapeau LATE_CANCEL est positionné, ignore la requête. Si l'heure programmée (ou une répétition) se trouve dans le future, &kalarm; ajoute le message d'alarme dans le fichier de calendrier pour l'afficher plus tard.</para>

<para
>Utilisez une séquence de code similaire à ce qui suit pour configurer les paramètres pour l'appel &DCOP; à <function
>scheduleMessage()</function
> pour une alarme non répétitive&nbsp;:</para>

<screen>
QString message, audioFile;
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 &lt;&lt; audioFile;
</screen>

<para
>Utilisez une séquence de code similaire à ce qui suit pour configurer les paramètres pour l'appel &DCOP; à <function
>scheduleMessage()</function
> pour une alarme répétitive&nbsp;:</para>

<screen>
QString message, audioFile;
QDateTime dateTime;
QColor bgColour;
Q_UINT32 flags;
Q_INT32 repeatType, 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; audioFile &lt;&lt; repeatType &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 which displays the contents of a
text file.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>repeatCount</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dateTime</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flags</replaceable
>, const QString&amp; <replaceable
>audioURL</replaceable
>, int <replaceable
>simpleRepeatType</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Paramètres</title>
<variablelist
> <varlistentry
> <term
><parameter
>URL</parameter
></term
> <listitem
> <para
>Spécifie le nom ou l'&URL; d'un fichier texte dont le contenu sera affiché dans le message à programmer.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Spécifie la date et l'heure programmée à laquelle le fichier devra être affiché.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Spécifie la couleur de fond pour afficher le fichier.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>drapeaux</parameter
></term
> <listitem
> <para
>Spécifie le OU logique du drapeau de l'alarme spécifiée. Les bit du drapeau sont ceux définis dans la classe KAlarmEvent dans <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>audioURL</parameter
></term
> <listitem
> <para
>Spécifie le nom ou l'&URL; d'un fichier audio à jouer lorsque le message est affiché.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Spécifie le type de récurrence de l'alarme. Les valeurs admises sont MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. Elles sont définies dans la classe KAlarmEvent dans <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Spécifie la période (minutes/jours/semaines/mois/années) entre les répétitions de l'alarme.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Spécifie le nombre de fois que l'alarme devra être affichée. Spécifiez -1 pour répéter l'alarme indéfiniment.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Description</title>
<para
><function
>scheduleFile()</function
>  est un appel &DCOP; pour programmer l'affichage du fichier texte spécifié à la date et à l'heure spécifiée. À part la spécification d'un nom de fichier ou d'une &URL;, son utilisation est identique à  <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - voir la description de cette fonction pour plus de détails.</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
>Paramètres</title>
<variablelist
> <varlistentry
> <term
><parameter
>commandLine</parameter
></term
> <listitem
> <para
>Spécifie la commande shell dont l'exécution doit être programmée.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>dateTime</parameter
></term
> <listitem
> <para
>Spécifie la date et l'heure programmée à laquelle la commande doit être exécutée.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>drapeaux</parameter
></term
> <listitem
> <para
>Spécifie le OU logique du drapeau de l'alarme désirée. Les bits du drapeau sont ceux définis dans la classe KAlarmEvent dans <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>simpleRepeatType</parameter
></term
> <listitem
> <para
>Spécifie le type de récurrence de l'alarme. Les valeurs admises sont MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. Elles sont définies dans la classe KAlarmEvent dans <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>interval</parameter
></term
> <listitem
> <para
>Spécifie la période (minutes/jours/semaines/mois/années) entre les répétitions de l'alarme.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>repeatCount</parameter
></term
> <listitem
> <para
>Spécifie le nombre de fois que l'alarme doit être répétée. Spécifiez -1 pour répéter l'alarme indéfiniment.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Description</title>
<para
><function
>scheduleCommand()</function
> est un appel &DCOP; pour programmer la ligne de commande spécifiée à exécuter à la date et à l'heure spécifiée. À part donner la ligne de commande et ommettre la couleur du message et le paramètre du fichier audio, son utilisation est identique à <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - voir la desctiption de cette fonction pour plus d'informations.</para>
</refsect1>
</refentry>
</sect1>

<sect1 id="cmdline-interface">
<title
>Interface en ligne de commande</title>

<para
>Les options de la ligne de commande sont fournies pour permettre à d'autres programmes (comme le <application
>démon d'alarmes</application
>) de démarrer &kalarm;, s'il ne fonctionne pas encore, de façon à déclencher ou annuler les alarmes programmées, ou programmer de nouvelles alarmes. Il est préférable d'utiliser les options de la ligne de commande dans ce but car si &kalarm; était démarré sans aucun paramètre de ligne de commande, et si ensuite vous envoyiez des requêtes &DCOP;, il démarrerait dans son mode graphique par défaut, ce qui est clairement indésirable pour une requête d'un programme extérieur.</para>

<note
><para
>Les programmes devraient d'abord vérifier si &kalarm; fonctionne déjà. Si c'est le cas, il devraient utiliser les appels &DCOP; pour faire ces opérations.</para
></note>

<para
>Les options en ligne de commande pour programmer une nouvelle alarme sont décrites dans le chapitre <link linkend="cmdline-operation"
>Utilisation de &kalarm;</link
>.
Les options pour déclencher et annuler les alarmes programmées sont les suivantes&nbsp;:</para>

<note
><para
>Les utilisateurs peuvent également s'ils le souhaitent utiliser ces options en ligne de commande (en supposant qu'ils peuvent fournir les paramètres nécessaires).</para
></note>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Option</entry
> <entry
>Description</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--calendarURL <replaceable
>url</replaceable
></option
></entry
> <entry
>Utilise le fichier de calendrier pour spécifier l'&URL;. Cette option n'est utilisée que pour tester l'intégrité. Si l'&URL; ne spécifie aucun fichier de calendrier par défaut actuel de &kalarm;, la requête sera ignorée.</entry
> </row
> <row
> <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Annule l'événement avec l'identificateur d'événement spécifié.</entry
> </row
> <row
> <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Active l'événement avec l'identificateur d'événement spécifié. L'action réalisée est la même que pour l'appel &DCOP; <link linkend="triggerEvent"
>triggerEvent()</link
>.</entry
> </row
> <row
> <entry
><option
>--handleEvent <replaceable
>eventID</replaceable
></option
></entry
> <entry
>Active ou annule l'événement avec l'identificateur d'événement ID. &kalarm; détermine quelle action effectuer de la même façon que pour l'appel &DCOP; <link linkend="handleEvent"
>handleEvent()</link
>.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
><option
>--cancelEvent</option
>, <option
>--triggerEvent</option
> et <option
>--handleEvent</option
> sont mutuellement exclusifs. <option
>--calendarURL</option
> est optionnel, mais ne peut être utilisé qu'avec une des trois autres options.</para>

<para
>Voici des exemples&nbsp;:</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
>Questions et réponses</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Quels sont les fichiers de configuration utilisés par &kalarm;&nbsp;?</para>
</question>
<answer>
<para
>Le fichier <filename
>$KDEHOME/share/config/kalarmrc</filename
> contient vos préférences pour &kalarm;.</para>

<para
>Le fichier de calendrier qui stocke vos alarmes programmées est <filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
>, à moins qu'un autre fichier de calendrier n'ait été spécifié dans le fichier de configuration.</para>

<note
><para
>Si vous changez le fichier de calendrier dans le fichier de configuration, vous devrez également éditer le fichier de configuration <filename
>clients</filename
> du <application
>démon d'alarmes</application
> pour enlever les références de l'ancien fichier de calendrier. Ceci devrait être fait tandis que le <application
>démon d'alarmes</application
> ne fonctionne pas pour éviter d'écraser vos modifications.</para
></note>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Quels fichiers de configuration le <application
>démon d'alarmes</application
> utilise-t-il&nbsp;?</para>
</question>
<answer>
<para
>Le fichier <filename
>$KDEHOME/share/config/kalarmdrc</filename
> contient vos préférences du <application
>démon d'alarmes</application
>.</para>

<para
>Le fichier <filename
>$KDEHOME/share/apps/kalarmd/clients</filename
> contient les détails sur les applications clientes qui ont précédemment été inscrites avec le <application
>démon d'alarmes</application
>, et leurs fichiers de calendrier.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Quels sont les noms des applications de &kalarm; et du <application
>démon d'alarmes</application
>&nbsp;?</para>
</question>
<answer>
<para
>Le nom de l'application &kalarm; est <application
>kalarm</application
>, et le nom de l'application <application
>démon d'alarmes</application
> est <application
>kalarmd</application
>. De plus, dans les version de &kde; antérieures à 3.1, il y a une petite application <application
>kalarmautostart</application
> dont la fonction est de démarrer l'icône de &kalarm; dans la boîtes à miniatures dès la connexion.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Remerciements et licence</title>

<para
> &kalarm; </para>
<para
> Programme copyright 2001, 2002 David Jarvie <email
>software@astrojar.org.uk</email
> </para>
<para
> Auteurs du démon d'alarmes&nbsp;: <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
> Documentation copyright 2001, 2002 David Jarvie <email
>software@astrojar.org.uk</email
> </para>

<para
>Traduction française par &EricBischoff; et &LudovicGrossard;.</para>

<para
>Remerciements à l'auteur de l'application KAlarm pour &kde; 1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, qui a gentiment accepté que le nom &kalarm; soit utilisé par cette application &kde;2/&kde;3. </para>

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

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

</chapter>

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

<sect1 id="getting-kalarm">
<title
>Comment obtenir &kalarm;</title>

&install.intro.documentation;

<para
>&kalarm; est disponible pour &kde; 2 et comme paquetage indépendant pour &kde; 3 depuis <ulink url="http://www.astrojar.org.uk/linux"
>http://www.astrojar.org.uk/linux</ulink
> </para>

</sect1>

<sect1 id="requirements">
<title
>Configuration nécessaire</title>

<para
>&kalarm; nécessite que les librairies standards de &kde; soient installées (le paquetage <filename
>kdelibs</filename
>). Pour compiler à partir des sources, vous avez également besoin de &Qt; et des paquetages de développement de <filename
>kdelibs</filename
>.</para>

<para
>&kalarm; utilise environ 12&nbsp;Mo et le <application
>démon d'alarmes</application
> utilise environ 2,5&nbsp;Mo de mémoire pour fonctionner, mais ceci peut varier en fonction de votre plate-forme et de votre configuration.</para>

<para
>Vous pouvez trouver une liste des changements dans le fichier <filename
>ChangeLog</filename
> ou à <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
>Compilation et installation</title>

<para
>Si vous ne pouvez pas obtenir un paquetage de binaires précompilés adapté, vous devez compiler &kalarm; vous-même à partir des sources. Récupérez le paquetage contenant les sources <filename
>kdepim-x.x.tar.bz2</filename
> ou <filename
>kalarm-x.x.tar.bz2</filename
> (ou similaire), suivant que vous voulez installer &package; ou simplement &kalarm;. Décompactez-le dans un nouveau dossier en utilisant une commande similaire à <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>package.tar.bz2</replaceable
></option
></userinput
> et allez dans le dossier qui a été créé.</para>

&install.compile.documentation;

<note
><para
>Si vous avez plusieurs versions de &kde; installées (&pex; &kde;2 et &kde;3), il se peut que &kalarm; soit installé dans le mauvais dossier de &kde;. Si nécessaire, vous pouvez donner le dossier de &kde; comme paramètre de <userinput
><command
>./configure</command
></userinput
>. Par exemple, si votre &kde; est installé dans  <filename
>/opt/kde2</filename
>&nbsp;:</para
> <para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para
> </note>
</sect1>

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

<para
>Il n'y a pas de contraintes de configuration particulières pour paramétrer &kalarm; pour qu'il s'exécute dans l'environnement de bureau &kde;. Une fois que &kalarm; a été exécuté au moins une fois, le <application
>démon d'alarmes</application
> sera lancé chaque fois que vous vous connectez afin de surveiller les alarmes planifiées.</para>

<para
>Pour exécuter &kalarm; dans un environnement de bureau autre que &kde;, la contrainte principale est de s'assurer que le <application
>démon d'alarme</application
> se lance automatiquement chaque fois que vous vous connectez. Des instructions plus détaillées sont fournies dans le fichier <filename
>INSTALL</filename
> qui est distribué avec &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:
-->

