<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY % Catalan  "INCLUDE"
><!-- change language only here -->
]>

<refentry id='kabcclient1'>
<refentryinfo>
<title
>Manual d'usuari del &kde;</title>
<author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
><email
>kevin.krammer@gmx.at</email
></address>
  </affiliation>
  <contrib
>Autor</contrib>
</author>
<date
>08-09-2005</date>
<productname
>Entorn d'escriptori K</productname>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>kabcclient</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>
<refnamediv id='name'>
<refname
>kabcclient</refname>
<refpurpose
>Client de línia d'ordres per a la llibreta d'adreces de &kde;</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis
><command
>kabcclient</command
> <group
> <arg choice="opt"
>-A</arg
> <arg choice="opt"
>-R</arg
> <arg choice="opt"
>-M</arg
> <arg choice="opt"
>-S</arg
> <arg choice="opt"
>-L</arg
> </group
> <arg choice="opt"
>--match-case</arg
> <arg choice="opt"
>--nosave</arg
> <arg choice="opt"
>-ic <replaceable
>codec</replaceable
></arg
> <arg choice="opt"
>-if <replaceable
>format</replaceable
></arg
> <arg choice="opt"
>-if-opts <replaceable
>opcions-format</replaceable
></arg
> <arg choice="opt"
>-oc <replaceable
>codec</replaceable
></arg
> <arg choice="opt"
>-of <replaceable
>format</replaceable
></arg
> <arg choice="opt"
>-of-opts <replaceable
>opcions-format</replaceable
></arg
> <arg choice="opt"
> data-entrada </arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id='description'>
<title
>Descripció</title
> 
<para
><command
>kabcclient</command
> permet accés mitjançant la línia d'ordres a la llibreta d'adreces de &kde;, per exemple en scripts de l'intèrpret d'ordres. Admet entrada des de stdin a través d'arguments addicionals en la línia d'ordres. La sortida sempre s'escriurà a stdout.</para>
</refsect1>

<refsect1 id='options'>
<title
>Opcions</title>
<variablelist>

<varlistentry>
<term
><emphasis
>Modes d'operació</emphasis
></term>
<listitem>
<variablelist>

<varlistentry>
  <term
><option
>-A, --add</option
></term>
  <listitem>
<para
>Afegeix una nova entrada de contacte a la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-R, --remove</option
></term>
  <listitem>
<para
>Elimina una entrada de contacto existent de la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-M, --merge</option
></term>
  <listitem>
<para
>Fusiona les dades d'entrada amb un contacte existent en la llibreta d'adreces. Això afegeix la nova informació a la ja existent.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-S, --search</option
></term>
  <listitem>
<para
>Cerca a la llibreta d'adreces les entrades de contactes que coincideixin.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-L, --list</option
></term>
  <listitem>
<para
>Mostra totes les entrades de la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>


<varlistentry>
<term
><emphasis
>Opcions d'entrada</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>-ic, --input-codec</option
></term>
  <listitem>
<para
>Codifica el text introduït mitjançant una codificació de text establerta. Veure <option
>-ic</option
><replaceable
> ajuda</replaceable
> per a informació addicional sobre codecs d'entrada. Per omissió <emphasis
>local</emphasis
> és la que usarà el codificador per a les preferències actuals de <citerefentry
><refentrytitle
>locale</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if, --input-format</option
></term>
  <listitem>
<para
>Analitza el text introduït d'acord amb les regles de format indicades. Veure <option
>-if</option
><replaceable
> help</replaceable
> per als formats disponibles. Per omissió és <emphasis
>search</emphasis
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
>En comptes de llegir el text introduït, kabcclient pot mostrar un diàleg per a seleccionar els contactes utilitzant el format de l'entrada.</term>
  <listitem>
<para
><emphasis
>diàleg</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if-opts, --input-format-options</option
></term>
  <listitem>
<para
>Opcions addicionals per al formato d'entrada seleccionat. Pot ser opcional, igual que el mandat depenent del format. Veure <option
>-if-opts</option
><replaceable
> help</replaceable
> per a les opcions de format disponibles.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><emphasis
>Opcions de sortida</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>-oc, --output-codec</option
></term>
  <listitem>
<para
>Codifica el text de sortida mitjançant una codificació especificada. Veure <option
>-oc</option
><replaceable
> help</replaceable
> per a informació addicional sobre els codificadors actuals. Per omissió <emphasis
>local</emphasis
> és el codificador que s'utilitzarà per a les preferències actuals de <citerefentry
><refentrytitle
>locale</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of, --output-format</option
></term>
  <listitem>
<para
>Formats de text de sortida d'acord amb les regles de format indicades. Veure <option
>-of</option
><replaceable
> help</replaceable
> per als formats disponibles. Per omissió és <emphasis
>vcard</emphasis
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of-opts, --output-format-options</option
></term>
  <listitem>
<para
>Opcions addicionals per al format de sortida triat. Pot ser opcional, igual que el mandat, depenent del format. Veure <option
>-of-opts</option
><replaceable
> help</replaceable
> per a les opcions de format disponibles.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><emphasis
>Opcions addicionals</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>--match-case</option
></term>
  <listitem>
<para
>Utilitza la coincidència sensible de text en comprar el text introduït amb les entrades de contactes.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>--nosave</option
></term>
  <listitem>
<para
>Realitza operacions de canvi d'informació com <option
>-A, -R</option
> o <option
>-M</option
> només en memòria, però no escriu els canvis en la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>

</variablelist>
</refsect1>

<refsect1 id='diagnostics'>
<title
>Diagnòstics</title>
<para
>Com de costum, un estat de sortida 0, indica èxit. Depenent del mode d'operació triat, un estat de sortida diferent de 0, indica que l'aplicació ha detectat un problema.</para>
<variablelist>

<varlistentry>
<term
><emphasis
>AFEGEIX</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Error en llegir el text introduït.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Ha fallat la creació d'una entrada de contacte correcta a partir del text introduït, p.ex. sense dades o format incorrecte del text d'entrada per al format d'entrada triat.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Error en desar els canvis a la llibreta d'adreces. Per exemple això es pot deure a que actualment hi ha altres aplicacions bloquejant la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><emphasis
>ESBORRA</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Error en llegir el text introduït.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>El programa podria no esborrar contactes de la llibreta d'adreces. Això es pot deure per un error en analitzar el text introduït, falla en trobar l'entrada del contacte en la llibreta d'adreces o en trobar més d'un contacte idèntic en la llibreta d'adreces. En l'últim cas, s'escriurà un missatge d'error a stderr.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Error en desar els canvis a la llibreta d'adreces. Per exemple això es pot deure a que actualment hi ha altres aplicacions bloquejant la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><emphasis
>FUSIONA</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Error en llegir el text introduït.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>El programa podria no fusionar l'entrada amb cap entrada de contacte de la llibreta d'adreces. Això es pot deure per una falla en analitzar el text introduït, falla en trobar el contacte a la llibreta d'adreces o en trobar més d'una coincidència. En l'últim cas, s'escriurà un missatge d'error a stderr.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Error en desar els canvis a la llibreta d'adreces. Per exemple això es pot deure a que actualment hi ha altres aplicacions bloquejant la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><emphasis
>CERCA</emphasis
></term>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Error en llegir el text introduït.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>El programa podria no trobar cap coincidència d'entrada de contacte a la llibreta d'adreces. Això es pot deure a una falla en analitzar el text introduït, o una falla en trobar el contacte a la llibreta d'adreces.</para>
  </listitem>
  </varlistentry>

</variablelist>
</listitem>
</varlistentry>

</variablelist>
</refsect1>

<refsect1 id='examples'>
<title
>Exemples</title>
<para
><emphasis
>Cercar entrades de contacte amb «Jordi» en el nom o en l'adreça de correu.</emphasis
></para>
<literallayout
>kabcclient -S Jordi
</literallayout>

<para
><emphasis
>Fer el mateix utilitzant coincidència sensible.</emphasis
></para>
<literallayout
>kabcclient --match-case -S Jordi
</literallayout>

<para
><emphasis
>Fer el mateix llegint el text introduït a stdin.</emphasis
></para>
<literallayout
>echo "Jordi" | kabcclient --match-case -S
</literallayout>

<para
><emphasis
>Intentar afegir una nova entrada de contacte utilitzant informació d'una adreça de correu amb format.</emphasis
></para>
<literallayout
>kabcclient --nosave --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout
> 

<para
><emphasis
>Fer el mateix però aquesta vegada desant realment a la llibreta d'adreces canviada.</emphasis
></para>
<literallayout
>kabcclient --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout>

<para
><emphasis
>Mostrar els formats d'entrada disponibles.</emphasis
></para>
<literallayout
>kabcclient -if help
</literallayout>

<para
><emphasis
>Mostrar els formats de sortida disponibles.</emphasis
></para>
<literallayout
>kabcclient -of help
</literallayout>

<para
><emphasis
>Mostrar les opcions disponibles per al format de sortida «email».</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts help
</literallayout>

<para
><emphasis
>Mostrar totes les adreces de correu electrònic de tots els contactes que continguin «Marilyn».</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts allemails -S Marilyn
</literallayout>

<para
><emphasis
>Esborrar tots els contactes seleccionats en el diàleg de selecció de contactes.</emphasis
></para>
<literallayout
>kabcclient --remove -if dialog
</literallayout>

<para
><emphasis
>Exportar els contactes seleccionats a un fitxer VCard (formato de sortida per omissió).</emphasis
></para>
<literallayout
>kabcclient -S -if dialog &gt; contacts.vcf
</literallayout>

</refsect1>

<refsect1 id='author'
><title
>Autor</title>
<para
>Aquest manual fou escrit per en Kevin Krammer &lt;kevin.kramer@gmx.at&gt;. Es permet la còpia, distribució o modificació d'aquest document sota els termes de la Llicencia Pública General de GNU, versió 2 o qualsevol versió posterior publicada per la Free Software Foundation.</para>

<para
>En sistemes Debian, el text complet de la Llicencia Pública General de GNU es pot trobar a /usr/share/common-licenses/GPL.</para>
</refsect1>
</refentry>
