<?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 % Spanish "INCLUDE"
><!-- change language only here -->
]>

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

<book lang="&language;">

<bookinfo>
<title
>El manual 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>

<othercredit role="translator"
> <firstname
>Juan Manuel</firstname
> <surname
> García Molina</surname
> <affiliation
><address
><email
>juanma_gm@wanadoo.es</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit>

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

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2002-10-04</date>
<releaseinfo
>0.08.01</releaseinfo>

<abstract>
<para
>&kalarm; es un programa planificador de alarmas/mensajes y comandos para &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarma</keyword>
<keyword
>recordatorio</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Introducción</title>

<para
>&kalarm; es un programa de mensajes de alarma y planificador de comandos. Le permite configurar sus mensajes de alarma/recordatorio personales que se mostrarán en la pantalla a la hora que especifique, o puede configurar los comandos que serán ejecutados.</para>

<para
>En su modo gráfico predeterminado, &kalarm; muestra una lista de alarmas pendientes, mostrando sus horas y detalles. Puede crear alarmas nuevas o puede seleccionar las alarmas existentes para modificación o borrado.</para>

<para
>Al configurar o modificar una alarma, puede teclear el texto del mensaje de alarma, especificar un archivo de texto a mostrar o especificar un comando que ejecutar. También puede seleccionar el color del mensaje de alarma, si se repetirá, si reproducir un sonido y si se debe cancelar la alarma si no se puede disparar a la hora planificada.</para>

<para
>Las alarmas también pueden ser programadas desde la línea de comandos, o vía  llamadas a programas &DCOP;.</para>

<para
>Cuando cumple un mensaje de alarma, se muestra en cada escritorio de &kde; para asegurarse de que no los olvida. La ventana del mensaje muestra la hora para la que se programó la alarma. Normalmente tiene una opción de retrasar para pedir que la alarma se muestre de nuevo más tarde. Un ejemplo de un mensaje de alarma:</para>

<screenshot
> <screeninfo
>Captura de pantalla de &kalarm; ventana de mensaje</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="alarmmessage.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Mensaje de alarma</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Cuando la alarma especifica un comando a ejecutar, &kalarm; no muestra nada.</para>

<para
>&kalarm; puede corren en dos modos: <quote
>continuo</quote
> (el predeterminado) si corre desde la bandeja del sistema de &kde;, o <quote
>bajo demanda</quote
>, donde corre si se solicita (con la opción de mostrar un icono independiente en la bandeja del sistema).</para>

<para
>Este documento hace varias referencias al <application
>demonio de alarma</application
>. Esta es una aplicación que corre en segundo plano, comprobando las alarmas pendientes y diciéndole a &kalarm; que las muestre cuando sea necesario.</para>

</chapter>

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

<sect1 id="graphmode">
<title
>Modo gráfico</title>

<para
>Cuando corre sin parámetros de línea de comando, &kalarm; empieza en modo gráfico. Muestra la lista actual de alarmas pendientes, mostrando sus horas, intervalos de repetición, colores y textos de mensaje, nombres de archivos a mostrar o comandos a ejecutar. (Para una alarma recurrente, la hora mostrada es la hora de la siguiente activación planificada.) Un icono a la izquierda de cada texto/archivo/comando indica el tipo de alarma.</para>

<screenshot
> <screeninfo
>Captura de pantalla de la ventana principal de &kalarm;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Ventana principal</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Para una alarma repetida, la lista muestra si siguiente hora de activación planificada y el número de veces que se repetirá tras esta.</para>

<para
>Las alarmas pueden ordenarse por fecha/hora, intervalo de repetición, color o texto, haciendo clic en la barra de título de la columna adecuada. Para invertir el orden, haga clic de nuevo en la barra de título de la columna.</para>

<para
>Cuando &kalarm; se inicia en modo gráfico, comprueba si el <application
>demonio de alarma</application
> está corriendo. Si no está corriendo ya, &kalarm; lo inicia.</para>

<sect2>
<title
>Añadiendo una nueva alarma</title>

<para
>Para añadir una alarma nueva, seleccione <menuchoice
> <guimenu
>Acciones</guimenu
><guimenuitem
>Nuevo</guimenuitem
></menuchoice
>. Esto muestra el diálogo de edición de la alarma tal y como se describe debajo.</para>

</sect2>

<sect2>
<title
>Modificando una alarma existente</title>

<para
>Para modificar una alarma existente, haga una de las siguientes:</para>

<itemizedlist
> <listitem
> <para
>Doble clic en su entrada en la lista de alarmas.</para
> </listitem
> <listitem
> <para
>Selecciónelo haciendo clic en su entrada en la lista de la alarma. Luego seleccione <menuchoice
><guimenu
>Acciones</guimenu
> <guimenuitem
>Modificar</guimenuitem
></menuchoice
></para
> </listitem
> <listitem
> <para
>Clic <mousebutton
>derecho</mousebutton
> en su entrada en la lista dealarmas y seleccione <menuchoice
><guimenuitem
>Modificar</guimenuitem
></menuchoice
> del menú contextual.</para
> </listitem
> </itemizedlist>

<para
>Esto muestra el diálogo de edición de alarma:</para>

<screenshot
> <screeninfo
>Captura e pantalla del diálogo de edición de la alarma</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="editwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Diálogo de edición de alarma</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>En el grupo <guilabel
>Acción</guilabel
>, seleccione <guilabel
>Texto</guilabel
> para introducir el texto del mensaje (que puede incluir líneas nuevas) en la caja de edición, <guilabel
>Archivo</guilabel
> para introducir el nombre o &URL; de un archivo de texto cuyos contenidos mostrar en el mensaje de alarma o <guilabel
>Comando</guilabel
> para introducir un comando de la shell para ejecutar. Cuando se selecciona <guilabel
>Archivo</guilabel
>, el botón de la derecha se puede usar para mostrar un diálogo de selección de archivo.</para>

<para
>Si la alarma es una alarma recurrente y se retrasó tras la última vez que se mostró, el grupo <guilabel
>Alarma diferida</guilabel
> muestra la hora a la que fue retrasada la alarma. <guibutton
>Cambiar...</guibutton
> muestra un diálogo que le permite cambiar el tiempo diferido o cancelar el retraso.</para>

<para
>En el grupo <guilabel
>Hora</guilabel
>, seleccione</para>

<itemizedlist
> <listitem
> <para
><guilabel
>En fecha/hora</guilabel
> para introducir la fecha y hora en la que la alarma se activará. Marque <guilabel
>Cualquier hora</guilabel
> si quiere especificar sólo una fecha para la alarma: en este caso, la alarma se mostrará en la primera oportunidad o tras la hora de comienzo del día configurado de la fecha especificada. (<link linkend="preferences"
>Configurando las opciones predeterminadas</link
> describe cómo configurar la hora de comienzo del día.)</para
> </listitem
> <listitem
> <para
><guilabel
>Tiempo desde ahora</guilabel
> para introducir dentro de cuánto tiempo (en horas y minutos) se activará la alarma.</para
> </listitem
> </itemizedlist>

<para
>Especifique si o cómo se debe repetir en el grupo <guilabel
>Repetición</guilabel
>.</para>

<itemizedlist
> <listitem
><para
>Para activar la alarma sólo una vez, seleccione <guilabel
>Sin repetición</guilabel
></para
></listitem
> <listitem
><para
>Seleccione <guilabel
>Repetir al entrar</guilabel
> para activar la alarma cada vez que ingrese, hasta la hora programada. (Note que una alarma repetida al ingresar también se activará cada vez que active las alarmas o reinicie el <application
>demonio de alarma</application
>.)</para
></listitem
> <listitem
><para
>Seleccione <guilabel
>Recur</guilabel
> para activar la alarma a intervalos regulares. Debe especificar luego los parámetros de la recurrencia en la pestaña <guilabel
>Recurrencia</guilabel
>.</para
> <para
>En el cuadro <guilabel
>Regla de recurrencia</guilabel
>, fije el periodo de tiempo de recurrencia seleccionando uno de los tipos de periodos de tiempo e introduciéndolo en el cuadro <guilabel
>Repetir cada</guilabel
> cuántos periodos de tiempo deben transcurrir entre las recurrencias. Por ejemplo, para repetir cada quincena, debe seleccionar <guilabel
>Diario</guilabel
> e introducir un valor de 14, o seleccionar <guilabel
>Semanal</guilabel
> e introducir un valor de 2. Dependiendo del periodo de tiempo seleccionado, puede tener más opciones:</para
> <itemizedlist
> <listitem
> <para
>Para una recurrencia semanal, marque cada día de la semana en el que desee activar la alarma.</para
> </listitem
> <listitem
> <para
>Para una recurrencia mensual, puede seleccionar un día fijo o una posición (&eg; el segundo jueves).</para
> </listitem
> <listitem
> <para
>Para una recurrencia anual, puede seleccionar un día fijo del año o una posición de un mes (&eg; el último domingo de mayo).</para
> </listitem
> </itemizedlist
> <para
>En el cuadro <guilabel
>Fin de la recurrencia</guilabel
>, fije el tiempo de recurrencia total de la siguiente forma:</para
> <itemizedlist
> <listitem
><para
>Seleccione <guilabel
>Sin fin</guilabel
> para continuar las repeticiones indefinidamente.</para
></listitem
> <listitem
><para
>Seleccione <guilabel
>Acabar tras</guilabel
> para especificar el número total de ocurrencias de la alarma.</para
></listitem
> <listitem
><para
>Seleccione <guilabel
>Finalizar en</guilabel
> para especificar la fecha/hora hasta la que se repetirá la alarma.</para
></listitem
> </itemizedlist
> </listitem
> </itemizedlist>

<para
>El cuadro <guilabel
>Cancelar si es tarde</guilabel
> determina qué ocurre si la alarma no se puede activar en su hora planificada. Marque esta caja para cancelar la alarma si no puede ser activada en el minuto siguiente de la hora correcta. Deje el cuadro sin marcar para activar la alarma en la primera oportunidad al iniciar la hora planificada. Para alarmas de sólo fecha, &ie; para las que está seleccionada la opción <guilabel
>Cualquier hora</guilabel
>, se cancelará si no se puede mostrar en 24 horas de la hora de comienzo del día de la fecha programada.</para>

<note
><para
>Una alarma sólo se puede activar cuando está dentro y mientras tanto X como el <application
>demonio de alarma</application
> estén corriendo.</para
></note>

<para
>El cuadro de verificación <guilabel
>Confirmar asentimiento</guilabel
> le permite especificar si se le pedirá confirmación cuando cierre la ventana del mensaje de alarma. Esto se puede usar como método de seguridad contra asentimiento accidental de alarmas.</para>

<para
>Marque <guilabel
>Sonido</guilabel
> si quiere que suene una alarma audible cuando se muestre el mensaje de alarma. Por defecto, suena un pitido; use el botón de la derecha para seleccionar el archivo de sonido que reproducir. Para volver a escuchar un pitido, haga clic en el botón de nuevo. Para oír cómo suena su selección actual, lleve el ratón sobre el botón hasta que aparezca un consejo.</para>

<para
>Seleccione el color de fondo para la ventana del mensaje de alarma.</para>

<para
>Presione el botón <guibutton
>Aceptar</guibutton
> cuando todos los detalles estén correctos, para añadir la alarma a la lista programada.</para>

</sect2>

<sect2>
<title
>Borrar una alarma existente</title>

<para
>Para borrar una alarma existente, haga una cosa de las siguientes:</para>

<itemizedlist
> <listitem
> <para
>Selecciónelo haciendo clic en su entrada en la lista de alarma. Luego seleccione <menuchoice
> <guimenu
>Acciones</guimenu
><guimenuitem
>Borrar</guimenuitem
> </menuchoice
>.</para
> </listitem
> <listitem
> <para
>Clic <mousebutton
>derecho</mousebutton
> en su entrada en la lista de alarmas y seleccione <menuchoice
><guimenuitem
>Borrar</guimenuitem
></menuchoice
> del menú contextual.</para
> </listitem
> </itemizedlist>

</sect2>

<sect2>
<title
>Aceptando una alarma</title>

<para
>Vea <link linkend="message-window"
>Ventana de mensaje de alarma</link
> para saber cómo confirmar las alarmas.</para>

</sect2>

<sect2>
<title
>Mostrando &kalarm; en la bandeja del sistema</title>

<para
>Debe estar corriendo el escritorio &kde; para mostrar &kalarm; en la bandeja del sistema. Si &kalarm; está corriendo en modo <quote
>continuo</quote
>, el icono de la bandeja del sistema siempre se detecta. Estas instrucciones tienen validez sólo para el modo <quote
>bajo demanda</quote
>. (Vea <link linkend="preferences"
>Configurando las opciones predeterminadas</link
> para una descripción de los modos de ejecución.)</para>

<para
>Para mostrar &kalarm; en la bandeja del sistema de &kde;, seleccione <menuchoice
> <guimenu
>Ver</guimenu
><guimenuitem
>Mostrar en la bandeja del sistema</guimenuitem
> </menuchoice
>.</para>

<para
>Para borrar &kalarm; de la bandeja del sistema de &kde;, haga una de las siguientes cosas:</para>

<itemizedlist
> <listitem
> <para
>Seleccione <menuchoice
><guimenu
>Vista</guimenu
> <guimenuitem
> Ocultar de la bandeja del sistema</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Clic <mousebutton
>derecho</mousebutton
> en el icono de la bandeja del sistema y seleccione <menuchoice
><guimenuitem
>Salir</guimenuitem
></menuchoice
> del menú contextual.</para
> </listitem
> </itemizedlist>

<para
>El uso del icono de la bandeja del sistema se describe <link linkend="system-tray"
>abajo</link
>.</para>

</sect2>

<sect2 id="enable-disable">
<title
>Activando/desactivando el monitoreo de alarma</title>

<sect3>
<title
>Activar el monitoreo de alarma</title>

<para
>Primero, si el modo de ejecución de &kalarm; es <quote
>continuo</quote
> y ha seleccionado <guilabel
>Desactivar alarmas cuando no esté corriendo</guilabel
> en el diálogo de Preferencias, debe asegurarse de que &kalarm; está corriendo para que el monitoreo de alarma ocurra.</para>

<para
>Entonces si el monitoreo de alarma está desactivado actualmente, haga una de las siguientes cosas:</para>

<itemizedlist
> <listitem
> <para
>Seleccione <menuchoice
><guimenu
>Acciones</guimenu
> <guimenuitem
>Activar alarmas</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Clic <mousebutton
>derecho</mousebutton
> en el icono de la bandeja del sistema y seleccione <menuchoice
><guimenuitem
>Activar alarmas</guimenuitem
></menuchoice
> del menú contextual.</para
> </listitem
> </itemizedlist>

<para
>El <application
>demonio de alarma</application
> se inicia si es necesario y las alarmas se monitorizarán cuando sea necesario.</para>

<warning
><para
>Iniciar el <application
>demonio de alarma</application
> afectará a cualquier otra aplicación que use el <application
>demonio de alarma</application
>.</para
></warning>

</sect3>

<sect3>
<title
>Desactivando el monitoreo de alarma</title>

<para
>Hay varias formas de desactivar la monitorización de la alarma, lo que evita que &kalarm; muestre más alarmas tanto si reactiva las alarmas como si asume que el <application
>demonio de alarma</application
> está configurado para comenzar al ingresar - hasta la próxima vez que ingrese.</para>

<para
>Para desactivar las alarmas sin detener el <application
>demonio de alarma</application
> (y por lo tanto sin verse afectada por ninguna otra aplicación que use el <application
>demonio de alarma</application
>, haga una de las siguientes cosas:</para>

<itemizedlist
> <listitem
> <para
>Seleccione <menuchoice
><guimenu
>Acciones</guimenu
> <guimenuitem
>Alarmas activadas</guimenuitem
></menuchoice
>.</para
> </listitem
> <listitem
> <para
>Clic <mousebutton
>derecho</mousebutton
> en el icono de la bandeja del sistema y seleccione <menuchoice
><guimenuitem
>Alarmas activadas</guimenuitem
></menuchoice
> del menú de contexto.</para
> </listitem
> <listitem
> <para
>Si el modo de ejecución de &kalarm; es <quote
>continuo</quote
> y tiene seleccionado <guilabel
>Desactivar alarmas mientras no esté corriendo</guilabel
> en el diálogo de Preferencias, salga de &kalarm;.</para
> </listitem
> </itemizedlist>

<para
>Para desactivar las alarmas, detenga el <application
>demonio de alarma</application
></para>

<itemizedlist
> <listitem
> <para
>Seleccione <menuchoice
><guimenu
>Configuración</guimenu
> <guimenuitem
>Demonio de control de alarma...</guimenuitem
></menuchoice
>. Esto muestra el diálogo de gestor de servicio que le permite detener el <application
>demonio de alarma</application
> </para
> </listitem
> </itemizedlist>

<warning
><para
>Esto afectará a cualquier otra aplicación que use el <application
>demonio de alarma</application
>.</para
></warning>

</sect3>
</sect2>

<sect2>
<title
>Refrescando las alarmas</title>

<para
>En el caso de que cualquier alarma no se active cuando debiera, puede refrescar la lista de alarmas y activar cualesquiera alarmas perdidas seleccionando <menuchoice
> <guimenu
>Acciones</guimenu
><guimenuitem
>Refrescar alarmas</guimenuitem
> </menuchoice
>.</para>

<para
>&kalarm; reactiva las alarmas perdidas al reiniciar el<application
>demonio de alarma</application
>, lo que se discute en la sección <link linkend="daemon-reset"
>Demonio de alarma</link
> section.</para>

</sect2>

<sect2>
<title
>Controlar el <application
>demonio de alarma</application
></title>

<para
>Para controlar el <application
>demonio de alarma</application
>, seleccione <menuchoice
><guimenu
>Configuración</guimenu
> <guimenuitem
>Controlar el demonio de alarma...</guimenuitem
></menuchoice
>. Esto muestra el diálogo del gestor de servicio del <application
>demonio de alarma</application
> y configura si corre automáticamente al ingresar. Vea <link linkend="daemon-control"
>Controlar el demonio de alarma con el gestor de servicio</link
> para más detalles.</para>

</sect2>

<sect2>
<title
>Saliendo del programa</title>

<para
>Salga de &kalarm; cerrando todas sus ventanas y el icono de la bandeja del sistema o si está corriendo en modo <quote
>continuo</quote
> cerrando cualesquiera ventanas de mensaje y seleccionando <menuchoice
><guimenuitem
>Salir</guimenuitem
></menuchoice
> en el menú de contexto del icono de la bandeja del sistema.</para>

<para
><menuchoice
><guimenu
>Archivo</guimenu
><guimenuitem
>Salir</guimenuitem
> </menuchoice
> cierra sólo las ventanas implicadas. El efecto del elemento del menú de contexto del icono de la bandeja del sistema <menuchoice
><guimenuitem
>Salir</guimenuitem
></menuchoice
> depende del modo de ejecución: en modo <quote
>bajo demanda</quote
> oculta el icono de la bandeja del sistema, mientras que en modo <quote
>continuo</quote
> sale del programa.</para>

<tip
><para
>Salir de &kalarm; no tiene efecto en el <application
>demonio de alarma</application
>, que si ya está activo continuará monitorizando las alarmas programadas y solicitando su muestra cuando sea necesario (a no ser que haya seleccionado <guilabel
>Desactivar alarmas mientras no estécorriendo</guilabel
> en el diálogo de Preferencias).</para
></tip>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Ventana de mensaje de alarma</title>

<para
>Cuando cumple un mensaje de alarma, se muestra en cada escritorio de &kde; para asegurarse de que lo ve. La ventana del mensaje muestra la hora para la que se programó la alarma, lo que puede ser útil para saber si se mostró tarde o si estaba lejos del computador cuando surgió.</para>

<para
>Si se trata de una alarma repetida, si permanece una ventana de mensaje sin confirmar de una ocurrencia previa de la alarma, la ventana existente simplemente vuelve a surgir cuando vuelva a ocurrir la alarma. Esto evita tener que reconocer múltiples copias del mismo mensaje que no desea, o ser incapaz de confirmar un mensaje a la vez que aparece.</para>

<para
>Cuando se muestra una ventan de mensaje, haga una de las cosas siguientes:</para>

<itemizedlist
> <listitem
> <para
>Asienta haciendo clic en el botón <guibutton
>Cerrar</guibutton
>. Esto cierra la ventana (tras pedirle confirmación, si seleccionó <guilabel
>Confirmar asentimiento</guilabel
>).</para
> </listitem
> <listitem
> <para
>Muestra las opciones para retrasar la alarma haciendo clic en el botón <guibutton
>Retrasar...</guibutton
> button. Luego seleccione <guilabel
>Retrasar a fecha/hora</guilabel
> para introducir la fehca y hora para que el mensaje se vuelva a mostrar o seleccione <guilabel
>Retrasar un intervalo de tiempo</guilabel
> para introducir dentro de cuánto tiempo (en horas y minutos) se debe volver a mostrar el mensaje. Luego haga clic en <guibutton
>Retrasar</guibutton
> para posponer el mensaje de alarma.</para
> <note
><para
>Si la alarma recurre regularmente, el tiempo por el que se retrasa debe transcurrir antes de la siguiente repetición planificada.</para
></note
> <note
><para
>El botón <guibutton
>Retrasar...</guibutton
> no está disponible para las alarmas que se muestran al ingresar debido a que la opción <guilabel
>Repetir al ingresar</guilabel
> tiene que estar seleccionada.</para
></note
> </listitem
> </itemizedlist>

<para
>El botón con el icono de <guiicon
>&kalarm;</guiicon
> proporciona una forma adecuada de activar &kalarm;. Hacer clic en él no tiene efecto en la ventana de mensaje de alarma.</para>

</sect1>

<sect1 id="system-tray">
<title
>Icono de la bandeja del sistema</title>

<para
>&kalarm; puede correr como un icono en la bandeja del sistema de &kde;. Este icono permite la activación con un clic de &kalarm;, y proporciona tanto indicación de control como de estado de la monitorización de alarma. Un icono normal de &kalarm; indica que las alarmas están siendo monitorizadas, mientras que una cruz roja encima del icono indica que las alarmas no están siendo monitorizadas.</para>

<para
>Clic <mousebutton
>izquierdo</mousebutton
> en el icono de la bandeja del sistema para cambiar entre mostrar y ocultar la ventana principal de &kalarm;.</para>

<para
>Clic <mousebutton
>derecho</mousebutton
> en el icono de la bandeja del sistema para mostrar su menú de contexto:</para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Activar alarmas</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Activar monitorización de alarmas.</action
></para
> <para
>Vea <link linkend="enable-disable"
>Activando/desactivando la monitorización de alarmas</link
> para más detalles.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Alarmas activadas</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Desactiva la monitorización de alarmas.</action
></para
> <para
>Vea <link linkend="enable-disable"
>Activando/desactivando la monitorización de alarmas</link
> para más detalles.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Configurar &kalarm;...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Muestra el diálogo de preferencias de &kalarm;.</action
></para
> <para
>El diálogo de preferencias se describe en <link linkend="preferences"
>Configurando las opciones predeterminadas</link
>. Incluye opciones relativas al icono de la bandeja del sistema de &kalarm;.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Controlar el demonio de alarma...</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Muestra el diálogo del gestor de servicio que le permite controlar el demonio de alarma.</action
></para
> <para
>Vea <link linkend="enable-disable"
>Controlar el demonio de alarma con el gestor de servicio</link
> para más detalles.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Restaurar / Minimizar</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Restaura o minimiza la ventana principal de &kalarm;.</action
></para
> <para
>Esta opción sólo está disponible si el modo de ejecución es <quote
>continuo</quote
>. (Vea <link linkend="preferences"
>Configurando las opciones predeterminadas</link
> para una descripción de los modos de ejecución.)</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Salir</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Cierra el icono de la bandeja de &kalarm;.</action
></para
> <para
>En modo de ejecución <quote
>continuo</quote
> sólo, también cierra todas las ventanas principales de &kalarm;. No tiene efecto sobre la monitorización de alarmas por el <application
>demonio de alarma</application
> (a no ser que haya seleccionado <guilabel
>Desactivar alarmas mientras no esté corriendo</guilabel
> en el diálogo de Preferencias).</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="preferences">
<title
>Configurando las opciones predeterminadas</title>

<para
>Para fijar las opciones predeterminadas para &kalarm;, seleccione <menuchoice
><guimenu
>Configuración</guimenu
> <guimenuitem
>Configurar &kalarm;...</guimenuitem
></menuchoice
>. Esto muestra el diálogo de configuración. La sección <guilabel
>General</guilabel
> le permite controlar el comportamiento global de &kalarm;:</para>

<itemizedlist
> <listitem
><para
>Especificar el modo de ejecución de &kalarm;. Puede seleccionar que corra continuamente en la bandeja del sistema de &kde; o que corra sólo bajo demanda. Esta selección no afecta a la muestra de alarmas cuando ocurran, ya que es el <application
>demonio de alarma</application
> y no &kalarm; quien monitoriza la lista de alarmas. Correr &kalarm; en la bandeja del sistema hace la aplicación más accesible y muestra una indicación de activación de alarmas, pero correr una aplicación continuamente consume algunos recursos del sistema. Así que si el rendimiento de su sistema se be comprometido, puede ser preferible la opción <quote
>bajo demanda</quote
>.</para
> <para
>Al correr en modo <quote
>bajo demanda</quote
>, el icono de la bandeja del sistema puede mostrarse aún. La diferencia principal entre la operación de los dos modos es el efecto de cerrar el icono de la bandeja del sistema:en modo <quote
>bajo demanda</quote
>, cerrarlo no tiene efecto sobre ninguna ventana de &kalarm;, mientras que en modo <quote
>continuo</quote
>, cerrarlo también cierra todas las ventanas principales de &kalarm;.</para
> </listitem
> <listitem
><para
>Si especificó que &kalarm; debe correr en modo <quote
>continuo</quote
>, puede desactivar todas las alarmas debido a que se muestra mientras que &kalarm; no esté corriendo.</para
> </listitem
> <listitem
><para
>Especifique que el icono de la bandeja del sistema de &kalarm; deba mostrarse al ingresar en la sesión de &kde;.</para
> </listitem
> <listitem
><para
>Fije la frecuencia en la que el icono de la bandeja del sistema de &kalarm; se actualice para reflejar si las alarmas están siendo monitorizadas. Esto implica comprobar si el <application
>demonio de alarma</application
> está corriendo.</para
> </listitem
> <listitem
><para
>Fije la hora de inicio del día para los propósitos de activar alarmas sólo por fecha, &ie; aquellos para los que se selección la opción <guilabel
>Cualquier hora</guilabel
>. En la fecha en las que fueron programadas, tales alarmas se mostrarán lo más temprano posible -en la primera oportunidad- durante las 24 horas comenzando desde la hora de inicio del día.</para
> </listitem
> <listitem
><para
>Especifique si se le debe pedir confirmación cada vez que borra una alarma.</para
> </listitem
> </itemizedlist>

<para
>Las secciones <guilabel
>Predeterminados de alarma</guilabel
> y <guilabel
>Apariencia</guilabel
> le permiten elegir los valores predeterminados para las opciones del diálogo de edición de alarma:</para>
<itemizedlist
> <listitem
><para
>Fije la tipografía predeterminada y el color del fondo que usar para mostrar un mensaje de alarma.</para
> </listitem
> <listitem
><para
>Fije los estados predeterminados para los cuadros de verificación <guilabel
>Cancelar si es tarde</guilabel
> y <guilabel
>Confirmar asentimiento</guilabel
>.</para
> </listitem
> <listitem
><para
>Fija el bip como el predeterminado para la opción <guilabel
>Sonido</guilabel
>.</para
> </listitem
> <listitem
><para
>Fija la recurrencia predeterminada de las alarmas recurrentes.</para
> </listitem
> </itemizedlist>

</sect1>

<sect1 id="cmdline-operation">
<title
>Operación de la línea de comandos</title>

<para
>Cuando se suministras parámetros de la línea de comandos, &kalarm; no muestra la lista de alarmas planificadas como se describe en el <link linkend="graphmode"
>Modo gráfico</link
> de arriba. Las opciones de la línea de comandos específicas para &kalarm; se pueden usar para realizar las siguientes operaciones:</para>

<itemizedlist
> <listitem
><para
>planificar una alarma nueva</para
> </listitem
> <listitem
><para
>controlar el <application
>demonio de alarma</application
></para
> </listitem
> <listitem
><para
>controlar el modo de muestra de &kalarm;</para
> </listitem
> <listitem
><para
>obtener ayuda</para
> </listitem
> </itemizedlist>

<para
>Se proporcionan opciones de la línea de comando adicionales principalmente para activar el interfaz de &kalarm; para otros programas. Se describen en el capítulo <link linkend="cmdline-interface"
>Guía del desarrollador de &kalarm;</link
>.</para>

<para
>La línea de comando sólo debe contener opciones aplicables a una operación de &kalarm;. Si quiere realizar múltiples operaciones, debe invocar a &kalarm; múltiples veces con un sólo juego de opciones cada vez.</para>

<sect2 id="cmdline-schedule">
<title
>Planificar una nueva alarma</title>

<para
>Las opciones siguientes se usan para planificar una alarma nueva:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Opción</entry
> <entry
>Descripción</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry
> <entry
>Pide confirmación cuando se asiente el mensaje de alarma.</entry
> </row
> <row
> <entry
><option
>-b</option
>, <option
>--beep</option
></entry
> <entry
>Hace un pitido audible cuando el mensaje se muestre. <option
>--sound</option
> no debe estar presente si se especifica esta opción.</entry
> </row
> <row
> <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>color</replaceable
></option
></entry
> <entry
>Fija el color de fondo del mensaje al nombre de color de &Qt; especificado o al código hexadecimal 0xRRGGBB.</entry
> </row
> <row
> <entry
><option
>-e</option
>, <option
>--exec <replaceable
>línea de comando</replaceable
></option
></entry
> <entry
>Especifique un comando de shell a ejecutar. Si se especificó, esta opción deber ser la última opción de &kalarm; en la línea de comando de &kalarm;. Todos los parámetros de comando subsecuentes y opciones se interpretan como formantes de la línea de comando a ejecutar. <option
>--file</option
> no se puede especificar con esta opción. <option
>--ack-confirm</option
>, <option
>--beep</option
> y <option
>--color</option
> se ignoran con esta opción.</entry
> </row
> <row
> <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry
> <entry
>Especifique el nombre o &URL; de un archivo de texto cuyos contenidos van a formar el mensaje de alarma. El <replaceable
>mensaje</replaceable
> no debe estar presente si se especifica esta opción.</entry
> </row
> <row
> <entry
><option
>-i</option
>, <option
>--interval <replaceable
>periodo</replaceable
></option
></entry
> <entry
>Fija el intervalo entre repeticiones de la alarma. Horas/minutos se especifican en el formato <replaceable
>nHnM</replaceable
>, donde <replaceable
>n</replaceable
> es un número, &eg; 3H30M. Otros periodos de tiempo se especifican en el formato <replaceable
>nX</replaceable
>, donde <replaceable
>n</replaceable
> es un número y <replaceable
>X</replaceable
> es una de las letras siguientes: Y (años), M (meses), W (semanas), D (días). Obligatorio si se especifica la opción <option
>--repeat</option
> o <option
>--until</option
>.</entry
> </row
> <row
> <entry
><option
>-l</option
>, <option
>--late-cancel</option
></entry
> <entry
>Cancelar la alarma si no se puede activar a la hora correcta.</entry
> </row
> <row
> <entry
><option
>-L</option
>, <option
>--login</option
></entry
> <entry
>Activar la alarma cada vez que ingrese. <option
>--interval</option
>, <option
>--repeat</option
> y <option
>--until</option
> no se pueden especificar con esta opción.</entry
> </row
> <row
> <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>contador</replaceable
></option
></entry
> <entry
>el número de veces que se debe activar la alarma. Especifique -1 para repetir la alarma indefinidamente. <option
>--interval</option
> se puede especificar con esta opción, y <option
>--until</option
> no se puede especificar.</entry
> </row
> <row
> <entry
><option
>-s</option
>, <option
>--sound <replaceable
>URL</replaceable
></option
></entry
> <entry
>Especifique el nombre o &URL; de un archivo de audio que reproducir cuando se muestre el mensaje de alarma. <option
>--beep</option
> no debe estar presente.si esta opción se especifica.</entry
> </row
> <row
> <entry
><option
>-t</option
>, <option
>--time <replaceable
>fecha/hora</replaceable
></option
></entry
> <entry
>Disparar la alarma en la fecha o en la fecha/hora especificada. Especifique una fecha sin hora con el formato <replaceable
>aaaa-mm-dd</replaceable
>; especifique una fecha y hora con <replaceable
>[[[aaaa-]mm-]dd-]hh:mm</replaceable
> (cuando se omiten, los campos de fecha predeterminados son los valores para hoy).</entry
> </row
> <row
> <entry
><option
>-u</option
>, <option
>--until <replaceable
>fecha/hora</replaceable
></option
></entry
> <entry
>Repite la alarma hasta la fecha o fecha/hora especificada. Especifique una fecha sin una hora con el mismo formato que para <option
>--time</option
>. <option
>--interval</option
> puede estar con esta opción y<option
>--repeat</option
> no se puede especificar con esta opción.</entry
> </row
> <row
> <entry
><replaceable
>mensaje</replaceable
></entry
> <entry
>Próximo mensaje a mostrar.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Se debe especificar o el texto de un mensaje, o <option
>--file</option
> o <option
>--exec</option
>; salvo si se indica como arriba, todas las opciones son opcionales.</para>

<para
>Dos ejemplos distintos que muestran un mensaje con múltiples líneas con un fondo rojo a las 10 p.m. el día 27 de este mes son:</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
>"Remember to\nSTOP"</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
>"Remember to\nSTOP"</replaceable
></option
></userinput>
</screen
> </informalexample>

</sect2>

<sect2>
<title
>Otras opciones</title>

<para
>Las siguientes opciones se usan para reiniciar o terminar el <application
>demonio de alarma</application
> o para controlar el modo de muestra de &kalarm;.</para>

<para
>Vea la sección <link linkend="daemon-reset"
>Demonio de alarma</link
> para una discusión sobre el reinicio y la parada del <application
>demonio de la aplicación</application
>.</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Opción</entry
> <entry
>Descripción</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--reset</option
></entry
> <entry
>Reinicia el <application
>demonio de alarma</application
>.</entry
> </row
> <row
> <entry
><option
>--stop</option
></entry
> <entry
>Detiene el <application
>demonio de alarma</application
>.</entry
> </row
> <row
> <entry
><option
>--tray</option
></entry
> <entry
>Muestra &kalarm; como un icono en la bandeja del sistema de &kde;.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
>Por ejemplo, para reiniciar el <application
>demonio de alarma</application
>:</para>

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

</sect2>

<sect2>
<title
>Opciones de ayuda</title>

<para
>Las siguientes opciones de ayuda con comunes a todos los programas de &kde;:</para>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Opción</entry
> <entry
>Descripción</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--help</option
></entry
> <entry
>Muestra un texto de ayuda breve con las opciones.</entry
> </row
> <row
> <entry
><option
>--help-qt</option
></entry
> <entry
>Muestra numerosas opciones generales propias de &Qt;.</entry
> </row
> <row
> <entry
><option
>--help-kde</option
></entry
> <entry
>Muestra numerosas opciones generales propias de &kde;.</entry
> </row
> <row
> <entry
><option
>--help-all</option
></entry
> <entry
>Muestra todas las opciones.</entry
> </row
> <row
> <entry
><option
>--author</option
></entry
> <entry
>Muestra los nombres y direcciones de correo de los autores de &kalarm;.</entry
> </row
> <row
> <entry
><option
>-v</option
>, <option
>--version</option
></entry
> <entry
>Muestra las versiones que están corriendo de la biblioteca &Qt;, &kde; y &kalarm;.</entry
> </row
> <row
> <entry
><option
>--license</option
></entry
> <entry
>Muestra información sobre la licencia.</entry
> </row
> </tbody>
</tgroup>
</informaltable>

</sect2>
</sect1>

<sect1 id="daemon">
<title
>Demonio de alarma</title>

<para
>El <application
>demonio de alarma</application
>, &kalarmd;, monitoriza el archivo de calendario de &kalarm; para alarmas pendiente. Cuando determina que hay una alarma pendiente, le dice a &kalarm; que la muestre o la ejecute o la cancele si ya es tarde y no se selección el aviso tardío para esta alarma.</para>

<para
>En &kde;3, el <application
>demonio de alarma</application
> también puede ser usado por otras aplicaciones, incluyendo KOrganizer.</para>

<para
>El <application
>demonio de alarma</application
> corre en segundo plano, sin interfaz de usuario. Se puede controlar como se describe abajo.</para>

<sect2>
<title
>Iniciando, reiniciando y deteniendo el <application
>demonio de alarma</application
></title>

<para
>El <application
>demonio de alarma</application
> se inicia normalmente al entrar en la sesión de &kde; (a no ser que use el diálogo del gestor de servicio para desactivar el inicio automátio), y corre continuamente hasta la salida -logout-. Si por cualquier motivo no está corriendo, la monitorización de la alarma no ocurrirá y &kalarm; no mostrará ni ejecutará alarmas.</para>

<sect3>
<title
>Iniciando el <application
>demonio de alarma</application
></title>

<para
>Para iniciar el <application
>demonio de alarma</application
>, puede o bien correr &kalarm; en su modo gráfico predeterminado (&ie; sin ningún parámetro en la línea de comando), activar las alarmas usando el menú de la bandeja del sistema de &kalarm;, reiniciar el demonio como se describe <link linkend="daemon-reset"
>abajo</link
>, iniciarlo usando el diálogo del gestor de servicio (vea <link linkend="daemon-control"
>Controlar el demonio de alarma con el gestor de servicio</link
>)  o puede correr el <application
>demonio de alarma</application
> directamente desde la línea de comando:</para>

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

</sect3>

<sect3 id="daemon-reset">
<title
>Reiniciando el <application
>demonio de alarma</application
></title>

<para
>También es posible reiniciar el <application
>demonio de alarma</application
> sin detenerlo. Reinciarlo causa que el <application
>demonio de alarma</application
> vuelva a leer la lista de mensajes programados del archivo de calendario y reinicie sus datos relativos a &kalarm;.</para>

<para
>¿Por qué debe querer resetear el <application
>demonio de alarma</application
>? No es una ocurrencia demasiado buena, pero si por cualquier motivo &kalarm; no pudo correr cuando el <application
>demonio de alarma</application
> le dijo que activara una alarma, esa alarma nunca se mostraría o se ejecutaría hasta que el <application
>demonio de alarma</application
> se reiniciara o se reseteara. Es preferible resetear para detener el <application
>demonio de alarma</application
> y reiniciarlo, ya que resetear el demonio no afectará a ninguna otra aplicación que sue el <application
>demonio de alarma</application
>.</para>

<tip
><para
>Resetear inicia el <application
>demonio de alarma</application
> si no está corriendo actualmente.</para
></tip>

<para
>Para reiniciar el <application
>demonio de alarma</application
>, use el comando del menú <menuchoice
> <guimenu
>Acciones</guimenu
><guimenuitem
>Refrescar alarmas</guimenuitem
> </menuchoice
> o teclee el siguiente comando:</para>

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

</sect3>

<sect3>
<title
>Deteniendo el <application
>demonio de alarma</application
></title>

<para
>Detener el <application
>demonio de alarma</application
> evitará cualquier próxima monitorización de mensajes de alarma planificados hasta que el demonio se reinicie.</para>

<warning
><para
>Detenerlo afectará al funcionamiento de cualquier otra aplicación que también use el <application
>demonio de alarma</application
>. Considere resetear el demonio en su lugar.</para
></warning>

<para
>Para detener el <application
>demonio de alarma</application
>, use o bien el diálogo del gestor de servicio (vea <link linkend="daemon-control"
>Controlar el demonio de alarma con el gestor de servicio</link
>), o teclee el siguiente comando:</para>

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

</sect2>

<sect2 id="daemon-control">
<title
>Controlar el <application
>demonio de alarma</application
> con el gestor de servicio</title>

<para
>El diálogo de gestor de servicio le permite configurar y controlar el <application
>demonio de alarma</application
>. Puede:</para>

<itemizedlist
> <listitem
> <para
>Configure si corre automáticamente al ingresar.</para
> <warning
><para
>Si ni la aplicación del <application
>demonio de alarma</application
> ni &kalarm; están configurados para correr al ingresar, la monitorización de alarma no ocurrirá y &kalarm; no mostrará ni ejecutará ninguna alarma.</para
></warning
> </listitem
> <listitem
> <para
>Detiene e inicia el <application
>demonio de alarma</application
>.</para
> <warning
><para
>Iniciar o detener el <application
>demonio de alarma</application
> afectará a cualquier otra aplicación que use el <application
>demonio de alarma</application
>.</para
></warning
> </listitem
> </itemizedlist>

<para
>Al diálogo de gestión de servicio se puede acceder bien vía la opción del menú <menuchoice
><guimenu
>Preferencias</guimenu
> <guimenuitem
>Demonio de control de alarma...</guimenuitem
></menuchoice
>, o vía el Centro de control de &kde;.</para>

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

<chapter id="developers">
<title
>Guía del desarrollador de &kalarm;</title>

<para
>&kalarm; proporciona un interfaz para permitir que otras aplicaciones soliciten las siguientes funciones:</para>

<itemizedlist
> <listitem
><para
>planificar una alarma nueva</para
></listitem
> <listitem
><para
>activar o cancelar una alarma ya planificada</para
></listitem
> <listitem
><para
>cancelar una alarma ya planificada</para
></listitem
> <listitem
><para
>activar una alarma ya planificada</para
></listitem
> </itemizedlist>

<para
>Cada una de las llamadas de arriba se implementan tanto por una llamada &DCOP; como por la línea de comando. Las llamadas &DCOP; se deberían usar preferentemente si &kalarm; ya está corriendo.</para>

<sect1 id="dcop-interface">
<title
>interfaz de &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
>archivoCalendario</replaceable
>, const QString&amp; <replaceable
>IDevento</replaceable
>)
</synopsis>

<refsect2>
<title
>Parámetros</title>
<variablelist
> <varlistentry
> <term
><parameter
>archivoCalendario</parameter
></term
> <listitem
> <para
>Especifica la &URL; del archivo de calendario que contiene el evento que va a ser cancelado.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>IDevento</parameter
></term
> <listitem
> <para
>Especifica el ID único del evento que va a ser cancelado, como está guardado en <replaceable
>archivoCalendario</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>

<para
><function
>cancelEvent()</function
> es una llamada &DCOP; para cancelar la alarma especificada. &kalarm; borra la alarma del archivo de calendario sin mostrarla o ejecutarla.</para>

<note
><para
>El parámetro <replaceable
>archivoCalendario</replaceable
> sólo se usa para comprobación de integridad: si la &URL; no especifica el archivo de calendario predeterminado actual de &kalarm;, la petición se ignora.</para
></note>

<note
><para
>El viejo nombre para esta función, <function
>cancelMessage</function
>, se ha mantenido para compatibilidad, pero todas las aplicaciones nuevas deberían usar <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
>archivoCalendario</replaceable
>, const QString&amp; <replaceable
>IDevento</replaceable
>)
</synopsis>

<refsect2>
<title
>Parámetros</title>
<variablelist
> <varlistentry
> <term
><parameter
>archivoCalendario</parameter
></term
> <listitem
> <para
>Especifica la &URL; del archivo de calendario que contiene el evento que va a ser activado.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>IDevento</parameter
></term
> <listitem
> <para
>Especifica el ID único del evento que va a ser disparado, tal y como está guardado en el <replaceable
>archivoCalendario</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>

<para
><function
>triggerEvent()</function
> es una llamada &DCOP; para activar la muestra inmediata o la ejecución de la alarma especificada (sin importar la hora para la que estaba planificada). &kalarm; recupera la alarma del archivo de calendario y luego la muestra o la ejecuta.</para>

<para
>Si la alarma ya está lista, &kalarm; borra luego todas las ocurrencias planificadas de la alarma hasta la hora actual, y si no restan repeticiones de la alarma, la alarma se borra del archivo de calendario. Si la alarma no está lista aún, sus ocurrencias planificadas permanecen sin cambios.</para>

<note
><para
>El parámetro <replaceable
>archivoCalendario</replaceable
> sólo se usa para comprobación de integridad: si la &URL; no especifica el archivo de calendario predeterminado actual de &kalarm;, la petición se ignora.</para
></note>

<note
><para
>El nombre viejo para esta función, <function
>displayMessage</function
>, se ha mantenido para compatibilidad, pero todas las aplicaciones nuevas deberían usar <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
>archivoCalendario</replaceable
>, const QString&amp; <replaceable
>IDevento</replaceable
>)
</synopsis>

<refsect2>
<title
>Parámetros</title>
<variablelist
> <varlistentry
> <term
><parameter
>archivoCalendario</parameter
></term
> <listitem
> <para
>Especifica la &URL; del archivo de calendario que contiene el evento que se muestra/ejecuta o cancela.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>IDevento</parameter
></term
> <listitem
> <para
>Especifica el ID único del evento que se muestra/ejecuta o cancela, tal y como está grabado en <replaceable
>archivoCalendario</replaceable
>.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>

<para
><function
>handleEvent()</function
> es una llamada&DCOP; para mostrar/ejecutar o cancelar la alarma especificada. &kalarm; recupera la alarma del archivo de calendario y luego determina qué acción realizar dependiendo de si la alarma está lista.</para>

<itemizedlist
> <listitem
><para
>Si la alarma aún no está lista, no ocurre nada.</para
> </listitem
> <listitem
><para
>Si la alarma está lista, se comporta de la siguiente manera: Si la bandera de cancelar más tarde está fijada y la alarma llega tarde, &ie; el tiempo de activación programado fue mayor que hace un minuto, &kalarm; no muestra ni ejecuta la alarma. Si no hay repeticiones de la alarma planificadas, &kalarm; borra la alarma desde el archivo de calendario.</para
> </listitem
> </itemizedlist>

<note
><para
>El parámetro <replaceable
>archivoCalendario</replaceable
> sólo se usa para comprobación de integridad: si la &URL; no especifica el archivo de calendario predeterminado actual de &kalarm;, la petición se ignora.</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
>mensaje</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>banderas</replaceable
>, const QString&amp; <replaceable
>URLaudio</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>mensaje</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>banderas</replaceable
>, const QString&amp; <replaceable
>URLaudio</replaceable
>, int <replaceable
>tipoRepSimple</replaceable
>, int <replaceable
>intervalo</replaceable
>, int <replaceable
>contRep</replaceable
>)
</synopsis>
<synopsis>
bool scheduleMessage(const QString&amp; <replaceable
>mensaje</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>banderas</replaceable
>, const QString&amp; <replaceable
>URLaudio</replaceable
>, int <replaceable
>tipoRepSimple</replaceable
>, int <replaceable
>intervalo</replaceable
>, const QDateTime&amp; <replaceable
>tiempoFin</replaceable
>)
</synopsis>

<refsect2>
<title
>Parámetros</title>
<variablelist
> <varlistentry
> <term
><parameter
>mensaje</parameter
></term
> <listitem
> <para
>Especifica el texto del mensaje que se va a programar.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>fechaHora</parameter
></term
> <listitem
> <para
>Especifica la fecha y hora programadas en las que se debe mostrar el mensaje.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Especifica el color de fondo para mostrar el mensaje.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>banderas</parameter
></term
> <listitem
> <para
>Especifica el O lógido de las banderas del mensaje de alarma deseado. Los bits de banderas están definidos en la clase KAlarmEvent en <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>URLaudio</parameter
></term
> <listitem
> <para
>Especifica el nombre o &URL; de un archivo de audio que se va a reproducir al mostrar el mensaje.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>tipoRepSimple</parameter
></term
> <listitem
> <para
>Especifica el tipo de recurrencia para la alarma. Los valores permitidos son MINUTELY -al minuto-, DAILY -diario-, MONTHLY_DAY -día del mes-, ANNUAL_DATE -día del año-. Estos valores están definidos en la clase KAlarmEvent en <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>intervalo</parameter
></term
> <listitem
> <para
>Especifica el número de periodos (minutos/días/semanas/meses/años) entre repeticiones del mensaje de alarma.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>contRep</parameter
></term
> <listitem
> <para
>Especifica el número de veces que se debe mostrar el mensaje de alarma. Especifique -1 para repetir la alarma indefinidamente.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Descripción</title>
<para
><function
>scheduleMessage()</function
> es una llamada &DCOP; para programas el mensaje de alarma especificado para que se muestre en la fecha y hora especificadas. Tiene tres formas; una para alarmas sin repetición, otra para alarmas que se repiten un número de veces y otra para una alarma con repetición con un tiempo de conclusión.</para>

<para
>Si la hora programada (incluyendo cualesquiera repeticiones) ya ha transcurrido, &kalarm; muestra inmediatamente el mensaje o, si se ha fijado el bit LATE_CANCEL, ignora la petición. Si la hora programada (o una repetición) ocurre en el futuro, &kalarm; añade el mensaje de alarma al archivo de calendario para mostrarlo más tarde.</para>

<para
>Use una secuencia de códigos similar a la siguiente para configurar los datos del parámetro para la llamada &DCOP; a <function
>scheduleMessage()</function
> para una alarma sin repetición:</para>

<screen>
QString mensage, archivoAudio;
QDateTime fechaHora;
QColor bgColor;
Q_UINT32 banderas;
. . .
QByteArray datos;
QDataStream arg(datos, IO_WriteOnly);
arg &lt;&lt; mensaje;
arg.writeRawBytes((char*)&amp;fechaHora, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColor, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; archivoAudio;
</screen>

<para
>Use una secuencia de códigos similar a la siguiente para configurar los datos del parámetro para la llamada &DCOP; a <function
>scheduleMessage()</function
> para una alarma con repetición:</para>

<screen>
QString mensaje, archivoAudio;
QDateTime fechaHora;
QColor bgColor;
Q_UINT32 banderas;
Q_INT32 tipoRep, contRep, intervaloRep;
. . .
QByteArray datos;
QDataStream arg(datos, IO_WriteOnly);
arg &lt;&lt; mensaje;
arg.writeRawBytes((char*)&amp;fechaHora, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColor, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; archivoAaudio &lt;&lt; tipoRep &lt;&lt; contRep &lt;&lt; intervaloRep;
</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
>fechaHora</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>banderas</replaceable
>, const QString&amp; <replaceable
>URLaudio</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>banderas</replaceable
>, const QString&amp; <replaceable
>URLaudio</replaceable
>, int <replaceable
>tipoRepSimple</replaceable
>, int <replaceable
>intervalo</replaceable
>, int <replaceable
>contRep</replaceable
>)
</synopsis>
<synopsis>
bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>banderas</replaceable
>, const QString&amp; <replaceable
>URLaudio</replaceable
>, int <replaceable
>tipoRepSimple</replaceable
>, int <replaceable
>intervalo</replaceable
>, const QDateTime&amp; <replaceable
>tiempoFin</replaceable
>)
</synopsis>

<refsect2>
<title
>Parámetros</title>
<variablelist
> <varlistentry
> <term
><parameter
>URL</parameter
></term
> <listitem
> <para
>Especifica el nombre o la &URL; de un archivo de texto cuyos contenidos van a ser mostrados en el mensaje que se va a programar.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>fechaHora</parameter
></term
> <listitem
> <para
>Especifica la fecha y hora planificada a la que se debe mostrar el archivo.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>bg</parameter
></term
> <listitem
> <para
>Especifica el color de fondo para mostrar el archivo.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>banderas</parameter
></term
> <listitem
> <para
>Especifica el O lógico de las banderas de alarma deseadas. Los bits de bandera son aquellos definidos en la clase KAlarmEvent en <filename
>msgevent.h</filename
></para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>URLaudio</parameter
></term
> <listitem
> <para
>Especifica el nombre o &URL; de un archivo de audio que se va a reproducir al mostrar el mensaje.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>tipoRepSimple</parameter
></term
> <listitem
> <para
>Especifica el tipo de recurrencia para la alarma. Los valores permitidos son MINUTELY -al minuto-, DAILY -diario-, MONTHLY_DAY -día del mes-, ANNUAL_DATE -día del año-. Estos valores están definidos en la clase KAlarmEvent en <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>intervalo</parameter
></term
> <listitem
> <para
>Especifica el número de periodos (minutos/días/semanas/meses/años) entre repeticiones de la alarma.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>contRep</parameter
></term
> <listitem
> <para
>Especifica el número de veces que se debe mostrar el archivo. Especifique -1 para repetir la alarma indefinidamente.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>
<para
><function
>scheduleFile()</function
> es una llamada &DCOP; para programar el texto especificado para mostrarlo en la fecha y hora marcadas. Además de especificar un nombre de archivo o &URL;, su uso es idéntico a <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - vea la descripción de esta función para más detalles.</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
>lineaComando</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, int <replaceable
>banderas</replaceable
>)
</synopsis>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>lineaComando</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, int <replaceable
>banderas</replaceable
>, int <replaceable
>tipoRepSimple</replaceable
>, int <replaceable
>intervalo</replaceable
>, int <replaceable
>contRep</replaceable
>)
</synopsis>
<synopsis>
bool scheduleCommand(const QString&amp; <replaceable
>lineaComando</replaceable
>, const QDateTime&amp; <replaceable
>fechaHora</replaceable
>, int <replaceable
>banderas</replaceable
>, int <replaceable
>tipoRepSimple</replaceable
>, int <replaceable
>intervalo</replaceable
>, const QDateTime&amp; <replaceable
>tiempoFin</replaceable
>)
</synopsis>

<refsect2>
<title
>Parámetros</title>
<variablelist
> <varlistentry
> <term
><parameter
>lineaComando</parameter
></term
> <listitem
> <para
>Especifica la línea de comando del shell cuyo lanzamiento va a ser programado.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>fechaHora</parameter
></term
> <listitem
> <para
>Especifica la fecha y hora programadas a las que se debería ejecutar el comando.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>banderas</parameter
></term
> <listitem
> <para
>Especifica el O lógico de las banderas de alarma deseadas. Los bits de la bandera son aquellos definidos en la clase KAlarmEvent en <filename
>msgenvnt.h</filename
> salvo que el bit de la bandera BEEP se ignora.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>tipoRepSimple</parameter
></term
> <listitem
> <para
>Especifica el tipo de recurrencia para la alarma. Los valores permitidos son MINUTELY -al minuto-, DAILY -diario-, MONTHLY_DAY -día del mes-, ANNUAL_DATE -día del año-. Estos valores están definidos en la clase KAlarmEvent en <filename
>msgevent.h</filename
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>intervalo</parameter
></term
> <listitem
> <para
>Especifica el número de periodos (minutos/días/semanas/meses/años) entre repeticiones de la alarma.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>contRep</parameter
></term
> <listitem
> <para
>Especifique el número de veces que se debería repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.</para
> </listitem
> </varlistentry
> </variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>
<para
><function
>scheduleCommand()</function
> es una llamada &DCOP; para programar la ejecución de la línea de comando especificada en la fecha y hora marcadas. Además de especificar una línea de comandos y omitir los parámetros color del mensaje y archivo de audio, su uso es idéntico a <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - vea la descripción de esta función para más detalles.</para>
</refsect1>
</refentry>
</sect1>

<sect1 id="cmdline-interface">
<title
>Interfaz de la línea de comando</title>

<para
>Las opciones de la línea de comando se proporcionan para permitir que otros programas (como el <application
>demonio de alarma</application
>) inicie &kalarm; si no está corriendo ya, para activar o cancelar las alarmas programadas o programar nuevas alarmas. La razón para usar las opciones de la línea de comando para este propósito es que si &kalarm; se iniciara sin ningún parámetro en la línea de comando y luego enviara peticiones &DCOP;, se iniciaría en su modo gráfico predeterminado, lo que es claramente indeseable para una petición entre programas.</para>

<note
><para
>Los programas deberían comprobar primero que &kalarm; está corriendo ya; si es así, en lugar de usar llamadas &DCOP; deberían solicitar estas operaciones.</para
></note>

<para
>Las opciones de la línea de comando para planificar una alarma nueva se describen en el capítulo <link linkend="cmdline-operation"
>Usando &kalarm;</link
>. Las opciones para activar y cancelar las alarmas planificadas son las siguientes:</para>

<note
><para
>Los usuarios normales también pueden si así lo desean usar estas opciones en la línea de comandos (asumiendo que puedan suministrar la información de los parámetros necesaria).</para
></note>

<informaltable>
<tgroup cols="2">
<thead
> <row
> <entry
>Opción</entry
> <entry
>Descripción</entry
> </row
> </thead>
<tbody
> <row
> <entry
><option
>--calendarURL <replaceable
>url</replaceable
></option
></entry
> <entry
>Use el archivo de calendario con la &URL; especificada. Esta opción sólo se usa para comprobar la integridad: si la &URL; no especifica un archivo de calendario predeterminado de &kalarm;, la petición será ignorada.</entry
> </row
> <row
> <entry
><option
>--cancelEvent <replaceable
>IDevento</replaceable
></option
></entry
> <entry
>Cancela el evento con el ID de evento especificado.</entry
> </row
> <row
> <entry
><option
>--triggerEvent <replaceable
>IDevento</replaceable
></option
></entry
> <entry
>Dispara el evento con el ID de evento especificado. La acción que ocurre es la misma que para la llamada &DCOP; <link linkend="triggerEvent"
>triggerEvent()</link
>.</entry
> </row
> <row
> <entry
><option
>--handleEvent <replaceable
>IDevento</replaceable
></option
></entry
> <entry
>Dispara o cancela el evento con el ID de evento especificado. &kalarm; determina qué acción ocurre de la misma forma que la llamada &DCOP; <link linkend="handleEvent"
>handleEvent()</link
></entry
> </row
> </tbody>
</tgroup>
</informaltable>

<para
><option
>--cancelEvent</option
>, <option
>--triggerEvent</option
> y <option
>--handleEvent</option
> son mutuamente exclusivas. <option
>--calendarURL</option
> es opcional, pero sólo se puede usar con una de las otras tres opciones.</para>

<para
>Ejemplos:</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
>Preguntas y respuestas</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>¿Qué archivos de configuración usa &kalarm;?</para>
</question>
<answer>
<para
>El archivo <filename
>$KDEHOME/share/config/kalarmrc</filename
> mantiene sus preferencias de &kalarm;.</para>

<para
>El archivo de calendario que graba sus alarmas programadas es <filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
>, a no ser que se especifique un archivo de calendario diferente en el archivo de preferencias.</para>

<note
><para
>Si cambia el archivo de calendario en el archivo de preferencias, debería editar también lel archivo de configuración <filename
>clients</filename
> del <application
>demonio de alarma</application
> para borrar la referencia al archivo de calendario anterior. Esto se debe hacer cuando el <application
>demonio de alarma</application
> no esté corriendo para evitar la posibilidad de sobreescribir su cambio.</para
></note>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Qué archivos de configuración usa el <application
>demonio de alarma</application
>?</para>
</question>
<answer>
<para
>El archivo <filename
>$KDEHOME/share/config/kalarmdrc</filename
> mantiene sus preferencias para el <application
>demonio de alarma</application
>.</para>

<para
>El archvivo <filename
>$KDEHOME/share/apps/kalarmd/clients</filename
> mantiene los detalles de las aplicaciones clientes que se han registrado previamente con el <application
>demonio de alarma</application
> y sus archivos de calendario.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Cuáles son los nombres de aplicación para &kalarm; y el <application
>demonio de alarma</application
>?</para>
</question>
<answer>
<para
>El nombre de la aplicación &kalarm; es <application
>kalarm</application
>, y el nombre de la aplicación del <application
>demonio de alarma</application
>es <application
>kalarmd</application
>. Además, en las versiones de &kde; anteriores a la 3.1 había una pequeña aplicación <application
>kalarmautostart</application
>, cuya función era iniciar el icono de la bandeja del sistema de &kalarm; al ingresar.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Créditos y licencia</title>

<para
> &kalarm; </para>
<para
> Copyright del programa 2001, 2002 David Jarvie <email
>software@astrojar.org.uk</email
> </para>
<para
> Autores del demonio de alarma: <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
> Copyright de la documentación 2001, 2002 David Jarvie <email
>software@astrojar.org.uk</email
> </para>

<para
>Juan Manuel García Molina <email
>juanma_gm@wanadoo.es</email
></para>

<para
>Gracias al autor de la aplicación KAlarm para &kde;1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, que estuvo de acuerdo gentilmente en permitirme que usara el nombre &kalarm; para esta aplicación de &kde;2/&kde;3. </para>

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

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

</chapter>

<appendix id="installation">
<title
>Instalación</title>

<sect1 id="getting-kalarm">
<title
>Cómo obtener &kalarm;</title>

&install.intro.documentation;

<para
>&kalarm; está disponible para &kde;2 y como un sólo paquete para &kde;3 en <ulink url="http://www.astrojar.org.uk/linux"
>http://www.astrojar.org.uk/linux</ulink
> </para>

</sect1>

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

<para
>&kalarm; precisa que se instalen las bibliotecas estándar de &kde; (el paquete llamado <filename
>kdelibs</filename
>). Para compilar desde las fuentes, también necesitará los paquetes de desarrollo de &Qt; y <filename
>kdelibs</filename
>.</para>

<para
>&kalarm; usa en torno a 12 MB y el <application
>demonio de alarma</application
> usa sobre 2.5 MB de memoria para correr, pero esto puede variar según su plataforma y configuración.</para>

<para
>Puede encontrar una lista de cambios en el archivo <filename
>ChangeLog</filename
> o en <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
>Compilación e instalación</title>

<para
>Si no puede obtener un paquete binario precompilado adecuado, necesita compilar &kalarm; por sí mismo desde los archivos fuente. Obtenga el archivo del paquete fuente <filename
>kdepim-x.x.tar.bz2</filename
> o <filename
>kalarm-x.x.tar.bz2</filename
> (o similar), dependiendo de si quiere instalar el &package; o sólo &kalarm;. Descomprímalo en un directorio nuevo usando un comando similar a <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>package.tar.bz2</replaceable
></option
></userinput
>, y muévase al directorio que ha sido creado.</para>

&install.compile.documentation;

<note
><para
>Si tiene más de una versión de &kde; instalada (por ejemplo, &kde;2 y &kde;3), esto puede hacer que se instale &kalarm; en el directorio de &kde; equivocado. Si es necesario, puede proporcionar el directorio de &kde; como un parámetro a <userinput
><command
>./configure</command
></userinput
> . Por ejemplo, si su &kde; está instalado en <filename
>/opt/kde2</filename
>:</para
> <para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para
> </note>
</sect1>

<sect1 id="configuration">
<title
>Configuración</title>

<para
>No se precisa una configuración especial para configurar &kalarm; de tal forma que corra en el escritorio de &kde;. Una vez que haya ejecutado &kalarm; por vez primera, el <application
>demonio de alarma</application
> se iniciará cada vez que ingrese, para monitorizar las alarmas programadas.</para>

<para
>Para correr &kalarm; en un escritorio distinto de &kde;, el requisito principal es asegurarse de que el <application
>demonio de alarma</application
> corra automáticamente cada vez que ingrese. Hay instrucciones más detalladas en el archivo <filename
>INSTALL</filename
> que se distribuye con &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:
-->

