# El manual de &kalarm;

David Jarvie

    software@astrojar.org.uk

Juan Manuel García Molina

    juanma_gm@wanadoo.es

Traductor
2001 2002 David Jarvie
&FDLNotice;
2002-10-04
0.08.01

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

KDE kdepim kalarm alarma recordatorio

## Introducción

&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.

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.

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.

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

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:

Captura de pantalla de &kalarm; ventana de mensaje
Mensaje de alarma

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

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

Este documento hace varias referencias al demonio de alarma. 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.

## Usando &kalarm;

### Modo gráfico

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.

Captura de pantalla de la ventana principal de &kalarm;
Ventana principal

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.

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.

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

#### Añadiendo una nueva alarma

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

#### Modificando una alarma existente

Para modificar una alarma existente, haga una de las siguientes:

- Doble clic en su entrada en la lista de alarmas.

- Selecciónelo haciendo clic en su entrada en la lista de la alarma. Luego seleccione Acciones Modificar

- Clic derecho en su entrada en la lista dealarmas y seleccione Modificar del menú contextual.

Esto muestra el diálogo de edición de alarma:

Captura e pantalla del diálogo de edición de la alarma
Diálogo de edición de alarma

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

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

En el grupo Hora, seleccione

- En fecha/hora para introducir la fecha y hora en la que la alarma se activará. Marque Cualquier hora 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. (Configurando las opciones predeterminadas describe cómo configurar la hora de comienzo del día.)

- Tiempo desde ahora para introducir dentro de cuánto tiempo (en horas y minutos) se activará la alarma.

Especifique si o cómo se debe repetir en el grupo Repetición.

- Para activar la alarma sólo una vez, seleccione Sin repetición

- Seleccione Repetir al entrar 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 demonio de alarma.)

- Seleccione Recur para activar la alarma a intervalos regulares. Debe especificar luego los parámetros de la recurrencia en la pestaña Recurrencia.

  En el cuadro Regla de recurrencia, fije el periodo de tiempo de recurrencia seleccionando uno de los tipos de periodos de tiempo e introduciéndolo en el cuadro Repetir cada cuántos periodos de tiempo deben transcurrir entre las recurrencias. Por ejemplo, para repetir cada quincena, debe seleccionar Diario e introducir un valor de 14, o seleccionar Semanal e introducir un valor de 2. Dependiendo del periodo de tiempo seleccionado, puede tener más opciones:

  - Para una recurrencia semanal, marque cada día de la semana en el que desee activar la alarma.

  - Para una recurrencia mensual, puede seleccionar un día fijo o una posición (⪚ el segundo jueves).

  - Para una recurrencia anual, puede seleccionar un día fijo del año o una posición de un mes (⪚ el último domingo de mayo).

  En el cuadro Fin de la recurrencia, fije el tiempo de recurrencia total de la siguiente forma:

  - Seleccione Sin fin para continuar las repeticiones indefinidamente.

  - Seleccione Acabar tras para especificar el número total de ocurrencias de la alarma.

  - Seleccione Finalizar en para especificar la fecha/hora hasta la que se repetirá la alarma.

El cuadro Cancelar si es tarde 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 Cualquier hora, se cancelará si no se puede mostrar en 24 horas de la hora de comienzo del día de la fecha programada.

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

El cuadro de verificación Confirmar asentimiento 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.

Marque Sonido 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.

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

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

#### Borrar una alarma existente

Para borrar una alarma existente, haga una cosa de las siguientes:

- Selecciónelo haciendo clic en su entrada en la lista de alarma. Luego seleccione Acciones Borrar .

- Clic derecho en su entrada en la lista de alarmas y seleccione Borrar del menú contextual.

#### Aceptando una alarma

Vea Ventana de mensaje de alarma para saber cómo confirmar las alarmas.

#### Mostrando &kalarm; en la bandeja del sistema

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

Para mostrar &kalarm; en la bandeja del sistema de &kde;, seleccione Ver Mostrar en la bandeja del sistema .

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

- Seleccione Vista Ocultar de la bandeja del sistema.

- Clic derecho en el icono de la bandeja del sistema y seleccione Salir del menú contextual.

El uso del icono de la bandeja del sistema se describe abajo.

#### Activando/desactivando el monitoreo de alarma

##### Activar el monitoreo de alarma

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

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

- Seleccione Acciones Activar alarmas.

- Clic derecho en el icono de la bandeja del sistema y seleccione Activar alarmas del menú contextual.

El demonio de alarma se inicia si es necesario y las alarmas se monitorizarán cuando sea necesario.

Iniciar el demonio de alarma afectará a cualquier otra aplicación que use el demonio de alarma.

##### Desactivando el monitoreo de alarma

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 demonio de alarma está configurado para comenzar al ingresar - hasta la próxima vez que ingrese.

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

- Seleccione Acciones Alarmas activadas.

- Clic derecho en el icono de la bandeja del sistema y seleccione Alarmas activadas del menú de contexto.

- Si el modo de ejecución de &kalarm; es continuo y tiene seleccionado Desactivar alarmas mientras no esté corriendo en el diálogo de Preferencias, salga de &kalarm;.

Para desactivar las alarmas, detenga el demonio de alarma

- Seleccione Configuración Demonio de control de alarma.... Esto muestra el diálogo de gestor de servicio que le permite detener el demonio de alarma

Esto afectará a cualquier otra aplicación que use el demonio de alarma.

#### Refrescando las alarmas

En el caso de que cualquier alarma no se active cuando debiera, puede refrescar la lista de alarmas y activar cualesquiera alarmas perdidas seleccionando Acciones Refrescar alarmas .

&kalarm; reactiva las alarmas perdidas al reiniciar eldemonio de alarma, lo que se discute en la sección Demonio de alarma section.

#### Controlar el demonio de alarma

Para controlar el demonio de alarma, seleccione Configuración Controlar el demonio de alarma.... Esto muestra el diálogo del gestor de servicio del demonio de alarma y configura si corre automáticamente al ingresar. Vea Controlar el demonio de alarma con el gestor de servicio para más detalles.

#### Saliendo del programa

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

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

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

### Ventana de mensaje de alarma

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ó.

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.

Cuando se muestra una ventan de mensaje, haga una de las cosas siguientes:

- Asienta haciendo clic en el botón Cerrar. Esto cierra la ventana (tras pedirle confirmación, si seleccionó Confirmar asentimiento).

- Muestra las opciones para retrasar la alarma haciendo clic en el botón Retrasar... button. Luego seleccione Retrasar a fecha/hora para introducir la fehca y hora para que el mensaje se vuelva a mostrar o seleccione Retrasar un intervalo de tiempo para introducir dentro de cuánto tiempo (en horas y minutos) se debe volver a mostrar el mensaje. Luego haga clic en Retrasar para posponer el mensaje de alarma.

  Si la alarma recurre regularmente, el tiempo por el que se retrasa debe transcurrir antes de la siguiente repetición planificada.

  El botón Retrasar... no está disponible para las alarmas que se muestran al ingresar debido a que la opción Repetir al ingresar tiene que estar seleccionada.

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

### Icono de la bandeja del sistema

&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.

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

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

Activar alarmas

  Activar monitorización de alarmas.

  Vea Activando/desactivando la monitorización de alarmas para más detalles.

Alarmas activadas

  Desactiva la monitorización de alarmas.

  Vea Activando/desactivando la monitorización de alarmas para más detalles.

Configurar &kalarm;...

  Muestra el diálogo de preferencias de &kalarm;.

  El diálogo de preferencias se describe en Configurando las opciones predeterminadas. Incluye opciones relativas al icono de la bandeja del sistema de &kalarm;.

Controlar el demonio de alarma...

  Muestra el diálogo del gestor de servicio que le permite controlar el demonio de alarma.

  Vea Controlar el demonio de alarma con el gestor de servicio para más detalles.

Restaurar / Minimizar

  Restaura o minimiza la ventana principal de &kalarm;.

  Esta opción sólo está disponible si el modo de ejecución es continuo. (Vea Configurando las opciones predeterminadas para una descripción de los modos de ejecución.)

Salir

  Cierra el icono de la bandeja de &kalarm;.

  En modo de ejecución continuo sólo, también cierra todas las ventanas principales de &kalarm;. No tiene efecto sobre la monitorización de alarmas por el demonio de alarma (a no ser que haya seleccionado Desactivar alarmas mientras no esté corriendo en el diálogo de Preferencias).

### Configurando las opciones predeterminadas

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

- 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 demonio de alarma 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 bajo demanda.

  Al correr en modo bajo demanda, 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 bajo demanda, cerrarlo no tiene efecto sobre ninguna ventana de &kalarm;, mientras que en modo continuo, cerrarlo también cierra todas las ventanas principales de &kalarm;.

- Si especificó que &kalarm; debe correr en modo continuo, puede desactivar todas las alarmas debido a que se muestra mientras que &kalarm; no esté corriendo.

- Especifique que el icono de la bandeja del sistema de &kalarm; deba mostrarse al ingresar en la sesión de &kde;.

- 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 demonio de alarma está corriendo.

- 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 Cualquier hora. 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.

- Especifique si se le debe pedir confirmación cada vez que borra una alarma.

Las secciones Predeterminados de alarma y Apariencia le permiten elegir los valores predeterminados para las opciones del diálogo de edición de alarma:

- Fije la tipografía predeterminada y el color del fondo que usar para mostrar un mensaje de alarma.

- Fije los estados predeterminados para los cuadros de verificación Cancelar si es tarde y Confirmar asentimiento.

- Fija el bip como el predeterminado para la opción Sonido.

- Fija la recurrencia predeterminada de las alarmas recurrentes.

### Operación de la línea de comandos

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

- planificar una alarma nueva

- controlar el demonio de alarma

- controlar el modo de muestra de &kalarm;

- obtener ayuda

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 Guía del desarrollador de &kalarm;.

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.

#### Planificar una nueva alarma

Las opciones siguientes se usan para planificar una alarma nueva:

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

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

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:

    % kalarm -c red -t 27-22:00 "Remember to\nSTOP"
    % kalarm -c 0xFF0000 -t 27-22:00 "Remember to\nSTOP"

#### Otras opciones

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

Vea la sección Demonio de alarma para una discusión sobre el reinicio y la parada del demonio de la aplicación.

Opción | Descripción
--- | ---
`--reset` | Reinicia el demonio de alarma.
`--stop` | Detiene el demonio de alarma.
`--tray` | Muestra &kalarm; como un icono en la bandeja del sistema de &kde;.

Por ejemplo, para reiniciar el demonio de alarma:

    % kalarm --reset

#### Opciones de ayuda

Las siguientes opciones de ayuda con comunes a todos los programas de &kde;:

Opción | Descripción
--- | ---
`--help` | Muestra un texto de ayuda breve con las opciones.
`--help-qt` | Muestra numerosas opciones generales propias de &Qt;.
`--help-kde` | Muestra numerosas opciones generales propias de &kde;.
`--help-all` | Muestra todas las opciones.
`--author` | Muestra los nombres y direcciones de correo de los autores de &kalarm;.
`-v`, `--version` | Muestra las versiones que están corriendo de la biblioteca &Qt;, &kde; y &kalarm;.
`--license` | Muestra información sobre la licencia.

### Demonio de alarma

El demonio de alarma, &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.

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

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

#### Iniciando, reiniciando y deteniendo el demonio de alarma

El demonio de alarma 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.

##### Iniciando el demonio de alarma

Para iniciar el demonio de alarma, 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 abajo, iniciarlo usando el diálogo del gestor de servicio (vea Controlar el demonio de alarma con el gestor de servicio) o puede correr el demonio de alarma directamente desde la línea de comando:

    % kalarmd

##### Reiniciando el demonio de alarma

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

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

Resetear inicia el demonio de alarma si no está corriendo actualmente.

Para reiniciar el demonio de alarma, use el comando del menú Acciones Refrescar alarmas o teclee el siguiente comando:

    % kalarm --reset

##### Deteniendo el demonio de alarma

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

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

Para detener el demonio de alarma, use o bien el diálogo del gestor de servicio (vea Controlar el demonio de alarma con el gestor de servicio), o teclee el siguiente comando:

    % kalarm --stop

#### Controlar el demonio de alarma con el gestor de servicio

El diálogo de gestor de servicio le permite configurar y controlar el demonio de alarma. Puede:

- Configure si corre automáticamente al ingresar.

  Si ni la aplicación del demonio de alarma ni &kalarm; están configurados para correr al ingresar, la monitorización de alarma no ocurrirá y &kalarm; no mostrará ni ejecutará ninguna alarma.

- Detiene e inicia el demonio de alarma.

  Iniciar o detener el demonio de alarma afectará a cualquier otra aplicación que use el demonio de alarma.

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

## Guía del desarrollador de &kalarm;

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

- planificar una alarma nueva

- activar o cancelar una alarma ya planificada

- cancelar una alarma ya planificada

- activar una alarma ya planificada

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.

### interfaz de &DCOP;

cancelEvent
cancelEvent cancel an already scheduled alarm.

    void cancelEvent(const QString& archivoCalendario, const QString& IDevento)

###### Parámetros

archivoCalendario

  Especifica la &URL; del archivo de calendario que contiene el evento que va a ser cancelado.

IDevento

  Especifica el ID único del evento que va a ser cancelado, como está guardado en archivoCalendario.

##### Descripción

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

El parámetro archivoCalendario 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.

El viejo nombre para esta función, `cancelMessage`, se ha mantenido para compatibilidad, pero todas las aplicaciones nuevas deberían usar `cancelEvent`.

triggerEvent
triggerEvent trigger an already scheduled alarm.

    void triggerEvent(const QString& archivoCalendario, const QString& IDevento)

###### Parámetros

archivoCalendario

  Especifica la &URL; del archivo de calendario que contiene el evento que va a ser activado.

IDevento

  Especifica el ID único del evento que va a ser disparado, tal y como está guardado en el archivoCalendario.

##### Descripción

`triggerEvent()` 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.

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.

El parámetro archivoCalendario 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.

El nombre viejo para esta función, `displayMessage`, se ha mantenido para compatibilidad, pero todas las aplicaciones nuevas deberían usar `triggerEvent`.

handleEvent
handleEvent trigger or cancel an already scheduled alarm.

    void handleEvent(const QString& archivoCalendario, const QString& IDevento)

###### Parámetros

archivoCalendario

  Especifica la &URL; del archivo de calendario que contiene el evento que se muestra/ejecuta o cancela.

IDevento

  Especifica el ID único del evento que se muestra/ejecuta o cancela, tal y como está grabado en archivoCalendario.

##### Descripción

`handleEvent()` 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.

- Si la alarma aún no está lista, no ocurre nada.

- 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.

El parámetro archivoCalendario 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.

scheduleMessage
scheduleMessage schedule a new alarm message.

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& URLaudio)

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& URLaudio, int tipoRepSimple, int intervalo, int contRep)

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& URLaudio, int tipoRepSimple, int intervalo, const QDateTime& tiempoFin)

###### Parámetros

mensaje

  Especifica el texto del mensaje que se va a programar.

fechaHora

  Especifica la fecha y hora programadas en las que se debe mostrar el mensaje.

bg

  Especifica el color de fondo para mostrar el mensaje.

banderas

  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 `msgevent.h`

URLaudio

  Especifica el nombre o &URL; de un archivo de audio que se va a reproducir al mostrar el mensaje.

tipoRepSimple

  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 `msgevent.h`.

intervalo

  Especifica el número de periodos (minutos/días/semanas/meses/años) entre repeticiones del mensaje de alarma.

contRep

  Especifica el número de veces que se debe mostrar el mensaje de alarma. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleMessage()` 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.

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.

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

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

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

    QString mensaje, archivoAudio;
    QDateTime fechaHora;
    QColor bgColor;
    Q_UINT32 banderas;
    Q_INT32 tipoRep, contRep, intervaloRep;
    . . .
    QByteArray datos;
    QDataStream arg(datos, IO_WriteOnly);
    arg << mensaje;
    arg.writeRawBytes((char*)&fechaHora, sizeof(QDateTime));
    arg.writeRawBytes((char*)&bgColor, sizeof(QColor));
    arg << flags << archivoAaudio << tipoRep << contRep << intervaloRep;

scheduleFile
scheduleFile schedule a new alarm which displays the contents of a text file.

    bool scheduleFile(const QString& URL, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& URLaudio)

    bool scheduleFile(const QString& URL, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& URLaudio, int tipoRepSimple, int intervalo, int contRep)

    bool scheduleFile(const QString& URL, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& URLaudio, int tipoRepSimple, int intervalo, const QDateTime& tiempoFin)

###### Parámetros

URL

  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.

fechaHora

  Especifica la fecha y hora planificada a la que se debe mostrar el archivo.

bg

  Especifica el color de fondo para mostrar el archivo.

banderas

  Especifica el O lógico de las banderas de alarma deseadas. Los bits de bandera son aquellos definidos en la clase KAlarmEvent en `msgevent.h`

URLaudio

  Especifica el nombre o &URL; de un archivo de audio que se va a reproducir al mostrar el mensaje.

tipoRepSimple

  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 `msgevent.h`.

intervalo

  Especifica el número de periodos (minutos/días/semanas/meses/años) entre repeticiones de la alarma.

contRep

  Especifica el número de veces que se debe mostrar el archivo. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleFile()` 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 `scheduleMessage` - vea la descripción de esta función para más detalles.

scheduleCommand
scheduleCommand schedule a new alarm which executes a shell command.

    bool scheduleCommand(const QString& lineaComando, const QDateTime& fechaHora, int banderas)

    bool scheduleCommand(const QString& lineaComando, const QDateTime& fechaHora, int banderas, int tipoRepSimple, int intervalo, int contRep)

    bool scheduleCommand(const QString& lineaComando, const QDateTime& fechaHora, int banderas, int tipoRepSimple, int intervalo, const QDateTime& tiempoFin)

###### Parámetros

lineaComando

  Especifica la línea de comando del shell cuyo lanzamiento va a ser programado.

fechaHora

  Especifica la fecha y hora programadas a las que se debería ejecutar el comando.

banderas

  Especifica el O lógico de las banderas de alarma deseadas. Los bits de la bandera son aquellos definidos en la clase KAlarmEvent en `msgenvnt.h` salvo que el bit de la bandera BEEP se ignora.

tipoRepSimple

  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 `msgevent.h`.

intervalo

  Especifica el número de periodos (minutos/días/semanas/meses/años) entre repeticiones de la alarma.

contRep

  Especifique el número de veces que se debería repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleCommand()` 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 `scheduleMessage` - vea la descripción de esta función para más detalles.

### Interfaz de la línea de comando

Las opciones de la línea de comando se proporcionan para permitir que otros programas (como el demonio de alarma) 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.

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.

Las opciones de la línea de comando para planificar una alarma nueva se describen en el capítulo Usando &kalarm;. Las opciones para activar y cancelar las alarmas planificadas son las siguientes:

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).

Opción | Descripción
--- | ---
`--calendarURL url` | 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.
`--cancelEvent IDevento` | Cancela el evento con el ID de evento especificado.
`--triggerEvent IDevento` | Dispara el evento con el ID de evento especificado. La acción que ocurre es la misma que para la llamada &DCOP; triggerEvent().
`--handleEvent IDevento` | 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; handleEvent()

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

Ejemplos:

    % kalarm --triggerEvent &kalarm;-387486299.702 --calendarURL file:/home/zaphod/hydra.ics
    % kalarm --cancelEvent &kalarm;-388886299.793

## Preguntas y respuestas

&reporting.bugs; &updating.documentation;

¿Qué archivos de configuración usa &kalarm;?

El archivo `$KDEHOME/share/config/kalarmrc` mantiene sus preferencias de &kalarm;.

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

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

¿Qué archivos de configuración usa el demonio de alarma?

El archivo `$KDEHOME/share/config/kalarmdrc` mantiene sus preferencias para el demonio de alarma.

El archvivo `$KDEHOME/share/apps/kalarmd/clients` mantiene los detalles de las aplicaciones clientes que se han registrado previamente con el demonio de alarma y sus archivos de calendario.

¿Cuáles son los nombres de aplicación para &kalarm; y el demonio de alarma?

El nombre de la aplicación &kalarm; es kalarm, y el nombre de la aplicación del demonio de alarmaes kalarmd. Además, en las versiones de &kde; anteriores a la 3.1 había una pequeña aplicación kalarmautostart, cuya función era iniciar el icono de la bandeja del sistema de &kalarm; al ingresar.

## Créditos y licencia

&kalarm;

Copyright del programa 2001, 2002 David Jarvie software@astrojar.org.uk

Autores del demonio de alarma:

- Preston Brown pbrown@kde.org

- David Jarvie software@astrojar.org.uk

- Cornelius Schumacher schumacher@kde.org

Copyright de la documentación 2001, 2002 David Jarvie software@astrojar.org.uk

Juan Manuel García Molina juanma_gm@wanadoo.es

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

&underFDL; &underGPL;

## Instalación

### Cómo obtener &kalarm;

&install.intro.documentation;

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

### Requisitos

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

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

Puede encontrar una lista de cambios en el archivo `ChangeLog` o en http://www.astrojar.org.uk/linux/kalarm.html.

### Compilación e instalación

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 `kdepim-x.x.tar.bz2` o `kalarm-x.x.tar.bz2` (o similar), dependiendo de si quiere instalar el &package; o sólo &kalarm;. Descomprímalo en un directorio nuevo usando un comando similar a ``tar` `xvfj package.tar.bz2``, y muévase al directorio que ha sido creado.

&install.compile.documentation;

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 ``./configure`` . Por ejemplo, si su &kde; está instalado en `/opt/kde2`:

``./configure` --prefix=/opt/kde2`

### Configuración

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 demonio de alarma se iniciará cada vez que ingrese, para monitorizar las alarmas programadas.

Para correr &kalarm; en un escritorio distinto de &kde;, el requisito principal es asegurarse de que el demonio de alarma corra automáticamente cada vez que ingrese. Hay instrucciones más detalladas en el archivo `INSTALL` que se distribuye con &kalarm;.

&documentation.index;