<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY gnupg "<acronym
>GnuPG</acronym
>">
  <!ENTITY gpgconf "<application
>GPGConf</application
>">
  <!ENTITY watchgnupg "<application
>WatchGnuPG</application
>">
  <!ENTITY kwatchgnupg "<application
>KWatchGnuPG</application
>">
  <!ENTITY kappname "&kwatchgnupg;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Polish "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>Podręcznik &kwatchgnupg;</title>

<authorgroup>
<author
><firstname
>Marc</firstname
> <surname
>Mutz</surname
> <affiliation
> <address
>&Marc.Mutz.mail;</address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>Steffen</firstname
> <surname
>Hansen</surname
> <contrib
>Programista</contrib>
<affiliation>
<address
>&Steffen.Hansen.mail;</address>
</affiliation>
</othercredit>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Faure</surname
> <affiliation
> <address
>&David.Faure.mail;</address>
</affiliation>
<contrib
>Programista</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Tomasz</firstname
><surname
>Walach</surname
><affiliation
><address
><email
>tomasz_rysz@o2.pl</email
></address
></affiliation
><contrib
></contrib
></othercredit
> 
</authorgroup>

<legalnotice
>&GPLNotice;</legalnotice>

<date
>2004-05-09</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&kwatchgnupg; jest prostą przeglądarką dziennika &gnupg;. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>Kapp</keyword>
<keyword
>gpg</keyword>
<keyword
>gpgsm</keyword>
<keyword
>GnuPG</keyword>
<keyword
>Przeglądarka dziennika</keyword>
</keywordset>

</bookinfo>

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

<para
>&kwatchgnupg; jest prostą przeglądarką dziennika &gnupg;dla wersji 1.4 i 2.0 &gnupg;. Pracuje jako graficzna nakładka &watchgnupg; narzędzia z konsoli tekstowej, które nasłuchuje gniazdo danych dziennika &gnupg; wspieranych programów. Użyj <userinput
>info watchgnupg</userinput
> dla uzyskania dodatkowych informacji o &watchgnupg;.</para>

<para
>&kwatchgnupg; można uruchomić z menu <menuchoice
><guimenu
>Narzędzia</guimenu
></menuchoice
> programów &kleopatra; i &kmail;, a także z wiersza poleceń. Nazwa polecenia wykonywalnego &kwatchgnupg; to <userinput
>kwatchgnupg</userinput
>. </para>

</chapter>

<chapter id="mainfunc"
><title
>Główne funkcje</title>

<sect1 id="mainfunc.viewing"
><title
>Przeglądanie dziennika</title>

<para
>Podstawowym oczywistym zadaniem &kwatchgnupg; jest prezentacja informacji użytkownikowi z debugowania i logowania &gnupg;. Okno główne jest podzielone na duże okno tekstowe, gdzie pojawiają się generowane przez &gnupg; wiadomości, i pasek narzędzi umożliwiający szybki dostęp do najczęściej potrzebnych funkcji, tak jak w menu wyboru. </para>

<para
>Każdy wiersz tekstu w oknie podglądu jest poprzedzona identyfikatorem <acronym
>FD</acronym
> i odciskiem czasowym w formacie ISO. Identyfikator <acronym
>FD</acronym
> pomaga rozróżnić wynikami z równolegle uruchomionych przypadków &gnupg;. Następnym po odcisku czasu jest nazwa źródła wiersza logowania, razem z niektórymi wewnętrznymi informacjami w nawiasach kwadratowych, następnie oryginalne dane debugowania lub logi wyjściowe przekazane przez składniki. </para>

<para
>Domyślnie liczba wierszy dziennika jaką przechowuje jako historie jest ograniczona do 1000 wierszy. Można skonfigurować rozmiar historii w ustawieniach konfiguracji. </para>

</sect1>

<sect1 id="mainfunc.saving">
<title
>Zapisywanie zawartości okna dziennika do pliku</title>

<para
>Czasami jest przydatne zapisanie obecnej zawartości okna dziennika do pliku, &eg; aby wysłać pocztą elektroniczną do programistów załącznik z informacji o problemach. Można to zrealizować na dwa sposoby w &kwatchgnupg;: </para>

<para
>Pierwszy, można wybrać <menuchoice
><guilabel
>Plik</guilabel
><guimenuitem
>Zapisz jako...</guimenuitem
></menuchoice
> (lub odpowiadającą ikonę z paska narzędzi) aby zapisać kompletną zawartość okna dziennika do pliku. Pojawi się pytanie o podanie położenia dla zapisywanego pliku. </para>

<para
>Drugi, można zaznaczyć interesujące wiersze za pomocą zaznaczania wskaźnikiem myszy i wklejenia do edytora tekstu lub klienta poczty, tak jak inny tekst. Warto zwrócić uwagę aby wiersze nie były przerwane ponieważ zmniejsza to czytelność dziennika. </para>

</sect1>

<sect1 id="mainfunc.clear"
><title
>Czyszczenie okna dziennika</title>

<para
>Wygodnie wyczyści się okno dziennika używając polecenia &kwatchgnupg; <menuchoice
><guimenu
>Plik</guimenu
><guimenuitem
>Wyczyść historię</guimenuitem
></menuchoice
> (lub odpowiadającą ikonę z paska narzędzi). </para>

<para
>Zastosować przed monitorowaną operacją kryptograficzną aby uzyskać wynik z tej operacji. Następnie można zachować używając <menuchoice
><guimenu
>Plik</guimenu
><guimenuitem
>Zapisz jako...</guimenuitem
></menuchoice
> jak opisano powyżej. </para>

<para
>Czyszczenie dziennika usuwa całą zawartość. Jeśli później może być potrzebna obecna zawartość, lepiej zapisać do pliku (opis powyżej) przed czyszczeniem. </para>

</sect1>

</chapter>

<chapter id="configure"
><title
>Konfiguracja &kwatchgnupg;</title>

<para
>Aby skonfigurować &kwatchgnupg;, należy wybrać <menuchoice
><guimenu
>Ustawienia</guimenu
><guimenuitem
>Konfiguracja &kwatchgnupg;...</guimenuitem
></menuchoice
>, lub odpowiadającą ikonę z paska narzędzi. Opcje konfiguracji &kwatchgnupg; są podzielone na dwie części, które zostaną opisane poniżej. </para>

<sect1 id="configure.watchgnupg"
><title
>Ustawienia &watchgnupg;</title>

<para
>&watchgnupg; jest programem, który ciągle monitoruje gniazdo logowania pod względem aktywności i formatuje wiersze widocznych w oknie &kwatchgnupg;. Ustawienia z tej grupy są przekazywane do innych programów z użyciem mechanizmu &gpgconf;. </para>

<para
>Pole <guilabel
>Plik wykonywalny</guilabel
> zawiera ścieżkę do programu &watchgnupg;. Jeśli &watchgnupg; znajduje się w <varname
>$PATH</varname
>, można pozostawić domyślny wpis <userinput
>watchgnupg</userinput
>. A jeśli &watchgnupg; nie znajduje się w <varname
>$PATH</varname
>, lub jest kilka wersji zainstalowanych, wpisać pełną ścieżkę z nazwą do pliku wykonywalnego watchgnupg. </para>

<para
>Pole <guilabel
>Gniazdo</guilabel
> zawiera ścieżkę do gniazda na którym nasłuchuje &watchgnupg;. Zmiany tutaj są przenoszone do wszystkich modułów zewnętrznych &gnupg; używających &gpgconf;, a wiec nie potrzeba zmieniać tych ustawień, jeśli konfiguracja &gnupg; nie ma innych ustawień w <varname
>log-file</varname
>. </para>

<para
><guilabel
>Domyślny poziom logowania</guilabel
> ustala ilość informacji która jest zwracana przez zewnętrzne moduły. Dokumentacja &watchgnupg; opisuje jakie informacje dostarcza dany poziom logowania. Zmiany tutaj są przenoszone do wszystkich modułów zewnętrznych &gnupg; używających &gpgconf;, a wiec nie potrzeba zmieniać tych ustawień jeśli konfiguracja &gnupg; nie ma innych ustawień w <varname
>log-level</varname
>. </para>

</sect1>

<sect1 id="configure.logwindow"
><title
>Ustawienia okna dziennika</title>

<para
>Tutaj można zdefiniować rozmiar bufora historii, tzn. liczbę wierszy dziennika, który jest utrzymywany. Jeśli jest więcej wierszy wysłanych przez &gnupg;, od ostatniego czyszczenia historii, wtedy starsze wiersze są wyrzucane póki nie będzie wystarczającego miejsca dla nowych. </para>

<para
>Klikając na przycisk <guibutton
>Ustaw bez ograniczeń</guibutton
> ustawia się brak limitu na zapis historii. Należy zwrócić uwagę że zużyta pamięć przez &kwatchgnupg; rośnie z liczbą wyświetlanych wierszy. Jeśli używa się nielimitowanego rozmiaru historii, uruchamiać &kwatchgnupg; dla krótkich operacji, lub regularnie czyścić historie samodzielnie. </para>

</sect1>

</chapter>

<chapter id="credits-and-license">
<title
>Zasługi i licencje</title>

<para
>&kwatchgnupg; copyright 2004 Klar&auml;lvdalens Datakonsult AB</para>

<para
>Dokumentacja copyright 2004 Klar&auml;lvdalens Datakonsult AB</para>

<itemizedlist>
<title
>Twórcy</title>
<listitem>
<para
>&Steffen.Hansen; <email
>hansen@kde.org</email
></para>
</listitem>
<listitem>
<para
>&Marc.Mutz; &Marc.Mutz.mail;</para>
</listitem>
<listitem>
<para
>&David.Faure; &David.Faure.mail;</para>
</listitem>
</itemizedlist>

<para
>Tomasz Walach<email
>tomasz_rysz@o2.pl</email
></para
> 
&underFDL; &underGPL; </chapter>

&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:

// vim:ts=2:sw=2:tw=78:noet
-->
