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

<refentry id='kabcclient1'>
<refentryinfo>
<title
>&kde; användarhandbok</title>
<author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
><email
>kevin.krammer@gmx.at</email
></address>
  </affiliation>
  <contrib
>Upphovsman</contrib>
</author>
<date
>2005-09-08</date>
<productname
>K-skrivbordsmiljön</productname>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>kabcclient</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>
<refnamediv id='name'>
<refname
>kabcclient</refname>
<refpurpose
>Kommandoradsklient för &kde;:s adressbok</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
>avkodare</replaceable
></arg
> <arg choice="opt"
>-if <replaceable
>format</replaceable
></arg
> <arg choice="opt"
>-if-opts <replaceable
>formatalternativ</replaceable
></arg
> <arg choice="opt"
>-oc <replaceable
>kodare</replaceable
></arg
> <arg choice="opt"
>-of <replaceable
>format</replaceable
></arg
> <arg choice="opt"
>-of-opts <replaceable
>formatalternativ</replaceable
></arg
> <arg choice="opt"
> indata </arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1 id='description'>
<title
>Beskrivning</title
> 
<para
><command
>kabcclient</command
> möjliggör åtkomst av &kde;:s adressbok från kommandoraden, till exempel i skalskript. Det stöder indata från standardinmatningen eller via ytterligare kommandoradsväljare. Utdata skrivs alltid till standardutmatningen.</para>
</refsect1>

<refsect1 id='options'>
<title
>Väljare</title>
<variablelist>

<varlistentry>
<term
><emphasis
>Användningssätt</emphasis
></term>
<listitem>
<variablelist>

<varlistentry>
  <term
><option
>-A, --add</option
></term>
  <listitem>
<para
>Lägger till en ny kontaktpost i adressboken</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-R, --remove</option
></term>
  <listitem>
<para
>Tar bort en befintlig kontaktpost från adressboken</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-M, --merge</option
></term>
  <listitem>
<para
>Sammanfogar indata med en befintlig kontaktpost i adressboken. Det lägger till eventuell ny information till den som redan finns</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-S, --search</option
></term>
  <listitem>
<para
>Söker i adressboken efter motsvarande kontaktposter</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-L, --list</option
></term>
  <listitem>
<para
>Listar alla kontaktposter i adressboken</para>
  </listitem>
  </varlistentry>

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


<varlistentry>
<term
><emphasis
>Indataväljare</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>-ic, --input-codec</option
></term>
  <listitem>
<para
>Skicka indatatext via en angiven textavkodare. Se <option
>-ic</option
> <replaceable
>help</replaceable
> för ytterligare information om avkodare av indata. Förval är <emphasis
>local</emphasis
> som använder avkodaren för nuvarande inställning av <citerefentry
><refentrytitle
>locale</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if, --input-format</option
></term>
  <listitem>
<para
>Tolkar indatatexten enligt angivna formateringsregler. Se <option
>-if</option
><replaceable
> help</replaceable
> för tillgängliga format. Förval är <emphasis
>search</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
>Istället för att läsa indatatext kan kabcclient visa en dialogruta för att välja kontakter med indataformatet</term>
  <listitem>
<para
><emphasis
>dialog</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-if-opts, --input-format-options</option
></term>
  <listitem>
<para
>Ytterligare väljare för det valda indataformatet. Kan vara valfria eller nödvändiga beroende på formatet. Se <option
>-if-opts</option
><replaceable
> help</replaceable
> för tillgängliga formatväljare</para>
  </listitem>
  </varlistentry>

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

<varlistentry>
<term
><emphasis
>Utdataväljare</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>-oc, --output-codec</option
></term>
  <listitem>
<para
>Skicka utdatatext via en angiven textkodare. Se <option
>-oc</option
> <replaceable
>help</replaceable
> för ytterligare information om kodare av utdata. Förval är <emphasis
>local</emphasis
> som använder kodaren för nuvarande inställning av <citerefentry
><refentrytitle
>locale</refentrytitle
><manvolnum
>5</manvolnum
></citerefentry
>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of, --output-format</option
></term>
  <listitem>
<para
>Formaterar utdatatexten enligt angivna formateringsregler. Se <option
>-of</option
><replaceable
> help</replaceable
> för tillgängliga format. Förval är <emphasis
>vcard</emphasis
></para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>-of-opts, --output-format-options</option
></term>
  <listitem>
<para
>Ytterligare väljare för det valda utdataformatet. Kan vara valfria eller nödvändiga beroende på formatet. Se <option
>-of-opts</option
><replaceable
> help</replaceable
> för tillgängliga formatväljare</para>
  </listitem>
  </varlistentry>

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

<varlistentry>
<term
><emphasis
>Ytterligare väljare</emphasis
></term>
<listitem>
<variablelist>

  <varlistentry>
  <term
><option
>--match-case</option
></term>
  <listitem>
<para
>Använd skiftlägeskänslig textmatchning vid jämförelse av indatatext med kontaktposter</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><option
>--nosave</option
></term>
  <listitem>
<para
>Utför bara åtgärder som ändrar information, liksom <option
>-A, -R</option
> eller <option
>-M</option
>, i minnet, men skriv inte tillbaka ändringarna i adressboken</para>
  </listitem>
  </varlistentry>

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

</variablelist>
</refsect1>

<refsect1 id='diagnostics'>
<title
>Diagnostik</title>
<para
>Som vanligt anger avslutningsstatus noll att programmet lyckades. Beroende på valt åtgärdsläge anger en avslutningsstatus skild från noll ett visst problem som programmet stötte på</para>
<variablelist>

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Läsning av indatatexten misslyckades</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Att skapa en lämplig kontaktpost från indatatexten misslyckades, t.ex. ingen data eller felformaterad indata för det valda indataformatet</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Att spara ändringarna i adressboken misslyckades. Det kan exempelvis orsakas av andra program som för närvarande har låst adressboken.</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Läsning av indatatexten misslyckades</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Programmet kunde inte ta bort någon kontaktpost från adressboken. Det kan orsakas av att tolkning av indatatexten misslyckades, att en motsvarande kontaktpost inte hittades i adressboken eller att mer än en motsvarande kontaktpost hittades i adressboken. I det senare fallet skrivs ett felmeddelande ut på standardfelutmatningen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Att spara ändringarna i adressboken misslyckades. Det kan exempelvis orsakas av andra program som för närvarande har låst adressboken.</para>
  </listitem>
  </varlistentry>

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

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

  <varlistentry>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Läsning av indatatexten misslyckades</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Programmet kunde inte sammanfoga indata med någon kontaktpost i adressboken. Det kan orsakas av att tolkning av indatatexten misslyckades, att en motsvarande kontaktpost inte hittades i adressboken eller att mer än en motsvarande kontaktpost hittades i adressboken. I det senare fallet skrivs ett felmeddelande ut på standardfelutmatningen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>3</literal
></term>
  <listitem>
<para
>Att spara ändringarna i adressboken misslyckades. Det kan exempelvis orsakas av andra program som för närvarande har låst adressboken.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><emphasis
>SEARCH</emphasis
></term>
  <term
><literal
>1</literal
></term>
  <listitem>
<para
>Läsning av indatatexten misslyckades</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><literal
>2</literal
></term>
  <listitem>
<para
>Programmet kunde inte hitta någon motsvarande kontaktpost i adressboken. Det kan orsakas av att tolkning av indatatexten misslyckades eller att en motsvarande kontaktpost inte hittades i adressboken</para>
  </listitem>
  </varlistentry>

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

</variablelist>
</refsect1>

<refsect1 id='examples'>
<title
>Exempel</title>
<para
><emphasis
>Sök efter kontaktposter med Anna antingen i namn eller e-postadresser</emphasis
></para>
<literallayout
>kabcclient -S Anna
</literallayout>

<para
><emphasis
>Gör samma sak, men använd skiftlägeskänslig sökning</emphasis
></para>
<literallayout
>kabcclient --match-case -S Anna
</literallayout>

<para
><emphasis
>Gör samma sak, men läs indatatexten från standardinmatningen</emphasis
></para>
<literallayout
>echo "Anna" | kabcclient --match-case -S
</literallayout>

<para
><emphasis
>Försök lägga till en ny kontaktpost med data från en formaterad e-postadress</emphasis
></para>
<literallayout
>kabcclient --nosave --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout
> 

<para
><emphasis
>Gör samma sak med spara verkligen den ändrade adressboken denna gången</emphasis
></para>
<literallayout
>kabcclient --add -if email "Marilyn Monroe &lt;mmonroe@moviestars.com&gt;"
</literallayout>

<para
><emphasis
>Listar tillgängliga indataformat</emphasis
></para>
<literallayout
>kabcclient -if help
</literallayout>

<para
><emphasis
>Listar tillgängliga utdataformat</emphasis
></para>
<literallayout
>kabcclient -of help
</literallayout>

<para
><emphasis
>Listar tillgängliga alternativ för utdataformatet 'email'</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts help
</literallayout>

<para
><emphasis
>Listar alla e-postadresser för alla kontakter som innehåller 'Marilyn'</emphasis
></para>
<literallayout
>kabcclient -of email -of-opts allemails -S Marilyn
</literallayout>

<para
><emphasis
>Tar bort alla kontakter som användaren markerat i dialogrutan för kontaktval</emphasis
></para>
<literallayout
>kabcclient --remove -if dialog
</literallayout>

<para
><emphasis
>Exportera markerade kontakter till en vCard-fil (förvalt utdataformat)</emphasis
></para>
<literallayout
>kabcclient -S -if dialog &gt; kontakter.vcf
</literallayout>

</refsect1>

<refsect1 id='author'
><title
>Upphovsman</title>
<para
>Manualsidan är skriven av Kevin Krammer &lt;kevin.krammer@gmx.at&gt;. Rättighet ges att kopiera, distribuera och/eller ändra dokumentet enligt villkoren i GNU General Public License, version 2 eller en senare version publicerad av Free Software Foundation.</para>

<para
>På Debian-system finns den fullständiga texten för GNU General Public License i /usr/share/common-licenses/GPL.</para>
</refsect1>
</refentry>
