# Manual del usuario de &kde;

Kevin
Krammer

    kevin.krammer@gmx.at

Autor
2005-09-08
K Desktop Environment
kabcclient
1

# kabcclient

cliente de línea de órdenes para la libreta de direcciones de &kde;

    kabcclient  -A -R -M -S -L  --match-case --nosave -ic codec -if formato -if-opts opciones de formato -oc codec -of formato -of-opts opciones de formato  input-data

## Descripción

`kabcclient` permite acceso mediante línea de órdenes a la libreta de direcciones de &kde;, por ejemplo en guiones de shell. Admite entrada desde stdin a través de argumentos adicionales en la línea de órdenes. La salida se escribirá siempre en stdout.

## Opciones

Modos de operación
  `-A, --add`

    Añadir una nueva entrada de contacto a la libreta de direcciones

  `-R, --remove`

    Elimina una entrada de contacto existente en la libreta de direcciones

  `-M, --merge`

    Combina los datos de entrada con un contacto existente en la libreta de direcciones. Esto añade la nueva información a la ya existente

  `-S, --search`

    Busca en la libreta de direcciones las entradas de contactos que coincidan

  `-L, --list`

    Muestra todas las entradas de la libreta de direcciones

Opciones de entrada
  `-ic, --input-codec`

    Codifica el texto introducido mediante una codificación establecida. Mirar `-ic` ayuda para información adicional sobre codificadores de entrada. Por defecto local es el que usará el codificador para las preferencias actuales de locale 5

  `-if, --input-format`

    Analiza el texto introducido de acuerdo con las reglas de formateo proporcionadas. Mirar `-if` ayuda para los formatos disponibles. Por defecto es buscar

  En lugar de leer el texto introducido, kabcclient puede mostrar un diálogo para seleccionar los contactos usando el formato de entrada

    diálogo

  `-if-opts, --input-format-options`

    Opciones adicionales para el formato de entrada seleccionado. Puede ser opcional, al igual que el mandato dependiendo del formato. Mirar `-if-opts` ayuda para las opciones de los formatos disponibles

Opciones de salida
  `-oc, --output-codec`

    Codifica el texto de salida mediante una codificación establecida. Mirar `-oc` ayuda para información adicional sobre los codificadores actuales. Por defecto local es el codificador que se usará para las preferencias actuales de locale 5.

  `-of, --output-format`

    Formatos de texto de salida de acuerdo con las reglas de formateo proporcionadas. Vea `-of` ayuda para los formatos disponibles. Por defecto es vcard

  `-of-opts, --output-format-options`

    Opciones adicionales para el formato de salida elegido. Puede ser opcional, al igual que el mandato, dependiendo del formato. Ver `-of-opts` ayuda para las opciones de formato disponibles

Opciones adicionales
  `--match-case`

    Usa la coincidencia sensible de texto, al comprar el texto introducido con las entradas de contactos

  `--nosave`

    Realiza operaciones de cambio de información como `-A, -R` o `-M`, únicamente en memoria, pero no escribe los cambios en la libreta de direcciones

## Diagnósticos

Como de costumbre, un estado de salida cero, indica éxito. Dependiendo del modo de operación escogida, un estado de salida distinto de cero, indica que la aplicación ha detectado un problema

Añadir
  `1`

    Error al leer el texto introducido

  `2`

    Falló la creación de una entrada de contacto correcta a partir del texto introducido, p.ej. sin datos o formato incorrecto del texto de entrada para el formato de entrada escogido

  `3`

    Error al guardar los cambios en la libreta de direcciones. Esto puede deberse, por ejemplo, a que actualmente, hay otras aplicaciones bloqueando la libreta de direcciones.

ELIMINAR
  `1`

    Error al leer el texto introducido

  `2`

    El programa podría no eliminar contactos de la libreta de direcciones. Esto puede estar causado por error al analizar el texto introducido, fallo al encontrar la entrada del contacto en la libreta de direcciones o al encontrar más de un contacto idéntico en la libreta de direcciones. En el último caso, se escribirá un mensaje de error en stderr

  `3`

    Error al guardar los cambios en la libreta de direcciones. Esto puede deberse, por ejemplo, a que actualmente, hay otras aplicaciones bloqueando la libreta de direcciones.

MERGE
  `1`

    Error al leer el texto introducido

  `2`

    El programa podría no combinar lo introducido con ninguna entrada de contacto de la libreta de direcciones. Esto puede estar causado por fallo al analizar el texto introducido, fallo al encontrar el contacto en la libreta de direcciones o al encontrar más de una coincidencia. En el último caso, un mensaje de error se escribirá en stderr

  `3`

    Error al guardar los cambios en la libreta de direcciones. Esto puede deberse, por ejemplo, a que actualmente, hay otras aplicaciones bloqueando la libreta de direcciones.

  SEARCH
  `1`

    Error al leer el texto introducido

  `2`

    El programa podría no encontrar ninguna coincidencia de entrada de contacto en la libreta de direcciones. Esto puede estar causado por fallo al analizar el texto introducido, o fallo al encontrar el contacto en la libreta de direcciones

## Ejemplos

Buscar entradas de contacto con «Joe» en el nombre o en la dirección de correo

    kabcclient -S Joe

Hacer lo mismo usando coincidencia sensible

    kabcclient --match-case -S Joe

Hacer lo mismo leyendo el texto introducido de stdin

    echo «Joe» | kabcclient --match-case -S

Intente añadir una nueva entrada de contacto utilizando información de una dirección de correo con formato

    kabcclient --nosave --add -if email «Marilyn Monroe <mmonroe@moviestars.com>»

Hacer lo mismo, guardando la libreta de direcciones modificada

    kabcclient --add -if email «Marilyn Monroe <mmonroe@moviestars.com>»

Mostrar los formatos de entrada disponibles

    kabcclient -if help

Mostrar los formatos de salida disponibles

    kabcclient -of help

Mostrar las opciones disponibles para el formato de salida «correo»

    kabcclient -of email -of-opts help

Mostrar todas las direcciones de correo electrónico de todos los contactos que contengan «Marilyn»

    kabcclient -of email -of-opts allemails -S Marilyn

Eliminar todos los contactos seleccionados en el diálogo de selección de contactos

    kabcclient --remove -if dialog

Exportar los contactos seleccionados a archivo de tipo VCard (formato de salida por defecto)

    kabcclient -S -if dialog > contacts.vcf

## Autor

Este manual ha sido escrito por Kevin Krammer <kevin.kramer@gmx.at>. Se permite la copia, distribución o modificación de este documento bajo los términos de la Licencia Pública General GNU, versión 2 o cualquier versión posterior publicada por la Free Software Foundation.

En sistemas Debian, el texto completo de la Licencia Pública General GNU puede encontrarse en /usr/share/common-licenses/GPL.