<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY okteta "<application
>Okteta</application
>">
  <!ENTITY kappname "&okteta;">
  <!ENTITY package "kdesdk">
  <!ENTITY Friedrich.Kossebau
"<personname
><firstname
>Friedrich</firstname
><othername
>W. H.</othername
><surname
>Kossebau</surname
></personname
>">
  <!ENTITY Friedrich.Kossebau.email "<email
>kossebau@kde.org</email
>">
  <!ENTITY Alex.Richardson
"<personname
><firstname
>Alex</firstname
><surname
>Richardson</surname
></personname
>">
  <!ENTITY Alex.Richardson.email "<email
>alex.richardson@gmx.de</email
>">
  <!ENTITY % Estonian  "INCLUDE">
  <!ENTITY % addindex "IGNORE">
]>

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

<bookinfo>
<title
>&okteta; käsiraamat</title>

<authorgroup>
    <author
><firstname
>Friedrich</firstname
><othername
>W. H.</othername
><surname
>Kossebau</surname
> <affiliation
> <address
>&Friedrich.Kossebau.email;</address>
      </affiliation>
    </author>
    <author
><firstname
>Alex</firstname
><surname
>Richardson</surname
> <affiliation
> <address
>&Alex.Richardson.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, 2010, 2011</year>
<holder
>&Friedrich.Kossebau; ja &Alex.Richardson;</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2013-11-28</date>
<releaseinfo
>0.12 (&kde; 4.12)</releaseinfo>

<abstract>
  <para
>&okteta; on lihtne failide toorandmete redaktor. Niisuguseid rakendusi nimetatakse ka binaar- või hex-redaktoriteks.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>&package;</keyword>
<keyword
>Okteta</keyword>
<keyword
>vaade</keyword>
<keyword
>redigeerimine</keyword>
<keyword
>bitid</keyword>
<keyword
>baidid</keyword>
<keyword
>binaar</keyword>
<keyword
>kaheksandsüsteem</keyword>
<keyword
>kuueteistkümnendsüsteem</keyword>
<keyword
>binaarfailide redaktor</keyword>
<keyword
>toorandmed</keyword>
</keywordset>
</bookinfo>

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

<para
>&okteta; on lihtne failide toorandmete redaktor.</para>

<para
>Andmeid kuvatakse kahel viisil: baitide arvväärtustena ja väärtustele omistatud märkidena. Väärtusi ja märke võib lasta näidata kahes veerus (niisuguste redaktorite tavapärane kuvamisviis) või ridades, kus väärtus on märgi peal. Redigeerida saab nii väärtusi kui ka märke.</para>

<para
>Lisaks tavapärastele redigeerimisvõimalustele pakub &okteta; veel teatavat valikut tööriistu, näiteks tabelit, mis dekodeerib andmed levinumatesse andmetüüpidesse, tabelit, mis näitab kõiki võimalikke baite koos nende märk- ja väärtusvastetega, infovaadet statistikaga, kontrollsumma kalkulaatorit, filtritööriista ja stringide ekstraktimise tööriista.</para>

<para
>Kõiki laaditud andmetega ette võetud toiminguid saab piiramatult tühistada ja uuesti sooritada.</para>

</chapter>

<chapter id="basics">
<title
>Põhitõed</title>

<sect1 id="starting-basics">
<title
>&okteta; käivitamine</title>

    <para
>Kurjuta käsureale <userinput
><command
>okteta</command
></userinput
> või vali rakenduste käivitajas <menuchoice
><guisubmenu
>Rakendused</guisubmenu
><guisubmenu
>Tööriistad</guisubmenu
></menuchoice
> <guimenuitem
>Binaarfailide redaktor</guimenuitem
>.</para>

    <para
>Kasutada saab tavapäraseid &Qt; ja &kde; käsureavõtmeid, mida saab näha käsuga <userinput
><command
>okteta</command
> <option
>--help</option
></userinput
>.</para>

    <para
>&okteta; spetsiifilised võtmed on järgmised:</para>

    <para
><option
><replaceable
>&lt;&URL;(id)&gt;</replaceable
></option
> - määratud &URL;-i(de)ga faili(de) avamine</para>

</sect1>

<sect1 id="usage-basics">
<title
>Kasutamine</title>

    <para
>&okteta; peaaken koosneb järgmistest komponentidest: menüüriba, tööriistariba, olekuriba, üks või mitu külgriba tööriistadega ning peavaade kaartideks jagatud andmevaadetega.</para>

    <para
>Faili avamisel või uue baidimassiivi loomisel näidatakse sisalduvaid baite üksteise järel ridades, kus iga rea juures on baitide arv. Neid kuvatakse kahel viisil: baitide arvväärtustena või väärtustele omistatud märkidena. Väärtusi ja märke võib lasta näidata kas eraldi kahes veerus või üksteise kõrval, nii et väärtus on märgi peal. Vasakul näidatakse iga rea esimese baidi suhtaadressi.</para>

    <para
>Kasutamine on sarnane enamiku tekstiredaktoritega: andmeid saab redigeerida, lõigata, kopeerida, asetada ja lohistada nagu ikka. Kursor tähistab aktiivset asukohta. Klahviga <keycap
>Insert</keycap
> saab lülitada ülekirjutamis- ja lisamisrežiimi vahel. Ülekirjutamisrežiim on tavalistest tekstiredaktoritest siiski rangem. see ei luba toiminguid, mis muudavad baidimassiivi suurust.</para>

    <para
>Erinevalt teistest tekstiredaktoritest on sisu kuvatud kahes variandis. Sisestamise mõttes on aktiivne ainult üks neist. Kaks omavahel seotud kursorit näitavad vastavalt väärtust ja märki ning aktiivne on see variant, mille kursor plingib. Kui aktiivsed on märgid, saab märke sisestada nagu igas tekstiredaktoris. Kui aktiivsed on väärtused, avab arvu kirjutamine tillukese redaktori, mis võimaldab sisestada ülejäänud väärtuse.</para>

    <para
>Otsingudialoog võimaldab kasutajal otsida konkreetset baidistringi kas väärtusena (16nd-, 10nd-, 8nd-, 2nd-süsteemis) või tekstina (8-bitine kodeering või UTF-8).</para>

    <para
>Korraga võib avada mitu baidimassiivi, kuid ainult üks neist saab olla aktiivne. Seda, milline baidimassiiv on aktiivne, saab valida menüüst <guimenu
>Aknad</guimenu
>.</para>
</sect1>


</chapter>

<chapter id="tools">
  <title
>Tööriistad</title>

<!-- The tool Versions is not part of released versions,
just used for development, so no need to document it. -->
<!--
4.7
Other stuff:
New encodings: ISO-8859-14, ISO-8859-16, Codepage 874
File info tool now estimates the mimetype also for the unstored/edited data in the working memory
FIXME  
-->
<sect1 id="tools-overview">

  <title
>Ülevaade</title>
  <para
>&okteta; pakub mitmeid tööriistu: osad on mõeldud baidimassiivide analüüsimiseks ja käitlemiseks, mõned on üldisemad. Tööriistu saab nähtavale tuua või varjata vastavate kirjetega menüüs <guimenu
>Tööriistad</guimenu
>. Kõigil tööriistadel on pisike vaade, mis paikneb dokina ühel külgribadest või vabalt omaette aknana. Tööriistavaateid saab dokkida, dokist vabastada, ümber korraldada ja pinusse seada hiirega või tööriistavaate tiitliribal &HVNga; klõpsates ja seda vajalikku kohta liigutades, pärast mida tuleb &HVN; toimingu lõpetamiseks lahti lasta või toimingust loobuda klahvile &Esc; vajutades.</para>

<sect2>
  <title
>Analüsaatorid ja käitlejad</title>
<variablelist>
  <varlistentry>
    <term
>Väärtuse/märgitabel</term>
    <listitem
><para
>Tabel toob ära kõik võimalikud baidiväärtused nii märk- kui arvväärtusena.</para>
    <para
>Valitud väärtuse saab sisestada kursori asukohta. Selleks tuleb klõpsata nupule <guibutton
>Lisa</guibutton
> või teha tabelis real topeltklõps.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Binaarfilter</term>
    <listitem
><para
>Filter võimaldab valitud baitidega ette võtta binaartoiminguid. Pärast toimingu (AND, OR, ROTATE...) valimist saab allpool olevas kastis soovi korral paika panna parameetrid. Filtri saab rakendada klõpsuga nupule <guibutton
>Filtreeri</guibutton
>.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Stringid</term>
    <listitem
><para
>See tööriist tuvastab valitud baitides stringid. Stringi miinimumpikkuse valimise järel hangitakse stringid klõpsuga nupule <guibutton
>Hangi</guibutton
>. Näidatavate stringide loendit saab piirata, kui sisestada sobiv filter.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Statistika</term>
    <listitem
><para
>Siin näeb valitud baitide statistikat. See näitab iga valikusse kuuluva baidi esinemissagedust. See arvutatakse välja, kui klõpsata nupule <guibutton
>Loo</guibutton
>.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Kontrollsumma</term>
    <listitem
><para
>See tööriist arvutab mitmesuguseid valitud baitide kontrollsummasid. Pärast algoritmi valimist ja vajaduse korral parameetrite määramist arvutatakse kontrollsumma välja, kui klõpsata nupule <guibutton
>Arvuta</guibutton
>.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Dekodeerimistabel</term>
    <listitem
><para
>Siin näeb baidi või baitide (alates kursorist) väärtust, mida esitatakse selliste levinud andmetüüpide, nagu täis- või murdarv, aga ka UTF-8 kohta. Tabeli real topeltklõpsu tehes käivitab redaktori, kus saab väärtusi muuta.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Struktuurid</term>
    <listitem
><para
>See tööriist võimaldab baidimassiive uurida ja muuta vastavalt kasutaja määratud struktuuridefinitsioonile. Üksikasjalikumalt kõneldakse selles omaette <link linkend="tools-structures"
>osas</link
>.</para
></listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2>
  <title
>Üldised tööriistad</title>
<variablelist>
  <varlistentry>
    <term
>Failisüsteem</term>
    <listitem
><para
>See tööriist pakub põimitud failisirvijat, mille abil saab valida avatavaid faile.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Dokumendid</term>
    <listitem
><para
>See tööriist näitab kõiki viimati loodud või laaditud faile. Sümbolid tähistavad parajasti aktiivses vaates olevat faili, samuti näitavad, millistes failides on salvestamata muudatusi või millist salvestil leiduvat faili on muutnud mõni muu programm.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Järjehoidjad</term>
    <listitem
><para
>Selle tööriista abil saab hallata järjehoidjaid, mis on võimalik ka <link linkend="bookmarks-menu"
><guimenu
>järjehoidjate</guimenu
></link
> menüü vahendusel. <note
><para
>Järjehoidjad on praegu ainult ajutised ning neid ei salvestata, kui sulged baidimassiivi või rakenduse.</para
></note
></para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Failiinfo</term>
    <listitem
><para
>See tööriist näitab mõningat teavet aktiivse faili kohta, sealhulgas selle tüüpi, asukohta ja suurust.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Terminal</term>
    <listitem
><para
>Põimitud terminal; töökataloog ei ole seotud aktiivse failiga.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Märgistiku teisendamine</term>
    <listitem
><para
>See tööriist kirjutab baidid ümber, nii et vastavad märgid oleksid samad nagu teises märgistikus. Toetatud on ainult 8-bitised märgistikud ning vasteta märgid asendatakse praegu väärtusega 0. </para
></listitem>
  </varlistentry>
</variablelist>
</sect2>
</sect1>


<sect1 id="tools-structures">
<!--
Many improvements in the Structures tool by Alex:
Begin of a structure can be pinned to a specific offset
Support for strings (various Unicode encodings) in definitions
  -->
    <title
>Struktuuride tööriist</title>

    <sect2>
      <title
>Üldine</title>

      <para
>Struktuuride tööriist võimaldab baidimassiive analüüsida ja muuta vastavalt kasutaja loodud struktuuridefinitsioonidele, mida saab luua massiividest, ühendutest, primitiivide tüüpidest ja loendiväärtustest</para>
     <!-- explain/link what these types are? probably not, since most user will be programmers? -->
      <para
>Tööriistal on oma seadistustedialoog, mille saab avada nupuga <guibutton
>Seadistused</guibutton
>. Seal saab seadistada mitmesuguseid valikuid, näiteks stiili, millega väärtusi kuvatakse (10nd-, 16nd- või 2nd-süsteem). Samuti saab määrata, millised struktuuridefinitsioonid laaditakse ja milliseid struktuure näidatakse vaates.</para>
      <para
>Struktuurid on defineeritud &okteta; struktuuridefinitsioonifailides (need on &XML;-failid laiendiga <literal role="extension"
>.osd</literal
>). Lisaks sisaldab <literal role="extension"
>.desktop</literal
>-fail struktuuridefinitsioonifaili metaandmeid, näiteks autor, kodulehekülg ja litsents.</para>
      <para
>Praegu puudub struktuuridefinitsioonide loomise või muutmise sisseehitatud toetus, mistõttu seda tuleb teha käsitsi, nagu kirjeldatakse järgmistes lõikudes.</para>
    </sect2>

    <sect2>
      <title
>Struktuuridefinitsioonide paigaldamine</title>

      <sect3>
        <title
>Paigaldamine KNewStuffi abil</title>
        <para
>Lihtsaim viis uusi struktuuridefinitsioone paigaldada on kasutada &okteta;sse sisse ehitatud KNewStuffi toetust. Olemasoleva struktuuri paigaldamiseks avada struktuuritööriista seadistustedialoog. Vali seal kaart <guilabel
>Struktuuride haldamine</guilabel
> ja vajuta nupule <guibutton
>Hangi uusi struktuure...</guibutton
> Ilmub dialoog, mis võimaldab struktuure paigaldada ja eemaldada.</para>
      </sect3>
      <sect3>
        <title
>Struktuuridefinitsioonide käsitsi paigaldamine</title>
        <para
>Struktuuride tööriist otsib struktuuridefinitsioone kasutaja programmi andmete kataloogi (selle saab teada käsuga <userinput
><command
>kde4-config</command
> <option
>--localprefix</option
></userinput
>) alamkataloogis <filename class="directory"
>share/apps/okteta/structures/</filename
>. Kui sul pole veel ühtegi struktuuridefinitsiooni paigaldatud, võib olla vajalik see alamkataloog esmalt luua.</para>
          <para
>Iga struktuuridefinitsioon koosneb kahest failist. Üks sisaldab tegelikku definitsiooni, teine on aga metaandmetele (autor, versioon jne.) mõeldud <literal role="extension"
>.desktop</literal
>-fail.</para>
          <para
>Selles alamkataloogis on oma alamkataloogid igale struktuuridefinitsioonile, mis sisaldavad nii definitsiooni <literal role="extension"
>.desktop</literal
>-faili kui ka <literal role="extension"
>.osd</literal
>- või <filename
>main.js</filename
> faili.</para>
          <para
>Kui näiteks programmi andmete kataloog on <filename class="directory"
>.kde</filename
> ja struktuuridefinitsiooni nimi ExampleStructure, siis on olemas kataloog <filename class="directory"
>.kde/share/apps/okteta/structures/ExampleStructure</filename
>, mis sisaldab faile <filename
>ExampleStructure.desktop</filename
> ja <filename
>ExampleStructure.osd</filename
>.</para>
      </sect3>
      <sect3>
        <title
>Äsja paigaldatud struktuuride kasutamine</title>
        <para
>Kui oled paigaldanud uue struktuuridefinitsiooni, tuleb &okteta; taaskäivitada. Siis ava struktuuri tööriista seadistustedialoog. Vali seal kaart <guilabel
>Struktuuride haldamine</guilabel
> ja kontrolli, et vastav struktuuridefinitsioon on märgitud. Seejärel vali kaart <guilabel
>Struktuurid</guilabel
> ja kontrolli, et soovitud element on ikka parempoolses nimekirjas.</para>
      </sect3>
    </sect2>

    <sect2>
      <title
>Struktuuridefinitsioonide jagamine</title>
      <para
>Levinumate struktuuride jaoks võid muidugi definitsiooni ka ise luua, kuid selle asemel võib kasutada ka teiste loodud definitsioone, mida leiab näiteks veebileheküljelt <ulink url="http://kde-files.org/index.php?xcontentmode=691"
>kde-files.org</ulink
>.</para>
      <para
>Samuti võib jagada teistega enda loodud definitsioone. Selleks loo failiarhiiv (nt. zip-pakenduses tar-arhiiv <literal role="extension"
>.tar.gz</literal
>), mis sisaldab alamkataloogi struktuuri definitsiooni ja <literal role="extension"
>.desktop</literal
>-failiga. Eespool toodud näite põhjal oleks selleks kataloog <filename class="directory"
>ExampleStructure</filename
> kogu oma sisuga. Selle vormingu kasutamine struktuuri definitsioonide jagamiseks võimaldab paigaldada neid otse &okteta;s ega nõua käsitsi paigaldamist.</para>
    </sect2>


    <sect2>
      <title
>Struktuuridefinitsioonide loomine</title>
      <para
>Struktuuridefinitsioone saab luua kahel moel. Esiteks võib kirjutada definitsiooni &XML;-is, teiseks saab kasutada JavaScripti. Viimane võimalus lubab luua keerukamaid struktuure selliste omadustega, nagu näiteks struktuuri valideerimine. &XML;-i kasutamine pakub vähem võimalusi, aga kui vajad ainult staatilist struktuuri, siis on see ilmselt lihtsam viis. Kui vajad aga dünaamilist struktuuri, see tähendab struktuuri, mille puhul massiivi pikkused sõltuvad struktuuri teistest väärtustest või struktuuri ülesehitus muutub, kui mõne liikme väärtus muutub, siis lihtsalt tuleb kirjutada struktuuridefinitsioon JavaScriptis. Reeglist on üks erand: kui tegemist on massiiviga, mille pikkus peab olema <emphasis role="bold"
>täpselt</emphasis
> võrdne teise struktuuri väärtusega, siis võib kasutada ka &XML;-i. Aga kui see on näiteks <emphasis
>length - 1</emphasis
> või midagi sellist, siis peab kasutama JavaScripti.</para>
    </sect2>


    <sect2>
      <title
>Struktuuridefinitsioon &XML;-faili vormingus</title>
      <para
><literal role="extension"
>.osd</literal
> &XML;-failil on üks juurelement: <emphasis
>&lt;data&gt;</emphasis
> ilma atribuutideta. Selle elemendi sees peab olema üks järgmistest elementidest:</para>
      <!-- TODO markup, though better than nothing this way-->
      <variablelist>
          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;primitive&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Primitiivi andmetüübi loomiseks, nt. <emphasis
>int</emphasis
> ja <emphasis
>float</emphasis
>. See element ei luba alamelemente ja sel võivad olla järgmised atribuudid:</para>
              <variablelist>
                <varlistentry>
                <term
><emphasis role="bold"
>type</emphasis
></term>
                <listitem>
                  <para
>Primitiivi tüüp. See peab olema üks järgnevatest:</para>
                  <itemizedlist>
                    <listitem
><para
><emphasis
>char</emphasis
> 8-bitise ASCII märgi korral</para
></listitem>
                    <listitem
><para
><emphasis
>int8, int16, int32, int64</emphasis
> vastava suurusega märgiga täisarvu korral</para
></listitem>
                    <listitem
><para
><emphasis
>uint8, uint16, uint32, uint64</emphasis
> vastava suurusega märgita täisarvu korral</para
></listitem>
                    <listitem
><para
><emphasis
>bool8, bool16, bool32, bool64</emphasis
> vastava suurusega märgita tõeväärtuse (0 = väär, kõik teised väärtused = tõene) korral</para
></listitem>
                    <listitem
><para
><emphasis
>float</emphasis
> 32-bitise IEEE754 murdarvu korral</para
></listitem>
                    <listitem
><para
><emphasis
>double</emphasis
> 64-bitise IEEE754 murdarvu korral</para
></listitem>
                  </itemizedlist>
                </listitem>
                </varlistentry>
              </variablelist>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;bitfield&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Bitivälja loomiseks. See element ei luba alamelemente ja sel võivad olla järgmised atribuudid:</para>
              <variablelist>
                <varlistentry>
                  <term
><emphasis role="bold"
>width</emphasis
></term>
                  <listitem
><para
>Bitivälja kasutatud bittide arv. Peab olema vahemikus 1 kuni 64.</para
></listitem>
                </varlistentry>
                <varlistentry>
                  <term
><emphasis role="bold"
>type</emphasis
></term>
                  <listitem>
                    <para
>Bitivälja tüüp. Peab olema üks järgnevatest:</para>
                    <itemizedlist>
                      <listitem
><para
><emphasis
>unsigned</emphasis
> bitivälja korral, milles väärtust interpreteeritakse märgita väärtusena (väärtus vahemikus 0 kuni 2<superscript
>width</superscript
> - 1)</para
></listitem>
                      <listitem
><para
><emphasis
>signed</emphasis
> bitivälja korral, milles väärtust interpreteeritakse märgiga väärtusena (väärtus vahemikus -2<superscript
>width - 1</superscript
> kuni 2<superscript
>width - 1</superscript
> - 1)</para
></listitem>
                      <listitem
><para
><emphasis
>bool</emphasis
> bitivälja korral, milles väärtust interpreteeritakse tõeväärtusena</para
></listitem>
                  </itemizedlist>
                  <note
><para
>Pea alati meeles lisada <emphasis
>&lt;bitfield&gt;</emphasis
> järele täidis, sest vastasel juhul algab järgmine element (välja arvatud stringid ja massiivid, sest need lisavad täidise automaatselt) baidi keskel. Mõistagi ei ole täidis vajalik, kui see ongi sinu taotlus.</para
></note>
                  </listitem>
                </varlistentry>
              </variablelist>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;enum&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Primitiivi tüübi loomiseks, milles väärtused kuvatakse võimaluse korral väärtustiku liikmetena. See element ei luba alamelemente (küll aga läheb failis vaja sellele viitamiseks silti <emphasis
>&lt;enumDef&gt;</emphasis
>). Sel on järgmised atribuudid:</para>
              <variablelist>
                <varlistentry>
                  <term
><emphasis role="bold"
>enum</emphasis
></term>
                  <listitem
><para
>Väärtuse taga seisev väärtustik. Peab sobima kokku ühe failis esineva sildi <emphasis
>&lt;enumDef&gt;</emphasis
> atribuudiga <emphasis
>name</emphasis
>.</para
></listitem>
                </varlistentry>
                <varlistentry>
                  <term
><emphasis role="bold"
>type</emphasis
></term>
                  <listitem>
                    <para
>Loendi tüüp. Vaata <emphasis
>&lt;primitive&gt;</emphasis
> atribuudi tüüpi. Ainuke erinevus on see, et <emphasis
>Double</emphasis
> ja <emphasis
>Float</emphasis
> on siinkohal ülearused.</para>
                  </listitem>
                </varlistentry>
              </variablelist>
            </listitem>
          </varlistentry>


          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;flags&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Sama, mis <emphasis
>&lt;enum&gt;</emphasis
>, ainult et väärtused esitatakse kõigi väärtustiku väärtuste korral bitikaupa disjunktsioonina (<emphasis
>bitwise-or</emphasis
>).</para
></listitem>
          </varlistentry>

          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;struct&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Struktuuri loomiseks. Kõik teised elemendid (kaasa arvatud <emphasis
>&lt;struct&gt;</emphasis
>) võivad olla selle järglased ja on sel juhul tulemusena saada struktuuri koosseisus</para
></listitem>
          </varlistentry>

          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;union&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Ühenduse loomiseks. Põhimõtteliselt sama, mis <emphasis
>&lt;struct&gt;</emphasis
>, aga kõik järglaselemendid algavad samalt suhtaadressilt. Kasulik sama jada interpreteerimiseks erinevatel viisidel.</para
></listitem>
          </varlistentry>

          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;array&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Massiivi loomiseks. See element lubab täpselt üht järglast (massiivi taga seisev tüüp), mis võib olla suvaline element, isegi <emphasis
>&lt;array&gt;</emphasis
> ise. Samuti on sel järgmised atribuudid:</para>
              <variablelist>
                <varlistentry>
                  <term
><emphasis role="bold"
>length</emphasis
></term>
                  <listitem
><para
>Massiivi elementide arv kümnendnumbrina. See võib aga olla ka string, mis vastab eelnevalt defineeritud elemendi <emphasis
>&lt;primitive&gt;</emphasis
>, <emphasis
>&lt;enum&gt;</emphasis
> või <emphasis
>&lt;flags&gt;</emphasis
> nimeatribuudile. Sel juhul on pikkuseks selle elemendi väärtus. Praegu on piiranguks 10000, sest pikemad massiivid võtaksid liiga palju mälu ja aeglustaksid liialt rakendust. </para
></listitem>
                </varlistentry>
              </variablelist>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term
><emphasis role="bold"
><emphasis
>&lt;string&gt;</emphasis
></emphasis
></term>
            <listitem
><para
>Eri kodeeringus stringi loomiseks. Vaikimisi on see <emphasis
>NULL</emphasis
>-lõpetusega C stiilis string. Siiski võib luua eri tüüpi stringe järgmiste atribuutidega:</para>
              <variablelist>
                <varlistentry>
                  <term
><emphasis role="bold"
>terminatedBy</emphasis
></term>
                  <listitem
><para
>See atribuut määrab, millise Unicode'i märgiga string lõpetatakse. See peab olema kuueteistkümnendsüsteemi arv (lisaks võib sellele eelneda <emphasis
>0x</emphasis
>). Kui kodeeringuks on ASCII, omavad tähendust ainult väärtused kuni 0x7f. Kui määratud pole see ega <emphasis
>maxCharCount</emphasis
> või <emphasis
>maxByteCount</emphasis
>, eeldatakse väärtuseks 0 (C stiilis string). </para
></listitem>
                </varlistentry>
                <varlistentry>
                  <term
><emphasis role="bold"
>maxCharCount</emphasis
></term>
                  <listitem
><para
>Maksimaalne stringis lubatud märkide arv. Kui määratud on ka <emphasis
>terminatedBy</emphasis
>, siis lõpetab stringi see, milleni esimesena jõutakse. See on vastastikku välistav atribuudiga <emphasis
>maxByteCount</emphasis
></para
></listitem>
                </varlistentry>
                <varlistentry>
                  <term
><emphasis role="bold"
>maxByteCount</emphasis
></term>
                  <listitem
><para
>Stringi maksimaalne pikkus baitides. Kui määratud on ka <emphasis
>terminatedBy</emphasis
>, lõpetab stringi see, milleni esimesena jõutakse. See on vastastikku välistav atribuudiga <emphasis
>maxCharCount</emphasis
>. Selliste kodeeringute korral nagu <emphasis
>ASCII</emphasis
> on see võrdne atribuudiga <emphasis
>maxCharCount</emphasis
>.</para
></listitem>
                </varlistentry>
                <varlistentry>
                  <term
><emphasis role="bold"
>type</emphasis
></term>
                  <listitem
><para
>Stringi kodeering. Võib olla üks järgnevatest:</para>
                    <itemizedlist>
                      <listitem
><para
><emphasis
>ASCII</emphasis
></para
></listitem>
                      <listitem
><para
><emphasis
>LATIN-1</emphasis
></para
></listitem>
                      <listitem
><para
><emphasis
>UTF-8</emphasis
></para
></listitem>
                      <listitem
><para
><emphasis
>UTF-16-LE</emphasis
> või <emphasis
>UTF-16-BE</emphasis
>. Kui antud pole ei sufiksit <emphasis
>-LE</emphasis
> ega <emphasis
>-BE</emphasis
>, eeldatakse peeneotsalist (LE). </para
></listitem>
                      <listitem
><para
><emphasis
>UTF-32-LE</emphasis
> või <emphasis
>UTF-32-BE</emphasis
>. Kui antud pole ei sufiksit <emphasis
>-LE</emphasis
> ega <emphasis
>-BE</emphasis
>, eeldatakse peeneotsalist (LE). </para
></listitem>
                    </itemizedlist>
                  </listitem>
                </varlistentry>
              </variablelist>
            </listitem>
          </varlistentry>
      </variablelist>
      <para
>Kõik elemendid lubavad ka atribuuti <emphasis
>name</emphasis
>, mis on hiljem nähtav struktuurivaates. </para>
    </sect2>

    <sect2>
      <title
>Näidisstruktuuridefinitsioon nii &XML;-is kui ka JavaScriptis</title>
      <sect3>
        <title
>Ühine samm mõlemal juhul</title>
        <para
>Metaandmete fail näeb välja selline: <screen>
        [Desktop Entry]
        Encoding=UTF-8
        Icon=arrow-up<co id="icon" />
        Type=Service
        ServiceTypes=KPluginInfo

        Name=Simple test structure
        Comment=A very simple test structure containing only two items

        X-KDE-PluginInfo-Author=Alex Richardson
        X-KDE-PluginInfo-Email=foo.bar@email.org
        X-KDE-PluginInfo-Name=simplestruct
        X-KDE-PluginInfo-Version=1.0
        X-KDE-PluginInfo-Website=http://www.plugin.org/
        X-KDE-PluginInfo-Category=structure
        X-KDE-PluginInfo-License=LGPL
        X-KDE-PluginInfo-EnabledByDefault=false
        </screen
> <calloutlist
> <callout arearefs="icon"
> <para
>Ikoon, mida &okteta; selle struktuuri puhul näitab, võib olla milline tahes, mille leiab käsuga <userinput
><command
>kdialog</command
> <option
>--geticon</option
></userinput
>, või siis ikooni konkreetne asukoht</para
> </callout
> </calloutlist
> Need väljad peaksid olema üsna enesestmõistetavad, välja arvatud ehk <literal
>X-KDE-PluginInfo-Name</literal
>. Selle välja väärtus peab sobima nii kataloogi nimega, mis sisaldab faili, kui ka <literal role="extension"
>.desktop</literal
>-faili nimega. &XML;-struktuuri definitsioone luues peab ka <literal role="extension"
>.osd</literal
>-faili nimi sobima selle nimega. </para>

        <para
>Selles näites on meil kataloog <filename
>simplestruct</filename
>, mis sisaldab faili <filename
>simplestruct.desktop</filename
>. Struktuuride defineerimisel &XML;-is sisaldab kataloog ka faili <filename
>simplestruct.osd</filename
>. JavaScripti kasutamisel on selle asemel fail <filename
>main.js</filename
>.</para>
      </sect3>
      <sect3>
        <title
>Lihtne &XML;-i struktuuridefinitsioon</title>
        <para
>Alustuseks loome definitsiooni hästi lihtsale teststuktuurile, mis sisaldab ainult täisarvulisi andmetüüpe (üks märk, üks 32-bitine täisarv ja bitiväli). Need väljenduvad C/C++ keeles järgmiselt: <screen>
          struct simple {
            char aChar;
            int anInt;
            bool bitFlag :1;
            unsigned padding :7;
          };
          </screen
> Kõigepealt tuleb kirjutada <literal role="extension"
>.osd</literal
>-fail vastavalt eelnevas osas defineeritud failivormingule. Anname sellele nimeks <filename
>simplestruct.osd</filename
>: <screen
><markup>
           &lt;?xml version="1.0" encoding="UTF-8"?&gt;
          &lt;data&gt;
            &lt;struct name="simple"&gt;
              &lt;primitive name="aChar" type="Char"/&gt;
              &lt;primitive name="anInt" type="Int32"/&gt;
              &lt;bitfield name="bitFlag" type="bool" width="1"/&gt;
              &lt;bitfield name="padding" type="unsigned" width="7"/&gt;
            &lt;/struct&gt;
          &lt;/data&gt;
          </markup
></screen
> mis on päris sarnane C/C++ definitsioonile. </para>
          <para
>Nüüd tuleb luua kataloog <filename class="directory"
>simplestruct</filename
> struktuuri paigalduskataloogi, nagu eespool kirjeldatud, kopeerida kaks faili sellesse kataloogi ja taaskäivitada &okteta;.</para>
      </sect3>
      <sect3>
        <title
>Lihtne struktuur JavaScriptis</title>
        <para
>Eelneva struktuuri teostamiseks JavaScriptis loo <filename
>simplestruct.osd</filename
> asemel fail nimega <filename
>main.js</filename
>. Selle sisu peaks olema järgmine:<screen>
        function init() {
          var structure = struct({
            aChar : char(),
            anInt : int32(),
            bitFlag : bitfield("bool", 1),
            padding : bitfield("unsigned", 7),
          })
          return structure;
        }
        </screen
> &okteta; näidatav struktuur on alati funktsiooni <literal
>init</literal
> tagastatav väärtus.</para>
        <para
>Primitiivi tüübi loomiseks võib välja kutsuda järgmisi funktsioone: <itemizedlist
> <listitem
><para
>char()</para
></listitem
> <listitem
><para
>int8(), int16(), int32() või int64()</para
></listitem
> <listitem
><para
>uint8(), uint16(), uint32() või uint64()</para
></listitem
> <listitem
><para
>bool8(), bool16(), bool32() või bool64()</para
></listitem
> <listitem
><para
>float()</para
></listitem
> <listitem
><para
>double()</para
></listitem
> </itemizedlist
> Bitivälja funktsioon kasutab kaht parameetrit, millest esimene on string, mille sisu on <literal
>bool</literal
>, <literal
>signed</literal
> või <literal
>unsigned</literal
>. Teine parameeter on täisarv, mis määrab laiuse bittides. </para>
      </sect3>
      <sect3>
        <title
>Keerulisemad struktuurid</title>
        <para
>Nüüd loome definitsiooni keerulisemale struktuurile, millele annamegi nimeks "complex" ja salvestame failina <filename
>complex.osd</filename
>. See struktuur sisaldab kaht massiivi (üks kindla pikkusega, teise pikkus määratakse käitusajal) ning pesastatud struktuuri ja ühendit. <screen
><markup>
          &lt;?xml version="1.0" encoding="UTF-8"?&gt;
          &lt;data&gt;
            &lt;struct name="complex"&gt;
              &lt;primitive name="size" type="UInt8" /&gt;
              &lt;union name="aUnion"&gt;
                &lt;array name="fourBytes" length="4"&gt;
                  &lt;primitive type="Int8" /&gt;
                &lt;/array&gt;
              &lt;/union&gt;
              &lt;struct name="nested"&gt;
                &lt;array name="string" length="size"&gt; &lt;!-- references the field size above --&gt;
                  &lt;primitive type="Char" /&gt;
                &lt;/array&gt;
              &lt;/struct&gt;
            &lt;/struct&gt;
          &lt;/data&gt;
          </markup
></screen
> Selle vasteks on pseudo-C/C++ korral  <screen
>struct complex {
            uint8_t size;
            union aUnion {
              int8_t fourBytes[4];
            };
            struct nested {
              char string[size] //not valid C++, references value of the uint8 size
            };
          };
          </screen>
          </para>
          <note
><para
>Enne massiivi saavad mõistagi olla ainult dünaamilise pikkusega massiivide viidete väljad.</para
></note>
          <para
>Nüüd loome faili <filename
>complex.desktop</filename
> samamoodi nagu eelmises näites (kontrolli, et <literal
>X-KDE-PluginInfo-Name</literal
> oleks ikka korrektselt määratud) ning järgime eelmist näidet ka mõlema faili paigaldamisel.</para>
      </sect3>
      <sect3>
        <title
>Täiendav teave</title>
        <para
>Mõningaid näidisstruktuuridefinitsioone leiab <ulink url="https://projects.kde.org/projects/kde/kdesdk/okteta/repository/revisions/master/show/kasten/controllers/view/structures/examples/okteta/structures"
>Giti hoidlast</ulink
>. Nende seas on näiteks PNG-failide failipäis ja ELF-faili päis. <literal role="extension"
>.osd</literal
>-faili struktuuri kirjeldava &XML; skeemi leiab <ulink url="https://projects.kde.org/projects/kde/kdesdk/okteta/repository/revisions/master/show/kasten/controllers/view/structures/schema"
>siit</ulink
>. Kui tunned veel millegi vastu huvi, võta ühendust autoriga aadressil &Alex.Richardson.email;. </para>
      </sect3>
    </sect2>
<!--FIXME missing
Extended structures definitions
Structures Script Console-->
</sect1>
</chapter>

<chapter id="interface-overview">
<title
>Liidese tutvustus</title>

<sect1 id="menu-commands">
<title
>Menüükirjed</title>

<para
>Lisaks &kde; üldistele menüüdele, mida kirjeldab &kde; põhitõdede käsiraamatu peatükk <ulink url="help:/fundamentals/ui.html#menus"
>Menüü</ulink
>, on rakendusel mõned spetsiifilised menüükirjed: </para>

<sect2 id="file-menu">
<title
>Menüü Fail</title>

<variablelist>
    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Uus</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Loob uue baidimassiivi...</action
></para>
    <itemizedlist>
    <listitem
><para
><guimenuitem
>Tühi</guimenuitem
>: ...sõna otseses mõttes tühjana.</para>
    </listitem>
    <listitem
><para
><guimenuitem
>Lõikepuhvrist</guimenuitem
>: ...lõikepuhvri sisu põhjal.</para
></listitem>
    <listitem
><para
><guimenuitem
>Muster...</guimenuitem
>: ...määratud mustriga.</para>
    </listitem>
    <listitem
><para
><guimenuitem
>Juhuslikud andmed</guimenuitem
>: ...juhuslike andmetega.</para
></listitem>
    <listitem
><para
><guimenuitem
>Jada</guimenuitem
>: ...kõigi baitidega vahemikus 0 kuni 255.</para
></listitem>
    </itemizedlist>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Fail</guimenu
> <guisubmenu
>Eksport</guisubmenu
> </menuchoice
></term>
    <listitem
><para
>Ekspordib valitud baidid faili...</para>
    <itemizedlist>
    <listitem
><para
><guimenuitem
>Väärtused</guimenuitem
> ... kodeerituna baidiväärtustena. Vaikimisi eraldab väärtusi üks tühimärk. <guilabel
>Eraldusmärke</guilabel
> saab muuta <guilabel
>eksportimise</guilabel
> dialoogis. </para>
    </listitem>
    <listitem
><para
><guimenuitem
>Märgid</guimenuitem
>: ...kodeerituna lihttekstina. </para
></listitem>
    <listitem
><para
><guimenuitem
>Base64</guimenuitem
>: ...kodeerituna <ulink url="https://en.wikipedia.org/wiki/Base64"
>Base64</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>Base32</guimenuitem
>: ...kodeerituna <ulink url="https://en.wikipedia.org/wiki/Base32"
>Base32</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>Ascii85</guimenuitem
>: ... kodeerituna <ulink url="https://en.wikipedia.org/wiki/Ascii85"
>Ascii85</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>Uuencoding</guimenuitem
>: ... kodeerituna <ulink url="https://en.wikipedia.org/wiki/Uuencoding"
>Uuencoding</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>Xxencoding</guimenuitem
>: ... kodeerituna <ulink url="https://en.wikipedia.org/wiki/Xxencoding"
>Xxencoding</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>Intel Hex</guimenuitem
>: ... kodeerituna <ulink url="https://en.wikipedia.org/wiki/Intel_Hex"
>Intel Hex</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>S-Record</guimenuitem
>: ... kodeerituna <ulink url="https://en.wikipedia.org/wiki/S-record"
>S-Record</ulink
> vormingusse.</para
></listitem>
    <listitem
><para
><guimenuitem
>C massiiv</guimenuitem
>: ...massiivina C programmeerimiskeeles.</para
></listitem>
    <listitem
><para
><guimenuitem
>Vaade lihttekstina</guimenuitem
>: ...andmevaatena koos suhtaadresside, baidiväärtuste ja märkidega. </para
></listitem>
    </itemizedlist>
    </listitem>

</varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Fail</guimenu
> <guisubmenu
>Õigused</guisubmenu
> <guimenuitem
>Kirjutuskaitstud</guimenuitem
> </menuchoice
></term>
    <listitem
><para
>Selle määramise korral ei saa laaditud baidimassiivi muudatusi teha.</para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Sulge kõik teised</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Sulgeb kõik baidimassiivid peale aktiivse.</action
></para
></listitem>
    </varlistentry>

</variablelist>
</sect2>

<sect2 id="edit-menu">
<title
>Menüü Redigeerimine</title>
<variablelist>
<para
>Lihtsalt kopeerides ja lõigates andmed lõikepuhvrisse MIME tüübiga <quote
>application/octetstream</quote
> ei suuda &klipper; neid kuvada. Õieti ei suuda seda pea ükski muu rakendus, sest tegemist on puhaste toorandmetega. Niisiis tasub arvestada alammenüüga <guisubmenu
>Kopeeri kui</guisubmenu
>.</para>
    <varlistentry>
    <term
><menuchoice
><guimenu
>Redigeerimine</guimenu
> <guisubmenu
>Kopeeri kui</guisubmenu
> </menuchoice
></term>
    <listitem
><para
>Kopeerib valitud baidid mõnes muus vormingus lõikepuhvrisse. Saadaolevate vormingute kohta vaata menüükirje <menuchoice
><guimenu
>Fail</guimenu
> <guisubmenu
>Eksport</guisubmenu
></menuchoice
> juurest. </para>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Redigeerimine</guimenu
> <guisubmenu
>Lisa</guisubmenu
> </menuchoice
></term>
    <listitem>
    <variablelist>
    <varlistentry>
    <term
><menuchoice>
    <guimenuitem
>Muster...</guimenuitem>
    </menuchoice
></term>
    <listitem
><para
><action
>Lisab kursori asukohta määratud baidistringi.</action
></para>
    <para
>Dialoogi valikud lubavad määrata mustri lisamiskordade arvu ja mustri vormingu (16nd-, 10nd-, 8nd- või 2nd-süsteem, märk või UTF-8).</para>
    <!--FIXME Random Data + Sequence - use cases?-->
    </listitem>
    </varlistentry>
    </variablelist>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Tühista valik</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Tühistab aktiivse valiku.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Vali vahemik...</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Avab põimitud dialoogi valitava vahemiku määramiseks.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>Ins</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Ülekirjutamisrežiim</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Võimaldab valida lisamis- ja ülekirjutamisrežiimi vahel</action
>. </para>
    <note
><para
>Ülekirjutamisrežiim on äärmiselt range: andmete suurust ei ole võimalik muuta (baite ei saa lisada ega eemaldada).</para
></note>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Otsi...</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Võimaldab otsida dokumendist määratud mustrit.</action
>Otsida saab 16nd-, 8nd-, 2nd-süsteemis või tekstimustreid.</para>
    <para
>Dialoogi valikud lubavad määrata alguskoha, suuna ja otsinguvahemiku.</para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Mine suhtaadressile...</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Liigutab kursori määratud suhtaadressile.</action
></para
></listitem>
    </varlistentry>

</variablelist>
</sect2>

<sect2 id="view-menu">
<title
>Menüü Vaade</title>

<variablelist>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Mittetrükitavate märkide näitamine</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Lülitab mittetrükitavate märkide näitamise sisse või välja.</action
> Kui see on väljas, näidatakse märgiveerus vastavates kohtades asendusmärke.</para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycap
>F11</keycap
> </shortcut
><guimenu
> Vaade</guimenu
> <guimenuitem
>Rea suhtaadressi näitamine</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Lülitab rea suhtaadressi näitamise vasakus paneelis sisse või välja.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
><guisubmenu
>Väärtuste või märkide näitamine</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Võimaldab valida, millist baiditõlgendust näidatakse.</action
> Valikud on järgmised:</para>
    <itemizedlist>
    <listitem
><para
><guimenuitem
>Väärtused</guimenuitem
></para>
    </listitem>
    <listitem
><para
><guimenuitem
>Märgid</guimenuitem
></para
></listitem>
    <listitem
><para
><guimenuitem
>Väärtused ja märgid</guimenuitem
></para
></listitem>
    </itemizedlist>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guisubmenu
>Väärtuste kodeering</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Võimaldab valida väärtuste kodeeringu</action
>:</para>
    <itemizedlist>
    <listitem
><para
><guimenuitem
>16nd-süsteemis</guimenuitem
></para
></listitem>
    <listitem
><para
><guimenuitem
>10nd-süsteemis</guimenuitem
></para
></listitem>
    <listitem
><para
><guimenuitem
>8nd-süsteemis</guimenuitem
></para
></listitem>
    <listitem
><para
><guimenuitem
>2nd-süsteemis</guimenuitem
></para
></listitem>
    </itemizedlist>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guisubmenu
>Märkide kodeering</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Võimaldab valida märkide kodeeringu</action
> alammenüüst. </para>
    </listitem>
    </varlistentry>
    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guisubmenu
>Määra baitide arv rea kohta</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Näidatavate baitide valimine rea kohta</action
> dialoogis, kus vaikeväärtus on 16 baiti. </para>
    </listitem>
    </varlistentry>
    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
><guisubmenu
>Määra baitide arv rühma kohta</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Vaikimisi näidatakse kuueteistkümnendväärtusi 4 baidist koosnevates rühmades.</action
> Selle menüükirjega saab dialoogis eelistust muuta. </para>
    </listitem>
    </varlistentry>
    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guisubmenu
>Dünaamiline paigutus</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Määrab andmekuva paigutuse reeglid.</action
> Sellega sätestatakse, kui palju baite, sõltuvalt vaate laiusest, real näidatakse. Võimalikud reeglid on järgmised:</para>
    <itemizedlist>
    <listitem
><para
><guimenuitem
>Väljas</guimenuitem
>: paigutus on fikseeritud aktiivse baitide arvuga rea kohta ning seda ei muudeta ka vaate suuruse muutmisel.</para>
    </listitem>
    <listitem
><para
><guimenuitem
>Ainult täielike baidirühmade murdmine</guimenuitem
>: reale seatakse võimalikult palju baite, peaasi et baidirühmad on terviklikud. </para
></listitem>
    <listitem
><para
><guimenuitem
>Sees</guimenuitem
>: sama, mis eelmine, kuid lubab ka ebatäielikke baidirühmi.</para
></listitem>
    </itemizedlist>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guisubmenu
>Vaaterežiim</guisubmenu
> </menuchoice
></term>
    <listitem
><para
><action
>Võimaldab valida vaate paigutuse</action
>:</para>
    <itemizedlist>
    <listitem
><para
><guimenuitem
>Veerud</guimenuitem
>: väärtusi ja märke näidatakse klassikalise vaatena, mõlemad omaette veerus.</para
></listitem>
    <listitem
><para
><guimenuitem
>Read</guimenuitem
>: märke näidatakse otse väärtuse all.</para
></listitem>
    </itemizedlist>
    </listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Poolita rõhtsuunas</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Jagab parajasti fookuses vaate ala kaheks osaks ning lisab aktiivse vaate koopia uude, alumisse osasse.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>L</keycap
></keycombo
> </shortcut
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Poolita püstsuunas</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Jagab parajasti fookuses vaate ala kaheks osaks ning lisab aktiivse vaate koopia uude, parempoolsesse osasse.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Sulge vaateala</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Sulgeb parajasti fookuses vaate ala.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Vaateprofiil</guimenuitem
> </menuchoice
></term>
    <listitem
><para
>Vaateseadistusi saab salvestada eraldi vaateprofiilidena. Parajasti valitud profiili saab uuendada otse aktiivse vaate seadistustes või siis luua aktiivse põhjal uue profiili. Kõiki vaateprofiile saab hallata dialoogis, mille avab menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>Vaateprofiilide haldamine...</guimenuitem
></menuchoice
></para
></listitem>
    </varlistentry>

</variablelist>

</sect2>

<sect2 id="windows-menu">
<title
>Menüü Aknad</title>

    <para
>Näitab aktiivsete vaadete nimekirja, kust saab valida aktiivse akna.</para>

</sect2>

<sect2 id="bookmarks-menu">
<title
>Menüü Järjehoidjad</title>

    <para
>Ka ühte baidimassiivi võib lisada mitmeid järjehoidjaid. Igal baidimassiivil on oma järjehoidjad, mida näidatakse menüü <guimenu
>Järjehoidjad</guimenu
> allosas. Menüüst järjehoidjat valides viiakse kursor vajalikku kohta ning vastavalt liigub ka vaade. <note
><para
>Järjehoidjad on praegu ainult ajutised ning neid ei salvestata, kui sulged baidimassiivi või rakenduse.</para
></note
></para>

<variablelist>
    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
> </shortcut
> <guimenu
>Järjehoidjad</guimenu
> <guimenuitem
>Lisa järjehoidja</guimenuitem
> </menuchoice
></term>
    <listitem
><para
>Lisab asukoha baidimassiivis järjehoidjatesse.</para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>B</keycap
></keycombo
> </shortcut
> <guimenu
>Järjehoidjad</guimenu
> <guimenuitem
>Eemalda järjehoidja</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Eemalda aktiivse järjehoidja.</action
> Seda käsku saab kasutada ainult siis, kui kursor asub järjehoidjaga asukohas.</para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><guimenu
>Järjehoidjad</guimenu
> <guimenuitem
>Eemalda kõik järjehoidjad</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Puhastab järjehoidjate loendi.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Alt;<keycap
>Up</keycap
></keycombo
> </shortcut
> <guimenu
>Järjehoidjad</guimenu
><guimenuitem
>Liigu eelmisele järjehoidjale</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Liigutab kursori eelmisele järjehoidjale.</action
></para
></listitem>
    </varlistentry>

    <varlistentry>
    <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Alt;<keycap
>Down</keycap
></keycombo
> </shortcut
> <guimenu
>Järjehoidjad</guimenu
> <guimenuitem
>Liigu järgmisele järjehoidjale</guimenuitem
> </menuchoice
></term>
    <listitem
><para
><action
>Liigutab kursori järgmisele järjehoidjale.</action
></para
></listitem>
    </varlistentry>

</variablelist>

</sect2>

<sect2 id="tools-menu">
<title
>Menüü Tööriistad</title>

<para
>Siin näeb paigaldatud tööriistu. Kirjete abil saab nende näitamise sisse või välja lülitada. Kõigi tööriistade täpsema kirjelduse leiab sektsioonist <link linkend="tools"
>Tööriistad</link
>.</para>

</sect2>

<sect2 id="settings-menu">
<title
>Menüü Seadistused</title>
<variablelist>
    <varlistentry>
    <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Vaateprofiilide haldamine...</guimenuitem
> </menuchoice
></term>
    <listitem
><para
>Dialoogi avamine vaikimisi vaateprofiili loomiseks, muutmiseks, kustutamiseks ja määramiseks.</para
></listitem>
    </varlistentry>
</variablelist>

</sect2>

</sect1>

</chapter>

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

    <para
>&okteta; </para>

    <!--List all the copyright holders here-->
    <para
>Rakenduse autoriõigus 2006-2012: &Friedrich.Kossebau; &Friedrich.Kossebau.email;</para>

    <para
>Dokumentatsiooni autoriõigus 2008, 2010: &Friedrich.Kossebau; &Friedrich.Kossebau.email;, &Alex.Richardson; &Alex.Richardson.email;</para>

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

<!-- !!!do not change ANYTHING after this line!!!! -->

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

    <sect1 id="getting-kapp">
        <title
>&okteta; hankimine</title>
&install.intro.documentation; </sect1>

    <sect1 id="Compilation">
        <title
>Kompileerimine ja paigaldamine</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
