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

<!-- The language must NOT be changed here. -->

<book lang="&language;">

<bookinfo>
<title
>Podręcznik &kalarm-dopelniacz;</title>

<authorgroup>
<author
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
> <address
>&David.Jarvie.mail;</address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
>&David.Jarvie.mail;</address
></affiliation>
<contrib
>Twórca</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Krzysztof</firstname
><surname
>Woźniak</surname
><affiliation
><address
><email
>wozniakk@ceti.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year
><year
>2004</year
><year
>2005</year
><year
>2006</year
><year
>2007</year
><year
>2008</year
><year
>2009</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2008-09-25</date>
<releaseinfo
>2.2.7</releaseinfo>

<abstract>
<para
>&kalarm; to osobisty harmonogram alarmów dla &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarm</keyword>
<keyword
>przypomnienie</keyword>
<keyword
>program planujący</keyword>
</keywordset>

</bookinfo>


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

<para
>Program &kalarm; pozwala na zaplanowanie wyświetlania wiadomości alarmowych, odtwarzania dźwięków, wykonywania poleceń lub wysłania wiadomości email.</para>

<para
>W domyślnym graficznym trybie pracy, &kalarm; wyświetla listę nadchodzących alarmów, pokazując terminy i informacje o nich. Można tu utworzyć nowy alarm, zmienić lub usunąć istniejące alarmy. Można też wyświetlić alarmy, których czas już minął.</para>

<para
>Podczas ustawiania alarmu, można zdecydować czy ma on być regularnie powtarzany oraz czy ma być anulowany, w przypadku gdy nie mógł być wyświetlony w określonym czasie. Dla alarmów wyświetlanych, można wprowadzić wiadomość tekstową, wybrać plik tekstowy lub graficzny do wyświetlenia lub wprowadzić polecenie, którego wynik będzie wyświetlony. Można także wybrać kolor tła dla wiadomości, oraz ustawić odtwarzanie dźwięku lub wypowiedzenie wiadomości.</para>

<para
>Alarmy mogą być także ustawiane za pomocą linii poleceń za pomocą wywołań interfejsu D-Bus.</para>

<para
>Gdy nadejdzie czas wyświetlenia danego alarmu, wiadomość pokazywana jest na wszystkich pulpitach &kde; aby użytkownik jej nie przeoczył. Okno wiadomości wyświetla godzinę, na którą alarm został ustawiony. Okno zawiera też z reguły możliwość odroczenia alarmu, aby był wyświetlony później. Przykładowa wiadomość alarmu: </para>

<screenshot>
<screeninfo
>Zrzut ekranu okna wiadomość programu &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Wiadomość alarmu</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Gdy alarm jest zdefiniowany jako wywołanie polecenia lub wysłanie wiadomości email, program &kalarm; nie wyświetla niczego.</para>

<para
>Program &kalarm; pokazuje ikonę na tacce systemowej, może ona być jednak ukryta jeżeli jest to pożądane.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Użytkowanie programu &kalarm;</title>

<para
>Po uruchomieniu &kalarm; bez parametrów, otwiera się w trybie graficznym. W oknie wyświetlana jest lista zaprogramowanych alarmów.</para>

<tip
><para
>Wszystkie pola przewijania w programie &kalarm; posiadają funkcję przyśpieszania. Aby wartość w polu zmieniała się szybciej, należy wcisnąć klawisz  &Shift; podczas klikania na strzałki obok pola przewijania.</para>

<mediaobject>
<imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</tip>

<sect1 id="alarm-types">
<title
>Typy alarmów</title>

<para
>Podstawowe rodzaje alarmów dostępne w programie &kalarm; są następujące:</para>

<itemizedlist>
<listitem>
<para
>Wyświetla alarm jako wiadomość tekstową wprowadzoną przez użytkownika, zawartość pliku tekstowegolub graficznego albo treść komunikatu wyjściowego polecenia uruchomionego po włączeniu alarmu. Oprócz wyświetlania ww. elementów, może być również zagrany plik dźwiękowy, krótki dźwięk bip lub wypowiedź z syntezatora mowy. Można także określić polecenia do wykonania przed i po wyświetleniu wiadomości alarmu.</para>
</listitem>

<listitem>
<para
>Alarmy w postaci polecenia uruchamiają polecenie lub skrypt powłoki. W przypadku, gdy polecenie wykonane jest bez błędu to nic nie jest wyświetlane na ekranie</para>
</listitem>

<listitem>
<para
>Alarm w postaci e-mail wysyłają wiadomość na podany adres. Nic nie wyświetla się, jeżeli nie wystąpił błąd.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Obsługa błędów</title>

<para
>W przypadku wystąpienia błędu w momencie zajścia wyzwalacza alarmu, wyświetla się komunikat błędu (chyba że użytkownik wcześniej zdecydował, aby nie pokazywać kolejnych komunikatów błędów)</para>

<para
>Jeżeli w trakcie wykonywania polecenia związanego z alarmem wystąpił błąd, do obok pola wiadomości pojawi się biały lub czerwony wykrzyknik, a w kolumnie z kolorem pojawi się czerwona barwa. Szczegółowe informacje o błędzie pojawiają się jako podpowiedź po najechaniu kursorem na linię w liście alarmów. Analogiczne informacje o błędach pojawiają się w przypadku błędów w wykonaniu poleceń przed i po wyświetleniu alarmu wpisanych w oknie "Działania specjalne". W tym jednak przypadku kolumna z kolorem nie zmienia barwy na czerwoną.</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Lista alarmów</title>

<para
>Główne okno programu &kalarm; wyświetla aktualną listę nadchodzących alarmów, wyświetlając ich czas, odstęp do powtórzenia, kolor i tekst wiadomości, nazwę pliku do wyświetlenia, polecenie do wykonania lub temat wiadomości. (Dla alarmów powtarzających się, wyświetlany jest czas następnego wystąpienia alarmu. Dla alarmów z przypomnieniem, pokazywany jest czas właściwego alarmu, a nie przypomnienia).  Ikona po lewej stronie opisu alarmu wskazuje na rodzaj alarmu.</para>

<screenshot>
<screeninfo
>Zrzut ekranu okna głównego programu &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Okno główne</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Dla alarmów powtarzających się, w liście widoczny jest czas najbliższego wystąpienia alarmu i podstawowy okres powtarzania (&eg; <quote
>1 dzień</quote
> dla codziennych wystąpień, <quote
>3 tygodnie</quote
> dla alarmów powtarzanych w każdy poniedziałek i czwartek co trzeci tydzień, <quote
>Logowanie</quote
> dla alarmów wyświetlanych po każdym zalogowaniu).</para>

<para
>W przypadku wystąpienia błędu wykonania polecenia dla alarmów w postaci polecenia, lub polecenia wykonywanego przed lub po wyświetleniu alarmu, w kolumnie kolor pojawi się ikona błędu co zostało opisane powyżej w części <link linkend="errors"
>Obsługa błędów</link
>.</para>

<sect2 id="listappear">
<title
>Zmiana wyglądu listy alarmów</title>

<para
>Alarmy mogą być sortowane w kolejności wg. daty/czasu, częstotliwości powtarzania, koloru, rodzaju lub treści. Zmiana kolejności sortowania odbywa się przez kliknięcie nagłówka danej kolumny, odwrócenie kolejności sortowania odbywa się przez ponowne kliknięcie na ten sam nagłówek.</para>

<para
>Można opcjonalnie wyświetlać czas do uruchomienia każdego alarmu, razem lub zamiast informacji o ustawionym czasie alarmu. Aby wyświetlić lub schować okno z czasem alarmu należy wybrać opcję w menu: <menuchoice
><guimenu
>Widok</guimenu
><guimenuitem
>Pokaż czasy alarmu</guimenuitem
></menuchoice
>. Aby wyświetlić lub schować kolumnę z czasem pozostałym do zadziałania alarmu należy wybrać opcję <menuchoice
><guimenu
>Widok</guimenu
><guimenuitem
>Pokaż czas do alarmu</guimenuitem
></menuchoice
>. Zawsze wyświetlana jest przynajmniej jedna z tych kolumn.</para>

<para
>Jeżeli w użyciu jest wiele kalendarzy alarmów, można ustawić kodowanie alarmów kolorem w zależności od tego, do którego kalendarza należy poprzez ustalenie różnych kolorów tła dla każdego kalendarza.</para>

</sect2>

<sect2 id="expired">
<title
>Zarchiwizowane alarmy</title>

<para
>Domyślnie, &kalarm; archiwizuje alarmu przez pewien czas po ich wygaśnięciu lub usunięciu. (Usunięte alarmy są archiwizowane tylko wtedy gdy przynajmniej raz wystąpiły). Ustawienia czasu archiwizacji możliwe jest w oknie<link linkend="preferences-storage"
>Konfiguracji</link
>.</para>

<para
>Zarchiwizowane alarmy mogą być wyświetlane na liście alarmów po wybraniu opcji <menuchoice
><guimenu
>Widok</guimenu
><guimenuitem
>Show Archived Alarms</guimenuitem
></menuchoice
>. Aby je schować, należy ponownie wybrać opcję <menuchoice
><guimenu
>Widok</guimenu
><guimenuitem
>Show Archived Alarms</guimenuitem
></menuchoice
>.</para>

</sect2>

<sect2 id="search">
<title
>Przeszukiwanie listy alarmów</title>

<para
>Użytkownik może poszukiwać dowolnego tekstu na liście alarmów. Funkcja wyszukiwania znajduje się menu<menuchoice
> <guimenu
>Edycja</guimenu
><guimenuitem
>Znajdź...</guimenuitem
></menuchoice
>. W wyświetlonym oknie dialogowym należy wybrać typ wyszukiwanego alarmu. Aby kontynuować operację wyszukiwania po znalezieniu tekstu można skorzystać z poleceń <menuchoice
> <guimenu
>Edycja</guimenu
><guimenuitem
>Znajdź następne</guimenuitem
></menuchoice
> lub <menuchoice
> <guimenu
>Edycja</guimenu
><guimenuitem
>Znajdź poprzednie</guimenuitem
> </menuchoice
>.</para>

<para
>Przeszukiwanie działa następująco:</para>

<itemizedlist>
<listitem>
<para
>W alarmach wyświetlanych, przeszukiwany jest tekst z treścią wiadomości.</para>
</listitem>

<listitem>
<para
>Dla alarmów wyświetlających plik, przeszukiwana jest ścieżka &URL; pliku.</para>
</listitem>

<listitem>
<para
>Dla alarmów w postaci poleceń, przeszukiwane jest polecenie lub skrypt.</para>
</listitem>

<listitem>
<para
>Dla alarmów w postaci wiadomości przeszukiwane są: temat wiadomości, treść wiadomości, odbiorcy wiadomości i adresy &URL; załączników.</para>
</listitem>
</itemizedlist>

<note
><para
>Tylko alarmy wyświetlane w liście alarmów mogą być przeszukiwane. Jeżeli użytkownik chce przeszukać alarmy archiwalne, musi najpierw włączyć ich wyświetlanie, co zostało opisane w poprzedniej sekcji.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Tworzenie i zarządzanie alarmami</title>

<sect2>
<title
>Tworzenie nowego alarmu</title>

<para
>Aby utworzyć nowy alarm, należy wybrać odpowiedni tym alarmu na wyświetlonej liście. Spowoduje to otwarcie okna <link linkend="alarm-edit-dlg"
>Edycji alarmu</link
> za pomocą którego można ustawić parametry alarmu.</para>

<itemizedlist>
<listitem>
<para
>Wybrać <menuchoice
><guimenu
>Działania</guimenu
> <guimenuitem
>Nowy</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Kliknąć <mousebutton
>Prawy</mousebutton
> przycisk myszy na ikonie na tacce systemowej i wybrać <menuchoice
><guimenuitem
>Nowy alarm</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>

<listitem>
<para
>Nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk na alarmie z listy i wybrać opcję <menuchoice
><guimenuitem
>Nowy</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

<para
>Dodatkowo, można tworzyć wstępnie skonfigurowane alarmy z różnych źródeł:</para>

<itemizedlist>
<listitem>
<para
>Aby utworzyć alarm na podstawie szablonu, należy skorzystać z instrukcji w sekcji<link linkend="templates"
>Szablony alarmów</link
>.</para>
</listitem>

<listitem>
<para
>Aby utworzyć nowy alarm na podstawie istniejącego, należy wybrać pozycję <menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Kopiuj...</guimenuitem
></menuchoice
>. Spowoduje to otwarcie okna <link linkend="alarm-edit-dlg"
>edycji alarmu</link
> wypełnionego ustawieniami pobranymi z kopiowanego alarmu.</para>
</listitem>

<listitem>
<para
>Aby utworzyć alarm wyświetlający wiadomość email, należy przeciągnąć z programu &kmail; wiadomość i opuścić ją w oknie programu &kalarm; lub na ikonie na tacce systemowej. Spowoduje to otwarcie<link linkend="alarm-edit-dlg"
>Okna edycji alarmu</link
>, w którym cała wiadomość email (wraz z nadawcą, odbiorcę, &etc;) będzie wprowadzona jako treść do wyświetlenia.</para>
</listitem>

<listitem>
<para
>Aby utworzyć nowy alarm w postaci wiadomości email, lub wysłać kopię istniejącego maila, należy przeciągnąć wiadomość z okna &kmail; do głównego okna &kalarm-dopelniacz; lub do ikony na tacce systemowej. Następnie należy wybrać opcję <guilabel
>Email</guilabel
>. W oknie <link linkend="alarm-edit-dlg"
>edycji alarmu</link
> pojawią się wszystkie szczegóły emaila poza nadawcą wiadomości.</para>
</listitem>

<listitem>
<para
>Aby utworzyć alarm wyświetlający informację o pozycji do zrobienia, należy przeciągnąć element do zrobienia z &korganizer-dopelniacz; lub innej aplikacji do głównego okna programu &kalarm; lub ikony na tacce systemowej. Otworzy to <link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> w którym zawartość czynności do zrobienia będzie wprowadzona jako treść wiadomości alarmu.</para>
</listitem>

<listitem>
<para
>Przeciągnięcie dowolnego zaznaczonego fragmentu tekstu do okna &kalarm-dopelniacz; lub do ikony na tacce systemowej otwiera <link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> i ustawienie przeciąganego tekstu jako wiadomości alarmu.</para>
</listitem>

<listitem>
<para
>Aby utworzyć alarm wyświetlający zawartość pliku, należy przeciągnąć ścieżkę &URL; do głównego okna &kalarm; lub ikony na tacce systemowej. Otworzy się<link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> z ustawioną nazwą pliku.</para>
</listitem>

<listitem>
<para
>Można automatycznie utworzyć alarmy związane z urodzinami kontaktów z programu &kaddressbook;. Opisane to zostało w sekcji <link linkend="birthdays"
>Importowanie urodzin z&kaddressbook-dopelniacz;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Modyfikacja istniejącego alarmu</title>

<para
>Aby zmodyfikować istniejący alarm oczekujący na wyświetlenie (alarmy których czas minął nie mogą być zmieniane), należy wykonać następujące operacje:</para>

<itemizedlist>
<listitem>
<para
>Dwukrotnie kliknąć na alarmie w liście alarmów.</para>
</listitem>

<listitem>
<para
>Wybrać alarm klikając raz na pozycji w liście alarmów, a następnie wybrać opcję <menuchoice
><guimenu
>Działania</guimenu
> <guimenuitem
>Edytuj</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk na alarmie z listy i wybrać opcję <menuchoice
><guimenuitem
>Edytuj</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

<para
>Wyświetli się okno <link linkend="alarm-edit-dlg"
>Modyfikacji alarmu</link
>.</para>

</sect2>

<sect2>
<title
>Usuwanie/Przywracanie alarmu</title>

<para
>To delete existing alarms, select one or more by clicking on their entries in the alarm list. Then do one of the following:</para>

<itemizedlist>
<listitem>
<para
>Choose <menuchoice
> <guimenu
>Actions</guimenu
><guimenuitem
>Delete</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Right</mousebutton
> click on the selected entries and choose <menuchoice
><guimenuitem
>Delete</guimenuitem
></menuchoice
> from the context menu.</para>
</listitem>
<listitem>
<para
>To delete them without a confirmation prompt, type &Shift;-<keycap
>Delete</keycap
>.</para>
</listitem>
</itemizedlist>

<para
>Przy usuwaniu aktywnego alarmu, jest on przenoszony do archiwum pod warunkiem że został przynajmniej raz aktywowany przed usunięciem oraz jeżeli włączona jest opcja archiwizacji alarmów. (Za pomocą opcji zawartych w <link linkend="preferences-storage"
>oknie konfiguracji</link
> można kontrolować czy i jak długo program będzie przechowywał zarchiwizowane alarmy). Alarmy zarchiwizowane albo takie, które nigdy wcześniej nie były aktywowane usuwane są bezpowrotnie.</para>

<para
>Można ponownie aktywować usunięty alarm z listy zarchiwizowanych alarmów, zakładając że jest on jeszcze dostępny. Aby tego dokonać, najpierw należy włączyć wyświetlanie zarchiwizowanych alarmów, co zostało opisanew sekcji <link linkend="expired"
>Zarchiwizowane alarmy</link
>. Następnie należy:</para>

<itemizedlist>
<listitem>
<para
>Wybrać jeden lub więcej zarchiwizowanych alarmów z listy klikając na odpowiednie pozycje, a następnie skorzystać z opcji <menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Włącz ponownie</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
>Należy nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk na zarchiwizowanym alarmie z listy i wybrać opcję <menuchoice
><guimenuitem
>Włącz ponownie</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Włączanie i wyłączanie alarmu</title>

<para
>W sekcji <link linkend="enable-disable"
>Włączanie i wyłączanie alarmów</link
> znajdują się informacje jak włączać lub wyłączać wszystkie lub wybrane alarmy.</para>

</sect2>

<sect2>
<title
>Potwierdzanie alarmu</title>

<para
>W sekcji <link linkend="message-window"
>Okno wiadomości alarmu</link
> znajdują się informację o tym jak potwierdzać alarmy.</para>

</sect2>

<sect2 id="templates">
<title
>Szablony alarmów</title>

<para
>Jeżeli użytkownik często ustawia podobne alarmy, można utworzyć szablon alarmu aby uniknąć ciągłego powtarzania konfiguracji tych samych ustawień. Szablon może zawierać wszystkie informacje ze zwykłego alarmu, poza terminem rozpoczęcia.</para>

<para
>Przykładowo, możesz często ustawiać alarm przypominający o programie telewizyjnym, który pojawia się o różnych porach dnia z tygodnia na tydzień. Szablon będzie zawierał wszystkie parametry alarmu (tekst wiadomości, czy alarm będzie odtwarzał dźwięk, &etc;) oprócz daty i czasu. Po stworzeniu takiego szablonu, wystarczy teraz na jego podstawie utworzyć nowy alarm i w otwartym oknie <link linkend="alarm-edit-dlg"
>edycji alarmu</link
> wprowadzić datę i czas.</para>

<para
>Aby utworzyć alarm na podstawie szablonu, trzeba otworzyć <link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> z ustawieniami pobranymi z szablonu:</para>

<itemizedlist>
<listitem>
<para
>Należy wybrać polecenie <menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Nowy alarm z szablonu</guimenuitem
> </menuchoice
>, a następnie wybrać pożądany szablon.</para>
</listitem>

<listitem>
<para
>Nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk myszy, wybrać<menuchoice
><guimenuitem
>Nowy alarm z szablonu</guimenuitem
></menuchoice
> w menu kontekstowym, a następnie wybrać pożądany szablon.</para>
</listitem>

<listitem>
<para
>Otworzyć okno <link linkend="alarm-edit-dlg"
>edycji alarmu</link
> w standardowy sposób, a następnie nacisnąć przycisk <guibutton
>Wczytaj szablon...</guibutton
> aby wybrać pożądany szablon.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Konfiguracja szablonów</title>

<para
>Można tworzyć, zmieniać i usuwać szablony za pomocą okna szablonów alarmów, można też utworzyć nowy szablon alarmu na podstawie istniejącego alarmu.</para>

<para
>Aby utworzyć nowy szablon alarmu, należy wykonać następujące operacje:</para>

<itemizedlist>
<listitem>
<para
>Należy otworzyć okno szablonów alarmów przez wybranie polecenia <menuchoice
> <guimenu
>Plik</guimenu
><guimenuitem
>Szablony...</guimenuitem
> </menuchoice
> w menu, następnie trzeba kliknąć <guibutton
>Nowy</guibutton
>, i wybrać rodzaj alarmu z wyświetlonej  listy. Spowoduje to otwarcie pustego okna edycji szablonu.</para>
</listitem>

<listitem>
<para
>Można otworzyć okno szablonów alarmu poprzez wybranie w menu <menuchoice
> <guimenu
>Plik</guimenu
><guimenuitem
>Szablony...</guimenuitem
> </menuchoice
>, wybranie istniejącego szablonu i kliknięcie przycisku <guibutton
>Kopiuj</guibutton
>. Spowoduje to otwarcie okna edycji szablonu wypełnionego ustawieniami skopiowanymi z wybranego szablonu.</para>
</listitem>

<listitem>
<para
>Można podświetlić alarm na liście alarmów i wybrać <menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Utwórz szablon...</guimenuitem
> </menuchoice
>. Spowoduje to otwarcie okna edycji szablonu wypełnionego kopią ustawień pobraną z wybranego alarmu.</para>
</listitem>
</itemizedlist>

<para
>Aby zmodyfikować istniejący szablon, należy otworzyć okno edycji szablonu poprzez<menuchoice
> <guimenu
>Plik</guimenu
><guimenuitem
>Szablony...</guimenuitem
> </menuchoice
> a następnie <guibutton
>Edycja</guibutton
>. Spowoduje to otwarcie okna edycji szablonu opisanego poniżej.</para>

<para
>Aby usunąć istniejący szablon, należy otworzyć okno edycji szablonu poprzez<menuchoice
> <guimenu
>Plik</guimenu
><guimenuitem
>Szablony...</guimenuitem
> </menuchoice
> a następnie wybranie jednego lub więcej szablonów i kliknięcie <guibutton
>Usuń</guibutton
>. Pojawi się prośba o potwierdzenie aby uniknąć przypadkowego usunięcia.</para>

</sect3>

<sect3>
<title
>Okno edycji szablonu</title>

<para
>Okno edycji szablonu jest podobne do okna <link linkend="alarm-edit-dlg"
>edycji alarmu</link
>. Okna różnią się następującymi ustawieniami:</para>

<itemizedlist>
<listitem>
<para
>Wprowadzanie nazwy szablonu możliwe jest w polu <guilabel
>Nazwa szablonu</guilabel
>. Jest to nazwa wyświetlana we wszystkich listach wyboru szablonu alarmu, tak więc najlepiej wybrać nazwę, która będzie jednoznacznie określać funkcję szablonu. Każda nazwa szablonu musi być unikalna.</para>
</listitem>

<listitem>
<para
>W polu wyboru <guilabel
>Czas</guilabel
> należy wybrać jedną z pozycji:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Domyślny czas</guilabel
> oznacza, że nie będzie ustalany żaden czas aktywacji alarmu. Alarmy bazujące na tym szablonie będą używały domyślnego czasu aktywacji dla nowych alarmów.</para>
</listitem>

<listitem>
<para
><guilabel
>Czas</guilabel
> aby umożliwić wpisanie terminu aktywacji alarmu.</para>
</listitem>

<listitem>
<para
><guilabel
>Tylko data</guilabel
> dla ustalenia że alarm powinien mieć ustawianą tylko datę bez czasu.</para>
</listitem>

<listitem>
<para
><guilabel
>Czas od teraz</guilabel
> umożliwia wprowadzenie jak długo (w godzinach i minutach) od utworzenia alarmu, ma zostać ustawiony czas jego aktywacji.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>W sekcji <guilabel
>Reguła powtarzania</guilabel
> w zakładce <guilabel
>Powtarzanie</guilabel
>, nie trzeba wybierać dnia ani miesiąca dla powtórzeń cotygodniowych i corocznych.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Kalendarze alarmów</title>

<para
>Jeżeli użytkownik pracuje tylko na jednym komputerze i nie współpracuje z innymi osobami, nie jest dla niego istotne gdzie &kalarm; przechowuje swoje alarmy. Jeżeli jednak, alarmy mają być dostępne na więcej niż jednym komputerze, w więcej niż jednej lokalizacji, można zdefiniować <quote
>kalendarze alarmów</quote
> aby &kalarm; mógł w nich przechowywać swoje alarmy dodatkowo lub zamiast kalendarzy domyślnych.</para>

<para
>Można przeglądać i manipulować kalendarzami za pomocą listy kalendarzy, która może być wyświetlona obok listy alarmów w głównym oknie programu &kalarm;. Alarmy z wszystkich kalendarzy alarmów są połączone w jedną listę. Podczas zapisywania nowego alarmu, można ustawić opcję konfiguracji określającą czy ma być zapisywany automatycznie do kalendarza domyślnego, lub czy użytkownik będzie proszony o wybranie kalendarza. Podczas edytowania istniejącego alarmu, jest on automatycznie zapisywane do oryginalnego kalendarza.</para>

<sect3>
<title
>Rodzaje i ustawienia kalendarzy</title>

<para
>Kalendarze alarmów są pogrupowane według rodzaju alarmu oraz rodzaju przechowywania. Mogą być wyłączone, ustawiane w tryb tylko do odczytu lub ustawiane jako domyślne dla danego rodzaju alarmu.</para>

<variablelist>
<varlistentry>
<term
>Typ alarmu</term>
<listitem>
<para
>Trzy typy alarmów &ndash; aktywne, zarchiwizowane i szablon &ndash; są przechowywane w oddzielnych kalendarzach. W związku z tym &kalarm; posiada trzy domyślne standardowe kalendarze, po jednym dla każdego typu (więcej na ten temat w sekcji <link linkend="faq"
>Pytania i odpowiedzi</link
>), które mogą być zmienione na życzenie użytkownika.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Miejsce przechowywania</term>
<listitem>
<para
>Program &kalarm; obsługuje trzy miejsca przechowywania alarmu:</para>

<itemizedlist>
<listitem
><para
>Plik lokalny: Alarmy są przechowywane w lokalnym pliku w formacie iCalendar.Domyślnie &kalarm; używa lokalnych plików kalendarza (więcej na ten temat w sekcji <link linkend="faq"
>Pytania i odpowiedzi</link
>). <quote
>Plik lokalny</quote
> może także oznaczać kalendarz umieszczony w sieci lokalnej, warunkiem jest tylko to, aby mógł być określony przez ścieżkę dostępu zaczynającą się od znaku: <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Lokalny katalog: Pliki przechowywane są w katalogu lokalnym. Każdy alarm umieszczany jest w osobnym pliku w formacie iCalendar. Ta metoda przechowywania ma tą przewagę, że w przypadku uszkodzenia pliku utracony zostanie tylko jeden alarm, a nie cały kalendarz.</para>
</listitem>

<listitem
><para
>Plik zdalny: Alarmy są przechowywane w pojedynczym pliku zdalnym w formacie iCalendar. Ta metoda pozwala na zdalny dostęp do danych o alarmach niezależnie od miejsca pobytu, pozwala także na oglądanie alarmów użytkownika przez inne osoby. Podczas używania plików zdalnych, &kalarm; pracuje na lokalnej podręcznej kopii danych.</para>

<warning
><para
>Jeżeli zdalne kalendarze alarmów są współdzielone między użytkownikami, zmiany dokonane przez jedną osobę nie będą automatycznie dostępne dla innych, albo może wystąpić opóźnienie zanim inni zobaczą te zmiany. Może się zdarzyć, że zmiany dokonane przez kogoś mogą zostać nadpisane przez kogoś innego, bez żadnej informacji że stało się coś takiego.Technicznymi przyczynami takiego zachowania jest fakt, iż zmiany dokonane przez osobę A będą widoczne dla osoby B, dopiero wtedy gdy podręczna kopia kalendarza A zostanie zapisana w pliku zdalnym, a następnie osoba B ponownie załaduje kalendarz zdalny do pamięci podręcznej. To czy i kiedy kalendarze zdalne są zapisywane i ponownie ładowane zależy od parametrów konfiguracji ustawianych przez każdego użytkownika dla tego kalendarza.</para>

<para
>Metodą uniknięcia ww. problemów może być dostosowanie parametrów konfiguracyjnych dotyczących zapisywania i przeładowywania kalendarzy lub wdrożenie zasady, że jedynie właściciel kalendarza może do niego zapisywać, a pozostałe osoby powinny otwierać go w trybie tylko do odczytu.</para
></warning>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Stan włączony/wyłączony</term>
<listitem>
<para
>Wyłączanie kalendarza ma taki sam efekt jak jego usunięcie, z tym wyjątkiem, że będzie on dalej dostępny na liście kalendarzy i można go ponownie włączyć. Jeżeli kalendarz jest wyłączony, alarmy w nim zdefiniowane są ignorowane i nie pojawiają się na liście alarmów lub na liście szablonów. Jeżeli zostanie ponownie włączony, alarmy pojawią się na liście i staną się aktywne.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Stan tylko do odczytu</term>
<listitem>
<para
>Kalendarze tylko do odczytu nie mogą być zmieniane, nie da się też do nich dodawać alarmów. Nie można więc edytować alarmów. Nie jest także możliwe odkładanie alarmów, ponieważ wymagałoby to zapisania czasu odłożenia. Po aktywacji alarmu, nie jest on usuwany z kalendarza ani archiwizowany dopóki jakiś użytkownik z prawami zapisu nie otworzy kalendarza.</para>

<para
>Można ustawić tryb tylko do odczytu dla kalendarza w oknie konfiguracyjnym. Niektóre kalendarze nie mogą jednak zostać ustawione w tryb zapisu, z kilku powodów:</para>

<itemizedlist>
<listitem
><para
>Jeżeli kalendarz został utworzony w innej aplikacji, nie będzie bezpieczne jego modyfikowanie przez program &kalarm;, gdyż różnice w formacie danych mogą spowodować, iż nie będzie można go używać w oryginalnej aplikacji.</para>
</listitem>

<listitem
><para
>Jeżeli kalendarz został utworzony w nowszej wersji programu &kalarm;, dane mogą być utracone jeżeli starsza wersja &kalarm; go zaktualizuje.</para>
</listitem>

<listitem
><para
>Jeżeli kalendarz został utworzony we wcześniejszej wersji programu &kalarm;, dane mogą być utracone lub staną się bezużyteczne dla starszej wersji, jeżeli zostaną zaktualizowane przez nowszą wersję &kalarm;. Wyświetli się pytanie, czy użytkownik chce skonwertować format kalendarza aby można go było zmieniać, z ostrzeżeniem o potencjalnych problemachz kompatybilnością jeżeli poprzednia wersja &kalarm; będzie otwierać kalendarz.</para>
</listitem>

<listitem
><para
>Jeżeli nie masz prawa zapisu do pliku lub katalogu kalendarza.</para>
</listitem>
</itemizedlist>

<para
>Jeżeli użytkownik potrzebuje zapisać coś w alarmach kalendarza, który jest tylko do odczytu, można skopiować alarmy i zaimportować do kalendarza, w którym można zapisywać, za pomocą polecenia <menuchoice
><guimenuitem
>Importuj...</guimenuitem
></menuchoice
> w menu kontekstowym kalendarza docelowego (więcej na ten temat w sekcji <link linkend="import"
>Importowanie alarmów z zewnętrznych kalendarzy</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Domyślny stan kalendarza</term>
<listitem>
<para
>Dla każdego rodzaju alarmu można zdefiniować po jednym kalendarzu domyślnym. Nowe alarmy będą automatycznie zapisywane w kalendarzu domyślnym dla danego rodzaju alarmu, chyba że zaznaczona została opcja pytania o miejsce zapisywania nowych alarmów i szablonów w <link linkend="preferences-storage"
>oknie konfiguracji</link
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3>
<title
>Korzystanie z kalendarzy</title>

<para
>Użytkownik może przeglądać i manipulować kalendarzami poprzez okno listy kalendarzy, które może być wyświetlone lub ukryte za pomocą polecenia <menuchoice
> <guimenu
>Widok</guimenu
><guimenuitem
>Pokaż kalendarze</guimenuitem
> </menuchoice
>. Podczas używania listy kalendarzy, najpierw należy wybrać rodzaj alarmu z listy rozwijanej znajdującej się w górnej części lub nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk myszy na wybranym kalendarzu i wybrać działanie z menu kontekstowego. Dostępne są następujące działania:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Dodaj...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Dodaje kalendarz wybranego rodzaju do listy. Użytkownik musi określić rodzaj nośnika, a następnie wyświetli się okno konfiguracji kalendarza, gdzie ustawić można lokalizację kalendarza i inne parametry. Jeżeli w danej lokalizacji nie ma żadnego kalendarza, to utworzony zostanie nowy plik z kalendarzem.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Usuń</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Usunięcie wybranego kalendarza z listy. Sam kalendarz nie jest usuwany, nie będzie tylko go na liście, może on być później dodany jeżeli pojawi się potrzeba.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Edycja...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Edytuje wybrany kalendarz. Wyświetla się okno konfiguracji dla wybranego kalendarza.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Wczytaj ponownie</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Wczytuje ponownie wybrany kalendarz. Kalendarz jest ponownie wczytany z ustawionej lokalizacji, aby zapewnić że nie ma niezgodności pomiędzy alarmami wyświetlanymi w &kalarm; a aktualną zawartością kalendarza. Jeżeli kalendarz jest współdzielony z innymi użytkownikami, wszelkie zmiany przez nich dokonane staną się widoczne w &kalarm;.</para>

<warning
><para
>Jeżeli użytkownik wczyta ponownie zdalny kalendarz, to wszelkie zmiany w alarmach dokonane po ostatnim jego zapisaniu zostaną utracone. Dodatkowo, alarmy które wygasły od ostatniego zapisu mogą zostać ponownie aktywowane.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Zapisz</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Zapisuje wszystkie zmiany w wybranym kalendarzu. Aktualizowane są wszelkie zmiany w alarmach, które wystąpiły od ostatniego zapisania lub przeładowania kalendarza. Polecenie jest użyteczne jedynie dla kalendarzy zdalnych, kalendarze lokalne są bowiem zapisywane po każdej zmianie. Użytkownik może ustawić jak często i kiedy zdalny kalendarz powinien być automatycznie zapisywany za pomocą okna konfiguracji kalendarza (polecenie <menuchoice
><guimenuitem
>Edytuj...</guimenuitem
></menuchoice
> w jego menu kontekstowym).</para>

<warning
><para
>Jeżeli zapisywany jest kalendarz zdalny współdzielony z innymi użytkownikami, wszelkie zmiany przez nich dokonane od momentu ostatniego przeładowania kalendarza (automatycznego lub ręcznego) zostaną utracone.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importuj...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importuje alarmy z zewnętrznego kalendarza do bieżącego kalendarza. Jest to opisane w sekcji <link linkend="import"
>Importowanie alarmów z zewnętrznych kalendarzy</link
>. Opcja nie jest dostępna dla kalendarzy wyłączonych lub znajdujących się w trybie tylko do odczytu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Eksportuj...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Eksportuje wszystkie alarmy z bieżącego kalendarza do zewnętrznego pliku kalendarza. Jest to opisane w sekcji <link linkend="export"
>Eksportowanie alarmów do zewnętrznych kalendarzy</link
>. Opcja nie jest dostępna dla kalendarzy wyłączonych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Pokaż szczegóły</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Wyświetla informacje o wybranym kalendarzu: lokalizację, rodzaj pamięci oraz status. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Użyj jako domyślny</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Ustawia wybrany kalendarz jako domyślny dla danego typu kalendarza. Opcja nie jest dostępna dla kalendarzy wyłączonych lub będących tylko do odczytu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Ustaw kolor...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Ustawia kolor tła dla podświetlania alarmów z danego kalendarza na liście alarmów. Dzięki temu, można łatwo zidentyfikować alarmu należące do poszczególnych kalendarzy.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Wyczyść kolor</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Usuwa kolor podświetlania alarmów należących do tego kalendarza.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Importowanie alarmów z kalendarzy zewnętrznych</title>

<para
>Użytkownik może importować alarmy z innych plików kalendarza do programu &kalarm;. Funkcja importowania skanuje wybrany kalendarz w poszukiwaniu zdarzeń zawierających alarmy, a następnie kopiuje je (nadając nowy unikalny numer ID) do kalendarza &kalarm;. Zdarzenia bez alarmów, oraz wpisy kalendarza nie będące zdarzeniami, są ignorowane. Możliwe są dwa sposoby importowania alarmów:</para>

<itemizedlist>
<listitem>
<para
>Za pomocą polecenia <menuchoice
><guimenu
>Plik</guimenu
> <guimenuitem
>Importuj Alarmy...</guimenuitem
></menuchoice
> można zaimportować alarmy wszystkich typów (aktywne, zarchiwizowane oraz szablony) z kalendarza.</para>

<para
>Jeżeli ustawiono <link linkend="calendars"
>kalendarz alarmu</link
>, dla każdego typu, alarmy zostaną dodane do kalendarzy odpowiednich dla ich typu. Jeżeli w <link linkend="preferences-storage"
>oknie konfiguracji</link
> ustawiono konieczność decyzji użytkownika, to pojawi się pytanie jakiego kalendarza użyć do zapisania importowanych alarmów.</para>
</listitem>

<listitem>
<para
>Naciśnięcie <mousebutton
>prawego</mousebutton
> przycisku myszy na kalendarzu w liście i wybranie polecenia <menuchoice
><guimenuitem
>Importuj...</guimenuitem
></menuchoice
> z menu kontekstowego. Importuje to alarmy aktualnie wybranego rodzaju do tego kalendarza. Na przykład, jeżeli dany kalendarz dotyczy szablonów alarmów, to zaimportowane zostaną tylko szablony alarmów (a nie aktywne bądź zarchiwizowane alarmy).</para>
</listitem>
</itemizedlist>

<warning
><para
>Jeżeli alarmy są importowane z plików utworzonych przez inne programy, alarmy mogą zostać zmienione podczas procesu importowania, zmianie mogą ulec nawet czasy alarmów. Zależy to od formatu danych stosowanych przez inną aplikację, i jest to nieuniknione jeżeli ten format jest inny od tego, którego oczekuje &kalarm;. Zawsze po zaimportowaniu należy sprawdzić alarmy i poprawić jeśli zajdzie potrzeba.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Eksportowanie alarmów do kalendarzy zewnętrznych</title>

<para
>Użytkownik może eksportować alarmy z programu &kalarm; do innych plików kalendarza. Może eksportować alarmy wybrane na liście lub wszystkie alarmy zapisane w kalendarzu. Różne sposoby eksportowania zostały opisane poniżej. Którykolwiek z tych sposobów zostanie użyty, można zarówno utworzyć nowy plik lub dopisać alarmy do istniejącego pliku kalendarza. Aby dopisać alarmy do pliku, należy zaznaczyć opcję <guilabel
>Dołącz do istniejącego pliku</guilabel
> w oknie wyboru pliku, w przeciwnym wypadu plik zostanie nadpisany.</para>

<itemizedlist>
<listitem>
<para
>Aby wyeksportować alarmy zaznaczone na liście, należy nacisnąć <mousebutton
>prawy</mousebutton
> przycisk myszki na zaznaczeniu i wybrać <menuchoice
><guimenuitem
>Eksportuj...</guimenuitem
></menuchoice
> z menu kontekstowego, lub wybrać polecenie <menuchoice
><guimenu
>Plik</guimenu
> <guimenuitem
>Eksportuj zaznaczone alarmy...</guimenuitem
></menuchoice
> z menu głównego.</para>
</listitem>

<listitem>
<para
>Aby wyeksportować wszystkie alarmy z kalendarza, należy nacisnąć  <mousebutton
>prawy</mousebutton
> przycisk myszki na kalendarzu w liście, i wybrać <menuchoice
><guimenuitem
>Eksportuj...</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Importowanie urodzin z programu &kaddressbook;</title>

<para
>Użytkownik może zdefiniować alarmy dla dat urodzin kontaktów zapisany w programie &kaddressbook;, poprzez wybranie polecenia<menuchoice
><guimenu
>Plik</guimenu
> <guimenuitem
>Importujurodziny...</guimenuitem
></menuchoice
>. Wyświetli się okno dialogowe, w którym można wybrać dla czyich urodzin zdefiniować alarm.</para>

<itemizedlist>
<listitem>
<para
>W sekcji <guilabel
>Tekst alarmu</guilabel
> można wpisać tekst wyświetlany w wiadomościach alarmu dla urodzin. Tekst wiadomości jest tworzony przez połączenie tekstów z pola <guilabel
>Przedrostek</guilabel
> imienia i nazwiska osoby oraz pola <guilabel
>Przyrostek</guilabel
>. Nie są dodawane spacje, więc należy uwzględnić je w polach <guilabel
>Przyrostek</guilabel
> i <guilabel
>Przedrostek</guilabel
>.</para>

<note
><para
>Jeżeli tekst alarmu zostanie zmieniony, lista wyboru urodzin zostanie odświeżona.</para
></note>
</listitem>

<listitem>
<para
>W tabeli <guilabel
>Wybierz urodziny</guilabel
> należy wybrać osoby, dla których użytkownik chce ustawić alarm. Uwaga: lista wyświetla tylko te wpisy w programie&kaddressbook;, które zawierają datę urodzin i dla których nie został wcześniej zdefiniowany alarm o treści wprowadzonej w sekcji <guilabel
>Tekst alarmu</guilabel
>.</para>
</listitem>

<listitem>
<para
>Pozostałe ustawienia są takie same jak dla alarmów <guilabel
>Tekstowych</guilabel
> w <link linkend="alarm-edit-dlg"
>oknie edycji alarmu</link
>.</para>
</listitem>
</itemizedlist>

<para
>Jeżeli ustawiono <link linkend="calendars"
>kalendarz alarmu</link
>, alarmy zostaną dodane do aktywnego kalendarza. Jeżeli w <link linkend="preferences-storage"
>oknie konfiguracji</link
> ustawiono konieczność decyzji użytkownika, to pojawi się pytanie jakiego kalendarza użyć do zapisania importowanych alarmów.</para>

</sect2>

<sect2 id="undo">
<title
>Cofnij/przywróć</title>

<para
>Można cofać i przywracać ostanie zmiany dokonane w bieżącej sesji programu &kalarm;. Większość działań może zostać wycofana, włączając w to: tworzenie, edycję i usuwanie alarmu i szablonów alarmu, oraz ponowną aktywację alarmów. Aby zapobiec nadmiernemu zużyciu zasobów, historia poleceń, które można wycofać jest ograniczona do ostatnich 12 działań.</para>

<para
>Aby wycofać ostatnią zmianę, należy wybrać <menuchoice
> <guimenu
>Edycja</guimenu
><guimenuitem
>Cofnij</guimenuitem
></menuchoice
>. Aby przywrócić ostatnio wycofaną zmianę, należy wybrać  <menuchoice
> <guimenu
>Edycja</guimenu
><guimenuitem
>Przywróć</guimenuitem
> </menuchoice
>.</para>

<para
>Aby wycofać zmianę inną niż ostatnia, należy kliknąć przycisk <guibutton
>Cofnij</guibutton
> na pasku narzędzi i przytrzymać klawisz myszki. Wyświetli się lista działań, z których można wybrać działanie, które użytkownik chce wycofać. Jeżeli działanie nie jest widoczne na liście, konieczne może być wcześniejsze wycofanie ostatnich zmian, od których poszukiwana zmiana jest uzależniona. Na przykład, jeżeli użytkownik zmienił alarm, a następnie go skasował, to nie można wycofać operacji edycji alarmu, jeżeli wcześniej nie wycofa się operacji jego usunięcia</para>

<para
>Przywracania zmian innych niż ostatnia, odbywa się analogicznie za pomocą przycisku <guibutton
>Przywróć</guibutton
> na pasku narzędzi.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>Okno edycji alarmu</title>

<para
>Okno edycji alarmu umożliwia oglądanie i zmianę alarmu. Przy pierwszym użyciu programu &kalarm;, wyświetla się uproszczona forma okna, z niewielką liczbą opcji. Aby zobaczyć wszystkie dostępne opcje należy kliknąć przycisk <guibutton
>Więcej opcji</guibutton
>; aby powrócić do okna uproszczonego, należy kliknąć przycisk<guibutton
>Mniej opcji</guibutton
>. Program &kalarm; zapamiętuje wybór użytkownika przy każdym kolejnym wyświetleniu okna edycji alarmu.</para>

<screenshot>
<screeninfo
>Zrzut ekranu uproszczonego okna edycji alarmu</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Zrzut ekranu uproszczonego okna edycji alarmu</phrase>
</textobject>
<caption
><para
>Zrzut ekranu uproszczonego okna edycji alarmu</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Zrzut ekranu okna edycji alarmu z pełną listą opcji</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Zrzut ekranu okna edycji alarmu z pełną listą opcji</phrase>
</textobject>
<caption
><para
>Zrzut ekranu okna edycji alarmu z pełną listą opcji</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Działanie alarmu</title>

<para
>Ustawienia w sekcji <guilabel
>Działanie</guilabel
> są zróżnicowane w zależności od edytowanego rodzaju alarmu.</para>

<sect3>
<title
>Wyświetlaj alarmy</title>

<para
>Alarmy wyświetlane pokazują okno po aktywacji alarmu. Sposób generowania zawartości okna alarmu odbywa się za pomocą listy rozwijanej: Typ wyświetlania, znajdującej się w górnej części okna:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Wiadomość tekstowa</guilabel
> pozwala na wprowadzenie treści wiadomości (która może zawierać wiele linii) w oknie edycyjnym.</para>
</listitem>

<listitem>
<para
><guilabel
>Zawartość pliku</guilabel
> umożliwia wprowadzenie ścieżki lub adresu &URL; pliku tekstowego lub obrazka, którego zawartość ma być wyświetlona jako wiadomość alarmu. Przycisk obok pola adresu pliku otwiera okno wyboru pliku. Opcja <guilabel
>Przeczytaj</guilabel
> nie jest dostępna dla tego rodzaju alarmu.</para>
</listitem>

<listitem>
<para
><guilabel
>Wynik polecenia</guilabel
> pozwala na wyświetlania alarmu, którego treść będzie wynikiem polecenia uruchomionego po aktywacji alarmu. Więcej na temat wprowadzania poleceń i skryptów wykonywalnych można znaleźć w sekcji <link linkend="command-alarm"
>Alarmy w postaci poleceń</link
> poniżej.</para>
</listitem>
</itemizedlist>

<para
>Ustawienia dostępne dla wyświetlania alarmów są następujące: </para>

<itemizedlist>
<listitem>
<para
>Opcja <guilabel
>Dźwięk</guilabel
> pozwala na włączenie odtwarzania dźwięku przy wyświetlaniu wiadomości alarmu. Możliwe do wyboru są opcje:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Żaden</guilabel
> wyświetla alarm po cichu.</para>
</listitem>

<listitem>
<para
><guilabel
>Bip</guilabel
> odtworzy krótki dźwięk.</para>
</listitem>

<listitem>
<para
><guilabel
>Powiedz</guilabel
> wiadomość alarmu zostanie przeczytana i wyświetlona.Opcja jest dostępna tylko wtedy gdy zainstalowany jest program <application
>KTTSD</application
> (z pakietu kdeaccessibility) oraz skonfigurowany został zgodny z nim syntezator mowy, &eg; <application
>Festival</application
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Plik dźwiękowy</guilabel
> odtworzy plik dźwiękowy. Korzystając z przycisku po prawej stronie można wyświetlić okno dialogowe wyboru pliku oraz ustawienia głośności i powtarzania odtwarzania. Przesuwając myszkę nad przyciskiem wyboru, pojawi się podpowiedź wyświetlająca aktualnie skonfigurowaną nazwę pliku dźwiękowego.</para>

<para
>W oknie dialogowym pliku dźwiękowego:</para>

<itemizedlist>
<listitem>
<para
>Należy wprowadzić ścieżkę dostępu do pliku dźwiękowego, lub skorzystać z przycisku obok pola aby wyświetlić okno wyboru pliku. Można posłuchać wybranego pliku naciskając przycisk odtwarzania po lewej stronie pola edycyjnego. Po naciśnięciu przycisku odtwarzania zmieni się jego funkcja, ponowne jego naciśnięcie zatrzyma odtwarzanie jeżeli użytkownik już ma dość słuchania.</para>
</listitem>

<listitem>
<para
>Wybranie opcji <guilabel
>Powtarzaj</guilabel
> spowoduje powtarzanie odtwarzania dźwięku tak długo, dopóki wiadomość alarmu jest wyświetlana. (Okno wiadomości alarmu ma przycisk zatrzymujący odtwarzanie, tak aby użytkownik mógł wyłączyć dźwięk nie usuwając okna z alarmem).</para>
</listitem>

<listitem>
<para
>Suwak <guilabel
>Ustaw głośność</guilabel
> pozwala na ustawienie głośności odtwarzania wybranego pliku dźwiękowego.</para>
</listitem>

<listitem>
<para
>Użytkownik może w razie potrzeby włączyć zanikanie głośności. Zanikanie oznacza iż plik dźwiękowy zaczyna grać na początkowym poziomie głośności, a następnie ten poziom stopniowo zmienia się do osiągnięcia pożądanego poziomu głośności w określonym przedziale czasu. Końcowy poziom głośności ustala się suwakiem  <guilabel
>Ustaw głośność</guilabel
>. Aby włączyć zanikanie należy wybrać opcję <guilabel
>zanikanie</guilabel
>, podać czas zanikania w sekundach w polu <guilabel
>Czas zanikania</guilabel
> oraz ustawić suwakiem<guilabel
>głośność początkową</guilabel
>.</para>
</listitem>
</itemizedlist>

<tip
><para
>Można skorzystać z przycisku <guibutton
>Testuj dźwięk</guibutton
> aby sprawdzić ustawienia głośności.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Za pomocą przycisku <guibutton
>Czcionka i kolor</guibutton
> można zmieniać czcionkę, kolor czcionki i kolor tła dla wiadomości alarmu. Zaznaczenie opcji <guilabel
>Użyj domyślnej czcionki</guilabel
> w oknie <guilabel
>Wybierz czcionkę i kolor alarmu</guilabel
> wyświetli wiadomość w kolorze zdefiniowanym jako domyślny w momencie jej wyświetlania. Aby wybrać własny kolor dla wyświetlanej wiadomości, należy wyłączyć opcję <guilabel
>Użyj domyślnej czcionki</guilabel
>. (Domyślne czcionki i kolory mogą być ustawionew <link linkend="preferences-edit"
>oknie konfiguracji</link
>.)</para>

<para
>Wybrane kolory są pokazywane w oknie wprowadzania wiadomości alarmu.</para>
</listitem>

<listitem>
<para
>Przycisk <guibutton
>Działania specjalne...</guibutton
> służą do zdefiniowania działań powłoki do wykonania przed wyświetleniem alarmu. W oknie <guilabel
>Specjalne działania alarmu</guilabel
> dostępne są opcje:</para>

<itemizedlist>
<listitem>
<para
>W polu <guilabel
>Działanie przed alarmem</guilabel
> należy wprowadzić polecenie powłoki, które ma być wykonane przez wyświetleniem alarmu. Uwaga: &kalarm; będzie oczekiwał na zakończenie polecenia przed wyświetleniem alarmu.</para>

<para
>Działanie przed alarmem jest wykonywane raz, gdy alarm jest wyświetlany po raz pierwszy, włączając w to sytuację, gdy wiadomość przypomnienia jest zastępowana przez właściwy alarm. Polecenie <emphasis
>nie jest</emphasis
> wykonywane w następujących sytuacjach:</para>

<itemizedlist>
<listitem
><para
>Gdy wyświetla się wiadomość przypomnienia.</para
></listitem>
<listitem
><para
>Gdy wiadomość jest wyświetlana ponownie po odroczeniu alarmu.</para
></listitem>
<listitem
><para
>Gdy wiadomość powinna być wyświetlana w czasie gdy użytkownik był wylogowany i jest przywracana po zalogowaniu.</para
></listitem>
<listitem
><para
>Jeżeli powtarzający się alarm zostanie aktywowany w czasie gdy wiadomość alarmu (lub odłożona wiadomość alarmu) z jego poprzedniego wystąpienia jest dalej widoczna; innymi słowy, gdy poprzednie wystąpienie alarmu nie zostało zatwierdzone.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>W polu <guilabel
>Działanie po alarmie</guilabel
> należy wprowadzić polecenie powłoki do wykonania wtedy, gdy alarm jest zatwierdzony (za pomocą przycisku <guibutton
>Zamknij</guibutton
> lub ikony zamknij na pasku tytułowym okna). Polecenie <emphasis
>nie jest</emphasis
> wykonywane w żadnym z następujących przypadków:</para>

<itemizedlist>
<listitem
><para
>Gdy wiadomość przypomnienia została zamknięta.</para
></listitem>
<listitem
><para
>Gdy użytkownik odroczy alarm, z wyjątkiem sytuacji gdy odroczony alarm jest potwierdzony przez użytkownika.</para
></listitem>
<listitem
><para
>Gdy wiadomość alarm została zamknięta po wylogowaniu.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Zobacz informacje o działaniu poleceń powłoki w sekcji <link linkend="command-alarm"
>Alarmy w postaci poleceń</link
> poniżej.</para>

</listitem>
</itemizedlist>
</sect3>

<sect3 id="command-alarm">
<title
>Alarmy w postaci poleceń</title>

<para
>Alarmy w postaci poleceń uruchamiają polecenie bez wyświetlania żadnej wiadomości alarmu.</para>

<note
><para
>Te rodzaj alarmu nie jest dostępny, gdy środowisko &kde; pracuje w trybie kiosku.</para
></note>

<para
>Ustawienia dla alarmów w postaci poleceń są następujące:</para>

<itemizedlist>
<listitem>
<para
>Opcja <guilabel
>Wprowadź skrypt</guilabel
> pozwala wybrać pomiędzy wprowadzaniem skryptu lub wiersza polecenia.</para>

<para
>Jeżeli opcja nie jest zaznaczona, to można wprowadzić polecenia dla powłoki. Jest ono przekazywane do domyślnej powłoki (określonej w zmiennej środowiskowej: <envar
>SHELL</envar
>), można dodać do polecenia dowolne opcje, parametry, polecenia potokowe, &etc;, które są dopuszczane przez powłokę dla poleceń.</para>

<para
>Jeżeli opcja jest zaznaczona, użytkownik może wprowadzić skrypt do wykonania. Należy pamiętać aby skrypt rozpoczynał się od linii w postaci np. <literal
>#!/bin/bash</literal
> aby uruchomiony został prawidłowy interpreter poleceń.</para>
</listitem>

<listitem>
<para
>W sekcji <guilabel
>Wynik polecenia</guilabel
> można ustalić co program ma zrobić z informacjami wyjściowymi produkowanymi w terminalu przez program po uruchomieniu.</para>

<itemizedlist>
<listitem>
<para
>Opcja <guilabel
>Wykonaj w oknie terminala</guilabel
> spowoduje wykonanie polecenia w oknie terminala. Rodzaj okna terminala może być zdefiniowany w  <link linkend="preferences-general"
>oknie konfiguracji</link
>.</para>
</listitem>

<listitem>
<para
>Opcja <guilabel
>Zapisz do pliku</guilabel
> zapisuje wyjście polecenia do pliku. to save the command's output in a file. Wyjście polecenia, poprzedzone nagłówkiem zawierającym datę i czas, w którym polecenie było zdefiniowane do uruchomienia, będzie dopisane do poprzedniej zawartości pliku. Można wprowadzić nazwę pliku w polu lub użyć przycisku obok do wyświetlenia okna wyboru pliku.</para>
</listitem>

<listitem>
<para
>Zaznaczenie opcji <guilabel
>Odrzuć</guilabel
>, wyrzuca wynik polecenia.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>Alarmy w postaci e-maili</title>

<para
>Alarmy w postaci e-mail wysyłają wiadomość bez wyświetlania żadnego komunikatu.</para>

<para
>W trzech polach należy wprowadzić adresy odbiorców, temat wiadomości email i jej treść. Przycisk obok pola edycji adresu wyświetli książkę adresową &kde; z której można wybrać adresy mailowe odbiorców. Załączniki mogą być dodawane za pomocą przycisku <guibutton
>Dodaj...</guibutton
>. Uwaga, należy pamiętać aby załączanie pliki były dostępne na dysku w momencie wywołania alarmu; kopia tych plików nie jest tworzona w momencie definiowania alarmu. Aby usunąć załącznik, należy wybrać listę rozwijaną i nacisnąć przycisk <guibutton
>Usuń</guibutton
>.</para>

<para
>Dostępne są następujące ustawienia:</para>

<itemizedlist>
<listitem>
<para
>Lista rozwijana <guilabel
>Od</guilabel
> pozwala na wybranie tożsamości programu &kmail;, która ma zostać wykorzystana do wysyłania wiadomości. Opcja jest dostępna tylko wtedy, gdy w <link linkend="preferences-email"
>oknie konfiguracji</link
> została włączona opcja <guilabel
>Użyj tożsamości &kmail-dopelniacz;</guilabel
>. W innej sytuacji, użyty zostanie adres użytkownika zdefiniowany w <link linkend="preferences-email"
>oknie konfiguracji</link
>.</para>
</listitem>

<listitem>
<para
>Zaznaczenie opcji <guilabel
>Kopiuj e-mail do siebie</guilabel
> spowoduje wysłanie wiadomości email bcc na adres użytkownika po aktywacji alarmu. Adres email, na który ma być wysłana kopia wiadomości może zostać ustawiony w <link linkend="preferences-email"
>Oknie konfiguracji</link
>, wartością domyślną jest adres użytkownika zdefiniowany w ustawieniach systemowych &kde;.</para>
</listitem>
</itemizedlist>

</sect3>
</sect2>

<sect2>
<title
>Odroczenie</title>

<para
>Jeżeli alarm ma ustawione powtarzanie i został odroczony przy ostatnim wyświetleniu, to w sekcji <guilabel
>Odroczony alarm</guilabel
> widoczny będzie czas, do którego alarm został odroczony. Przycisk <guibutton
>Zmień...</guibutton
> wyświetli okno dialogowe, w którym można zmienić czas odroczenia alarmu lub anulować odroczenie.</para>

</sect2>

<sect2>
<title
>Czas</title>

<para
>W sekcji <guilabel
>Czas</guilabel
> można wybrać:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Dnia/Czas</guilabel
> i wprowadzić datę i czas wyświetlenia alarmu. Zaznaczenia opcji <guilabel
>Kiedykolwiek</guilabel
> pozwala na określenie tylko daty alarmu. W takim przypadku alarm zostanie wyświetlony przy najbliżej okazji o ustalonej dacie (lub po niej). Godzina wyświetlenia alarmu zależy od wartości ustawianej w oknie konfiguracji. (W części <link linkend="preferences-time"
>Konfiguracja &kalarm-dopelniacz;</link
> opisano jak ustalić godzinę początku dnia dla alarmów bez podanego czasu.)</para>

<para
>Dla alarmów bez określonego powtarzania, data i czas muszą dotyczyć przyszłości. Jeżeli podano tylko datę, to musi ona odnosić się do dnia bieżącego lub kolejnych. Dla alarmów z określonym powtarzaniem nie ma tego typu ograniczeń, gdyż data i godzina alarmu będzie automatycznie zmieniona na termin pierwszego powtórzenia.</para>
</listitem>

<listitem>
<para
><guilabel
>Czas od teraz</guilabel
> i wprowadzić kiedy licząc od chwili obecnej (w godzinach i minutach) ma zostać aktywowany alarm.</para>
</listitem>
</itemizedlist>

<para
>W razie potrzeby, można dla wyświetlanego alarmu ustawić strefę czasową. To ustawienie jest wykorzystywane dla wszystkich dat i czasów ustawionych dla alarmu, włączając w to powtórzenia i wyjątki. W normalnej sytuacji bez ważnego powodu, raczej nie należy zmieniać ustawień strefy czasowej.</para>

<para
>Opcje ustawień dla stref czasowych są wyświetlane tylko wtedy, jeżeli wybrana strefa czasowa jest inna od ustawionej w <link linkend="preferences-time"
>oknie konfiguracji</link
>, lub po naciśnięciu przycisku <guibutton
>Strefa czasowa</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>W liście rozwijanej, dokonuje się wyboru strefy czasowej, dotyczącej wywołania alarmu. Przy tworzeniu nowego alarmu, przyjmowana jest strefa czasowa ustawiona w <link linkend="preferences-time"
>oknie konfiguracji</link
>, którą jest zwykle strefa czasowa używanego komputera (chyba że użytkownik ją zmienił).</para>
</listitem>

<listitem>
<para
>Aby włączyć działanie programu wg. lokalnego zegara (komputera, na którym w danej chwili działa program &kalarm;) niezależnie od strefy czasowej,należy zaznaczyć opcję <guilabel
>Ignoruj strefę czasową</guilabel
>.</para>

<warning
><para
>Nie jest polecane używanie tej opcji kiedy alarm ma być powtarzany w określonych godzinach/minutach. Jeśli tak bowiem postąpisz, alarm może być wywołany w nieokreślonych momentach po zmianie czasu z zimowego na letni i odwrotnie.</para
></warning>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Przypomnienie</title>

<para
>Dla alarmów wyświetlanych, można włączyć <guilabel
>Przypomnienie</guilabel
> wyświetlające okno przypominające wcześniej o każdym wystąpieniu powtórzenia głównego alarmu (jeżeli się powtarza). W polu obok opcji przypomnienia należy podać ile minut wcześniej przed alarmem ma wyświetlić się przypomnienie.</para>

<note
><para
>Przypomnienia nie są wyświetlane dla pod-powtórzeń w ramach danego powtórzenia. Są one wyświetlane tylko przez wystąpieniem głównego powtórzenia alarmu.</para
></note>

<para
>Jeżeli alarm ma włączone powtarzanie, można włączyć opcję <guilabel
>Przypomnij tylko przy pierwszym powtórzeniu</guilabel
>.  Jeżeli opcja nie jest włączona, to okres, na który można zdefiniować przypomnienie jest ograniczony odstępem czasowym między powtórzeniami.</para>

</sect2>

<sect2>
<title
>Anulowanie</title>

<para
>Opcje anulowania opóźnionych alarmów określają w jaki sposób alarm będzie traktowany jeżeli minie czas dla niego zdefiniowany: </para>

<itemizedlist>
<listitem>
<para
>Opcja <guilabel
>Anuluj gdy opóźniony</guilabel
> określa co dzieje się z alarmem, który nie mógł być aktywowany w ustalonym dla niego czasie.</para>

<para
>Zaznaczenie tej opcji spowoduje anulowanie alarmu, który nie mógł być wyświetlony przez określony czas po ustawionym terminie aktywacji. Okres ten jest ustawiony za pomocą pola, które pojawi się po zaznaczeniu opcji. Jeżeli na przykład ustawiona zostanie wartość na 1 godzinę, alarm będzie pokazywany przy najbliższej okazji po ustawionym terminie aktywacji, ale tylko przez 1 godzinę po tym terminie. Jeżeli nie będzie mógł być w ciągu tej godziny aktywowany, to zostaje anulowany bez wyświetlania.</para>

<note
><para
>Opóźnienie dla alarmów, dla których ustawiona jest tylko data (tzn. tych dla których zaznaczono opcję<guilabel
>Kiedykolwiek</guilabel
>, obliczane jest od godziny początku dnia, dla którego ustawiono alarm.</para
></note>

<para
>Pozostawienie opcji nie zaznaczonej, spowoduje wywołanie alarmu w najbliższej nadarzającej się sposobności po ustawionym terminie, niezależnie od tego jak późno już jest.</para>

<note
><para
>Alarm może być aktywowany tylko wtedy gdy użytkownik jest zalogowany, oraz gdy uruchomiony jest menedżer okien X oraz program &kalarm;.</para
></note>
</listitem>

<listitem>
<para
>Zaznaczenie opcji <guilabel
>Automatycznie zamknij okno po tym czasie</guilabel
> spowoduje, iż okno alarmu będzie automatycznie zamykane (jeżeli jest jeszcze widoczne) po wygaśnięciu czasu zdefiniowanego dla anulowania opóźnionego alarmu.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Powtarzanie</title>

<para
>W zakładce <guilabel
>Powtarzanie</guilabel
> możne określić czy i w jaki sposób alarm powinien być powtarzany.</para>

<note
><para
>Podstawowe informacje o powtarzaniu alarmu, wyświetlane są dla wygody w tytule zakładki <guilabel
>Powtarzanie</guilabel
>. Jako pierwszy widoczny jest okres powtarzania, a następnie okres pod-powtórzenia ustawianego po naciśnięciu przycisku <guibutton
>Pod-powtórzenie</guibutton
>.</para
></note>

<para
>W sekcji <guilabel
>Reguła powtarzania</guilabel
> można ustawić zasady i czas powtarzania alarmu:</para>

<itemizedlist>
<listitem
><para
>Aby alarm był uruchamiany tylko raz, należy wybrać opcję <guilabel
>Bez powtarzania</guilabel
>.</para
></listitem>

<listitem
><para
>Wybranie opcji <guilabel
>Po zalogowaniu</guilabel
> spowoduje wyświetlenie alarmu po każdym zalogowaniu użytkownika, aż do czasu kiedy minie ustawiony okres powtarzania. W terminie ostatniego powtórzenia, alarm zostanie aktywowany ostatni raz. (Uwaga: alarmy powtarzające się po zalogowaniu będą aktywowane także po każdym restarcie &kalarm-dopelniacz;.)</para
></listitem>

<listitem>
<para
>Aby zdefiniować alarm powtarzający się w regularnych odstępach czasu, należy wybrać pożądany rodzaj odstępu i wprowadzić w polu <guilabel
>Powtarzaj co</guilabel
> wpisać ile okresów musi minąć pomiędzy powtórzeniami. Na przykład aby ustawić alarm wyświetlający się co dwa tygodnie, należy zaznaczyć opcję <guilabel
>Codzienny</guilabel
> i wprowadzić w polu wartość 14 lub <guilabel
>Cotygodniowy</guilabel
> i wpisać wartość 2. W zależność od rodzaju okresu mogą być dostępne także inne opcje:</para>

<itemizedlist>
<listitem>
<para
>Dla powtórzeń cotygodniowych, należy zaznaczyć dni tygodnia, w których alarm ma być aktywowany.</para>
</listitem>

<listitem>
<para
>Dla powtórzeń miesięcznych, można określić albo stałą datę albo pozycję względną w miesiącu(&eg; drugi czwartek miesiąca).</para>
</listitem>

<listitem>
<para
>Dla powtórzeń rocznych, można wprowadzić określony dzień w miesiącu, lub pozycję w ramach miesiące (&eg; ostatnia niedziela maja). Należy zaznaczyć wszystkie miesiące w roku, dla których alarm ma być aktywowany.</para>

<para
>Jeżeli ustawiono roczne powtarzanie na dzień 29 lutego, można określić jak będzie traktowana ta data w latach nieprzestępnych poprzez wybranie odpowiedniej wartości opcji <guilabel
>Alarm 29 lutego w lata nieprzestępne</guilabel
>:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Brak</guilabel
>: Alarm wyświetli się 29 lutego w latach przestępnych, ale nie wyświetli się w latach nieprzestępnych.</para>
</listitem>

<listitem
><para
><guilabel
>28 Lut</guilabel
>: Alarm wyświetli się 29 lutego w roku przestępnym, a 28 lutego w latach nieprzestępnych.</para>
</listitem>

<listitem
><para
><guilabel
>1 Mar</guilabel
>: Alarm wyświetli się 29 lutego w roku przestępnym, a 1 marca w latach nieprzestępnych.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>Aby ustawić codzienne powtarzanie tylko dla dni roboczych, trzeba skorzystać z powtarzania tygodniowego i zaznaczyć wszystkie dni robocze w tygodniu.</para
></tip>

</listitem>
</itemizedlist>

<para
>W sekcji <guilabel
>Koniec powtarzania</guilabel
> ustawia się ogólny okres powtarzania dla alarmu:</para>

<itemizedlist>
<listitem
><para
>Wybranie opcji <guilabel
>Nie ma końca</guilabel
> powoduje, iż alarm będzie powtarzany w nieskończoność.</para
></listitem>

<listitem
><para
>Opcja <guilabel
>Koniec po</guilabel
> pozwala na określenie całkowitej liczby wystąpień powtórzenia alarmu.</para
></listitem>

<listitem
><para
>Opcja<guilabel
>Koniec przy</guilabel
> umożliwia wprowadzenie daty/czasu do której alarm będzie powtarzany. Parametr wykorzystuje tą samą strefę czasową, która używana jest dla czasu rozpoczęcia alarmu.</para>

<note
><para
>Czas zakończenia powtarzania alarmu, określa kiedy wystąpi ostanie główne powtórzenie alarmu, nie ogranicza jednak pod-powtórzeń. Jeżeli zdefiniowane są pod-powtórzenia, będą one dalej aktywowane po ostatnim głównym wystąpieniu, niezależnie od daty/czasu.</para
></note>
</listitem>
</itemizedlist>

<para
>Sekcja <guilabel
>Wyjątki</guilabel
> pozwala na wyłączenie pewnych dat/terminów z reguł powtarzania. Uwaga: opcje te nie są pokazywane w uproszczonej wersji okna edycji alarmu. Aby je zobaczyć należy kliknąć przycisk <guibutton
>Więcej opcji</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>Lista wyjątków (wyłączonych dat i terminów) jest pokazana po lewej stronie. Aby dodać nowy wyjątek do listy, należy wprowadzić datę po prawej stronie i nacisnąć przycisk <guibutton
>Dodaj</guibutton
>. Aby zmienić wyjątek należy go wybrać na liście, i wpisać nową datę i nacisnąć przycisk <guibutton
>Zmień</guibutton
>. Aby usunąć wyjątek, należy go podświetlić na liście i nacisnąć <guibutton
>Usuń</guibutton
>.</para>
</listitem>

<listitem>
<para
>Można wyłączyć powtarzanie alarmu w dni świąteczne poprzez wybranie opcji <guilabel
>Nie wliczaj świąt</guilabel
>. Ta opcja nie zmienia ustawień powtarzania alarmu, blokuje tylko jego wyświetlanie w sytuacji gdyby miał się wyświetlić w dzień świąteczny. Ustawienie dni świątecznych zależnych od kraju i regionu odbywa się w <link linkend="preferences-time"
>oknie konfiguracji</link
>.</para>
</listitem>

<listitem>
<para
>Można spowodować aby alarm pokazywał się jedynie w godzinach pracy poprzez wybranie opcji <guilabel
>Tylko podczas godzin pracy</guilabel
>.  Ta opcja nie zmienia ustawień powtarzania alarmu, blokuje tylko jego wyświetlanie w sytuacji gdyby miał się wyświetlić poza godzinami pracy. Ustawienie dni roboczych i godzin pracy odbywa się w <link linkend="preferences-time"
>oknie konfiguracji</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Pod-powtórzenie</title>

<para
>Za pomocą przycisku <guibutton
>Pod-powtórzenie</guibutton
> można zdefiniować pod-powtórzenia w ramach danego powtórzenia. W takich przypadkach, zawsze gdy alarm ma zostać wyświetlony zgodnie z ustawieniami głównego powtórzenia, zamiast pojedynczej aktywacji, będzie włączany wielokrotnie zgodnie z ustawieniami pod-powtórzenia. Przykładowo aby ustawić alarm powtarzający się co godzinę między godziną 12 a 18 w każdy wtorek, należy zdefiniować cotygodniowe powtarzanie na wtorek na godzinę 12, i w oknie dialogowym pod-powtórzenia określić okres powtarzania na 1 godzinę i ustalić albo liczbę powtórzeń na 6 razyalbo czas trwania na 6 godzin.</para>

<para
>W oknie pod-powtórzenia wyświetlanym po naciśnięciu przycisku <guibutton
>Pod-powtórzenie</guibutton
>, należy zaznaczyć opcję <guilabel
>Powtarzaj co</guilabel
> aby włączyć pod-powtórzenie, lub usunąć zaznaczenie w celu wyłączenia pod-powtarzania. Po zaznaczeniu opcji <guilabel
>Powtarzaj co</guilabel
> można określić następujące parametry pod-powtórzenia:</para>

<itemizedlist>
<listitem
><para
>Określić odstęp czasu pomiędzy powtórzeniami w polu<guilabel
>Powtarzaj co</guilabel
>. Obok pola wartości należy wybrać odpowiednią jednostkę czasu (&eg; <guilabel
>dni</guilabel
>) i wpisać liczbę jednostek.</para>
</listitem>

<listitem
><para
>Określić ilość powtórzeń i czas trwania:</para>

<itemizedlist>
<listitem
><para
>W polu <guilabel
>Liczba powtórzeń</guilabel
> można wprowadzić ile razy ma nastąpić powtórzenie alarmu po głównym jego wystąpieniu. Tak więc, przykładowo, aby alarm pojawił się 4 razy po każdym głównym wystąpieniu, tzn. 3 dodatkowe razy, to należy tutaj wprowadzić wartość 3.</para>
</listitem>

<listitem
><para
>W polu <guilabel
>Czas trwania</guilabel
> można wprowadzić całkowity czas trwania okresu, w którym alarm będzie powtarzany. Nie musi to być wartość odpowiadająca wielokrotności odstępu między powtórzeniami, będzie ona automatycznie zaokrąglona po naciśnięciu przycisku <guibutton
>OK</guibutton
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Aby uniknąć nakładania się pod-powtórzeń dla tego samego alarmu, czas trwania pod-powtórzeń jest ograniczona do najdłuższego odstępu pomiędzy głównymi wystąpieniami alarmu. Za każdym razem, gdy alarm wystąpi zgodnie z regułą ustaloną dla głównego powtórzenia, wszystkie aktywne pod-powtórzenia, które zostały uruchomione wraz z poprzednim jego wystąpieniem, zostaną automatycznie anulowane.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Inne ustawienia</title>

<para
>Opcja alarmów wyświetlonych <guilabel
>Potwierdzenie</guilabel
> pozwala na włączenie zapytania o potwierdzenie, przy zamykaniu okna z wiadomością alarmu. Może to być wykorzystane jako zabezpieczenie przed przypadkowym zamknięciem okna i zatwierdzeniem alarmu.</para>

<para
>Opcja <guilabel
>Pokaż w &korganizer;</guilabel
> dodaje alarm do aktywnego kalendarza w programie &korganizer;, gdzie jest widoczny jako zdarzenie bez alarmu. Pozwala to na zarządzanie zdarzeniami w programie &korganizer;, korzystając jednak z funkcjonalności programu &kalarm;.</para>

<note
><para
>Jeżeli później alarm zostanie zmodyfikowany lub usunięty w programie &kalarm;, odpowiadające mu zdarzenie w programie &korganizer; będzie także zmodyfikowane lub usunięte. Jednak zmiana zdarzenia w &korganizer;, nie spowoduje zmiany odpowiadającego mu alarmu w &kalarm;.</para
></note>

<para
>Naciśnięcie przycisku <guibutton
>Wczytaj szablon</guibutton
> pozwala na wybranie szablonu dla alarmu za pomocą okna opisanego w sekcji <link linkend="create-edit"
>Tworzenie i modyfikacja alarmów</link
>. </para>

<para
>Naciśnięcie przycisku <guibutton
>Próbuj</guibutton
> spowoduje sprawdzenie alarmu czy poprawnie się wyświetla. Okno wiadomości wyświetla się tak samo jakby alarm został aktywowany w normalny sposób.</para>

<para
>Naciśnięcie <guibutton
>OK</guibutton
> po poprawnym wprowadzeniu wszystkich ustawień, dodaje alarm do listy zaplanowanych alarmów.</para>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Okno wiadomości alarmu</title>

<para
>Gdy nadejdzie termin alarmu, wiadomość wyświetlana jest na wszystkich pulpitach środowiska &kde; i nie może być przykryta przez zwykłe okna, aby użytkownik jej nie przeoczył. Okno wiadomości zawiera czas, w którym alarm był zaplanowany, tak więc można sprawdzić kiedy wiadomość się wyświetliła, jeżeli użytkownika akurat nie było przed komputerem. Jeżeli ustawiona dla alarmu strefa czasowa jest inna od strefy ustawionej dla lokalnego komputera, to pokazana zostanie także strefa czasowa (Dla wiadomości przypominających wyświetla się data i czas zaplanowanego alarmu, a nie czas wyświetlenia wiadomości przypominającej, zaś w tytule okna widoczny jest tekst <quote
>Przypomnienie</quote
>.)</para>

<para
>Okna alarmów są widoczne, aż do czasu ich zatwierdzenia przez użytkownika chyba że włączona została opcja <guilabel
>Automatycznie zamknij okno po tym czasie</guilabel
> w oknie <link linkend="alarm-edit-dlg"
>edycji alarmu</link
>.W przypadku alarmów powtarzających się, jeżeli widoczna jest niezatwierdzona wiadomość z poprzedniego wystąpienia alarmu, to to samo okno wystąpienia wyskakuje na pulpit dla kolejnego wystąpienia. Pozwala to uniknąć zatwierdzania wielu kopii tej samej wiadomości, jeżeli użytkownik nie mógł tego zrobić w czasie ich wystąpienia.</para>

<para
>Okno w którym wyświetla się komunikat alarmu, zawiera następujące polecenia dotyczące wyświetlonego alarmu:</para>

<itemizedlist>
<listitem>
<para
>Zatwierdzenie alarmu jest możliwe za pomocą przycisku <guibutton
>Zamknij</guibutton
>.Spowoduje to zamknięcie okna z komunikatem (ewentualnie wyświetli się dodatkowe okno potwierdzeniew przypadku wybrania opcji <guilabel
>Potwierdzenie</guilabel
> w ustawieniach alarmu).</para>
</listitem>

<listitem>
<para
>Edycja parametrów alarmu. Po kliknięciu przycisku <guibutton
>Edytuj...</guibutton
> wyświetla się okno <link linkend="alarm-edit-dlg"
>Edycji alarmu</link
>.</para>
</listitem>

<listitem>
<para
>Naciśnięcie przycisku <guibutton
>Odrocz...</guibutton
> wyświetla opcje służące do odkładania alarmu na późniejszy termin. W oknie tym należy wybrać <guilabel
>Odrocz do daty/czasu</guilabel
> aby wprowadzić datę i czas, w którym wiadomość ma zostać ponownie wyświetlona, lub opcję <guilabel
>Odroczenie na dany odstęp czasu</guilabel
> aby określić po jakim czasie licząc od chwili obecnej (w godzinach i minutach) wiadomość ma być ponownie wyświetlona. Po wybraniu jednej z opcji naciśnięcie przycisku <guibutton
>OK</guibutton
> spowoduje odroczenie wiadomości alarmu i zamkniecie okna.</para>

<note
><para
>Czas, do którego alarm jest odraczany musi być wcześniejszy od jego kolejnego wystąpienia lub kolejnego przypomnienia. Z tego powodu przyciski <guibutton
>Odrocz...</guibutton
> w oknie wiadomości alarmu oraz <guibutton
>OK</guibutton
> w oknie odraczania, są wyłączane na jedną minutę przed wystąpieniem następnego alarmu lub przypomnienia.</para
></note>

<note
><para
>Przycisk <guibutton
>Odrocz...</guibutton
> nie jest wyświetlany dla alarmów wyświetlanych po zalogowaniu ponieważ opcja <guilabel
>Powtarzaj po zalogowaniu</guilabel
> została wybrana.</para
></note>
</listitem>

<listitem>
<para
>Można wyłączyć odtwarzanie pliku dźwiękowego alarmu, poprzez naciśnięcie klawisza z ikona <quote
>zatrzymaj odtwarzanie</quote
>.</para>
</listitem>

<listitem>
<para
>Jeżeli wiadomość alarmu została wprowadzona poprzez przeciągnięcie wiadomości z programu &kmail;, można szybko otworzyć wiadomość klikając na ikonę &kmail-dopelniacz;. Spowoduje to wybranie i podświetlenie wiadomości w liście folderów &kmail-dopelniacz;.</para>

<warning
><para
>Jeżeli indeks wiadomości w programie &kmail; zostanie ponownie utworzony, spowoduje to utratę połączenia do wiadomości.</para
></warning>
</listitem>

<listitem>
<para
>Przycisk wyświetlający ikonę programu <guiicon
>&kalarm;</guiicon
> umożliwia wygodny dostęp do &kalarm-dopelniacz;.</para>
</listitem>
</itemizedlist>

<para
>W oknie <link linkend="preferences-view"
>Konfiguracji</link
> można wybrać jeden z dwóch trybów wyświetlania wiadomości alarmu:</para>

<itemizedlist>
<listitem>
<para
>Jako zwykłe okno. W tym trybie, po wyświetleniu alarmu okno staje się aktywne i przejmuje obsługę klawiatury. Oznacza to, że jeżeli alarm wyświetli się w trakcie pisania tekstu (np. w edytorze) wciskane klawisze będą obsługiwane przez &kalarm; a nie wykorzystywaną w danym momencie aplikację.</para>
</listitem>

<listitem>
<para
>Jako okno nie modalne. W tym trybie, wyświetlenie alarmu, nie spowoduje przejęcie klawiatury i nie przeszkodzi w trakcie pisania. W tym trybie jednak, okno alarmu nie ma paska tytułowego i ramki, tak więc nie można go przesuwać ani zmieniać jego rozmiaru.</para>
</listitem>
</itemizedlist>

<note
><para
>Gdy alarm jest wyświetlany w trakcie korzystania z aplikacji pełnoekranowej, zawsze wyświetla się w trybie nie modalnym niezależnie od ustawień. Spowodowane jest to ograniczeniami systemu obsługi okien.</para
></note>

<sect2>
<title
>Ustalanie pozycji okien wiadomości</title>

<para
>W oknie <link linkend="preferences-view"
>Konfiguracji</link
> można wybrać jeden z dwu sposobów pozycjonowania okien wiadomości alarmu:</para>

<itemizedlist>
<listitem>
<para
>Okna wyświetlane są tak daleko od aktualnej pozycji kursora, jak to jest możliwe. Ogranicza to możliwość przeszkodzenia w aktualnie wykonywanej pracy i ogranicza możliwość przypadkowego zatwierdzenia alarmu.</para>
</listitem>

<listitem>
<para
>Okna wyświetlane są w środku ekranu. Aby ograniczyć możliwość pomyłkowego zatwierdzenia alarmu, na początku przyciski są nieaktywne. Stają się aktywne po pewnym czasie, który można ustawić.</para>
</listitem>
</itemizedlist>

<para
>Jeżeli wyświetlanych jest wiele okien wiadomości alarmu lub komunikatów błędów, można je uporządkować na ekranie tak, aby wszystkie były widoczne, lub zgrupować je w górnym lewym rogu ekranu. Odbywa się to za pomocą opcji menu:<menuchoice
> <guimenu
>Widok</guimenu
><guimenuitem
>Spread Windows</guimenuitem
> </menuchoice
>. W razie potrzeby można dla tej akcji ustawić globalny skrót klawiszowy.</para>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Tacka systemowa</title>

<para
>Domyślnie &kalarm; wyświetla ikonę na tacce systemowej. Korzystają z ikony, można sterować programem. Służy też ona jako wskaźnik stanu pracy. Standardowa ikona &kalarm-dopelniacz; wskazuje, że alarmy są monitorowane, natomiast ikona w szarym kolorze wskazuje, że program jest nieaktywny.</para>

<para
>Przesunięcie kursora myszy nad ikonę na tacce systemowej, wyświetli podsumowanie pierwszych kilku alarmów zaprogramowanych na najbliższe 24 godziny. Funkcja ta może zostać wyłączona. Można również ustawić jak dużo alarmów ma być wyświetlanych oraz w jaki sposób. Dokonuje się tego w oknie <link linkend="preferences-view"
>Konfiguracji</link
>.</para>

<para
>Wciśnięcie <mousebutton
>Lewego</mousebutton
> przycisku myszy na ikonie na tacce systemowej, wyświetla i chowa główne okno programu &kalarm;.</para>

<para
>Wciśnięcie <mousebutton
>prawego</mousebutton
> przycisku myszy na ikonie na tacce systemowej, wyświetla menu kontekstowe:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Włącz alarmy</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Włącza lub wyłącza monitorowanie alarmów.</action
></para>
<para
>Więcej na ten temat w sekcji:<link linkend="enable-disable"
>Włączanie i wyłączanie alarmów</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nowy alarm</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Pozwala na wybranie alarmu z listy, a następnie otwarcie okna edycji dla tworzonego alarmu.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nowy alarm z szablonu</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Wyświetla listę szablonów alarmów. Po wybraniu jednej z pozycji, wyświetla się okno edycji alarmu, wypełnione wstępnymi ustawieniami pobranymi z szablonu.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Konfiguracja &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Wyświetla okno konfiguracji &kalarm;.</action
></para>
<para
>Okno konfiguracji opisane zostało w sekcji <link linkend="preferences"
>Konfiguracja &kalarm;</link
>. Zawiera ono opcje dotyczące zachowania ikony &kalarm-dopelniacz; na tacce systemowej.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Przywróć/Minimalizuj</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Przywraca lub minimalizuje główne okno &kalarm;.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Zakończ</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Zamyka program &kalarm; i ikonę na tacce systemowej.</action
></para>
<para
>Zamyka program &kalarm; jeżeli nie ma wyświetlanych żadnych okien alarmów.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>Wyświetlanie &kalarm-dopelniacz; na tacce systemowej</title>

<para
>Aby wyświetlić program &kalarm; na tacce systemowej. Użytkownik musi mieć uruchomione środowisko &kde; lub odpowiedni inny menedżer okien.</para>

<para
>Aby wyświetlić ikonę &kalarm; na tacce systemowej należy wybrać z menu <menuchoice
> <guimenu
>Widok</guimenu
><guimenuitem
>Pokaż w tacce systemowej</guimenuitem
> </menuchoice
>.</para>

<para
>Aby usunąć &kalarm; z tacki systemowej, należy usunąć zaznaczenie pozycji menu:<menuchoice
><guimenu
>Widok</guimenu
> <guimenuitem
>Pokaż w tacce systemowej</guimenuitem
></menuchoice
>.</para>

<para
>Aby ustawić wyświetlanie lub nie &kalarm-dopelniacz; w tacce systemowej po uruchomieniu, należy skorzystać z sekcji <link linkend="preferences-view"
>Widok</link
>  okna konfiguracji.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Odświeżanie alarmów</title>

<para
>Jeżeli z jakiegoś mało prawdopodobnego powodu, jakieś alarmy nie zostały aktywowane wtedy kiedy powinny, można odświeżyć listę alarmów i wywołać wszystkie pominięte alarmy za pomocą polecenia<menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Odśwież alarmy</guimenuitem
> </menuchoice
>. Spowoduje to, iż &kalarm; przeładuje wszystkie kalendarze alarmów.</para>

<para
>Możliwe jest przeładowywanie wybranych kalendarzy alarmów i odświeżanie ich alarmów, za pomocą kliknięcia <mousebutton
>prawym</mousebutton
> przyciskiem myszki na kalendarz a liście, i wybrania opcji  <menuchoice
><guimenuitem
>Odśwież</guimenuitem
></menuchoice
> z menu kontekstowego. Więcej na ten temat w sekcji <link linkend="calendars"
>Kalendarze alarmów</link
>.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Włączanie i wyłączanie alarmów</title>

<para
>Wszystkie lub pojedyncze alarmy mogą być włączane lub wyłączane:</para>

<itemizedlist>
<listitem>
<para
><quote
>Monitorowanie alarmów</quote
> dotyczy wszystkich alarmów. Jeżeli opcja zostanie wyłączona, to nie będzie wywołany żaden alarm. Jeżeli alarmy są włączone (sytuacja normalna), wszystkie alarmy, które nie zostały wyłączone przez użytkownika będą wyświetlone w zaplanowanym czasie.</para>

<para
>Powtórne włączenie monitorowania alarmu, powoduje iż alarmy, które byłyby wyświetlone w czasie wyłączenia monitoringu, są teraz wyświetlany (z wyjątkiem alarmów. dla których określono zasadę anulowania po opóźnienia). Innymi słowo, wyłączenie monitorowania alarmów, ma takie samo działanie jak zamknięcie programu &kalarm; - alarmy są odkładane do czasu ponownego jego uruchomienia.</para>
</listitem>

<listitem>
<para
>Pojedyncze alarmy mogą być włączane lub wyłączane niezależnie od działania funkcji monitorowania alarmów. Tak więc stan włączenia lub wyłączenia pojedynczego alarmu nie będzie się zmieniał po włączeniu lub wyłączeniu monitorowania alarmów. Inaczej niż w przypadku monitorowania alarmów, które może być wyłączone z powodu nie uruchomienia programu &kalarm;, pojedyncze alarmy mogą być wyłączone jedynie za pomocą polecenia menu.</para>

<para
>Gdy pojedynczy alarm jest ponownie włączany, nie powoduje to jego wyświetlenia w przypadku gdyby w trakcie wyłączenia upłynął termin jego wywołania. Innymi słowy, wyłączenie pojedynczego alarmu usuwa wszelkie informacje o jego wystąpieniach, aż do czasu ponownego jego włączenia.</para>

<para
>Stan włączenia lub wyłączenia dla pojedynczego alarmu jest wskazywany za pomocą koloru na liście alarmów (kolor ten może zostać ustawiony w sekcji <link linkend="preferences-view"
>Widok</link
> okna konfiguracji).</para>
</listitem>
</itemizedlist>

<para
>Aby alarm mógł być wyświetlony, powinien być włączony alarm oraz funkcja monitorowania alarmów.</para>

<sect2>
<title
>Włączanie monitorowania alarmów</title>

<para
>Aby działało monitorowanie alarmów, program &kalarm; musi być uruchomiony. Po pierwszym uruchomieniu &kalarm-dopelniacz; będzie on automatycznie się uruchamiał po każdym zalogowaniu, chyba że zostanie to wyłączone w sekcji <link linkend="preferences-general"
>Ogólne</link
> okna konfiguracji.</para>

<para
>Jeżeli monitorowanie alarmów jest wyłączone, to aby je ponownie włączyć należy:</para>

<itemizedlist>
<listitem>
<para
>Wybrać opcję <menuchoice
><guimenu
>Działania</guimenu
> <guimenuitem
>Włącz alarmy</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Nacisnąć <mousebutton
>prawy</mousebutton
> przycisk myszy na ikonie programu w tacce systemowej i wybrać <menuchoice
><guimenuitem
>Włącz alarmy</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Wyłączanie monitorowania alarmów</title>

<para
>Można tymczasowo wyłączyć monitorowanie alarmów, co spowoduje iż program &kalarm; nie będzie sprawdzał i wyświetlał alarmów, dopóki nie zostanie ono ponownie włączone, lub &ndash; zakładając że tak jest skonfigurowany &ndash; do ponownego zalogowania użytkownika.</para>

<itemizedlist>
<listitem>
<para
>Wyłączyć zaznaczenie opcji w menu <menuchoice
><guimenu
>Działania</guimenu
> <guimenuitem
>Włącz alarmy</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Nacisnąć <mousebutton
>prawy</mousebutton
> przycisk myszy na ikonie programu w tacce systemowej i usunąć zaznaczenie opcji <menuchoice
><guimenuitem
>Włącz alarmy</guimenuitem
></menuchoice
> w menu kontekstowym.</para>
</listitem>

<listitem>
<para
>Zatrzymać program &kalarm; zgodnie z opisem w sekcji <link linkend="quitting"
>Zakończenie pracy programu &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Alarmy mogą być całkowicie wyłączone poprzez wyłączenie opcji uruchamiania &kalarm-dopelniacz; po zalogowaniu, w sekcji  <link linkend="preferences-general"
>Ogólne</link
> okna konfiguracji.</para>

</sect2>

<sect2>
<title
>Włączanie i wyłączanie wybranych alarmów</title>

<para
>Aby włączyć pojedynczy wyłączony alarm, należy wykonać jedną z następujących operacji:</para>

<itemizedlist>
<listitem>
<para
>Po wybraniu jednego lub większej liczby alarmów za pomocą kliknięcia pozycji na liście alarmów, należy wybrać opcję <menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Włącz</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Należy nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk na alarmie z listy i wybrać opcję <menuchoice
><guimenuitem
>Włącz</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

<para
>Aby wyłączyć pojedynczy włączony alarm, należy wykonać jedną z następujących operacji:</para>

<itemizedlist>
<listitem>
<para
>Po wybraniu jednego lub większej liczby alarmów za pomocą kliknięcia pozycji na liście alarmów, należy wybrać opcję <menuchoice
> <guimenu
>Działania</guimenu
><guimenuitem
>Wyłącz</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Należy nacisnąć <mousebutton
>Prawy</mousebutton
> przycisk na alarmie z listy i wybrać opcję <menuchoice
><guimenuitem
>Wyłącz</guimenuitem
></menuchoice
> z menu kontekstowego.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="quitting">
<title
>Zakończenie pracy programu &kalarm;</title>

<para
>Aby zakończyć działanie programu &kalarm; należy wybrać polecenie <menuchoice
> <guimenu
>Plik</guimenu
><guimenuitem
>Zakończ</guimenuitem
></menuchoice
>, lub <menuchoice
><guimenuitem
>Zakończ</guimenuitem
></menuchoice
> w menu kontekstowym ikony programu na tacce systemowej. W przypadku, gdy ikona na tacce systemowej nie jest widoczna, wystarczy zamknąć wszystkie widoczne okna &kalarm-dopelniacz;.</para>

</sect1>
</chapter>

<chapter id="preferences">
<title
>Konfiguracja &kalarm;</title>

<para
>Aby skonfigurować działanie programu &kalarm; do indywidualnych wymagań systemu i użytkownika, należy wybrać <menuchoice
><guimenu
>Ustawienia</guimenu
> <guimenuitem
>Konfiguruj &kalarm;...</guimenuitem
></menuchoice
>. Spowoduje to wyświetlenie okna konfiguracji programu.</para>

<sect1 id="preferences-general">
<title
>Ogólne</title>

<para
>Sekcja <guilabel
>Ogólne</guilabel
> pozwala na ustawianie ogólnych parametrów zachowania programu &kalarm;:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Uruchamiaj przy logowaniu</guilabel
>: &kalarm; będzie uruchamiany automatycznie przy każdej sesji logowania do &kde;, aby zapewnić jego ciągłe działanie do momentu jego ręcznego wyłączenia przez użytkownika.</para>

<warning
><para
>Ta opcja powinna być zawsze zaznaczona, chyba że użytkownik rezygnuje z korzystania z &kalarm-dopelniacz;.</para
></warning>

<note
><para
>Ta opcja jest automatycznie włączana przy każdym uruchomieniu &kalarm-dopelniacz;. Jeżeli opcja została wyłączona przez użytkownika, a następnie program został przez niego uruchomiony, to żeby uniemożliwić jego uruchamianie po zalogowaniu, trzeba za każdym razem wyłączać ją w oknie konfiguracji.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Potwierdź zakończenie</guilabel
>: Jeżeli alarmy są wyłączone w czasie, gdy &kalarm; nie jest uruchomiony, włączenie tej opcji spowoduje wyświetlenie pytania o potwierdzenie, jeżeli użytkownik będzie chciał zakończyć pracę z programem za pomocą polecenia <menuchoice
><guimenu
>Zakończ</guimenu
></menuchoice
> z menu kontekstowego ikony w tacce systemowej. Zapobiega to przypadkowemu wyłączeniu alarmów. Dla bezpieczeństwa, opcja jest automatycznie włączana po każdym uruchomieniu programu.</para>
</listitem>

<listitem
><para
><guilabel
>Potwierdzenie usuwania alarmów</guilabel
>: Włącza wyświetlanie potwierdzenia przy próbie usunięcia alarmu.</para>
</listitem>

<listitem
><para
><guilabel
>Odroczenie na dany odstęp czasu</guilabel
>: Pozwala wprowadzić domyślny odstęp czasu w godzinach i minutach, pokazywany w oknie dialogowym odraczania alarmów. Uwaga, jeżeli alarm był wcześniej odroczony, to okres wyświetlony w kolejnym oknie odroczenia będzie taki sam jaki został użyty przy poprzednim odroczeniu. </para>
</listitem>

<listitem
><para
><guilabel
>Terminal dla alarmów w postaci poleceń</guilabel
>: Pozwala na wybranie, jaki program obsługi terminala powinien być użyty do wyświetlania terminala dla alarmów w postaci poleceń. Wstępnie skonfigurowanych jest kilka najpowszechniejszych programów &eg; <application
>xterm</application
>, &konsole;, jednak wyświetlone zostaną tylko te, które są zainstalowane w systemie.  Pełny kod wywołania programu terminala wraz z opcjami dodatkowymi, jest widoczny po wyświetleniu pomocy kontekstowej dla przycisku opcji.</para>

<para
>Jeżeli użytkownik chce użyć innego programu terminala, lub chce dodać swoje własne opcje do wywołania okna terminala, należy wybrać  <guilabel
>Inny</guilabel
> i wpisać w polu polecenie służące do wywołania okna terminala. Domyślnie na końcu tego polecenia, będzie dopisane polecenie powłoki wpisane w definicji alarmu. Można też zadecydować o miejscu umieszczenia polecenia alarmu w wywołaniu terminala, poprzez użycie następujących kodów:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>Kod zastępuje polecenie shella zdefiniowane do wykonania w alarmie.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>Kod zastępuje polecenie shella zdefiniowane do wykonania w alarmie, z dołożoną opcją <literal
>sleep</literal
> </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Kod spowoduje utworzenie tymczasowego pliku wykonywalnego zawierającego polecenie shella zdefiniowane w alarmie, a następnie kod zostanie zastąpiony poleceniem uruchomienia tego pliku.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Kod spowoduje utworzenie tymczasowego pliku wykonywalnego zawierającego polecenie shella zdefiniowane w alarmie uzupełnionego o opcję <literal
>sleep</literal
>, a następnie kod zostanie zastąpiony poleceniem uruchomienia tego pliku.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Jeżeli alarm w postaci polecenia zostanie wywołany, tekst polecenia będzie zamknięty w cudzysłowach przed przekazaniem go to polecenia wywołania terminala.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Czas i data</title>

<para
>Sekcja <guilabel
>Czas i data</guilabel
> umożliwia ustawianie parametrów związanych z czasem i datą:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Strefa czasowa</guilabel
>: Pozwala na wybranie strefy czasowej. &kalarm; będzie ją wykorzystywał w trakcie działania, można ją jednak zmieniać dla wybranych pojedynczych alarmów.</para>
</listitem>

<listitem
><para
><guilabel
>Ustawienia świąt</guilabel
>: Umożliwia określenie kraju lub regionu, którego dni świąteczne będą uwzględniane w programie. Dotyczy to alarmów powtarzających się, dla których zaznaczono opcję wyjątku: Nie wliczaj świąt.</para>
</listitem>

<listitem
><para
><guilabel
>Początek dnia dla alarmów bez podanego czasu</guilabel
>: Ustawia godzinę rozpoczęcia dnia, używaną dla wywoływania alarmów, dla których ustalona została tylko data, tzn. tych dla których zaznaczono opcję: <guilabel
>Kiedykolwiek</guilabel
>. W dniu, na który został ustawiony alarm, będzie on wywołany w najbliższej nadarzającej się okazji poczynając od zdefiniowanej tutaj godziny początku dnia.</para>
</listitem>

<listitem
><para
>Sekcja <guilabel
>Godziny pracy</guilabel
>: Te ustawienia pozwalają na określenie godzin pracy, wykorzystywanych przez opcję <guilabel
>Tylko w godzinach pracy</guilabel
> wybieraną dla alarmów powtarzanych w <link linkend="alarm-edit-dlg"
>oknie edycji alarmu</link
>.</para>

<itemizedlist>
<listitem
><para
>Należy zaznaczyć opcję przy każdym dniu roboczym.</para>
</listitem>

<listitem
><para
><guilabel
>Początek dnia</guilabel
>: należy tu wprowadzić, godzinę o której zaczyna się praca w dniu roboczym.</para>
</listitem>

<listitem
><para
><guilabel
>Koniec dnia</guilabel
>: należy tu wprowadzić, godzinę o której kończy się praca w dniu roboczym.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Nośnik</title>

<para
>Sekcja <guilabel
>Nośnik</guilabel
> pozwala ustawić opcje wykorzystywane do zapisywania i archiwizacji alarmów.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Nowe alarmy i szablony</guilabel
>: Pozwala określić, kalendarz w którym będą przechowywane nowe alarmy i szablony, w przypadku gdy wykorzystywanych jest wiele kalendarzy alarmów.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Przechowuj w domyślnym kalendarzu</guilabel
>: Nowe alarmy i szablony alarmów, będą automatycznie dodawane do domyślnego kalendarza, bez pytania o potwierdzenie.</para>
</listitem>

<listitem>
<para
><guilabel
>Zapytaj, w którym kalendarzu zapisać</guilabel
>: Przy tworzeniu nowego alarmu lub szablonu alarmu, jeżeli istnieje więcej niż jeden kalendarz z możliwością zapisu, użytkownik zostanie zapytany, w którym kalendarzu ma zostać umieszczony nowy alarm. Uwaga, jeżeli alarm wygaśnie, to zawsze bez pytania będzie użyty domyślny kalendarz dla zarchiwizowanych alarmów.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Sekcja <guilabel
>Zarchiwizowane alarmy</guilabel
>: Można tutaj skonfigurować parametry archiwizacji alarmów oraz wybrać domyślny kalendarz dla zarchiwizowanych alarmów.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Przechowuj nieaktualne alarmy</guilabel
>: Wybranie tej opcji włącza funkcję przechowywania nieaktualnych i usuniętych alarmów. Wyłączenie opcji spowoduje że program nie będzie przechowywał żadnych informacji o alarmach po ich wystąpieniu. Uwaga, usuwane alarmy są archiwizowane tylko wtedy, gdy wcześniej zostały wyświetlone. Usunięcie alarmu, przed jego aktywacją, nie powoduje przeniesienia go do archiwum, informacje o nim są utracone.</para>
</listitem>

<listitem
><para
><guilabel
>Usuń zarchiwizowane alarmy po</guilabel
>: Pozwala określić czas w dniach, przez jaki program ma przechowywać zarchiwizowane i usunięte alarmy. Po tym czasie są one bezpowrotnie usuwane.</para>
</listitem>

<listitem
><para
>Przycisk <guibutton
>Wyczyść zarchiwizowane alarmy</guibutton
>: Usuwa wszystkie aktualnie zarchiwizowane alarmy z domyślnego kalendarza (Inne niż domyślny kalendarze zarchiwizowanych alarmów nie są usuwane, gdyż mogą być współdzielone z innymi osobami.). Przycisk nie ma wpływu na alarmy, które dopiero staną się nieaktualne lub będą usuwane; dla takich alarmów archiwizacja będzie się dokonywać zgodnie z ustawieniami.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>Poczta</title>

<para
>Sekcja <guilabel
>Poczta</guilabel
> pozwala ustawić parametry wysyłania i adresowania dla alarmów w postaci wiadomości alarm.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Klient e-mail</guilabel
>: Pozwala na wybranie programu obsługi poczty, używanego do wysyłania wiadomości alarmu:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Gdy alarm w postaci wiadomości się aktywuje, wiadomość jest wysyłana za pomocą programu &kmail; (uruchamianego w razie potrzeby) w następujący sposób:</para>

<itemizedlist>
<listitem
><para
>Jeżeli zainstalowana jest wersja &kmail-dopelniacz; 1.7 lub wyższa, email jest wysyłany automatycznie.</para>
</listitem>

<listitem
><para
>Jeżeli wersja programu &kmail; jest starsza, to wiadomość jest dodawana do folderu <filename
>poczty wychodzącej</filename
> programu &kmail;  gdzie oczekuje na późniejsze wysłanie.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Gdy alarm w postaci wiadomości się aktywuje, wiadomość jest wysyłana za pomocą programu &Sendmail;. Ta opcja zadziała, tylko w przypadku jeżeli w systemie skonfigurowany jest program &Sendmail; lub kompatybilny, jak np.: <application
>postfix</application
> lub <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Kopiuj wysłane wiadomości do folderu "wysłane" KMaila</guilabel
>: Gdy ta opcja będzie zaznaczona to kopia wysłanej wiadomości zostanie zapamiętana w folderze <filename
>wysłane</filename
> programu &kmail;. </para>

<note
><para
>Opcja ta jest niedostępna jeżeli został wybrany &kmail; jako klient poczty, gdyż &kmail; robi to automatycznie.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Powiadom o kolejce zdalnych maili</guilabel
>: Powoduje wyświetlenie powiadomienia za każdym razem, gdy alarm w postaci wiadomości email wprowadzi email do kolejki wiadomości do wysłania. Ta opcja może być pożyteczna, jeśli na przykład użytkownik korzysta z połączenia dial-up lub wiadomość zostanie umieszczona w folderze poczty <filename
>wychodzącej</filename
> programu  &kmail;. Dzięki tej informacji, użytkownik może podjąć działania niezbędne do właściwego wysłania wiadomości.</para>
</listitem>

<listitem>
<para
>Można wybrać adres email używany jako adres nadawcy w wysyłanych wiadomościach e-mail.</para>

<itemizedlist>
<listitem
><para
>Opcja <guilabel
>Od</guilabel
> umożliwia ręczne wpisanie adresu</para>
</listitem>

<listitem
><para
>Opcja <guilabel
>Użyj adresu z /"Ustawień systemowych/"</guilabel
> spowoduje użycie adresu określonego w ustawieniach systemowych środowiska &kde;.</para>
</listitem>

<listitem
><para
>Zaznaczenie <guilabel
>Użyj tożsamości KMaila</guilabel
> pozwala na wybranie w momencie tworzenia alarmu w postaci wiadomości  email, tożsamości programu  &kmail;, która ma zostać wykorzystana do wysłania emaila.  Dla alarmów skonfigurowanych przez włączeniem tej opcji, użyta zostanie domyślna tożsamość ustawiona w programie &kmail;.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Tutaj należy podać adres email wykorzystywany do wysyłania ukrytych kopii wiadomości alarmu, jeżeli zaznaczono opcję: <guilabel
>Kopiuj wysłane wiadomości do folderu "wysłane" KMaila</guilabel
>.</para>

<itemizedlist>
<listitem
><para
>W polu <guilabel
>UDW</guilabel
> należy wprowadzić adres email. Jeżeli ukryte kopie mają być wysyłane do użytkownika na komputerze lokalnym, na którym działa &kalarm;. to wystarczy tu podać tylko nazwę użytkownika.</para>
</listitem>

<listitem
><para
>Opcja <guilabel
>Użyj adresu z /"Ustawień systemowych/"</guilabel
> spowoduje użycie adresu określonego w ustawieniach systemowych środowiska &kde;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Widok</title>

<para
>Sekcja <guilabel
>Widok</guilabel
> pozwala na ustawienie niektórych elementów związanych z wyglądem programu &kalarm;. W zakładce  <guilabel
>Ogólne</guilabel
> dostępne są opcje:</para>
<itemizedlist>

<listitem>
<para
><guilabel
>Pokaż w tacce systemowej</guilabel
>: Jeżeli zaznaczona, spowoduje wyświetlenie ikony programu &kalarm; na tacce systemowej. W tym trybie, zamknięcie programu poprzez ikonę na tacce systemowej zamyka główne okno &kalarm; i jeżeli nie ma wyświetlonych żadnych okien z wiadomościami, wychodzi z programu.</para>
</listitem>

<listitem>
<para
>Sekcja <guilabel
>Podpowiedź na tacce systemowej</guilabel
>: Te opcje pozwalają na ustawienie rodzaju informacji pokazywanych w podpowiedzi, gdy kursor myszki znajdzie się nad ikoną programu &kalarm; w tacce systemowej.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Pokaż alarmy w następnych 24 godzinach</guilabel
>: Jeżeli zaznaczona, powoduje wyświetlenie podsumowania pierwszych kilku alarmów, dla których czas aktywacji mija w ciągu następnych 24 godzin.</para>
</listitem>

<listitem>
<para
><guilabel
>Maksymalna liczba wyświetlanych alarmów</guilabel
>: Wyłączenie tej opcji spowoduje wyświetlenie wszystkich alarmów zaplanowanych w ciągu następnych 24 godzin. Włączenie tej opcji pozwala na wpisanie liczby alarmów, które mają być wyświetlane.</para>
</listitem>

<listitem>
<para
><guilabel
>Pokaż czas alarmu</guilabel
>: Włącza wyświetlanie czasu, na który został zaplanowany alarm.</para>
</listitem>

<listitem>
<para
><guilabel
>Pokaż czas do alarmu</guilabel
>: Włączenie opcji wyświetla czas pozostały do aktywacji następnego wystąpienia alarmu. Czas jest pokazywany w godzinach i minutach.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Przedrostek</guilabel
>: Określa symbol lub tekst dodawany na początku czasu pozostałego do aktywacji alarmu, aby odróżniał się on od czasu, na który alarm został zaplanowany.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Sekcja <guilabel
>Lista alarmów</guilabel
> umożliwia wybranie kolorów wykorzystywanych w głównym oknie listy alarmów programu &kalarm; do wyświetlania wyłączonych i zarchiwizowanych alarmów.</para>
</listitem>
</itemizedlist>

<para
>Zakładka <guilabel
>Okna alarmowe</guilabel
> zawiera ustawienia sterujące wyglądem okien z wiadomościami alarmów.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Umieść okna jak najdalej od kursora</guilabel
>: Włączenie tej opcji wyświetla okna wiadomości alarmów tak daleko od aktualnej pozycji kursora myszki jak tylko jest to możliwe. Ogranicza to możliwość przypadkowego potwierdzenia alarmu poprzez naciśnięcie myszki w momencie pojawienia się okna.</para>
</listitem>

<listitem>
<para
><guilabel
>Wyśrodkuj okna, zablokuj chwilowo przyciski</guilabel
>: Powoduje wyświetlenie wiadomości alarmu w środku ekranu. Aby ograniczyć możliwość przypadkowego potwierdzenia alarmu, przyciski w oknie są przez pewien czas wyłączone. Czas zablokowania przycisków ustawia się w polu <guilabel
>Czas zablokowania przycisków (w sekundach)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Okna wiadomości z paskiem tytułowym i przejmowaniem klawiatury</guilabel
>: Ta opcja steruje modalnością okna wiadomości alarmu, tzn. czy spowodują one przejęcie klawiatury po wyświetleniu. Więcej na ten temat w sekcji <link linkend="message-window"
>Okno wiadomości alarmu</link
>.</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-edit">
<title
>Edycja</title>

<para
>W sekcji <guilabel
>Modyfikuj</guilabel
> można ustawić domyślne ustawienia edycji alarmu, wykorzystywane przez <link linkend="alarm-edit-dlg"
>Okno edycji alarmu</link
>:</para>

<itemizedlist>
<listitem
><para
>Zakładka <guilabel
>Ogólne</guilabel
> zawiera opcje odnoszące się do wszystkich rodzajów alarmu.</para>

<itemizedlist>
<listitem
><para
>Ustawienie domyślnych wartości opcji<guilabel
>Pokaż w KOragnizer</guilabel
> oraz <guilabel
>Anuluj gdy opóźniony</guilabel
>.</para>
</listitem>

<listitem
><para
>Ustawienie domyślnego typu powtarzania.</para>
</listitem>

<listitem
><para
>Ustawienie domyślnego traktowania lat nieprzestępnych dla powtórzeń alarmów zdefiniowanych na dzień 29 lutego.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Zakładka <guilabel
>Typy alarmów</guilabel
>zawiera opcje odnoszące się do wybranych rodzajów alarmów.</para>

<itemizedlist>
<listitem>
<para
>Dla alarmów wyświetlanych:</para>

<itemizedlist>
<listitem
><para
>Ustawienie domyślnych wartości opcji <guilabel
>Automatycznie zamknij okno po czasie opóźnionego unieważnienia</guilabel
> oraz <guilabel
>Potwierdzenie</guilabel
>.</para>
</listitem>

<listitem
><para
>Ustawienie domyślnej jednostki czasu dla przypomnienia.</para>
</listitem>

<listitem
><para
>Ustawienie domyślnych działań specjalnych dla akcji alarmów wyświetlanych.</para>
</listitem>

<listitem
><para
>Ustawienie domyślnych opcji dla dźwięku. Uwaga, domyślny plik dźwiękowy może być ustawiony, nawet jeżeli nie wybrano domyślnego rodzaju dźwięku w liście rozwijanej.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Dla alarmów w postaci poleceń:</para>

<itemizedlist>
<listitem
><para
>Ustawienie domyślnych wartości opcji <guilabel
>Wprowadź skrypt</guilabel
> oraz <guilabel
>Wykonaj w oknie terminala</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Dla alarmów w postaci wiadomości email:</para>

<itemizedlist>
<listitem
><para
>Ustawienie domyślnej wartości opcji <guilabel
>Kopiuj e-mail do siebie</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Zakładka <guilabel
>Czcionki i kolory</guilabel
> pozwala na zdefiniowanie domyślnego wyglądu wiadomości alarmu. Można tu ustawić domyślną czcionkę, kolor tła i kolor tekstu.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Wywołanie z wiersza poleceń</title>

<para
>Jeżeli w momencie wywołania programu &kalarm; wprowadzono parametry do wiersza polecenia, nie wyświetli on okna listy alarmów opisywanego w sekcji <link linkend="using-kalarm"
>Wykorzystanie &kalarm;</link
> powyżej. Parametry wiersza poleceń specyficzne dla &kalarm; mogą być wykorzystane do wykonywania następujących operacji:</para>

<itemizedlist>
<listitem
><para
>zdefiniowanie nowego alarmu</para>
</listitem>
<listitem
><para
>ustawienia trybu wyświetlania &kalarm;</para>
</listitem>
<listitem
><para
>uzyskanie pomocy</para>
</listitem>
</itemizedlist>

<para
>Dodatkowe funkcje dostępne z linii poleceń służą w pierwszej kolejności umożliwieniu innym programom komunikacji z programem &kalarm;. Są one opisane w <link linkend="cmdline-interface"
>Podręczniku programisty &kalarm;</link
>.</para>

<para
>Opcje w wierszu poleceń mogą dotyczyć tylko jednej operacji w programie &kalarm; . Jeżeli użytkownik chce wykonać kilka operacji, to musi wywołać &kalarm; wielokrotnie z jednym zestawem opcji za każdym razem.</para>

<sect1 id="cmdline-schedule">
<title
>Zdefiniowanie nowego alarmu</title>

<para
>Następujące opcje wykorzystywane są do definiowania nowych alarmów:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opcja</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Pyta o potwierdzenie po przeczytaniu wiadomości.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Określa ścieżkę lub adres &URL; pliku, który ma być załączony do wiadomości email. Opcja ta może być w razie potrzeby kilka razy powtórzona. Opcja może być użyta tylko razem z opcją <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Automatycznie zamyka okno alarmu po upłynięciu terminu określonego opcją <option
>--late-cancel</option
>. Może być stosowana tylko razem z opcją <option
>--late-cancel</option
>.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Odtwarza krótkie bip przy wyświetlaniu alarmu. Nie można razem z tą opcją wykorzystywać opcji  <option
>--speak</option
>, <option
>--play</option
> oraz <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Ukryta kopia wiadomości do użytkownika. Może być stosowana tylko razem z opcją <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>kolor</replaceable
></option
></entry>
  <entry
>Określa kolor tła dla wiadomości alarmu za pomocą nazwy koloru zdefiniowanej w bibliotece &Qt; lub wartości szesnastkowej RGB: 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>kolor</replaceable
></option
></entry>
  <entry
>Określa kolor tekstu dla wiadomości alarmu za pomocą nazwy koloru zdefiniowanej w bibliotece &Qt; lub wartości szesnastkowej RGB: 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Wyłącza alarm. Nie będzie on aktywowany, aż do czasu jego ręcznego włączenia.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>polecenie</replaceable
></option
></entry>
  <entry
>Określa polecenie powłoki do wykonania. Może występować jedynie jako ostatni parametr wywołania &kalarm; w wierszu poleceń. Wszystkie następujące po nim parametry są interpretowane jako parametry polecenia powłoki do wykonania. Opcja nie może być stosowana razem z opcjami: <option
>--file</option
>, <option
>--exec-display</option
> oraz <option
>--mail</option
>.Parametry: <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> oraz <option
>--colorfg</option
> są ignorowane.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>polecenie</replaceable
></option
></entry>
  <entry
>Określa polecenie powłoki do wykonania będące źródłem wiadomości alarmu. Może występować jedynie jako ostatni parametr wywołania &kalarm; w wierszu poleceń. Wszystkie następujące po nim parametry są interpretowane jako parametry polecenia powłoki do wykonania. Opcja nie może być stosowana razem z opcjami: <option
>--file</option
>, <option
>--exec-display</option
> oraz <option
>--mail</option
>.Parametry: <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> oraz <option
>--colorfg</option
> są ignorowane.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Określa ścieżkę lub adres &URL; pliku tekstowego lub graficznego, którego zawartość ma się wyświetlić jako wiadomość alarmu.  Opcja nie może być stosowana razem z parametrami: <option
>--exec</option
>, <option
>--exec-display</option
> oraz <option
>--mail</option
>. Nie może też być w wywołaniu żadnej <replaceable
>wiadomości</replaceable
> do wyświetlenia.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Wskazuje na określoną tożsamość programu &kmail; do użycia jako nadawcy wiadomości email. Może być stosowana tylko razem z opcją <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>okres</replaceable
></option
></entry>
  <entry
>Określa odstęp pomiędzy powtórzeniami alarmu. Godziny i minuty podawane są w formacie <replaceable
>nHnM</replaceable
>, gdzie <replaceable
>n</replaceable
> oznacza liczbę, &eg; 3H30M. Inne odstępy są określane w formacie <replaceable
>nX</replaceable
>, gdzie <replaceable
>n</replaceable
> oznacza numer a <replaceable
>X</replaceable
> jedną z następujących liter:: Y (lata), M (miesiące), W (tygodnie), D (dni). Jeżeli jednocześnie podano parametr <option
>--recurrence</option
> to nie można stosować liter, Y (lata) oraz M (miesiące). Opcja jest wymagana w przypadku zastosowania parametrów:<option
>--repeat</option
> oraz <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Wyświetla alarm jako zdarzenie w aktywnym kalendarzu &korganizer-dopelniacz;.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>okres</replaceable
></option
></entry>
  <entry
>Cancel the alarm if it cannot be triggered within the specified <replaceable
>period</replaceable
> after the correct time. The <replaceable
>period</replaceable
> is specified in the same format as described for <option
>--reminder</option
>. The default value of <replaceable
>period</replaceable
> is 1 minute.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Aktywuje alarm po każdym zalogowaniu. Opcja nie może być stosowana razem z parametrami: <option
>--interval</option
>, <option
>--repeat</option
> oraz <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>adres</replaceable
></option
></entry>
  <entry
>Wysyła wiadomość email na podany adres. Opcja może być użyta wielokrotnie w razie potrzeby. Opcja nie może być stosowana razem z opcjami: <option
>--file</option
>, <option
>--exec-display</option
> oraz <option
>--mail</option
>.Parametry: <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> oraz <option
>--colorfg</option
> są ignorowane.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Określa ścieżkę lub adres &URL; pliku dźwiękowego, który ma być odtworzony jednokrotnie podczas wyświetlania wiadomości alarmu. Opcja nie może być stosowana razem z parametrami: <option
>--play-repeat</option
>, <option
>--beep</option
> oraz <option
>--speak</option
>.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Określa ścieżkę lub adres &URL; pliku dźwiękowego, który ma być odtwarzany wielokrotnie podczas wyświetlania wiadomości alarmy. Opcja nie może być stosowana jednocześnie z parametrami: <option
>--play</option
>, <option
>--beep</option
> oraz <option
>--speak</option
>.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>specyfikacja</replaceable
></option
></entry>
  <entry
>Określa regułę powtarzania alarmu. Należy określić regułę używając składni  iCalendar (opisanej w dokumencie <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), &eg; <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. Opcja nie może występować razem z opcją <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>liczba</replaceable
></option
></entry>
  <entry
>Określa liczbę powtórzeń alarmu, albo jeżeli powtórzenie jest zdefiniowane za pomocą <option
>--recurrence</option
>, liczbę powtórzeń przy każdym zadziałaniu opcji <option
>--recurrence</option
>(czyli podpowtórzenie w ramach powtórzenia). Jeżeli nie podano parametru <option
>--recurrence</option
> wpisanie wartości -1 powtarza alarm bez końca. Parametr wymaga jednoczesnego podania opcji <option
>--interval</option
>. Nie można go stosować razem z <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>okres</replaceable
></option
></entry>
  <entry
>Powoduje wyświetlenie przypomnienia o alarmie w określonym czasie przed terminem aktywacji właściwego alarmu i każdego z jego powtórzeń (jeżeli są). Godziny i minuty należy wprowadzić w formacie:<replaceable
>nHnM</replaceable
>, gdzie <replaceable
>n</replaceable
> jest liczbą, &eg; 3H30M. Inne odstępy są określane w formacie <replaceable
>nX</replaceable
>, gdzie <replaceable
>n</replaceable
> oznacza numer a <replaceable
>X</replaceable
> jedną z następujących liter: W (tygodnie), D (dni).  Opcja nie może być stosowana razem z parametrami <option
>--exec</option
>, <option
>--mail</option
> lub <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>okres</replaceable
></option
></entry>
  <entry
>Powoduje wyświetlenie jednokrotnego przypomnienia o alarmie w określonym czasie przed terminem aktywacji właściwego alarmu. Przypomnienie nie będzie wyświetlane przed powtórzeniami alarmu (jeżeli są). Opcja nie może być stosowana razem z parametrami: <option
>--exec</option
>, <option
>--mail</option
> lub <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Przy tej opcji wiadomość alarmu zostanie przeczytana i wyświetlona.Opcja jest dostępna tylko wtedy gdy zainstalowany jest program <application
>KTTSD</application
>  oraz skonfigurowany został zgodny z nim syntezator mowy. Razem z tą opcją nie można stosować opcji: <option
>--beep</option
>, <option
>--play</option
> oraz <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>temat</replaceable
></option
></entry>
  <entry
>Temat wiadomości email. Wymaga jednoczesnego wpisania opcji <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>date/time</replaceable
></option
></entry>
  <entry
>Aktywuje alarm o określonej dacie lub dacie/godzinie. Datę bez czasu należy podać w formacie <replaceable
>yyyy-mm-dd [TZ]</replaceable
>, datę z czasem należy podać w formacie: <replaceable
>[[[yyyy-]mm-]dd-]hh:mm [TZ]</replaceable
> (jeżeli pola daty są pominięte, to przyjmowana jest wartość domyślna, tzn. bieżący dzień). Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej  <replaceable
>TZ</replaceable
> odbywa się za pomocą nazwy strefy czasowej (&eg; <userinput
>Europa/Londyn</userinput
>), wartości <userinput
>UTC</userinput
> reprezentującej strefę czasową, lub tekstu <userinput
>Clock</userinput
> dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>procent</replaceable
></option
></entry>
  <entry
>Ustawia poziom głośności odtwarzania pliku dźwiękowego. Opcja ta może być wykorzystywana jedynie razem z opcjami: <option
>--play</option
> lub <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>date/time</replaceable
></option
></entry>
  <entry
>Powtarza alarm do określonej daty lub daty/czasu. Wprowadzenie daty lub daty/czasu odbywa się w formacie takim jak dla opcji: <option
>--time</option
>. Uwaga, jeżeli podano parametr <option
>--time</option
>, to ustawienia strefy czasowej są pobierane z jego wartości, nie można wtedy podać strefy czasowej jako wartości parametru <option
>--until</option
>. Razem z tą opcją musi występować opcja: <option
>--interval</option
>. Opcje <option
>--repeat</option
> oraz <option
>--recurrence</option
> nie mogą występować razem z tą opcją.</entry>
</row>
<row>
  <entry
><replaceable
>wiadomość</replaceable
></entry>
  <entry
>Treść wiadomości do wyświetlenia, a w przypadku opcji <option
>--mail</option
> zawartość wiadomości email.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>W każdym wywołaniu w wierszu polecenia treść wiadomości albo parametry <option
>--file</option
>, <option
>--exec</option
> lub <option
>--exec-display</option
> muszą być podane. Wszystkie pozostałe opcje są opcjonalne.</para>

<para
>Dwa poniższe przykłady wyświetlają dwu-linijkową wiadomość na czerwonym tle o godzinie 10 po południu 27-go bieżącego miesiąca:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Pamiętaj aby \nZATRZYMAĆ"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Pamięŧaj aby \nZATRZYMAĆ"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Pozostałe parametry</title>

<para
>Następujące opcje są wykorzystywane do wyświetlania <link linkend="alarm-edit-dlg"
>okna edycji alarmu</link
> lub do ustawiania sposobu wyświetlania okna programu &kalarm;.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opcja</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Wyświetla okno edycji alarmu dla alarmu o określonym numerze ID zdarzenia.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Wyświetla okno edycji alarmu dla ustawienia parametrów nowego alarmu w postaci polecenia.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Wyświetla okno edycji alarmu dla ustawienia parametrów nowego alarmu wyświetlanego.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Wyświetla okno edycji alarmu dla ustawienia parametrów nowego alarmu w postaci wiadomości alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>nazwaSzablonu</replaceable
></option
></entry>
  <entry
>Wyświetla okno edycji alarmu dla nowego alarmu i ładuje do niego ustawienia określone we wskazanym szablonie.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Wyświetla program &kalarm; jako ikonę na tacce systemowej.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="cmdline-help">
<title
>Opcje pomocy</title>

<para
>Opisane poniżej opcje odnoszą się do wszystkich programów dla środowiska &kde;:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opcja</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Wyświetla pomoc na temat opcji programu.</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Wyświetla różne opcje związane z biblioteką &Qt;.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Wyświetla różne opcje związane z &kde;.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Wyświetla wszystkie dostępne opcje.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Pokazuje nazwiska i adresy email autorów &kalarm-dopelniacz;.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--version</option
></entry>
  <entry
>Wyświetla wersję biblioteki &Qt;, środowiska &kde; oraz programu &kalarm;.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Podaje informacje na temat licencji.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

<chapter id="developers">
<title
>Podręcznik programisty &kalarm;</title>

<para
>&kalarm; udostępnia interfejs pozwalający innym aplikacjom wykonanie następujących funkcji:</para>

<itemizedlist>
<listitem
><para
>zdefiniowanie nowego alarmu</para
></listitem>
<listitem
><para
>anulowanie zdefiniowanego alarmu</para
></listitem>
<listitem
><para
>wywołanie zdefiniowanego alarmu</para
></listitem>
<listitem
><para
>wyświetlenie okna edycji alarmu</para
></listitem>
</itemizedlist>

<para
>Wszystkie powyższe funkcje są dostępne zarówno jako wywołania interfejsu D-Bus lub z linii poleceń. Wywołania D-Bus należy zdecydowanie preferować w przypadku, gdy &kalarm; jest już uruchomiony.</para>

<sect1 id="dbus-interface">
<title
>Interfejs D-Bus</title>

<para
>Wszystkie wywołania D-Bus opisane tutaj są zaimplementowane w ścieżce obiektu <constant
>/kalarm</constant
> dla interfejsu D-Bus. Interfejs jest zdefiniowany w plikach <filename
>org.kde.kalarm.kalarm.xml</filename
> oraz <filename
>kalarmiface.h</filename
>.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>anuluje zdefiniowany alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Określa unikalny numer ID zdarzenia, które ma zostać anulowane.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>cancelEvent()</function
> to wywołania D-Bus anuluje określony alarm. Program &kalarm; usuwa alarm z kalendarza bez wyświetlenia go lub aktywowania.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>wywołuje zdefiniowany alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Określa unikalny numer ID zdarzenia, które ma zostać wywołane.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>triggerEvent()</function
> jest wywołaniem D-Bus służącym do natychmiastowego wyświetlenia lub aktywacji określonego alarmu (niezależnie od zaplanowanego czasu). Program &kalarm; pobiera informacje o alarmie z kalendarza i aktywuje go.</para>

<para
>Jeżeli dla alarmu minął termin wyświetlenia, &kalarm; usuwa wszystkie zaplanowane wystąpienia do chwili obecnej, a jeżeli dla alarmu nie ma żadnych kolejnych powtórzeń, to jest usuwany z kalendarza. Jeżeli termin wyświetlenia alarmu jeszcze nie upłynął, to żadne zmiany w zaplanowanych terminach nie są dokonywane.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>definiuje nowy alarm wyświetlający wiadomość.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>wiadomość</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     const QString&amp; <replaceable
>recurrence</replaceable
>,
                     int <replaceable
>subRepeatInterval</replaceable
>, 
                     int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>wiadomość</replaceable
>, 
                     const QString&amp; <replaceable
>startDateTime</replaceable
>, 
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     int <replaceable
>recurType</replaceable
>, 
                     int <replaceable
>recurInterval</replaceable
>, 
                     int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>wiadomość</replaceable
>, 
                     const QString&amp; <replaceable
>startDateTime</replaceable
>, 
                     int <replaceable
>lateCancel</replaceable
>, 
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     int <replaceable
>recurType</replaceable
>, 
                     int <replaceable
>recurInterval</replaceable
>, 
                     const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>wiadomość</parameter
></term>
<listitem>
<para
>Określa tekst wiadomości planowanego alarmu, a jeżeli parametr <parameter
>flags</parameter
> ma ustawiony bit <userinput
>DISPLAY_COMMAND</userinput
>, to definiowane jest tutaj polecenia powłoki generujące tekst wiadomości alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:<replaceable
>YYYY-MM-DD [TZ]</replaceable
> (format daty zwracany przez metodę <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (format daty zwracany przez metodę<methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) lub <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (format zwracany przez metodę: <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.</para>

<para
> Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej  <replaceable
>TZ</replaceable
> odbywa się za pomocą nazwy strefy czasowej (&eg; <userinput
>Europa/Londyn</userinput
>), wartości <userinput
>UTC</userinput
> reprezentującej strefę czasową, lub tekstu <userinput
>Clock</userinput
> dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Definiuje logiczne OR dla wybranych bitów sterujących alarmu. Bity sterujące zdefiniowane są przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów wyświetlanych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Określa kolor tła dla wyświetlanej wiadomości. Format koloru powinien mieć postać: <quote
>#RRGGBB</quote
> (taki jak wartość zwracana przez metodę <methodname
>QColor::name()</methodname
>) gdzie RR, GG i BB są dwuznakowymi szesnastkowymi wartościami składowych czerwonej, zielonej i niebieskiej. Dodatkowo kolor może być określony w dowolnym innym formacie akceptowanym przez metodę <methodname
>QColor::setNamedColor()</methodname
>, jak na przykład nazwa koloru z bazy danych kolorów X (&eg; <quote
>red</quote
> or <quote
>steelblue</quote
>). Pusta wartość spowoduje użycie bieżącego koloru domyślnego.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fgColor</parameter
></term>
<listitem>
<para
>Określa kolor tekstu dla wyświetlanej wiadomości alarmu. Format wartości jest taki sam jak dla parametru <parameter
>bgColor</parameter
>, możne też podać ciąg pusty, dla określenia domyślnego koloru tekstu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>font</parameter
></term>
<listitem>
<para
>Określa czcionkę użytą do wyświetlenia wiadomości. Format tekst jest taki jak zwracany przez metodę <methodname
>QFont::toString()</methodname
>. Pusta wartość spowoduje użycie domyślnej w momencie wyświetlania czcionki dla wiadomości.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Określa plik dźwiękowy, który ma być odtworzony przy wyświetlaniu wiadomości alarmu. Podanie wartości pustej nie odtworzy żadnego dźwięku.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Określa na ile minut przed wyświetleniem alarmu i każdego z jego powtórzeń (jeżeli są) ma się wyświetlać przypomnienie. Wartość 0 oznacza brak przypomnienia.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na przykład: <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:<parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem<parameter
>recurType</parameter
>) pomiędzy powtórzeniami alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr<parameter
>startDateTime</parameter
> zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś <parameter
>startDateTime</parameter
> zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Opis</title>
<para
><function
>scheduleMessage()</function
> jest to wywołanie D-Bus do zaplanowania alarmu w postaci wiadomości do wyświetlenia w określonej dacie i czasie. Wywołanie ma trzy postacie: Najbardziej ogólna postać pozwala na zdefiniowanie typowego powtarzania alarmu i jest także używana dla alarmów bez powtórzeń. Pozostałe formy pozwalają zdefiniować tylko określone typy alarmów z powtórzeniami, jedna dla określenia liczby powtórzeń i druga dla określania początku i końca powtórzeń.</para>

<para
>Jeżeli zaplanowany czas alarmu (i wszystkich powtórzeń) minął, &kalarm; natychmiast wyświetli wiadomość (z wyjątkiem sytuacji gdy parametr <parameter
>lateCancel</parameter
> określa, iż na wyświetlenie alarmu jest już za późno. Wtedy &kalarm; ignoruje wywołanie). Jeżeli zaplanowany czas alarmu (lub jego powtórzenia) odnosi się do przyszłości, &kalarm; dodaje alarm do domyślnego aktywnego kalendarza alarmów, celem późniejszego jego wyświetlenia.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>definiuje nowy alarm wyświetlający wiadomość lub zawartość pliku tekstowego lub graficznego.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  const QString&amp; <replaceable
>recurrence</replaceable
>,
                  int <replaceable
>subRepeatInterval</replaceable
>, 
                  int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  int <replaceable
>recurType</replaceable
>,
                  int <replaceable
>recurInterval</replaceable
>,
                  int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  int <replaceable
>recurType</replaceable
>,
                  int <replaceable
>recurInterval</replaceable
>,
                  const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
>Określa plik z tekstem lub obrazkiem, którego zawartość ma być wyświetlona jako wiadomość alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:<replaceable
>YYYY-MM-DD [TZ]</replaceable
> (format daty zwracany przez metodę <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (format daty zwracany przez metodę<methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) lub <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (format zwracany przez metodę: <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.</para>

<para
> Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej  <replaceable
>TZ</replaceable
> odbywa się za pomocą nazwy strefy czasowej (&eg; <userinput
>Europa/Londyn</userinput
>), wartości <userinput
>UTC</userinput
> reprezentującej strefę czasową, lub tekstu <userinput
>Clock</userinput
> dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Definiuje logiczne OR dla wybranych bitów sterujących alarmów. Bity sterujące zdefiniowane są przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów wyświetlanych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Określa kolor tła dla wyświetlanej wiadomości Format koloru powinien mieć postać: <quote
>#RRGGBB</quote
> (taki jak wartość zwracana przez metodę <methodname
>QColor::name()</methodname
>) gdzie RR, GG i BB są dwuznakowymi szesnastkowymi wartościami składowych czerwonej, zielonej i niebieskiej. Dodatkowo kolor może być określony w dowolnym innym formacie akceptowanym przez metodę <methodname
>QColor::setNamedColor()</methodname
>, jak na przykład nazwa koloru z bazy danych kolorów X (&eg; <quote
>red</quote
> or <quote
>steelblue</quote
>). Pusta wartość spowoduje użycie bieżącego koloru domyślnego.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Określa plik dźwiękowy, który ma być odtworzony przy wyświetlaniu wiadomości alarmu. Podanie wartości pustej nie odtworzy żadnego dźwięku.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Określa na ile minut przed wyświetleniem alarmu i każdego z jego powtórzeń (jeżeli są) ma się wyświetlać przypomnienie. Wartość 0 oznacza brak przypomnienia.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na przykład: <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:<parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem<parameter
>recurType</parameter
>) pomiędzy powtórzeniami alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr<parameter
>startDateTime</parameter
> zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś <parameter
>startDateTime</parameter
> zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleFile()</function
> jest wywołaniem D-Bus powodującym zaplanowanie alarmu wyświetlającego zawartość pliku tekstowego lub graficznego. Z wyjątkiem parametrów pozwalających określić ścieżkę lub adres &URL; pliku, oraz parametrów dotyczących koloru i czcionki, pozostałe parametry są identyczne jak dla funkcji <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - i w opisie tej funkcji, należy szukać dalszych szczegółów.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>definiuje nowy alarm w postaci polecenia powłoki.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     const QString&amp; <replaceable
>recurrence</replaceable
>,
                     int <replaceable
>subRepeatInterval</replaceable
>, 
                     int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     int <replaceable
>recurType</replaceable
>,
                     int <replaceable
>recurInterval</replaceable
>,
                     int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     int <replaceable
>recurType</replaceable
>,
                     int <replaceable
>recurInterval</replaceable
>,
                     const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>commandLine</parameter
></term>
<listitem>
<para
>Określa polecenie powłoki, którego wykonanie jest planowane. Flagi <parameter
>flags</parameter
> określają czy parameter zawiera polecenie powłoki czy skrypt do wykonania.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:<replaceable
>YYYY-MM-DD [TZ]</replaceable
> (format daty zwracany przez metodę <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (format daty zwracany przez metodę<methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) lub <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (format zwracany przez metodę: <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.</para>

<para
> Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej  <replaceable
>TZ</replaceable
> odbywa się za pomocą nazwy strefy czasowej (&eg; <userinput
>Europa/Londyn</userinput
>), wartości <userinput
>UTC</userinput
> reprezentującej strefę czasową, lub tekstu <userinput
>Clock</userinput
> dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Definiuje logiczne OR dla wybranych bitów sterujących alarmów. Bity sterujące zdefiniowane są przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów w postaci poleceń.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na przykład: <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:<parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem<parameter
>recurType</parameter
>) pomiędzy powtórzeniami alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr<parameter
>startDateTime</parameter
> zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś <parameter
>startDateTime</parameter
> zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleCommand()</function
> jest wywołaniem D-Bus do ustawienia określonego polecenia powłoki lub skryptu do wykonania w określonym czasie i dacie. Oprócz ustawień polecenia do wykonania, oraz pomijając parametry koloru, czcionki i pliku dźwiękowego, pozostałe parametry są takie same jak dla wywołania: <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - i w opisie tej funkcji, należy szukać dalszych szczegółów.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>definiuje nowy alarm w postaci emaila.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>, 
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   const QString&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>fromID</parameter
></term>
<listitem>
<para
>Tożsamość programu &kmail;, która ma być użyta jako nadawca wiadomości email. Jeżeli pusta, użyty zostanie adres nadawcy ostawiony w oknie konfiguracji &kalarm; <link linkend="preferences-email"
>Ustawienia email</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>addresses</parameter
></term>
<listitem>
<para
>Oddzielana przecinkami lista adresów odbiorców wiadomości emai.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subject</parameter
></term>
<listitem>
<para
>Temat wiadomości email.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>wiadomość</parameter
></term>
<listitem>
<para
>Treść wiadomości email.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>attachments</parameter
></term>
<listitem>
<para
>Rozdzielana przecinkami lista ścieżek lub &URL; do plików, które mają zostać wysłane jako załączniki.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Określa zaplanowaną datę lub datę i czas, w których alarm ma zostać wyświetlony. Dla alarmów zaplanowanych na dzień, wartość należy podać w formacie:<replaceable
>YYYY-MM-DD [TZ]</replaceable
> (format daty zwracany przez metodę <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Dla alarmów zaplanowanych na dzień i godzinę, format powinien być następujący: <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (format daty zwracany przez metodę<methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) lub <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (format zwracany przez metodę: <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Jeżeli nie podano daty, to przyjęta zostanie data aktualna. Uwaga, wartości określające sekundy są ignorowane.</para>

<para
> Jeżeli strefa czasowa nie jest określona, to przyjmowana jest strefa czasowa ustawiona w systemie. Określenie strefy czasowej  <replaceable
>TZ</replaceable
> odbywa się za pomocą nazwy strefy czasowej (&eg; <userinput
>Europa/Londyn</userinput
>), wartości <userinput
>UTC</userinput
> reprezentującej strefę czasową, lub tekstu <userinput
>Clock</userinput
> dla używania godziny zegara lokalnego systemu i ignorowania stref czasowych.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Powoduje anulowanie alarmu, jeżeli nie może być aktywowany przez określony w minutach czas po zaplanowanej aktywacji alarmu. Jeżeli wartość wynosi 0, alarm nie zostanie anulowany, niezależnie od tego jak późno mógł być aktywowany.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Definiuje logiczne OR dla wybranych bitów sterujących alarmów. Bity sterujące zdefiniowane są przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Uwaga, nie wszystkie bity sterujące są adekwatne dla alarmów w postaci wiadomości email.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Definiuje powtarzanie alarmu z użyciem składni iCalendar zdefiniowanej w dokumencie: <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Na przykład: <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> definiuje 4 powtórzenia w odstępach 3 miesięcznych, w ostatni poniedziałek miesiące. Dla alarmów bez powtórzeń, należy tutaj podać pustą wartość.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Określa rodzaj powtórzenia dla alarmu. Dostępne wartości są następujące:MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Są one zdefiniowane przez klasę <classname
>KAlarmIface</classname
> w pliku <filename
>kalarmiface.h</filename
>. Miesięczne powtarzanie odnosi się do dnia w ramach miesiąca, w coroczne dotyczy dnia w roku, gdzie dzień jest w obu przypadkach pobierany z parametru:<parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Określa liczbę okresów (minut, dni, tygodni, miesięcy, lat zgodnie z parametrem<parameter
>recurType</parameter
>) pomiędzy powtórzeniami alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Określa ile razy alarm ma zostać powtórzony. Liczba -1 wskazuje iż alarm ma być powtarzany bez końca.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Określa datę lub czas i datę zakończenia powtarzania alarmu. Jeżeli parametr<parameter
>startDateTime</parameter
> zawiera czas, to również w tym parametrze czas musi zostać podany. Jeżeli zaś <parameter
>startDateTime</parameter
> zawiera tylko datę, to i tutaj musi być tylko data. Nie należy tutaj podawać określenia strefy czasowej, do interpretacji parametru używana jest strefa czasowa podana w parametrze <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Określa ilość minut pomiędzy pod-powtórzeniami alarmu. Wartość 0 oznacza brak pod-powtórzeń. Parametr jest ignorowany, jeżeli nie zdefiniowano powtórzeń dla alarmu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Określa liczbę pod-powtórzeń alarmu, uwzględniającą pierwsze powtórzenie.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>
<para
><function
>scheduleEmail()</function
> jest wywołaniem D-Bus pozwalającym na zaplanowanie alarmu w postaci wiadomości email wysłanej w określonej dacie i czasie. Oprócz ustawień nagłówka wiadomości i treści, oraz pomijając parametry koloru, czcionki i pliku dźwiękowego, pozostałe parametry są takie same jak dla wywołania: <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - i w opisie tej funkcji, należy szukać dalszych szczegółów.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>edit</refname>
<refpurpose
>Wyświetla <link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> do modyfikacji alarmu.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Określa unikalny ID zdarzenia do modyfikacji.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Wartości zwracane</title>
<para
><returnvalue
>false</returnvalue
> jeżeli wskazany alarm nie został znaleziony lub jest w trybie tylko do odczytu,  <returnvalue
>true</returnvalue
> w przeciwnym wypadku.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>edit()</function
> jest wywołaniem D-Bus służącym do wyświetlenia <link linkend="alarm-edit-dlg"
>okna edycji alarmu</link
> i umożliwienia zmiany określonego alarmu.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Wyświetla <link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> do modyfikacji nowego alarmu.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>typ</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>templateName</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametry</title>
<variablelist>
<varlistentry>
<term
><parameter
>typ</parameter
></term>
<listitem>
<para
>Określa typ alarmu. Dostępne wartości są następujące: DISPLAY, COMMAND, EMAIL. Są one zdefiniowane przez klasę <classname
>KAlarmIface</classname
> w pliku źródłowym <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>templateName</parameter
></term>
<listitem>
<para
>Określa nazwę szablonu bazowego dla nowych alarmów</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Wartości zwracane</title>
<para
><returnvalue
>false</returnvalue
> jeżeli parametr <parameter
>typ</parameter
> zawiera nieprawidłową wartość, lub jeżeli nie można znaleźć szablonu określonego nazwą: <parameter
>templateName</parameter
>; w innym przypadku zwraca wartość <returnvalue
>true</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Opis</title>

<para
><function
>editNew()</function
> jest wywołaniem D-Bus wyświetlającym <link linkend="alarm-edit-dlg"
>okno edycji alarmu</link
> dla utworzenia nowego alarmu. Jeżeli w parametrze podano typ alarmu, wyświetla się puste okno. Jeżeli podano nazwę szablonu, to wyświetla się okno z ustawieniami pobranymi z szablonu.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Interfejs do uruchamiania poleceń</title>

<para
>Parametry wiersza poleceń są udostępniane, aby umożliwić innym programom uruchamianie programu &kalarm; jeżeli jeszcze nie jest uruchomiony, w celu aktywacji lub anulowania zaplanowanych alarmów, a także dodawania nowych alarmów. Powodem użycia w tym celu parametrów wiersza poleceń, jest fakt iż jeżeli &kalarm; byłby uruchomiony bez żadnych parametrów, a następnie zastosowano by wywołania D-Bus, to uruchomiłby się w domyślnym trybie graficznym, co jest niepożądane w przypadku komunikacji między aplikacjami.</para>

<note
><para
>Inne programy, powinny najpierw sprawdzić czy &kalarm; jest uruchomiony. Jeżeli tak jest to powinny używać wywołań D-Bus celem wykonania tych operacji.</para
></note>

<para
>Parametry wiersza poleceń służące do zaplanowania nowego alarmu są opisane w rozdziale:<link linkend="cmdline-operation"
>Wywołanie z wiersza poleceń</link
>. Parametry dla aktywacji i anulowania zaplanowanych alarmów są następujące:</para>

<note
><para
>Zwykli użytkownicy mogą wykorzystywać możliwość wywoływania programu z wiersza poleceń (zakładając że potrafią wprowadzić wszystkie niezbędne wartości parametrów).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opcja</entry>
  <entry
>Opis</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Anuluje alarm z podanym ID zdarzenia. Parametr <option
>--triggerEvent</option
> nie może być podany razem z tą opcją.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Aktywuje alarm określony wartością parametru ID zdarzenia. Wykonane zostanie działanie takie samo jak dla wywołania <link linkend="triggerEvent"
>triggerEvent()</link
> D-Bus. Nie może być stosowany razem z parametrem <option
>--cancelEvent</option
>.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Przykłady:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299.793</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Pytania i odpowiedzi</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Jakich plików konfiguracyjnych używa &kalarm;?</para>
</question>
<answer>
<para
>W pliku <filename
>$KDEHOME/share/config/kalarmrc</filename
> znajdują się ustawienia programu &kalarm;.</para>
<para
>W pliku <filename
>$KDEHOME/share/config/kresources/alarms/stdrc</filename
> znajdują się ustawienia kalendarzy.</para>

<para
>($<envar
>KDEHOME</envar
> odnosi się zwykle do katalogu <filename class="directory"
>~/.kde</filename
> lub podobnego.)</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Gdzie &kalarm; przechowuje swoje kalendarze?</para>
</question>
<answer>

<para
>Nazwy plików kalendarzy tworzonych przy pierwszym uruchomieniu programu &kalarm; są następujące (mogą one być zmienione w sekcji <parameter
>General</parameter
> w pliku konfiguracyjnym programu &kalarm;):</para>

<itemizedlist>
<listitem>
<para
>Plik <filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
> przechowuje aktywne alarmy (może być to zmienione przez parametr <parameter
>Calendar</parameter
>).</para>
</listitem>

<listitem>
<para
>Plik <filename
>$KDEHOME/share/apps/kalarm/expired.ics</filename
> przechowuje zarchiwizowane alarmy  (może być to zmienione przez parametr <parameter
>ExpiredCalendar</parameter
>).</para>
</listitem>

<listitem>
<para
>Plik <filename
>$KDEHOME/share/apps/kalarm/template.ics</filename
> przechowuje szablony alarmów  (może być to zmienione przez parametr <parameter
>TemplateCalendar</parameter
>).</para>
</listitem>
</itemizedlist>

<para
>Użytkownik może sprawdzić jaki plik jest używany dla danego kalendarza, sprawdzając szczegółu kalendarza w liście kalendarzy. Nazwy pliku kalendarza są przechowywane w pliku konfiguracyjnym kalendarza.</para>

<para
>Szczegóły alarmów aktualnie wyświetlanych są przechowywane w pliku kalendarza:<filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>W jakim formacie program przechowuje alarmy?</para>
</question>
<answer>
<para
>Pliki kalendarza używane w programie &kalarm; do przechowywania alarmów, są plikami tekstowymi o formacie zdefiniowanym w dokumencie: <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. Jest to standardowy format używany przez wszystkie programy modułu kdepim. Program &kalarm; wykorzystuje kilka nie standardowych właściwości, w zgodzie ze standardem RFC2445. W elemencie VEVENT, są to:<literal
>X-KDE-KALARM-FLAGS</literal
>, <literal
>X-KDE-KALARM-NEXTRECUR</literal
>, <literal
>X-KDE-KALARM-REPEAT</literal
>, <literal
>X-KDE-KALARM-ARCHIVE</literal
>, <literal
>X-KDE-KALARM-LOG</literal
>, oraz w elemencie VALARM: <literal
>X-KDE-KALARM-TYPE</literal
>, <literal
>X-KDE-KALARM-NEXTREPEAT</literal
>, <literal
>X-KDE-KALARM-FONTCOLOR</literal
>, <literal
>X-KDE-KALARM-VOLUME</literal
>, <literal
>X-KDE-KALARM-SPEAK</literal
>, <literal
>X-KDE-KALARM-EMAILID</literal
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Co robi program <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> jest niewielkim pomocniczym programem, którego zadaniem jest automatyczne uruchomienie &kalarm-dopelniacz; po zalogowaniu.</para>

<para
>Program &kalarm; jest zwykle przywracany do działania po zalogowaniu przez menedżera sesji (wyświetla się układ okien taki sam jaki był przy wylogowaniu). Jeżeli jednak nie był uruchomiony w momencie wylogowania, menedżer sesji nie uruchomi go, więc konieczne jest jest automatyczny start. Jeżeli jednak aplikacja jest jednocześnie zarządzana przez menedżera sesji i automatycznie uruchamiana, to nie ma gwarancji, która z tych sytuacji nastąpi wcześniej. Jeżeli automatyczny start zadziała na początku, to uniemożliwi to menedżerowi sesji przywrócenie stanu aplikacji z momentu wylogowania.</para>

<para
>Aby uniknąć tego problemu, program <application
>kalarmautostart</application
> jest uruchamiany po zalogowaniu zamiast programu &kalarm;. Jego zadaniem jest odczekanie krótkiego czasu (aby menedżer sesji mógł zakończyć swoje działanie) przed uruchomieniem programu &kalarm;, po czym kończy on pracę.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Licencje i zasługi</title>

<para
>&kalarm; </para>
<para
>Prawa autorskie: 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Prawa autorskie dokumentacji 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Krzysztof Woźniak <email
>wozniakk@ceti.pl</email
></para
> 
&underFDL; &underGPL; <para
>Podziękowania należą się autorowi aplikacji KAlarm dla &kde; Stefanowi Nikolausowi <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, który zgodził się na użycie nazwy &kalarm; dla tego programu, który jest dostępny od wersji &kde; 2. </para>

</chapter>

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

<sect1 id="getting-kalarm">
<title
>Jak zdobyć &kalarm;</title>
&install.intro.documentation; <para
>&kalarm; jest dostępne dla &kde; 2 i jako samodzielna aplikacja dla &kde; 3 pod adresem:<ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
> </para>

</sect1>

<sect1 id="requirements">
<title
>Wymagania</title>

<para
>Program &kalarm; wymaga zainstalowania standardowych bibliotek &kde; (pakiety <filename
>kdelibs</filename
>,  <filename
>kdepimlibs</filename
>), oraz pakietu aplikacji  <filename
>kdebase/runtime</filename
>. Kompilacja ze źródeł, wymaga również zainstalowania właściwych pakietów deweloperskich &kde; oraz  &Qt;.</para>

<para
>Następujące opcjonalne aplikacje zwiększają funkcjonalność programu &kalarm; (jeżeli są zainstalowane):</para>

<itemizedlist>
<listitem
><para
><application
>KTTSD</application
> (element pakietu kdeaccessibility): jeżeli jest zainstalowany i skonfigurowany razem z kompatybilnym syntezatorem mowy, pozwala programowi &kalarm; na wypowiadanie wyświetlanych wiadomości alarmu.</para>
</listitem>
</itemizedlist>

<para
>Program &kalarm; wykorzystuje do pracy około 12 MB pamięci, ale ta wartość może się zmieniać w zależności od środowiska i konfiguracji.</para>

<para
>Listę zmian można znaleźć w pliku <filename
>ChangeLog</filename
> lub na stronie <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Kompilacja i instalacja</title>

<para
>Jeżeli użytkownik nie może skorzystać z odpowiedniego pakietu binarnego z programem, powinien samodzielnie skompilować &kalarm; z plików źródłowych. Należy pobrać pliki: <filename
>kdepim-x.x.tar.bz2</filename
> lub <filename
>kalarm-x.x.tar.bz2</filename
> (lub podobne), w zależności czy chce zainstalować cały pakiet kdepim czy tylko &kalarm;. Rozpakować w katalogu roboczym, za pomocą komendy podobnej do:<userinput
><command
>tar</command
> <option
>xvfj <replaceable
>package.tar.bz2</replaceable
></option
></userinput
>, i przejść do tego katalogu.</para>
&install.compile.documentation; <note
><para
>Jeżeli użytkownik ma zainstalowaną więcej niż jedną wersję &kde; (np. &kde; 2 i &kde; 3), to możliwe jest zainstalowanie się programu &kalarm; w niewłaściwym katalogu &kde;. W razie konieczności, można podać katalog &kde; jako parametr polecenia <userinput
><command
>./configure</command
></userinput
> . Przykładowo, jeżeli &kde; jest zainstalowane w<filename
>/opt/kde2</filename
>, można napisać:</para>

<para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para>
</note>

<warning
><para
>Jeżeli &kalarm; zostanie zainstalowany w katalogu innym niż środowisko &kde;, to nie będzie poprawnie działał do czasu, aż w &kde; zostanie poprawnie zdefiniowana jego lokalizacja. Aby to zrobić, należy w zmiennej środowiskowej <envar
>KDEDIRS</envar
> dołączyć ścieżkę do programu&kalarm; za każdym razem przed uruchomieniem &kde;.</para>

<para
>Na przykład, jeżeli &kde; jest zainstalowane w <literal
>/opt/kde</literal
>, to zmienna <envar
>KDEDIRS</envar
> jest zwykle ustawiona na:<literal
>/etc/opt/kde:/opt/kde</literal
>. Jeżeli użytkownik zainstaluje &kalarm; w katalogu <literal
>/usr/local</literal
>, to zmienna <envar
>KDEDIRS</envar
> musi być ustawiona na: <literal
>/usr/local:/etc/opt/kde:/opt/kde</literal
> przed uruchomieniem &kde;.</para
></warning>

<para
>Samodzielna wersja programu &kalarm; posiada specjalną opcję konfiguracyjną pozwalającą na wybór języka dokumentacji do zainstalowania, poprzez określenie kodu języka lub języków przy wywoływaniu polecenia<command
>./configure</command
>. Domyślnie, instalowane są wszystkie języki dokumentacji. Lista języków dokumentacji zawartych w pakiecie, razem z ich kodami, znajduje się w pliku <filename
>DOC-LANGUAGES</filename
>. Na przykłady, aby zainstalować tylko francuską i brytyjską dokumentację należy wpisać:</para>

<para
><userinput
><command
>./configure</command
> --enable-doc-language=<replaceable
>"fr en_GB"</replaceable
></userinput
></para>

<para
>Uwaga: opcja ta nie ma żadnego wpływu, na to jakie tłumaczenia interfejsu zostaną zainstalowane.</para>

</sect1>

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

<para
>Program &kalarm; nie wymaga żadnych specjalnych czynności konfiguracyjnych przed uruchomieniem w środowisku &kde;. Po pierwszych uruchomieniu &kalarm-dopelniacz; program będzie uruchamiał się automatycznie po każdym zalogowaniu, aby monitorować zdefiniowane alarmy.</para>

<para
>Korzystanie z programu &kalarm; w środowisku innym niż &kde; wymaga upewnienia się że &kalarm; jest uruchamiany automatycznie po zalogowaniu. Szczegółowe informacje na ten temat znajdują się w pliku <filename
>INSTALL</filename
> rozpowszechnianym z programem &kalarm;. </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:
-->

