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

<refentry lang="&language;">
<refentryinfo>
<title
>&kde;-gebruikershandleiding</title>
<author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
><email
>kevin.krammer@gmx.at</email
></address>
  </affiliation>
  <contrib
>Auteur</contrib>
</author>
<date
>2005-09-08</date>
<productname
>K Desktop Environment</productname>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>kabcclient</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>
<refnamediv id='name'>
<refname
>kabcclient</refname>
<refpurpose
>commandoregel-client voor het &kde;-adresboek</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-opties</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-opties</replaceable
></arg
> <arg choice="opt"
> invoer-gegevens </arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id='description'>
<title
>Beschrijving</title
> 
<para
><command
>kabcclient</command
> staat commandoregel toegang tot het &kde;-adresboek, bijvoorbeeld in shell-scripts. Het ondersteunt invoer vanaf stdin of via extra commandoregel-argumenten. Uitvoer gaat altijd naar stdout.</para>
</refsect1>

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

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

<varlistentry>
  <term
><option
>-A, --add</option
></term>
  <listitem>
<para
>Een nieuw contactpersoon toevoegen aan het adresboek</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-R, --remove</option
></term>
  <listitem>
<para
>Een bestaand contactpersoon verwijderen uit het adresboek</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-M, --merge</option
></term>
  <listitem>
<para
>Mengt invoergegevens met een bestaand contactpersoon in het adresboek. Dit voegt elke nieuwe informatie toe aan het bestaande</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-S, --search</option
></term>
  <listitem>
<para
>Zoekt in het adresboek naar contacten die overeenkomen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-L, --list</option
></term>
  <listitem>
<para
>Toont alle contactpersonen in het adresboek</para>
  </listitem>
  </varlistentry>

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


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

  <varlistentry>
  <term
><option
>-ic, --input-codec</option
></term>
  <listitem>
<para
>Laat invoertekst passeren door een gespecificeerde tekstcodering. Zie <option
>-ic</option
><replaceable
> help</replaceable
> voor additionele informatie over invoercodecs. Standaard is <emphasis
>local</emphasis
> die de codec voor de huidige <citerefentry
><refentrytitle
>taalregio</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
>-instellingen zal gebruiken</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if, --input-format</option
></term>
  <listitem>
<para
>Ontleedt de invoertekst volgens gegeven formatteringsregels. Zie <option
>-if</option
><replaceable
> help</replaceable
> voor beschikbare formats. Standaard is <emphasis
>zoeken</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
>In plaats van invoertekst lezen, kan kabcclient een dialoog tonen voor het selecteren van contacten met gebruik van het invoerformat</term>
  <listitem>
<para
><emphasis
>dialoog</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if-opts, --input-format-options</option
></term>
  <listitem>
<para
>Additionele opties voor het gekozen invoerformat. Kan optioneel zijn maar ook verplicht, afhankelijk van het format. Zie <option
>-if-opts</option
><replaceable
> help</replaceable
> voor beschikbare formatopties</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><option
>-oc, --output-codec</option
></term>
  <listitem>
<para
>Laat uitvoertekst passeren door een gespecificeerde tekstcodering. Zie <option
>-oc</option
><replaceable
> help</replaceable
> voor additionele informatie over uitvoercodecs. Standaard is <emphasis
>local</emphasis
> die de codec voor de huidige <citerefentry
><refentrytitle
>taalregio</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
>-instellingen zal gebruiken.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of, --output-format</option
></term>
  <listitem>
<para
>Formatteert de uitvoertekst volgens gegeven formatteringsregels. Zie <option
>-of</option
><replaceable
> help</replaceable
> voor beschikbare formats. Standaard is <emphasis
>vcard</emphasis
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of-opts, --output-format-options</option
></term>
  <listitem>
<para
>Additionele opties voor het gekozen uitvoerformat. Kan optioneel zijn maar ook verplicht, afhankelijk van het format. Zie <option
>-of-opts</option
><replaceable
> help</replaceable
> voor beschikbare formatopties</para>
  </listitem>
  </varlistentry>

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

<varlistentry>
<term
><emphasis
>Extra opties</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>--match-case</option
></term>
  <listitem>
<para
>Gebruikt hoofdlettergevoelige overeenkomsten bij het vergelijken van ingevoerde tekst met de contactpersonen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>--nosave</option
></term>
  <listitem>
<para
>Voer informatiewijzigingsbewerkingen uit zoals <option
>-A, -R</option
> of <option
>-M</option
> alleen in het geheugen, maar schrijf deze wijzigingen niet terug naar het adresboek</para>
  </listitem>
  </varlistentry>

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

</variablelist>
</refsect1>

<refsect1 id='diagnostics'>
<title
>Uitgangcodes</title>
<para
>Zoals gebruikelijk betekent een afsluitstatus van nul succes. Afhankelijk van de gekozen bewerkingsmodus geeft een niet-nul afsluitstatus een bepaald probleem aan dat het programma tegenkwam</para>
<variablelist>

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Lezen van de invoertekst is mislukt</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Een bruikbare contactpersoon aanmaken van de invoertekst is mislukt, bijv. geen gegevens of fout geformatteerde gegevens voor het gekozen invoerformat</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Opslaan van de wijzigingen in het adresboek is mislukt. Dit kan bijvoorbeeld zijn veroorzaakt door andere programma's die het adresboek nu blokkeren.</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Lezen van de invoertekst is mislukt</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Het programma kon geen enkel contactpersoonitem uit het adresboek verwijderen. Dit kan worden veroorzaakt doordat het ontleden van de invoertekst is mislukt, waardoor er geen overeenkomend contactpersoonitem in het adresboek is gevonden of meer dan één item. In het laatste geval wordt er een foutboodschap naar stderr gestuurd</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Opslaan van de wijzigingen in het adresboek is mislukt. Dit kan bijvoorbeeld zijn veroorzaakt door andere programma's die het adresboek nu blokkeren.</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Lezen van de invoertekst is mislukt</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Het programma kon de invoer met geen enkel contactpersoonitem uit het adresboek mengen. Dit kan worden veroorzaakt doordat het ontleden van de invoertekst is mislukt, waardoor er geen overeenkomend contactpersoonitem in het adresboek is gevonden of meer dan één item. In het laatste geval wordt er een foutboodschap naar stderr gestuurd</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Opslaan van de wijzigingen in het adresboek is mislukt. Dit kan bijvoorbeeld zijn veroorzaakt door andere programma's die het adresboek nu blokkeren.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><emphasis
>ZOEKEN</emphasis
></term>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Lezen van de invoertekst is mislukt</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Het programma kon geen enkel overeenkomend contactpersoonitem in het adresboek vinden. Dit kan worden veroorzaakt doordat het ontleden van de invoertekst is mislukt of geen overeenkomend contactpersoonitem in het adresboek is gevonden</para>
  </listitem>
  </varlistentry>

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

</variablelist>
</refsect1>

<refsect1 id='examples'>
<title
>Voorbeelden</title>
<para
><emphasis
>Zoek naar contactpersoonitems met Joe in ofwel de naam of het e-mailadres</emphasis
></para>
<literallayout
>kabcclient -S Joe
</literallayout>

<para
><emphasis
>Doe het zelfde maar gebruik hoofdlettergevoelig zoeken</emphasis
></para>
<literallayout
>kabcclient --match-case -S Joe
</literallayout>

<para
><emphasis
>Doe hetzelfde maar lees de invoertekst van stdin</emphasis
></para>
<literallayout
>echo "Joe" | kabcclient --match-case -S
</literallayout>

<para
><emphasis
>Probeer een nieuwe contactpersoon toe te voegen uit een geformatteerd e-mailadres</emphasis
></para>
<literallayout
>kabcclient --nosave --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout
> 

<para
><emphasis
>Doe hetzelfde, maar sla de wijzigingen op het adresboek</emphasis
></para>
<literallayout
>kabcclient --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout>

<para
><emphasis
>Tonen van de beschikbare formats</emphasis
></para>
<literallayout
>kabcclient -if help
</literallayout>

<para
><emphasis
>Tonen van de beschikbare uitvoerformats</emphasis
></para>
<literallayout
>kabcclient -of help
</literallayout>

<para
><emphasis
>Tonen van de beschikbare opties voor het 'e-mail' uitvoerformat</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts help
</literallayout>

<para
><emphasis
>Toon alle e-mailadressen voor alle contactpersonen die 'Marilyn' bevatten</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts allemails -S Marilyn
</literallayout>

<para
><emphasis
>Alle contactpersonen verwijderen die de gebruiker heeft geselecteerd in de selectiedialoog voor contactpersonen</emphasis
></para>
<literallayout
>kabcclient --remove -if dialog
</literallayout>

<para
><emphasis
>Geselecteerde contactpersonen exporteren naar een vCard-bestand (standaard uitvoerformat)</emphasis
></para>
<literallayout
>kabcclient -S -if dialog &gt; contacts.vcf
</literallayout>

</refsect1>

<refsect1 id='author'
><title
>Auteur</title>
<para
>Deze gebruikerspagina is geschreven door Kevin Krammer &lt;kevin.krammer@gmx.at&gt;. Toestemming wordt gegeven om dit document te kopiëren, te verspreiden en/of te wijzigen onder de bepalingen van de GNU General Public License, Version 2 of een latere versie zoals gepubliceerd door de Free Software Foundation.</para>

<para
>Op Debian systemen kan de complete tekst van de GNU General Public License worden gevonden in /usr/share/common-licenses/GPL.</para>
</refsect1>
</refentry>
