<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [

  <!ENTITY kabcclient "<application
>KABC-Client</application
>">
  <!ENTITY kappname "KABCClient">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE">
]>
<!-- The language must NOT be changed here. -->

<book id="kabcclient" lang="&language;">

<bookinfo id="kabcclientinfo">

<title
>&kabcclient;i käsiraamat</title>

<authorgroup>
  <author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
> <email
>kevin.krammer@gmx.at</email>
      </address>
    </affiliation>
  </author>
  <othercredit role="translator"
><firstname
>Marek</firstname
> <surname
>Laane</surname
> <affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>

<copyright>
  <year
>2008</year>
  <holder
>Kevin Krammer</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>2008-11-20</date>
<releaseinfo
>1.1.1</releaseinfo>

<abstract>
  <para
>&kabcclient; on &kde; aadressiraamatute käsurealiides.</para>
</abstract>


<keywordset>
  <keyword
>KDE</keyword>
  <keyword
>&package;</keyword>
  <keyword
>&kappname;</keyword>
  <keyword
>KAddressBook</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Sissejuhatus</title>

<para
>&kabcclient; on &kde; aadressiraamatu käsurealiides. See võimaldab näha kontakte, neid otsida, lisada, eemaldada või liita käsureal või mõne skripti abil. &kabcclient; suudab käidelda mitmeid vorminguid nii sisendina kui ka väljundina, mis lubab seda kasutada kas või kogu &kde; aadressiraamatu importimiseks ja eksportimiseks. </para>

<para
>Kui kutsuda &kabcclient; välja ilma argumentideta, alustab see otsingurežiimis ning püüab leida standardsisendist leitud sisendi põhjal sobivaid kontakti kirjeid &kde; aadressiraamatus.</para>

<para
>&kabcclient;i põhiomadused: <itemizedlist>
  <listitem
><para
>Kõigi &kde; aadressiraamatu kontaktide näitamine</para
></listitem>
  <listitem
><para
>Sisendiga sobivate kontaktide otsimine</para
></listitem>
  <listitem
><para
>Kontaktide lisamine</para
></listitem>
  <listitem
><para
>Kontaktide eemaldamine</para
></listitem>
  <listitem
><para
>Sobivatele kontaktidele uute andmete liitmine</para
></listitem>
</itemizedlist
></para>

<para
>&kabcclient; <emphasis
>ei ole</emphasis
> veel üks &kde; aadressiraamatu (s.t &aadressiraamat;u) graafiline kasutajaliides. &kabcclient; on mõeldud kasutamiseks just sellistel juhtudel, kus graafilise liidese kasutamine ei ole mõttekas või isegi võimalik.</para>

<para
>&kabcclient;<emphasis
>ei paku</emphasis
> igakülgsete päringute võimalust kasutaja aadressiraamatus ja seda ei ole autoritel ka kavas. Kui keegi seda soovib, saab seda teha muude käsureatööriistadega või mõne skriptikeele vahendusel. </para>

<para
>Omaduste lihtsamaks tuvastamiseks saab iga võtit, mis vajab argumenti, välja kutsuda ka väärtusega <replaceable
>help</replaceable
>. Sel juhul näidatakse kõiki väärtusi, mida antud võtmele saab anda. </para>

</chapter>

<chapter id="features">
<title
>Võimalused</title>
<para
>Selles peatükis kirjeldatakse &kabcclient;i põhiomadusi ning nende juhtimist käsureaparameetritega (meenutame, et &kabcclient; ei ole graafiline kasutajaliides, vaid ainult käsureal töötav programm).</para>

<para
>Siin saab teada, kuidas lisada, kustutada ja otsida kontaktide andmeid ning kuidas kasutada sisendi ja väljundi puhul erinevaid vorminguid. </para>

<sect1 id="listing">
<title
>Aadressiraamatu sisu näitamine</title>

<para
>See on kõige elementaarsem töörežiim, mille saab käivitada võtmega <parameter
>--list</parameter
> või <parameter
>-L</parameter
>. &kabcclient; võtab ette kõik &kde; aadressiraamatu kontaktid ja kirjutab andmed programmi standardväljundisse. Väljundi maht ja vorming sõltuvad valitud väljundvormingust.</para>

<para>
<informalexample
><para
>Kõigi kontaktide nägemiseks standardsete vCardi kirjetena anna lihtsalt käsk:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient <option
>-L</option
></command>
</userinput
>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Et näha iga kontakti ainult ühel real, kui näiteks soovid lihtsalt nende arvu teada saada, anna käsk:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient <option
>-L</option
> <option
>-of <replaceable
>uid</replaceable
></option
></command>
</userinput
>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Järgmises näites tahame näha kõigi e-posti aadresse:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--list</option
> <option
>-of <replaceable
>email</replaceable
></option>
</userinput
>
</screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="searching">
<title
>Sisendandmetele sobivate kontaktide otsimine</title>

<para
>&kabcclient; võib võtta andmed käsurealt või programmi standardsisendist ning kontrollida, kas &kde; aadressiraamatus leidub neile minteid vasteid. Otsimine on vaikimisi režiim, kuid seda võib välja kutsuda ka konkreetselt, kasutades käsureaargumenti <parameter
>--search</parameter
> või <parameter
>-S</parameter
>. </para>

<para>
<informalexample
><para
>Järgmises näites kirjutatakse kõik kontaktid, mille mis tahes nimeväljal või e-posti aadressis esineb <replaceable
>jane</replaceable
>, programmi standardväljundisse vCardi vormingus (see on nimelt võtme <option
>--output-format</option
> puhul vaikeväärtus):</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--search</option
> <replaceable
>jane</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Sama päring uuesti, aga sedakorda loetakse otsingustring programmi standardsisendist:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>echo</command
> <replaceable
>jane</replaceable
> | <command
>kabcclient</command
> <option
>--search</option
></userinput
></screen>
</para>
</informalexample>
</para>

<para
>Päringu tõstutundlikkust saab lülitada võtmega <option
>--match-case</option
>.</para>
</sect1>

<sect1 id="adding">
<title
>Kontaktide lisamine</title>

<para
>&kabcclient; toetab uute kontaktide lisamist &kde; aadressiraamatusse käsureaargumendiga <parameter
>--add</parameter
> või <parameter
>-A</parameter
>. Andmed võib edastada täiendavate käsureaargumentidena või lugeda standardsisendist. Edu korral kirjutatakse lisatud kontaktid programmi standardväljundisse. Et see toiming muudab aadressiraamatut, võib seda käivitada ka nii-öelda kuivalt, lisades võtme <option
>--nosave</option
>, mille korral tegelikult muudatusi ei tehta. </para>

<para>
<informalexample
><para
>Nime ja e-posti aadressiga kontakti lisamine täiendavat käsureaargumenti sisendandmeteks võttes:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>email</replaceable
> </option
><replaceable
>"John Doe &lt;j.doe@example.com&gt;"</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Kõigi kontaktide lisamine vCardi failist, mis saadetakse programmi standardsisendisse:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>cat <replaceable
>example-file.vcf</replaceable
></command
> | <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>vcard</replaceable
> </option
></userinput
></screen>
</para>
</informalexample>
</para>
</sect1>

<sect1 id="deleting">
<title
>Kontaktide kustutamine</title>

<para
>&kabcclient; toetab kontaktide kustutamist &kde; aadressiraamatust käsureaargumendiga <parameter
>--remove</parameter
> või <parameter
>-R</parameter
>. Sisendandmed on põhimõtteliselt samasugune päring nagu aadressiraamatust otsimise puhul. Edu korral kirjutatakse eemaldatud kontaktid programmi standardväljundisse. Et see toiming muudab aadressiraamatut, võib seda käivitada ka nii-öelda kuivalt, lisades võtme <option
>--nosave</option
>, mille korral tegelikult muudatusi ei tehta. </para>

<warning
><para
>Kui kustutad midagi aadressiraamatust, siis <emphasis
>ei saa</emphasis
> seda tagasi võtta! See tähendab, et kui oled midagi kustutanud, siis ei saa lihtsalt kustutamiskäsku tühistada ja loota, et kõik on endine. Kui oled millegi kustutanud, siis see ongi jäädavalt kustutatud.</para
></warning>

<para>
<informalexample
><para
>Test kõigi kontaktide eemaldamiseks, mille nimes või e-posti aadressis esineb <replaceable
>jane</replaceable
>:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--remove</option
> <option
>--nosave</option
> <replaceable
>jane</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="formats">
<title
>Sisend- ja väljundvormingud</title>

<para
>&kabcclient; võib tõlgendada sisendandmeid ja vormindada väljundandmeid mitmesuguste vormindamisreeglite järgi. Sõltuvalt konkreetsest stsenaariumist on parim variant just mõni kindel kombinatsioon. Mõne vormingu puhul saab kasutada lisaparameetreid vormingu täiendavaks kohandamiseks. </para>

<para
>Kuna tekstiandmeid saab kodeerida, on võimalik dekodeerimist või kodeerimist rakendada vastavalt nii sisendi kui väljundi puhul. </para>

<para
>Kõigi käsureavõtmete korral saab lubatud väärtuste teadasaamiseks kasutada eriväärtust <replaceable
>help</replaceable
>.</para>

<sect2 id="vcard-format">
<title
>vCardi vorming</title>

<para
>vCard (<acronym
>RFC</acronym
> 2426) on kontaktandmete standardvorming ning võib sestap esitada kogu teavet, mida saavad kasutada teised aadressiraamatu rakendused, näiteks &aadressiraamat;. Seepärast on see ka väljundi vaikevorming. </para>
</sect2>

<sect2 id="csv-format">
<title
>Komadega eraldatud väärtuste (<acronym
>CSV</acronym
>) vorming</title>

<para
>Komadega eraldatud väärtusi võib kasutada sisendvorminguna kontakti kirje konkreetsete väljade täitmiseks andmetega ning värjundvorminguna andmete taandamiseks või ümberkorraldamiseks edasise töötlemise huvides. Piisava paindlikkuse võimaldamiseks kontakti väljade seondamisel CSV veergudega saab viimaseid määrata CSV malli kirjendusfailide abil, mida samal eesmärgil kasutab ka &aadressiraamat;. </para>
</sect2>
</sect1>
</chapter>

<chapter id="features-commandline-options">
<title
>Käsureaargumendid</title>

<para
>&kabcclient; toetab järgmisi võtmeid:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Võti</entry>
  <entry
>Kirjeldus</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help, --help-all</option
></entry>
  <entry
>Näitab abiteadet rakenduse võtmete kohta.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Näitab infot programmi autori kohta.</entry>
</row>
<row>
  <entry
><option
>-v, --version</option
></entry>
  <entry
>Näitab programmi versiooni.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Näitab infot programmi litsentsi kohta.</entry>
</row>
<row>
  <entry
><option
>--verbose</option
></entry>
  <entry
>Näitab töö ajal selgitavaid teateid.</entry>
</row>
<row>
  <entry
><option
>--nosave</option
></entry>
  <entry
>Näitab, mida vastav käsk teeb, aga ei tee seda tegelikult, see tähendab ei muuda midagi &kde; aadressiraamatus, ei lisa, eemalda ega muuda olemasolevaid kontakte.</entry>
</row>
<row>
  <entry
><option
>--match-case</option
></entry>
  <entry
>Sisendandmete võrdlemisel kontakti andmetega aadressiraamatus kasutatakse tõstutundlikku otsingut.</entry>
</row>
<row>
  <entry
><emphasis
>Peamised töörežiimid:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-L, --list</option
></entry>
  <entry
>Kõigi kontaktide näitamine määratud ekspordivormingus.</entry>
</row>
<row>
  <entry
><option
>-A, --add</option
></entry>
  <entry
>Kontaktide lisamine aadressiraamatusse.</entry>
</row>
<row>
  <entry
><option
>-R, --remove</option
></entry>
  <entry
>Kontaktide kustutamine aadressiraamatust.</entry>
</row>
<row>
  <entry
><option
>-M, --merge</option
></entry>
  <entry
>Sisendi andmete liitmine sobivale kontaktile aadressiraamatus.</entry>
</row>
<row>
  <entry
><emphasis
>Vormindamine ja kodeering:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-if, --input-format</option
> <replaceable
>vorming</replaceable
></entry>
  <entry
>Määrab, kuidas tõlgendada sisendandmeid. Saadaolevaid väärtusi näeb argumendiga <replaceable
>help</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>-of, --output-format</option
> <replaceable
>vorming</replaceable
></entry>
  <entry
>Määrab, kuidas vormindada väljundandmed. Saadaolevaid väärtusi näeb argumendiga <replaceable
>help</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>-if-opts, --input-format-options</option
> <replaceable
>võtmed</replaceable
></entry>
  <entry
>Sisendvormingu spetsiaalsed kohandamisvõtmed. Saadaolevaid väärtusi näeb argumendiga <replaceable
>help</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>-of-opts, --output-format-options</option
> <replaceable
>võtmed</replaceable
></entry>
  <entry
>Väljundvormingu spetsiaalsed kohandamisvõtmed. Saadaolevaid väärtusi näeb argumendiga <replaceable
>help</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>-ic, --input-codec</option
> <replaceable
>kodeering</replaceable
></entry>
  <entry
>Tekstikodeering sisendandmete jaoks. Saadaolevaid väärtusi näeb argumendiga <replaceable
>help</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>-oc, --output-codec</option
> <replaceable
>kodeering</replaceable
></entry>
  <entry
>Tekstikodeering väljundandmete jaoks. Saadaolevaid väärtusi näeb argumendiga <replaceable
>help</replaceable
>.</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</chapter>

<chapter id="faq">
<title
>Küsimused ja vastused</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Milliseid seadistusfaile kasutab &kabcclient;?</para>
</question>
<answer>
<para
>Mitte ühtki.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para
>Mis on &kabcclient;i rakenduse nimi?</para>
</question>
<answer>
<para
>&kabcclient;i rakenduse nimi ongi <application
>kabcclient</application
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Kuidas saan lisada oma küsimuse sellele <acronym
>KKK</acronym
>-le?</para>
</question>
<answer>
<para
>Saada oma küsimus aadressile <email
>kevin.krammer@gmx.at</email
>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Autorid ja litsents</title>

<para
>&kabcclient;i programmi autoriõigus 2005-2008:</para>

<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

<para
>Dokumentatsiooni autoriõigus 2008:</para>
<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>

<sect1 id="obtaining-application">
<title
>&kabcclient;i hankimine</title>
&install.intro.documentation; <para
>&kabcclient; on kaasas &kde;4-ga ega ole eraldi saadaval. </para>

</sect1>

<sect1 id="requirements">
<title
>Nõuded</title>

<para
>&kabcclient; vajab &kde; standardseid teeke (paketid <filename
>kdelibs</filename
> ja <filename
>kdepimlibs</filename
>). Lähtekoodist kompileerimiseks on veel vajalikud &Qt;, <filename
>kdelibs</filename
>'i ja <filename
>kdepimlibs</filename
>'i arenduspaketid.</para>

<para
>Muudatuste nimekirja leiab failist <filename
>ChangeLog</filename
>.</para>
</sect1>

<sect1 id="configuration">
<title
>Seadistamine</title>

<para
>&kabcclient;i töötamiseks &kde; töökeskkonnas ei ole vaja midagi spetsiaalselt seadistada.</para>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->