<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&klipper;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE" 
> <!-- change language only here -->
]>

<book lang="&language;">
<bookinfo>
<title
>&klipper;i käsiraamat </title>

<authorgroup>
<author
> <firstname
>Philip</firstname
> <surname
>Rodrigues</surname
> <affiliation
> <address
><email
>phil.rod@ntlworld.com</email
></address
> </affiliation
> </author>

<othercredit role="developer">
<firstname
>Carsten</firstname>
<surname
>Pfeiffer</surname>
<affiliation>
<address
><email
>pfeiffer@kde.org</email
></address>
</affiliation>
<contrib
>Arendaja</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<affiliation>
<address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Korrigeerija</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@online.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit>

</authorgroup>

<copyright>
<year
>2000</year
><year
>2001</year
><year
>2002</year>
<holder
>Philip Rodrigues</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-01-11</date>
<releaseinfo
>2.92.00</releaseinfo>

<abstract>
<para
>&klipper; on &kde; lõikepuhver, <quote
>lõika &amp; aseta</quote
> vahend.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Klipper</keyword>
<keyword
>kdebase</keyword>
<keyword
>lõikepuhver</keyword>
</keywordset>
</bookinfo>
 
<chapter id="introduction">
<title
>Sissejuhatus</title>
<para
>&klipper; on &kde; lõikepuhvrirakendus. See salvestab lõikepuhvri ajaloo ja võimaldab siduda lõikepuhvri sisu rakenduse tegevusega. Anna palun mistahes probleemidest või soovidest teada Carsten Pfeifferile <email
>pfeiffer@kde.org</email
>.</para>

</chapter>

<chapter id="using-klipper">
<title
>&klipper;i kasutamine</title>

<sect1 id="basic-usage">
<title
>Põhialused</title>

<para
>Lõikepuhvri ajaloo vaatamiseks klõpsa &klipper;i ikoonil või kasuta kiirklahvi <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>V</keycap
></keycombo
>. Varasemad lõikepuhvri elemendid on näha ilmuva hüpikmenüü ülaosas. Neist mõne valimine kopeerib selle lõikepuhvrisse, kust see on võimalik tavapäraselt kopeerida suvaliise &kde; või X'i rakendusse.</para>

</sect1>

<sect1 id="actions">
<title
>Tegevused</title>

<para
>&klipper; võib lõikepuhvri sisuga mitmesuguseid operatsioone sooritada vastavalt sellele, kas nad vastavad teatud regulaaravaldisele või mitte. Näiteks lõikepuhvri element, mille alguses seisab <quote
>http://</quote
>, saadetakse &URL;-ina avamiseks  &Netscape;le või &konqueror;ile.</para>

<para
>Selle võimaluse kasutamiseks kopeeri &URL; või failinimi lõikepuhvrisse. Kui see vastab &klipper;i nimekirjas olevale regulaaravaldisele, ilmu menüü, mis pakub vastavaid võimalusi (&eg; Ava &URL; &konqueror;is, ava &URL; &Netscape;s). Vali soovitud tegevus hiire või klaviaturi abil ning &klipper; käivitab valitud rakenduse, avades lõikepuhvri elemendis oleva aadressi.</para>

<para
>Kui sa ei soovi, et lõikepuhvri sisuga midagi ette võetaks, vali <guimenuitem
>Loobu</guimenuitem
>, mis laseb tagasi pöörduda varasema tegevuse juurde. Menüüst lahkudes see kaob, võimaldades jätkata muud tegevust. Aega, kui kaua menüü nähtaval püsib, saab määrata <guilabel
>Eelistuste</guilabel
> dialoogis võimalusega <guilabel
>Tegevuste hüpikmenüü aegumine</guilabel
> kaardil <guilabel
>Üldine</guilabel
>.</para>
	  
<para
>Tegevused võib ka täielikult keelata, klõpsates &klipper;il ja <guimenuitem
>Automaatsed tegevused on lubatud</guimenuitem
>. Sama tulemuse annavad järjestikku rakendatult kiirklahvid <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>V</keycap
></keycombo
> ja <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>X</keycap
></keycombo
>.</para>

<para
>Regulaaravaldisele vastavat lõikepuhvri sisu saab ka enne tegevuse rakendamist redigeerida. Selleks vali &klipper;i hüpikmenüüst käsk <guimenuitem
>Redigeeri sisu...</guimenuitem
> ning ilmuvas dialoogis saadki lõikepuhvri sisu muuta, seejärel vajutusega nupul <guibutton
>Olgu</guibutton
> vastavat tegevust käivitades.</para>

<para
>Kiirklahv <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>R</keycap
></keycombo
> toob esile hüpikmenüü, mis kordab viimast &klipper;i sooritatud tegevust.</para>

</sect1>

<sect1 id="clipboard-modes">
<title
>Lõikepuhvri režiimid</title>

<sect2 id="clipboard-modes-general">
<title
>Üldine</title>
<para
> &klipper;i abil on võimalik määrata lõikepuhvri käitumist kogu &kde;s. Esimene režiim on tuttav &Microsoft; &Windows; ja &Mac; kasutajatele: tekst sisestatakse lõikepuhvrisse rakenduse lõika/kopeeri-võimalusega (sama tulemuse annavad kiirklahvid <keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> ja <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
>) ning selle asetamiseks kasutatakse rakenduse aseta-funktsiooni (või kiirklahvi <keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
>). </para>
<para
> Teine režiim on tuttavam &UNIX; kasutajatele: valitud tekst kopeeritakse lõikepuhvrisse ning see asetatakse hiire <mousebutton
>keskmise</mousebutton
> nupu klõpsuga. </para>
</sect2>

<sect2 id="changing-clipboard-modes">
<title
>Lõikepuhvri režiimide vahetamine</title>
<para
> Lõikepuhvri režiimi vahetamiseks vali &klipper;i hüpikmenüüst <guimenuitem
>&klipper;i seadistamine...</guimenuitem
> ning ilmuvas dialoogis kaart <guilabel
>Üldine</guilabel
>. Lõikepuhvri režiimi määrab raadionupp <guilabel
>Lõikepuhvri sisu ja valikud sünkroniseeritakse</guilabel
>. Kui see on märgitud, toimib lõikepuhver &UNIX; režiimis, kui valitud on lõikepuhvri ja valikupuhvri eraldamine, siis &Windows;/&Mac; režiimis. </para>
</sect2>

</sect1>

</chapter>

<chapter id="preferences">
<title
>&klipper;i eelistused</title>

<sect1 id="viewing-options">

<title
>Eelistuste dialoog</title>

<para
>&klipper;i seadistuste vaatamiseks või muutmiseks ava &klipper;i hüpikmenüü ning vali <guimenuitem
>&klipper;i seadistamine...</guimenuitem
>. Seejärel ilmub &klipper;i eelistuste dialoog, mille sisu kohe kirjeldame.</para>

</sect1>

<sect1 id="general-tab">
<title
>Üldised valikud</title>

<variablelist
> <varlistentry
> <term
><guilabel
>Hüpikmenüü avatakse hiirekursori asukohas</guilabel
></term
> <listitem
><para
>Paneb &klipper;i hüpikmenüüd ilmuma seal, kus asub hiirekursor, selle asemel, et seda tavapäraselt &kde; paneelil avada. See võib olla kasulik, kui oled harjunud hiirt klaviatuurist enam kasutama.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Väljumisel salvestatakse lõikepuhvri sisu</guilabel
></term
> <listitem
><para
>Kui see on lubatud, sunnib elemendi valimine ajaloost &klipper;i kontrolima, kas selle puhul on mingi tegevus võimalik, ning vastavaid valikuid näitama. Kui see ei ole lubatud, ei saa ajaloost tegevusi käivitada.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tegevusi rakendatakse ka ajaloost valitud elementidele</guilabel
></term
> <listitem
><para
>Kui see on lubatud, sunnib elemendi valimine ajaloost &klipper;i hüpikmenüüs näitama selle puhul võimalikke tegevusi (kui neid on).</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Lõikepuhvri sisu ja valikud sünkroniseeritakse</guilabel
></term
> <listitem
><para
>Määrab lõikepuhri režiimi. Vaata <xref linkend="clipboard-modes"/>. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tühja lõikepuhvri vältimine</guilabel
></term
> <listitem
><para
>Kui see on lubatud, ei ole lõikepuhver kunagi tühi: &klipper; kannab viimased elemendid lõikepuhvrist selle ajalukku ega luba sel tühjana seista. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Tegevuste hüpikmenüü aegumine</guilabel
></term
> <listitem
><para
>Määrab aja, mille jooksul hüpikmenüü nähtaval püsib, kui sa midagi ette ei võta.</para
></listitem
> </varlistentry
> <varlistentry
><term
><guilabel
>Lõikepuhvri ajaloo suurus</guilabel
></term
> <listitem
><para
>Määrab lõikepuhvri ajalukku salvestatavate elementide arvu.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="actions-tab">
<title
>Tegevusvalikud</title>

<variablelist
> <varlistentry
> <term
>Regulaaravaldise/tegevuse redigeerimine</term
> <listitem
><para
>Klõpsa kaardil <guilabel
>Tegevused</guilabel
> regulaaravaldisele või tegevusele, mida soovid redigeerida. See muutub tekstiväljaks, kus võid avaldist või tegevust oma tahtmist mööda muuta. Kui oled valmis, vajuta kindlasti klahvi <keysym
>Enter</keysym
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Regulaaravaldise/tegevuse lisamine</term
> <listitem
><para
>Kui soovid lisada regulaaravaldise, mida &klipper; saaks kasutada, klõpsa nupul <guibutton
>Lisa tegevus</guibutton
>. &klipper; kasutab &Qt; <classname
>QRegExp</classname
>-i, mis tunnistab enamikku regulaaravaldisi, mida kasutatakse näiteks rakendustes <application
>grep</application
> või <application
>egrep</application
>.</para
> <para
>Regulaaravaldise kirjelduse (&eg; <quote
>HTTP URL</quote
>) saab lisada hiire <mousebutton
>vasaku</mousebutton
> nupu klõpsuga veerul <guilabel
>Kirjeldus</guilabel
>.</para
> <note
><para
>Põhjaliku info <classname
>QRegExp</classname
> regulaaravaldiste kasutamise kohta leiab internetis aadresil <ulink url="http://doc.trolltech.com/qregexp.html#details"
>http://doc.trolltech.com/qregexp.html#details</ulink
>. Pane tähele, et &klipper; ei toeta seal mainitud metamärkide kasutamist.</para
></note
> <para
>Redigeeri regulaaravaldist sarnaselt eespool kirjeldatule. Käivitatava käsu lisamiseks klõpsa hiire <mousebutton
>parema</mousebutton
> nupuga, vali <guimenuitem
>Lisa käsk</guimenuitem
> ning redigeeri käsku, mis ilmub puuna hargneva regulaaravaldise alla.</para
> <para
>Pane tähele, et parameeter <token
>%s</token
> asendatakse käsureal lõikepuhvri sisuga, &eg; kui käsk on <userinput
><command
>kedit</command
> <token
>%s</token
></userinput
> ja lõikepuhvri sisu <filename
>/home/pets/tekstifail</filename
>, siis käivitatakse käsk <userinput
><command
>kedit</command
><filename
>/home/pets/tekstifail</filename
></userinput
>. Et käsurida parameetrit <token
>%s</token
> arvestaks, tuleb see märkida langkriipsuga: <userinput
>\%s</userinput
>.</para
></listitem
> </varlistentry
> <varlistentry
><term
><guibutton
>Muud...</guibutton
></term
> <listitem
><para
>Avab dialoogi <guilabel
>Alltoodud akende klasside (WM_CLASS) ei rakendata tegevusi</guilabel
>.</para
> <para
>Mõned rakendused, näiteks &konqueror;, kasutavad lõikepuhvrit seesmiselt. Kui sa teatud rakendust kasutades oled hädas pidevalt ilmuvate &klipper;i hüpikmenüüdega, võta ette järgmised sammud:</para
> <orderedlist
> <listitem
><para
>Ava rakendus</para
></listitem
> <listitem
><para
>Anna terminalis käsk <userinput
><command
>xprop</command
> | <command
>grep</command
> <parameter
>WM_CLASS</parameter
></userinput
> ning klõpsa siis käivitatud rakenduse aknal</para
></listitem
> <listitem
><para
>Esimene string pärast võrdusmärki ongi see, mis tuleb sisestada</para
></listitem
> </orderedlist
> <para
>Kui WM_CLASS on lisatud, ei käivitata enam selle rakenduse akendes tegevusi.</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="shortcuts-tab">
<title
>Kiirklahvide valikud</title>

<para
>Kiirklahvide kaart võimaldab muuta klahvikombinatsioone, mida saab kasutada &klipper;i võimaluste rakendamiseks. Väärtusi saab muuta järgmiselt:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Puudub</guilabel
></term
> <listitem
><para
>Valitud tegevust ei saa esile kutsuda klaviatuurilt antava otsekorraldusega</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Vaikeväärtus</guilabel
></term
> <listitem
><para
>Valitud tegevuseks kasutatakse &klipper;i vaikimisi määratud kiirklahvi. Need on samad, millest on juttu käesolevas käsiraamatus.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Kohandatud</guilabel
></term
> <listitem
><para
>Valitud tegevust rakendatakse sinu määratud klahvidega.</para
> <para
>Kohandatud klahvi määramiseks klõpsa kiirklahvi näitaval nupul ekraani paremas allservas ning sisesta soovitud kombinatsioon täpselt samamoodi, nagu see käib muudes &kde; rakendustes. </para
> </listitem
> </varlistentry
> </variablelist>

</sect1>
</chapter>

<chapter id="credits">
<title
>Autorid ja litsents</title>

<para
> &klipper; </para>
<para
> Rakenduse autoriõigus 1998: Andrew Stanley-Jones <email
>asj@cban.com</email
> </para>
<para
> Rakenduse autoriõigus 1998-2000: Carsten Pfeiffer <email
>pfeiffer@kde.org</email
></para>
<para
> Praegune hooldaja: Carsten Pfeiffer </para>

<para
> Dokumentatsiooni autoriõigus 2000-2002: Philip Rodrigues <email
>phil.rod@ntlworld.com</email
> </para>

&underFDL;
&underGPL;

</chapter>

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

<sect1 id="getting-klipper">
<title
>&klipper;i hankimine</title>

&install.intro.documentation;

</sect1>


<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>
<para
>&klipper; tuleks kompileerida ja paigaldada koos paketiga kdebase ning see peaks ilmuma KDE 3 käivitamisel &kde; paneelile (&kicker;).</para
> 

<screenshot
> <screeninfo
>&klipper;i ikoon</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="screenshot.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Pilt</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Kui sa seda ei soovi, eemalda fail <filename
>$KDEDIR/share/autostart/klipper.desktop</filename
> või loo fail <filename
>$HOME/share/autostart/klipper.desktop</filename
> järgmise sisuga: <programlisting>
[Desktop Entry]
Hiiden=True
</programlisting
> Viimane võimalus ei kahjusta süsteemi ning väldib &klipper;i käivitumist ainult sinu, mitte aga teiste kasutajate puhul. </para>

</sect1>
</appendix>

&documentation.index; 

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step: 0
End:
-->










