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

<refentry id='kabcclient1'>
<refentryinfo>
<title
>Manuel utilisateur de &kde;</title>
<author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
><email
>kevin.krammer@gmx.at</email
></address>
  </affiliation>
  <contrib
>Auteur</contrib>
</author>
<date
>08/09/2005</date>
<productname
>Environnement de Bureau KDE</productname>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>kabcclient</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>
<refnamediv id='name'>
<refname
>kabcclient</refname>
<refpurpose
>client en ligne de commande pour le carnet d'adresses 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
>format-options</replaceable
></arg
> <arg choice="opt"
>-oc <replaceable
>codec</replaceable
></arg
> <arg choice="opt"
>-of <replaceable
>format</replaceable
></arg
> <arg choice="opt"
>-of-opts <replaceable
>format-options</replaceable
></arg
> <arg choice="opt"
> input-data </arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id='description'>
<title
>Description</title
> 
<para
><command
>kabcclient</command
> permet un accès en ligne de commande au carnet d'adresses de &kde;, par exemple dans les scripts shell. Ce programme travaille sur des éléments en entrée fournis via l'entrée standard ou via des arguments en ligne de commande supplémentaires. Sa sortie est toujours écrite sur la sortie standard.</para>
</refsect1>

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

<varlistentry>
<term
><emphasis
>Modes de fonctionnement</emphasis
></term>
<listitem>
<variablelist>

<varlistentry>
  <term
><option
>-A, --add</option
></term>
  <listitem>
<para
>Ajoute un nouveau contact au carnet d'adresses</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-R, --remove</option
></term>
  <listitem>
<para
>Supprime un contact existant du carnet d'adresses</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-M, --merge</option
></term>
  <listitem>
<para
>Fusionne les données en entrée avec un contact existant dans le carnet d'adresses. Ceci ajoute toute nouvelle information à celles existant déjà</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-S, --search</option
></term>
  <listitem>
<para
>Recherche les contacts correspondants dans le carnet d'adresses</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-L, --list</option
></term>
  <listitem>
<para
>Liste tous les contacts du carnet d'adresses</para>
  </listitem>
  </varlistentry>

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


<varlistentry>
<term
><emphasis
>Options pour l'entrée</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>-ic, --input-codec</option
></term>
  <listitem>
<para
>Ré-encode le texte en entrée avec l'encodage spécifié. Voyez <option
>-ic</option
> <replaceable
> help</replaceable
> pour des informations supplémentaires à propos des codecs en entrée. La valeur par défaut est <emphasis
>local</emphasis
> qui utilisera le codec pour la configuration actuelle de <citerefentry
><refentrytitle
>locale</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if, --input-format</option
></term>
  <listitem>
<para
>Interprète le texte en entrée selon des règles établies de formatage. Voyez <option
>-if</option
><replaceable
> help</replaceable
> pour les formats disponibles. La valeur par défaut est <emphasis
>search</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
>Au lieu de lire du texte en entrée, kabcclient peut afficher une boîte de dialogue permettant de sélectionner des contacts. Pour ce faire, utilisez le format d'entrée nommé</term>
  <listitem>
<para
><emphasis
>dialog</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if-opts, --input-format-options</option
></term>
  <listitem>
<para
>Options supplémentaires pour le format d'entrée choisi. Paramètre pouvant être optionnel ou obligatoire en fonction du format. Voyez <option
>-if-opts</option
><replaceable
> help</replaceable
> pour les options de formatage disponibles</para>
  </listitem>
  </varlistentry>

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

<varlistentry>
<term
><emphasis
>Options pour la sortie</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>-oc, --output-codec</option
></term>
  <listitem>
<para
>Ré-encode le texte en sortie avec l'encodage spécifié. Voyez <option
>-oc</option
> <replaceable
> help</replaceable
> pour des informations supplémentaires à propos des codecs en sortie. La valeur par défaut est <emphasis
>local</emphasis
> qui utilisera le codec pour la configuration actuelle de <citerefentry
><refentrytitle
>locale</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of, --output-format</option
></term>
  <listitem>
<para
>Met en forme le texte en sortie selon des règles établies de formatage. Voyez <option
>-of</option
><replaceable
> help</replaceable
> pour les formats disponibles. La valeur par défaut est <emphasis
>vcard</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of-opts, --output-format-options</option
></term>
  <listitem>
<para
>Options supplémentaires pour le format de sortie choisi. Paramètre pouvant être optionnel ou obligatoire en fonction du format. Voyez <option
>-of-opts</option
><replaceable
> help</replaceable
> pour les options de formatage disponibles</para>
  </listitem>
  </varlistentry>

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

<varlistentry>
<term
><emphasis
>Options supplémentaires</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>--match-case</option
></term>
  <listitem>
<para
>Effectue une recherche sans tenir compte de la casse lors de la comparaison du texte en entrée avec les contacts</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>--nosave</option
></term>
  <listitem>
<para
>Pour les opérations de modification d'informations telles <option
>-A, -R</option
> ou <option
>-M</option
>, ne les effectuer qu'en mémoire sans répercuter les modifications dans le carnet d'adresses</para>
  </listitem>
  </varlistentry>

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

</variablelist>
</refsect1>

<refsect1 id='diagnostics'>
<title
>Diagnostiques</title>
<para
>Comme d'habitude, un code de retour valant zéro indique un succès. En fonction du mode de fonctionnement choisi, un code de retour non nul indique un certain problème rencontré par l'application</para>
<variablelist>

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>La lecture du texte en entrée a échoué</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>La création d'un contact à partir du texte en entrée a échoué, par exemple à cause d'une absence de données ou d'un mauvais format des données pour le format de données choisi</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>L'enregistrement des modifications dans le carnet d'adresses a échoué. Ceci peut par exemple être dû à d'autres applications qui verrouillent actuellement le carnet d'adresses.</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>La lecture du texte en entrée a échoué</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Le programme n'a pu supprimer aucun contact du carnet d'adresses. Ceci peut être dû à un échec d'analyse du texte en entrée, à l'absence de contact correspondant dans le carnet d'adresses ou du fait d'avoir trouvé plus d'un contact correspondant dans le carnet d'adresses. Pour le dernier cas, un message d'erreur est écrit sur la sortie standard</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>L'enregistrement des modifications dans le carnet d'adresses a échoué. Ceci peut par exemple être dû à d'autres applications qui verrouillent actuellement le carnet d'adresses.</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>La lecture du texte en entrée a échoué</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Le programme n'a pu fusionner les données fournies avec aucun des contacts du carnet d'adresses. Ceci peut être dû à un échec d'analyse du texte en entrée, à l'absence de contact correspondant dans le carnet d'adresses ou du fait d'avoir trouvé plus d'un contact correspondant dans le carnet d'adresses. Pour le dernier cas, un message d'erreur est écrit sur la sortie standard</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>L'enregistrement des modifications dans le carnet d'adresses a échoué. Ceci peut par exemple être dû à d'autres applications qui verrouillent actuellement le carnet d'adresses.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><emphasis
>RECHERCHE</emphasis
></term>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>La lecture du texte en entrée a échoué</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Le programme n'a pu trouver aucun contact correspondant dans le carnet d'adresses. Ceci peut être dû à un échec d'analyse du texte en entrée ou à l'absence de contact correspondant dans le carnet d'adresses</para>
  </listitem>
  </varlistentry>

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

</variablelist>
</refsect1>

<refsect1 id='examples'>
<title
>Exemples</title>
<para
><emphasis
>Rechercher les contacts avec « Joe » dans le nom ou l'adresse de courrier électronique</emphasis
></para>
<literallayout
>kabcclient -S Joe
</literallayout>

<para
><emphasis
>Effectuer la même opération mais en tenant compte de la casse</emphasis
></para>
<literallayout
>kabcclient --match-case -S Joe
</literallayout>

<para
><emphasis
>Effectuer la même opération mais en lisant le texte à chercher depuis l'entrée standard</emphasis
></para>
<literallayout
>echo "Joe" | kabcclient --match-case -S
</literallayout>

<para
><emphasis
>Essayer d'ajouter un nouveau contact en utilisant les données d'une adresse formatée de courrier électronique</emphasis
></para>
<literallayout
>kabcclient --nosave --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout
> 

<para
><emphasis
>Effectuer la même opération mais cette fois en enregistrant le carnet d'adresses modifié</emphasis
></para>
<literallayout
>kabcclient --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout>

<para
><emphasis
>Lister les formats d'entrée disponibles</emphasis
></para>
<literallayout
>kabcclient -if help
</literallayout>

<para
><emphasis
>Lister les formats de sortie disponibles</emphasis
></para>
<literallayout
>kabcclient -of help
</literallayout>

<para
><emphasis
>Lister les options disponibles pour le format de sortie « email »</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts help
</literallayout>

<para
><emphasis
>Lister toutes les adresses de courrier électronique de tous les contacts contenant « Marilyn »</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts allemails -S Marilyn
</literallayout>

<para
><emphasis
>Supprimer tous les contacts que l'utilisateur a sélectionné dans la boîte de dialogue de sélection de contacts</emphasis
></para>
<literallayout
>kabcclient --remove -if dialog
</literallayout>

<para
><emphasis
>Exporter les contacts sélectionnés dans un fichier au format vCard (format de sortie par défaut)</emphasis
></para>
<literallayout
>kabcclient -S -if dialog &gt; contacts.vcf
</literallayout>

</refsect1>

<refsect1 id='author'
><title
>Auteur</title>
<para
>Cette page de manuel a été écrite par Kevin Krammer &lt;kevin.krammer@gmx.at&gt;. Il est permis de copier, distribuer et/ou modifier ce document sous les termes de la Licence Publique Générale GNU, version 2 et toute version ultérieure publiée par la Free Software Foundation.</para>

<para
>Sur les systèmes Debian, le texte intégral de la Licence Publique Générale GNU est disponible dans /usr/share/common-licenses/GPL.</para>
</refsect1>
</refentry>
