@database "Jabberwocky.guide"
@$VER: Jabberwocky.guide 1.4 (28.10.2003) $Header: /cvsroot/ajabberwocky/jabberwocky/Docs/Jabberwocky_polski.guide,v 1.1 2003/11/26 10:26:49 carrott Exp $

@node "main" "Jabberwocky - podrëcznik uûytkownika"

  Jabberwocky v1.4 - Podrëcznik uûytkownika
  =========================================

  @{"  Wprowadzenie          " link "intro"}
  @{"  Licencja              " link "license"}
  @{"  Wymagania             " link "reqs"}
  @{"  Instalacja            " link "install"}

  @{"  Obsîuga               " link "usage"}
  @{"  Okna                  " link "windows"}
  @{"  Menu                  " link "menus"}
  @{"  Konfiguracja          " link "config"}

  @{"  Polecenia ARexx'a     " link "arexx"}
  @{"  Szczegóîy techniczne  " link "tech"}
  @{"  FAQ                   " link "faq"}

  @{"  Kompilacja            " link "compile"}

  @{"  Historia              " link "history"}
  @{"  Plany na przyszîoôê   " link "future"}
  @{"  Podziëkowania         " link "thanks"}

 Byîo smaszno, a jaszmije smukwijne
   Ôwidroskrëtnie na zegwniku wëûaîy,
 Peliczaple staîy smutcholijne
   I zbîâkinie rykoôwistâkaîy.
            @{i}(tîum. Maciej Sîomczyïski)@{ui}

@endnode

@node "intro" "Wprowadzenie"

@{b}@{u}Wprowadzenie@{ub}@{uu}

Jabberwocky  jest  programem-klientem  przygotowanym  do  pracy   z   systemem
komunikacyjnym  Jabber.  Jabber  jest  zbliûony do ICQ i AIM (system AOL), ale
róûni sië od nich koncepcjâ. Jest on rozwijany przez uûytkowników,  caîkowicie
darmowy,  prosty, szybki, stwarza moûliwoôê rozbudowy dziëki moduîowej budowie
i niezaleûny od platformy.

Jabber jest  systemem  komunikacyjnym  wywodzâcym  sië  ze  spoîecznoôci  osób
zajmujâcych  sië projektami  typu "open source". Jabber jest  ciâgle rozwijany
i od czasu powstania zostaî wzbogacony  o liczne  rozszerzenia.  Jednâ  z cech
wyróûniajâcych  Jabbera  z  grupy  programów  bezpoôredniej  komunikacji (ang.
"instant  messaging")  jest  jego  protokóî  XML.  Pozwala  on  na   poprawnie
skonstruowanâ  i  inteligentnâ   wymianë   wiadomoôci  pomiëdzy  uûytkownikiem
i  oprogramowaniem.    Na  stronie  http://www.jabber.org  znajdziesz   wiëcej
informacji na temat Jabbera.

Systemy bezpoôredniej komunikacji typu Jabbera skîadajâ sië z  dwóch  gîównych
elementów,  zwykle okreôlanych jako  klienty (oprogramowanie dla  uûytkownika)
i wëzîy  (serwery). Programy-klienty  (takie   jak   Jabberwocky)   zapewniajâ
uûytkownikowi  odpowiedni  interfejs  i  poîâczenie  internetowe  niezbëdne do
przesyîania i otrzymywania  wiadomoôci  za  poôrednictwem  wëzîów  (serwerów).
Wëzîy uîatwiajâ wymianë wiadomoôci i informacji miëdzy klientami.

Wiëkszoôê  systemów utrzymuje  komunikacjë   pomiëdzy  klientami   korzystajâc
z jednego wëzîa.  Jabber  jest  rozgaîëzionym  systemem  z wieloma  dostëpnymi
wëzîami. Jako ûe wëzîy owe sâ wzajemnie poîâczone,  uûytkownicy  Jabbera  mogâ
porozumiewaê  sië  ze  sobâ niezaleûnie od tego, z jakiego serwera korzystajâ.
Poszczególni uûytkownicy  rozróûniani sâ  za pomocâ identyfikatora  zbliûonego
w formie do adresu poczty elektronicznej (nazwa_uûytkownika@nazwa_serwera).

Serwery  Jabbera  mogâ  udostëpniaê  dodatkowe  usîugi,   jak   na   przykîad:
wyszukiwanie  uûytkowników,  przeprowadzanie  konferencji  i dostëp do róûnych
informacji. Niektóre z serwerów pozwalajâ  na  wymianë  komunikatów  z  innymi
systemami  (AIM, ICQ, MSN, IRC itp.), tak wiëc Twoje dotychczasowe programy do
internetowych pogawëdek mogâ okazaê sië zbëdne ;). Przeksztaîcaniem protokoîów
innych  systemów  zajmuje sië sam serwer, tak wiëc klient typu Jabberwocky nie
musi  zwracaê uwagi na  róûnice  w  owych  protokoîach  i  moûe  wspóîpracowaê
z innymi systemami  po  prostu îâczâc sië z serwerem Jabbera. Poniewaû nad owâ
funkcjâ  oprogramowania  serwerów   pracuje   wielu   programistów,   wszelkie
zachodzâce w innych systemach zmiany mogâ byê szybko uwzglëdniane w programach
zajmujâcych  sië   konwersjâ   protokoîów.   Oznacza   to,   ûe   maîa   grupa
programistów-amigowców  moûe  tworzyê  klienta  systemu  Jabber, poniewaû caîa
ciëûka  praca  wykonywana  jest  przez  sporâ   grupë   (gîównie   Linuxowych)
programistów.

Wiëcej informacji znaleúê moûna na:

  http://www.jabber.org (strona dla programistów);

  http://www.jabbercentral.com (strona dla uûytkowników).

@endnode

@node "license" "Licencja"

@{b}@{u}Licencja@{ub}@{uu}

Jabberwocky (Klient Jabbera - Systemu Bezpoôredniej Komunikacji)
Copyright (C) 2003 Tom Parker (tom@carrott.org),
                   Matthias Münch (matthias@amigaworld.de)

Ten program jest darmowy; moûesz  go  rozpowszechniaê  i/lub  modyfikiowaê  na
warunkach @{" Powszechnej  Licencji  Publicznej  GNU " link "GNU License"} opublikowanej  przez  Free
Software Foundation w jej wersji drugiej lub dowolnej póúniejszej.

Program ten jest rozpowszechniany w nadziei, iû bëdzie  on  uûyteczny,  jednak
BEZ  JAKIEJKOLWIEK  GWARANCJI,  nawet  bez  domyôlnej  gwarancji  PRZYDATNOÔCI
HANDLOWEJ  lub  PRZYDATNOÔCI  DO  OKREÔLONYCH  ZASTOSOWAÏ.  Wiëcej  informacji
znajdziesz w Powszechnej Licencji Publicznej GNU.

Razem z tym oprogramowaniem powinieneô byî otrzymaê kopië Powszechnej Licencji
Publicznej  GNU.  Jeôli tak sië nie staîo, wyôlij list na adres: Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Wyjâtkowo Tom  Parker  i  Matthias  Münch  pozwalajâ  na  îâczenie  kodu  tego
programu,  gdy jest to niezbëdne dla dziaîania tego oprogramowania, z dowolnym
stosem TCP, jakâkolwiek oficjalnâ bibliotekâ lub klasâ MUI lub autorskâ  klasâ
MUI.  Wyjâtek  ten pozwala równieû na rozpowszechnianie poîâczeï tego programu
ze wspomnianymi wczeôniej klasami  i  bibliotekami.  W  odniesieniu  do  kodów
innych  niû  wspomniane  biblioteki  i  klasy  musisz  przestrzegaê pod kaûdym
wzglëdem  Powszechnej  Licencji  Publicznej  GNU.  Opisywany  wyjâtek  stanowi
równieû,  ûe  musisz przestrzegaê licencji dotyczâcych  wspomnianych bibliotek
i klas; poniûsza licencja nie zmusza Cië do  przestrzegania postanowieï  owych
licencji,  ale  jeôli nie zamierzasz sië do nich stosowaê, nie moûesz doîâczaê
kodów tychûe bibliotek. Modyfikujâc ten plik moûesz rozszerzyê ten wyjâtek  na
potrzeby  Twojej  wersji  pliku, ale nie jesteô do tego zobowiâzany. Jeôli nie
chcesz tego czyniê, usuï ten wyjâtek ze swojej wersji.

@endnode

@node "reqs" "Wymagania"

@{b}@{u}Wymagania@{ub}@{uu}

* AmigaOS 3.x
* MUI 3.8 lub nowszy
* NList.mcc 19.97+ (klasa MUI)
* textinput.mcc (klasa MUI)
* Mailtext.mcc 19.8+ (klasa MUI)
* TextEditor.mcc 15.9+ (klasa MUI)
* stos TCP/IP (Genesis, Miami 2.0+ lub MiamiDx)
* biblioteka OpenURL (wymagana przy przesyîaniu plików)

@endnode

@node "install" "Instalacja"

@{B}@{U}Instalacja:@{UB}@{UU}

Skopiuj katalog z programem Jabberwocky w dowolne miejsce Twojego  dysku.  Aby
Jabberwocky mógî pracowaê, pliki wymienione w czëôci  @{" Wymagania " link "reqs"}  muszâ  byê
równieû zainstalowane. Jeôli chcesz uûywaê  innego  jëzyka  przy  wyôwietlaniu
tekstów  pomocy  w  programie, i jest dokumentacja w formacie AmigaGuide w tym
jëzyku, skasuj plik "Jabberwocky.guide"  z  katalogu  "Docs/"  i  zmieï  nazwë
wybranego pliku z dokumentacjâ na "Jabberwocky.guide".

Jabberwocky zapisuje  swoje pliki konfiguracyjne i  pliki raportów w katalogu,
w   którym   jest   zainstalowany,  tak  wiëc  usuniëcie  tego  katalogu  jest
wystarczajâce do odinstalowania programu.

W przypadku,  gdy  posiadasz  archiwum  Jabberwocky  zawierajâce  dwie  wersje
programu  (dla  AmigaOS  i  MorphOS),  a  zamierzasz korzystaê tylko z jednej,
moûesz usunâê zbëdny plik  (np.  Jabberwocky.morphos),  a  wîaôciwemu  zmieniê
nazwë  na "Jabberwocky". Od wersji 1.4 wersja dla systemu AmigaOS jest od razu
nazwana "Jabberwocky", natomiast  wersja  dla  systemu  MorphOS  jest  nazwana
"Jabberwocky.elf".

@{B}@{I}Jabberwocky - struktura katalogów:@{UB}@{UI}

@{B}Jabberwocky ----------@{UB} Zawiera plik  gîówny  programu  razem  z  plikiem  jego
                       ikonki  (.info).  Po  pierwszym  uûyciu  programu, plik
                       preferencji oraz ustawienia konta  zostanâ  zapisane  w
                       gîównym katalogu.
                         Jabberwocky
                         Jabberwocky.info
                         Jabberwocky.xml (preferencje)
                         Account.xml (identyfikator i hasîo)

@{B}Jabberwocky/Rexx -----@{UB} Zawiera przykîadowe  skrypty  @{" ARexx'a " link "arexx"}  oraz  skrypty
                       wîasne uûytkownika.

@{B}Jabberwocky/Catalogs -@{UB} Zawiera pliki lokalizacyjne  programu  Jabberwocky  dla
                       jëzyków innych niû angielski.

@{B}Jabberwocky/Docs -----@{UB} Zawiera pliki dokumentacji programu Jabberwocky.
                         Jabberwocky.guide
                         Jabberwocky.guide.info

@{B}Jabberwocky/Icons ----@{UB} Zawiera alternatywne ikonki  programu  nadesîane  przez
                       uûytkowników  oraz  ikonki,  które  bëdâ  uûywane przez
                       program podczas ikonifikacji.
                         Jabberwocky_online.info (ikonka poîâczonego)
                         Jabberwpocky_offline.info (ikonka rozîâczonego)

@{B}Jabberwocky/Images ---@{UB} Zawiera  stworzone   przez   uûytkownika   alternatywne
                       @{" obrazki " link "images"}  listy,  które  bëdâ wczytywane przy urucha-
                       mianiu programu Jabberwocky.

@{B}Jabberwocky/Sounds ---@{UB} Zawiera dúwiëki ustawiane w  preferencjach  programu  w
                       zakîadce  Zdarzenia dla róûnych zdarzeï w trakcie pracy
                       programu,  takich  jak  uruchomienie,  czy   skoïczenie
                       pracy.   Szczegóîowe   informacje   na  temat  ustawieï
                       dúwiëków zdarzeï w programie Jabberwocky  znajdziesz  w
                       rozdziale @{" preferencje " link "window-prefs"}.

@endnode

@node "usage" "Obsîuga"

@{b}@{u}Obsîuga Jabberwocky@{uu}

  @{" Przygotowanie         " link "prep"} - Informacje potrzebne do pracy z Jabberwocky.

  @{" Zaczynamy             " link "starting"} - Pierwsze uruchomienie Jabberwocky.

  @{" Dodawanie kontaktów   " link "contacts"} - Dodawanie uûytkowników do wykazu (lista kumpli).

  @{" Wiadomoôci            " link "messages"} - Wysyîanie i otrzymywanie wiadomoôci.

  @{" Rozmowy               " link "chat"} - Rozmowy z innymi uûytkownikami.

  @{" Jabber User Directory " link "directory"} - Wyszukiwanie innych uûytkowników Jabbera.

  @{" Jabber Transports     " link "transports"} - Inne systemy bezpoôredniej komunikacji.

  @{" Konferencje           " link "conference"} - Jednoczesne rozmowy z wieloma osobami.

  @{" Inne usîugi Jabbera   " link "misc_agents"} - Korzystanie z pozostaîych usîug Jabbera.@{ub}

@endnode

@node "prep" "Przygotowanie"

@{b}@{u}Przygotowanie@{ub}@{uu}

Jeôli nie korzystaîeô jeszcze z systemu Jabber, bëdziesz musiaî wybraê  serwer
(wëzeî)   Jabbera  zanim  uruchomisz  Jabberwocky.  Jeûeli  jeszcze  tego  nie
zrobiîeô, moûesz skorzystaê z "Jabber.org" lub "Jabber.com." Listë publicznych
serwerów   Jabbera  znajdziesz  na  stronie  http://www.jabberview.com.  Nazwa
serwera bëdzie czëôciâ Twojego @{" identyfikatora " link "jabberID"}.

Bëdziesz takûe  musiaî okreôliê nazwë  uûytkownika dla  tegoû  identyfikatora.
W przypadku, gdy  wybierzesz juû istniejâcâ na  danym serwerze nazwë, zostanie
ona  odrzucona i  poproszony  zostaniesz o  ponowne podanie  nazwy (oczywiôcie
innej). Oczywiste jest, ûe  wiele  popularnych nazw bëdzie juû  zajëtych, wiëc
spróbuj wybraê doôê oryginalnâ.

Nazwa uûytkownika moûe skîadaê  sië  z  maksymalnie  255  znaków  i  nie  moûe
zawieraê   spacji,  tabulacji,  znaków  koïca  linii  i  znaków  nowej  linii.
Zabronione sâ równieû znaki : \@ / " '. Nie  sâ dozwolone takûe  wszelkie znaki
o kodzie ASCII  mniejszym  od  33 (dziesiëtnie)  oraz  kody  sterujâce. System
bezpoôredniej komunikacji  Jabber umoûliwia korzystanie ze  znaków  narodowych
w identyfikatorach, jednakûe  funkcja ta nie jest przetestowana. Moûesz uûywaê
znaków spoza zestawu US-ASCII, ale rezultaty mogâ róûniê sië spodziewanych.

@endnode

@node "starting" "Zaczynamy"

@{b}@{u}Zaczynamy:@{ub}@{uu}

Uruchom Jabberwocky  dwukrotnie  klikajâc  na  jego  ikonce.  Po  uruchomieniu
programu jest dostëpna pomoc kontekstowa, która jest aktywowana po naciôniëciu
klawisza "help".

Przy pierwszym  uruchomieniu  programu  pojawi  sië  @{" okno  konta " link "window-login"}.  Wprowadú
w odpowiednie pola @{" identyfikator " link "jabberID"} (nazwa_uûytkownika@nazwa_serwera) i hasîo.
Jeôli nie chcesz za kaûdym razem wpisywaê tych  danych,  kliknij  na  gadûecie
"Zapamiëtaj  hasîo".  Teraz  kliknij  na gadûecie rejestracji i zwróê uwagë na
@{" gîówne okno " link "window-main"}, gdy juû sië ono pojawi. Pod  ramkâ  okna  powinieneô  zobaczyê
informacjë  o  stanie  pracy  programu.  Bëdzie  tam   znajdowaî   sië   napis
"Îâczenie...", aû  poîâczenie  zostanie nawiâzane. Wtedy  pojawi sië komunikat
"Rejestrowanie...", ôwiadczâcy o rejestrowaniu Twojego  konta  Jabbera.  Napis
"Poîâczony"  oznacza,  ûe  moûesz  przystâpiê  do  pracy  z  programem.  Jeôli
komunikat  "Poîâczony"  nie  pojawi   sië,   przeczytaj   rozdziaî   dotyczâcy
@{" komunikatów stanu " link "status"}. Informacja  "Rejestracja  nie  powiodîa  sië!"   oznacza
prawdopodobnie,  ûe  wybrana przez  Ciebie nazwa  uûytkownika juû  jest zajëta
i musisz spróbowaê  jeszcze  raz wybierajâc innâ nazwë. W przypadku pierwszego
îâczenia sië z serwerem moûesz takûe otrzymaê komunikat powitalny. Gdy podczas
rejestracji  pojawi  sië w  gîównym  oknie  nowa pozycja, po prostu kliknij na
niej, przeczytaj powitanie i zamknij okno.

Gdy juû masz zaîoûone konto Jabbera, od razu po  uruchomieniu  Jabberwocky'ego
pojawi  sië  jego  okno  gîówne. Kliknij na gadûecie Poîâcz i poczekaj, aû pod
ramkâ okna ukaûe sië komunikat "Poîâczony". Teraz moûesz juû dodawaê  kontakty
i wysyîaê wiadomoôci.

@endnode

@node "contacts" "Dodawanie kontaktów"

@{b}@{u}Dodawanie kontaktów@{ub}@{uu}

Serwer Jabbera przechowuje wykaz kontaktów, który okreôlany jest jako @{" lista " link "roster"}
(ang.  roster)  i  wczytywana  przez  Jabberwocky'ego   podczas   nawiâzywania
poîâczenia. Pozycje na liôcie wyôwietlane sâ w @{" gîównym oknie " link "window-main"} Jabberwocky'ego
i mogâ byê reprezentowane przez identyfikator lub imië,  jeôli  wpisaîeô  imië
podczas  dodawania kontaktu. Kontakty dodawaê moûna po wybraniu z menu pozycji
"Lista/Dodaj kontakt". Pojawi  sië  wtedy  @{" okno dodawania kontaktów " link "window-contact"},  które
umoûliwia wpisanie informacji niezbëdnych do dodania kontaku do listy Jabbera.
Okno to  skîada sië z trzech pól tekstowych nazwanych  "Identyfikator", "Imië"
i "Pozdrowienie". Tylko pole @{" Identyfikator " link "jabberID"} @{u}musi@{uu} byê  wypeînione, aby  dodaê
kontakt do listy. Dwie pozostaîe pozycje sâ opcjonalne, ale przydatne.

Typowy  kontakt  Jabbera   ma   identyfikator   postaci   "maurycy@jabber.org"
(nazwa_uûytkownika@nazwa_serwera).   Dodawanie   kontaktu   z   wykorzystaniem
@{" usîugi " link "agents"}  serwera  wymaga  trochë odmiennego identyfikatora (id@nazwa_usîugi)
i jest moûliwe dopiero po @{" rejestracji " link "register"} odpowiedniej usîugi i  dodaniu jej do
Twojej listy Jabbera. Dla przykîadu, kontakt  ICQ  bëdzie  miaî  identyfikator
typu 1234567@icq.jabber.org (numer_ICQ@nazwa_usîugi_icq).

Jeôli nie wypeînisz pola "Imië" w oknie dodawania kontaktów, wtedy kontakt ten
na  liôcie  bëdzie  reprezentowany  przez identyfikator zamiast przez wîaôciwe
imië  osoby. Gdy  wypeînisz pole "Pozdrowienie",  to  jego  treôê  pojawi  sië
w  proôbie  o  @{" dopisanie " link "subscription"} u  osoby jâ  odbierajâcej.  Klikajâc  na  gadûecie
"Dopisz"  spodowujesz  pojawienie  sië nowej pozycji  w oknie  gîównym,  a  do
dodawanej osoby  zostanie  wysîana  proôba  o  dopisanie.  Jeôli nowy  kontakt
zaakceptuje  Twojâ  proôbë,  przy  liôcie  pojawi  sië   ikonka  @{" obecnoôci " link "presence"}.
Informuje  ona  o  tym,  czy  dana osoba  jest  dostëpna i   moûe   otrzymywaê
wiadomoôci. Natomiast jeôli kontakt odrzuci Twojâ  proôbë, to na liôcie bëdzie
widoczne  jedynie  imië  (ew. identyfikator)  tej osoby. Przewaûnie uûytkownik
akceptuje tego  typu  proôbë, wysyîajâc  analogicznâ  do Ciebie. Gdy bëdzie to
miaîo miejsce, otworzy sië @{" okno proôby o dopisanie " link "window-subscriptions"}, gdzie bëdziesz mógî owo
dopisanie zaakceptowaê lub odrzuciê korzystajâc z gadûetów na dole  tego okna.
Zaakceptowanie   umoûliwi nowemu  kontaktowi  bycie  poinformowanym  o  Twojej
obecnoôci w systemie.

@endnode

@node "messages" "Wiadomoôci"

@{b}@{u}Wiadomoôci@{ub}@{uu}

Otrzymywanie i wysyîanie wiadomoôci przy uûyciu Jabberwocky'ego  jest  proste.
Gdy  otrzymasz  wiadomoôê  od osoby z Twojej listy, ikonka obecnoôci tej osoby
zmieni sië w ikonkë wiadomoôci.  Gdy  nadawca  nie  znajduje  sië  na  liôcie,
utworzona zostanie tymczasowa pozycja, równieû oznaczona ikonkâ wiadomoôci (na
poczâtku pozycji). Aby otworzyê @{" okno czytania wiadomoôci " link "window-readmsg"} kliknij dwukrotnie
na pozycji z ikonkâ  lub wybierz z menu "Lista" opcjë  "Przeczytaj wiadomoôê".
W oknie wiadomoôci  podawane  sâ: adres  nadawcy, temat oraz treôê wiadomoôci.
Jeôli w czasie czytania wiadomoôci  pojawiâ  sië  nowe,  kliknij  na  gadûecie
"Nastëpna",  aby  je  przeczytaê. "Poprzednia" pozwala na powrót do wiadomoôci
otrzymanej wczeôniej.  Na  wiadomoôê  moûesz  odpowiedzieê  wybierajâc  gadûet
"Napisz" lub  "Odpowiedz".  "Odpowiedz"  otwiera  @{" okno  pisania  wiadomoôci " link "window-writemsg"}
z otrzymanym tekstem na poczâtku  pola  edycji.  Oba  gadûety  otwierajâ  okno
pisania  wiadomoôci  z  wypeînionymi polami adresu i tematu. W obu przypadkach
wystarczy wpisaê wîasny tekst w pole edycji i kliknâê na gadûecie "Wyôlij".

UWAGA: Gdy otwarte jest okno czytania wiadomoôci, ikonka nowej wiadomoôci  NIE
       pojawi sië na liôcie po otrzymaniu wiadomoôci. Jest to bîâd w programie
       i   zostanie   poprawiony  w  nastëpnej   wersji.  W  razie   problemów
       z odbieraniem wiadomoôci poszukaj okna czytania  schowanego  pod innymi
       oknami.

Istniejâ dwa sposoby wysyîania nowej wiadomoôci. Jeôli osoba, do której chcesz
napisaê  znajduje  sië  na  Twojej  liôcie, kliknij dwukrotnie na odpowiedniej
pozycji. Otwarte zostanie wtedy @{" okno pisania wiadomoôci " link "window-writemsg"}  z  identyfikatorem
osoby juû wpisanym w polu "Do". W innym przypadku wybierz z menu "Lista/Napisz
wiadomoôê" i w polu "Do" nowo otwartego okna pisania. Wypeînienie pola "Temat"
nie jest konieczne, ale uîatwia  rozeznanie  sië  w  wykazie  wiadomoôci,  gdy
prowadzisz  korespondencjë  z  wieloma  osobami.  W  pole  edycji  wpisz treôê
wiadomoôci i kliknij na gadûecie "Wyôlij".

Jeôli odbiorca nie jest dostëpny (nie jest poîâczony), Twoja wiadomoôê  bëdzie
przechowywana  na  serwerze Jabbera do czasu, gdy dana osoba sië poîâczy. Czas
przechowywania wiadomoôci  jest  róûny  dla  róûnych  serwerów,  nie  ma  wiëc
gwarancji, ûe informacja dotrze do uûytkownika, który w momencie jej wysyîania
nie jest poîâczony.

@endnode

@node "chat" "Rozmowy"

@{b}@{u}Rozmowy@{ub}@{uu}

Wiadomoôci  Jabbera  sâ  dobrym  sposobem  nawiâzywania  kontaktów  z   innymi
uûytkownikami,   ale   "pogawëdki"   sâ   znacznie   wygodniejsze  i  bardziej
bezpoôrednie. Kliknij na wybranej  pozycji  (kontakcie)  na  Twojej  @{" liôcie " link "roster"}
i wybierz "Lista/Rozmawiaj" z menu aby otworzyê  @{" okno rozmowy " link "window-chat"}  i  rozpoczâê
konwersacjë z danâ osobâ.  Gdy wpiszesz tekst do pola tekstowego  na dole okna
i naciôniesz klawisz  <Return>, linia  tekstu  wysyîana  jest  do  uûytkownika
wyôwietlonego na górze okna. Okno rozmowy otworzy sië automatycznie, gdy  ktoô
przeôle  Ci  wypowiedú.  Bëdziesz  mógî  jâ  wtedy przeczytaê i od razu na niâ
odpowiedzieê.

Lista w oknie rozmowy wyôwietla teksty obu rozmawiajâcych  stron  i  umoûliwia
powrót  do poprzednich tekstów dziëki suwakowi. Gadûet "Wyczyôê" na górze okna
pozwala na usuniëcie  z  listy  poprzednich  wiadomoôci.  Moûesz  jednoczeônie
prowadziê wiele rozmów - wystarczy w tym celu wybraê z listy kontaktów kolejnâ
osobë i otworzyê nowe okno rozmowy. Kaûde z takich  okien  bëdzie  wyôwietlaîo
tylko   przebieg  rozmowy  z  uûytkownikiem  wymienionym  na  górze  okna.  Po
skoïczeniu rozmowy po prostu zamknij dane okno.

@endnode

@node "directory" "Jabber User Directory"

@{u}@{b}Jabber User Directory@{ub}@{uu}

Usîuga Jabber User Directory (JUD) jest katalogiem uûytkowników umoûliwiajâcym
przechowywanie   i  wyszukiwanie  informacji  o  osobach.  Moûesz  wykorzystaê
@{" usîugë " link "agents"} JUD w  celu  znalezienia  osoby,  z  którâ  chcesz  sië skontaktowaê.
Jednakûe  uûytkownik  moûe  zostaê  odszukany  tylko  wtedy,   gdy   wczeôniej
zarejestrowaî  sië w JUD-zie. Wiëkszoôê serwerów Jabbera udostëpnia usîugë JUD
w odniesieniu do uûytkowników danego wëzîa, niektóre serwery posiadajâ  jednak
moûliwoôê przeszukiwania wielu serwerów Jabbera.

Z opisywanej  usîugi  moûesz  skorzystaê  poprzez  @{" okno listy usîug " link "window-agents"},  które
wywoîywane jest po wybraniu pozycji "Lista usîug" z menu "Okna". Nazwa  usîugi
róûni  sië  w  zaleûnoôci  od  serwera,  ale  wiëkszoôê  z  tych  nazw zawiera
sformuîowanie "User Directory". Klikajâc na usîudze  w  liôcie  bëdziesz  miaî
moûliwoôê zarejestrowania sië w katalogu uûytkowników (gadûet "Rejestruj") lub
przeszukania tegoû katalogu w celu znalezienia innej osoby (gadûet  "Szukaj").
Niezaleûnie  od wybranej opcji zostanie otworzone okno, w którym bëdziesz mógî
wpisaê informacje typu: imië, adres poczty elektronicznej i pseudonim.

W przypadku rejestrowania wpisz swoje dane i kliknij na  gadûecie  "Rejestruj"
lub,   jeôli   chcesz   anulowaê  operacjë,  "Poniechaj".  Po  wybraniu  opcji
"Rejestruj" wpisane informacje  zostanâ  przesîane  do  serwera,  co  umoûliwi
odnalezienie Cië innym uûytkownikom korzystajâcym z JUD-a.

W przypadku szukania wpisz ûâdane informacje i kliknij  na  gadûecie  "Szukaj"
lub,  jeôli chcesz przerwaê poszukiwania i zamknâê okno, "Poniechaj". Wybranie
"Szukaj"  spowoduje  przesîanie  danych  do  serwera  i  JUD   wyszuka   wôród
zarejestrowanych  uûytkowników  wszystkich  tych,  którzy  speîniajâ okreôlone
przez Ciebie kryteria. Dane zostanâ wyôwietlone  w  @{" oknie wyników szukania " link "window-searchresult"}.
Bëdziesz miaî teû wtedy moûliwoôê dodania tych osób do Twojej @{" listy " link "roster"}.

@endnode

@node "transports" "Jabber Transports"

@{u}@{b}Jabber Transports:@{uu}@{ub}

Uûytkownicy Jabbera mogâ  komunikowaê  sië  z  uûytkownikami  innych  systemów
bezpoôredniego kontaktu dziëki specjalnej @{" usîudze " link "agents"} Jabbera  okreôlanej  jako
"Transports". Speînia ona rolë bramy do innych  systemów  tîumaczâc  protokoîy
XML  Jabbera  na  protokoîy  uûywane  przez te systemy. Aktualnie moûliwa jest
wspóîpraca z nastëpujâcymi systemami bezpoôredniego kontaktu: AIM,  ICQ,  MSN,
IRC  i Yahoo! Poniewaû inne systemy korzystajâ z wîasnych sposobów podîâczania
oraz haseî, przed korzystaniem z tej usîugi naleûy zarejestrowaê sië na innych
systemach.  Dla przykîadu, aby uûyê usîugi "transport" dla ICQ trzeba mieê ICQ
UIN (numer identyfikacyjny) i hasîo. Na szczëôcie wiëkszoôê systemów umoûliwia
rejestracjë poprzez wîasne strony internetowe (AOL.com ICQ.com Yahoo!.com)

Przed skorzystaniem z tej usîugi musisz sië zarejestrowaê. Dokonaê tego moûesz
w @{" oknie listy usîug " link "window-agents"} wywoîywanym opcjâ "Lista usîug" z menu "Okna".  Wybierz
usîugë dotyczâcej systemu, który chcesz @{" zarejestrowaê " link "register"} i kliknij na gadûecie
"Rejestruj" na dole okna. Jeôli usîuga jest dostëpna,  pojawi  sië  nowe  okno
wraz  z  instrukcjami  dotyczâcymi  wypeînianych  pól. Wpisz odpowiednie  dane
i kliknij na gadûecie "Rejestruj".

Wymagania poszczególnych systemów:

ICQ - Niezbëdne jest posiadanie UIN (User ID number, czyli numeru uûytkownika)
      i  hasîa.  Po  zarejestrowaniu  moûesz juû dodawaê kontakty ICQ wpisujâc
      @{" identyfikator  Jabbera "  link  "jabberID"} w @{" oknie dodawania kontaktów " link "window-contact"}. Musi  on  mieê
      nastëpujâcy format: UIN@nazwa_usîugi, gdzie "nazwa  usîugi"  jest  nazwâ
      usîugi   "transport"  dla  ICQ  wraz  z  dodanâ  nazwâ  serwera  Jabbera
      (icq.nazwa_serwera). Dla przykîadu, identyfikator Jabbera dla dodawanego
      kontaktu    ICQ    na   serwerze   jabber.org   wyglâdaê   bëdzie   tak:
      "12345678@icq.jabber.org".

AIM - Niezbëdne jest posiadanie AOL ScreenName'a i hasîa.  Po  zarejestrowaniu
      moûesz  juû  dodawaê kontakty AIM wpisujâc identyfikator Jabbera w oknie
      dodawania    kontaktów.    Musi    on    mieê    nastëpujâcy     format:
      ScreenName@nazwa_usîugi,   gdzie   "nazwa   usîugi"  jest  nazwâ  usîugi
      "transport"   dla   AIM   wraz   z   dodanâ   nazwâ   serwera    Jabbera
      (aim.nazwa_serwera). Dla przykîadu, identyfikator Jabbera dla dodawanego
      kontaktu   AIM   na   serwerze   jabber.org   wyglâdaê    bëdzie    tak:
      "maurycy@icq.jabber.org".

Yahoo-Niezbëdne  jest  posiadanie  identyfikatora  (Yahoo!  ID)  i  hasîa.  Po
      zarejestrowaniu   sië moûesz   juû   dodawaê   kontakty  Yahoo  wpisujâc
      @{" identyfikator  Jabbera "  link  "jabberID"} w @{" oknie dodawania kontaktów " link "window-contact"}. Musi  on  mieê
      nastëpujâcy format: Yahoo_ID@nazwa_usîugi,  gdzie  "nazwa  usîugi"  jest
      nazwâ  usîugi  "transport" dla Yahoo wraz z dodanâ nazwâ serwera Jabbera
      (yahoo.nazwa_serwera).  Dla   przykîadu,   identyfikator   Jabbera   dla
      dodawanego  kontaktu  Yahoo  na serwerze jabber.org wyglâdaê bëdzie tak:
      "maurycy@yahoo.jabber.org".

MSN - Niezbëdne jest posiadanie konta MSN  i  hasîa.  Po  zarejestrowaniu  sië
       moûesz  juû dodawaê kontakty MSN wpisujâc identyfikator Jabbera w oknie
      dodawania    kontaktów.    Musi    on    mieê    nastëpujâcy     format:

      konto@nazwa_usîugi,  gdzie  "nazwa usîugi" jest nazwâ usîugi "transport"
      dla MSN wraz z dodanâ nazwâ serwera Jabbera (msn.nazwa_serwera). Jako ûe
      nazwa konta MSN zawiera w sobie znak "@" (nazwa@passport.com), niezbëdne
      jest "ominiëcie" tegoû znaku poprzez zastâpienie  go  znakiem  "%",  aby
      identyfikator  miaî  poprawnâ  postaê.  I  tak identyfikator Jabbera dla
      dodawanego kontaktu MSN na serwerze jabber.org wyglâdaê bëdzie np.  tak:
      "maurycy%passport.com@msn.jabber.org".

@endnode

@node "conference" "Konferencje"

@{b}@{u}Konferencje@{ub}@{uu}

Wiëkszoôê serwerów Jabbera udostëpnia przynajmniej jednâ @{" usîugë " link "agents"} konferencyj-
nâ. Usîuga taka umoûliwia równoczesnâ rozmowë wielu uûytkowników w  ôrodowisku
"grupowej  pogawëdki"  zbliûonej  do  IRC-a.  Kaûdy  z uczestników konferencji
otrzymuje  wszystkie wysyîane  komunikaty, które  rozróûniane sâ pseudonimami,
a nie  identyfikatorami Jabbera.  Wiëkszoôê programów korzysta  ze specjalnego
okna konferencyjnego,  w  którym wyôwietla  pseudonim obok kaûdej  przesyîanej
wiadomoôci  (co  pozwala  na  identyfikacjë  nadawcy)  oraz  listë uczestników
konferencji.

Rejestrowanie usîugi konferencyjnej nie jest  konieczne.  Jest  to  wykonywane
automatycznie  przez  odwoîywanie  sië  do  @{" identyfikatora  usîugi " link "jabberID"}  podczas
doîâczania sië  do konferencji. Niektóre z konferencji sâ prywatne i moûna  do
nich doîâczyê tylko po otrzymaniu zaproszenia,  podczas  gdy  inne, publiczne,
dostëpne sâ dla wszystkich. Usîuga konferencyjna umoûliwia  prowadzenie  wielu
niezaleûnych   konferencji,   czësto   okreôlanych  jako  "grupy"  bâdú  "sale
(konferencyjne)". Na kaûdym serwerze Jabbera znajdujâ sië zwykle  pewne  staîe
grupy  o  okreôlonej  tematyce.  Dla  przykîadu  na  Jabber.org  znaleúê moûna
konferencje poôwiëcone róûnym programom -  klientom  Jabbera.  Wiëkszoôê  grup
jest  jednak  czasowa, co oznacza, ûe sâ one zamykane po opuszczeniu ich przez
ostatniego uûytkownika. Grupa powstaje natomiast wtedy, gdy  ktoô  doîâcza  do
konferencji, która jeszcze nie istnieje.

Zanim  bëdziesz  mógî  skorzystaê  z  usîugi   konferencyjnej,   musisz   znaê
@{" identyfikator   Jabbera " link "jabberID"}   danej    usîugi.   Jabberwocky   nie    wyôwietla
identyfikatorów  usîug w @{" oknie listy usîug " link "window-agents"}, wiëc moûesz np.  spytaê o niego
innego uûytkownika. Identyfikator dla  grupy  ma  format:  grupa@nazwa_usîugi,
gdzie "nazwa_usîugi" jest nazwâ  usîugi konferencyjnej z dodanâ nazwâ  serwera
Jabbera (grupa@konferencja.nazwa_serwera np. uûytkownicy@conf.jabber.org).

W konferencji moûesz uczestniczyê po wybraniu  z  menu  "Okna"  pozycji  "Nowa
konferencja" i wyôwietleniu @{" okna konferencji Jabbera " link "window-conference"}.  Jabberwocky  automa-
tycznie utworzy dla Ciebie pseudonim, którym bëdzie czëôê  "nazwa_uûytkownika"
Twojego  identyfikatora  i wyôwietli go po lewej stronie gadûetu tekstowego na
dole okna. Wpisz  w  nim  polecenie  "/join"  dodajâc  do  niej  identyfikator
konferencji,  a  doîâczysz  do  konferencji lub rozpoczniesz nowâ. Na przykîad
wpisanie "/join jwocky@conference.jabber.org" spowoduje zaîoûenie nowej  grupy
o nazwie "jwocky". Inny uûytkownicy bëdâ teraz mogli przyîâczaê sië do Ciebie,
co umoûliwi prowadzenie rozmów.

Teksty wpisywane w pole po prawej stronie Twojego pseudonimu bëdâ rozesîane do
wszystkich  uczestników  konferencji. Wiadomoôci wysyîane przez innych pojawiâ
sië, poprzedzone pseudonimem nadawcy, w  polu  po  lewej  stronie.  Po  prawej
natomiast  znajdowaê  sië  bëdzie  lista  uczestników konferencji. Wypeînienie
górnego pola  (Temat) spowoduje zmianë  "Tematu" u  wszystkich  rozmawiajâcych
w danej  grupie.  Opuszczenie  sali konferencyjnej  moûliwe  jest  po wpisaniu
polecenia "/part" w polu na dole.

@endnode

@node "misc_agents" "Inne usîugi Jabbera"

@{b}@{u}Inne usîugi Jabbera@{ub}@{uu}

SMS - @{" Usîuga " link "agents"} SMS udostëpnia interfejs systemu krótkich wiadomoôci tekstowych
      (SMS-ów), znanych z telefonów  komórkowych  i  pagerów.  Obecnie  jedyna
      znana  nam  usîuga  SMS  (bëdâca czëôciâ usîugi "transport" ICQv7-t) nie
      wymaga oddzielnego rejestrowania. Jeôli zarejestrowaîeô juû usîugë  ICQ,
      moûesz  dodawaê  SMS-owe kontakty do swojej listy, o ile oczywiôcie Twój
      serwer Jabbera udostëpnia usîugë SMS. Wiadomoôê  do  kontaktu  SMS-owego
      wysyîana  bëdzie  ze  specjalnego  numeru telefonu; z tego samego numeru
      bëdziesz otrzymywaî odpowiedzi.

      Usîuga  SMS  nie  zawsze  dziaîa  poprawnie,   czasami   znikajâ   Twoje
      wiadomoôci,  czasami  odpowiedzi.  Nie jest to wina Jabberwocky'ego, ale
      usîugi ICQ SMS bâdú operatorów  sieci  komórkowych.  ICQv7-t  udostëpnia
      oficjalnâ  usîugë  SMS  serwerów  ICQ.  Usîuga  ta  powinna  dziaîaê jak
      analogiczna w programach - klientach ICQ.

      Do wiadomoôci wysyîanych na komórkë nie  sâ  dodawane  ûadne  sygnatury,
      wiëc  odbiorca nie bëdzie miaî pojëcia od kogo dostaî przesyîkë. Dlatego
      powinieneô  pamiëtaê  o   podpisaniu   sië.   Dîugie   wiadomoôci   mogâ
      byê podzielone na czëôci i wysîane w kawaîkach, obciëte (bez ostrzeûenia
      zarówno Ciebie, jak i odbiorcy) lub zagubione.

      Kontakty SMS-owe mogâ byê dodawane w @{" oknie dodawania kontaktów " link "window-contact"}  przez
      podanie @{" identyfikatora Jabbera " link "jabberID"} o postaci  numer_komórki@nazwa_usîugi.
      "Numer_komórki" ma formë (kierunkowy_kraju)(kierunkowy_rejonu)(...),  na
      przykîad  dla  "+7  910  XXX  XX XX" "numer_komórki" to 7910XXXXXXX (bez
      znaku "+"). "Nazwa_usîugi"  to  nazwa  usîugi  "transport"  obsîugujâcej
      SMS-y z dodanâ nazwâ serwera Jabbera (sms.nazwa_serwera). Dla przykîadu,
      identyfikator Jabbera dodawanego kontaktu  SMS  na  serwerze  jabber.org
      bëdzie miaî postaê "79103456789@sms.jabber.org".

RSS - RDF (Resource Description Framework)  Site  Summary  lub  Really  Simple
      Syndication.

SMTP- Usîuga SMPT przekazuje listy elektroniczne do uûytkowników Jabbera.

@endnode

@node "windows" "Okna"

@{b}@{u}Okna Jabberwocky'ego@{ub}@{uu}

Jabberwocky komunikuje sië z uûytkownikiem poprzez  standardowe  okna  systemu
Amigi,  posiadajâce  gadûety  zamkniëcia,  przesuniëcia  i  zmiany  wielkoôci.
Wybranie  pozycji  "Schowaj"  z  menu  "Jabberwocky"  spowoduje   ikonifikacjë
wszystkich otwartych okien.

  @{" Okno gîówne              " link "window-main"}

  @{" Okno konta               " link "window-login"}

  @{" Okno dodawania kontaktów " link "window-contact"}

  @{" Okno proôby o dopisanie  " link "window-subscriptions"}

  @{" Okno czytania wiadomoôci " link "window-readmsg"}

  @{" Okno pisania wiadomoôci  " link "window-writemsg"}

  @{" Okno rozmowy             " link "window-chat"}

  @{" Okno konferencji Jabbera " link "window-conference"}

  @{" Okno informacyjne        " link "window-info"}

  @{" Okno preferencji         " link "window-prefs"}

  @{" Okno wysyîania plików    " link "window-sendfile"}

  @{" Okno przesyîania plików  " link "window-filetrans"}

  @{" Okno konsoli             " link "window-console"}

  @{" Okno listy usîug         " link "window-agents"}

  @{" Okno szukania            " link "window-search"}

  @{" Okno wyników szukania    " link "window-searchresult"}

  @{" Okno rejestracji         " link "window-register"}

@endnode

@node "window-main" "Okno gîówne"
@toc "windows"

@{b}@{u}Okno gîówne@{ub}@{uu}

Jeôli  dokonaîeô  juû  rejestracji  konta,  to  po   kaûdorazowym   dwukrotnym
klikniëciu  na  ikonkë Jabberwocky ukaûe Ci sië gîówne okno programu. Jest ono
gîównym  elementem  interfejsu  i  tu   zaczynajâ   sië   wszelkie   dziaîania
uûytkownika.

Okno gîówne otwiera sië zawsze  z  aktywnâ  zakîadkâ  "Lista",  gdzie  znaleúê
moûesz wszystkie Twoje  kontakty  Jabbera  okreôlane  wîaônie  jako  @{" lista " link "roster"}.
Informacje  dotyczâce  dostëpnoôci  (@{" obecnoôci " link "presence"})  kaûdej  z  osób  z   listy
przedstawione sâ w postaci ikonek po lewej stronie kaûdego z kontaktów. Ikonka
@{" obecnoôci " link "subscription"}  zastâpiona jest ikonkâ wiadomoôci, gdy  otrzymasz  wiadomoôê  od
danej  osoby.  Styl  napisu  danej  pozycji  (@{B}wytîuszczony@{ub},  @{I}kursywa@{ui},  zwykîy)
wskazuje na status dotyczâcy dopisania kaûdego z kontaktów. Gadûet przewijania
po  prawej  stronie  okna umoûliwia obejrzenie caîej listy, gdy nie mieôci sië
ona w oknie.

Zakîadka "Obecnoôê" zawiera dwa gadûety wykorzystywane do  ustawiania  statusu
Twojej dostëpnoôci (@{" obecnoôci " link "presence"}). Gadûet cykliczny pozwala na wybranie jednej
z piëciu nastëpujâcych opcji:
  * - Poîâczony
  * - Dostëpny
  * - Chwilowo nieobecny
  * - Nieobecny na dîuûej
  * - Nie przeszkadzaê

Pole "Uwagi" sîuûy  do  dodawania  dodatkowej  wiadomoôci  do  statusu  Twojej
dostëpnoôci.  Gdy  zmienisz  tenûe  status,  Jabberwocky  wyôle  go do serwera
Jabbera wraz z treôciâ wpisanâ w pole "Uwagi". Informacje te przesyîane sâ  do
wszystkich osób z Twojej listy.

UWAGA: Szczegóîowe dane odnoszâce sië do dostëpnoôci  i  wiadomoôci  dotyczâce
       statusu moûna uzyskaê klikajâc na pozycji z listy  i  wybierajâc  opcjë
       "Informacje" z menu "Lista".

Okno gîówne zawiera 7 podstawowych gadûetów, wymienionych poniûej.

Status ------------- wyôwietla dane dotyczâce poîâczenia i bîëdów.
Lista -------------- wyôwietla Twojâ listë Jabbera wraz z informacjami o  dos-
                     tëpnoôci, dopisaniu i ewentualnych wiadomoôciach.
Obecnoôê ----------- umoûliwia kontrolë informacji o obecnoôci  wysyîanych  do
                     Twoich kontaktów.
  Obecnoôê (cykl.) - klikajâc zmieniasz swój status.
  Obecnoôê (uwagi) - moûesz wpisaê tu dodatkowâ  informacjë  dotyczâcâ  Twojej
                     dostëpnoôci.
Poîâcz ------------- pozwala na poîâczenie z serwerem, gdy  masz  juû  na  nim
                     zarejestrowane konto.
Rozîâcz ------------ rozîâczenie z serwerem.

* Zakîadki "Lista" i "Obecnoôê" posiadajâ gadûety przewijania  pozwalajâce  na
  wyôwietlenie tekstu, który nie mieôci sië w oknie.

@endnode

@node "window-login" "Okno konta"
@toc "windows"

@{b}@{u}Okno konta@{ub}@{uu}

Okno konta jest  pierwszym  elementem  programu,  który  pokaûe  Ci  sië  przy
pierwszym  uruchomieniu  Jabberwocky'ego.  Zanim  bëdziesz  mógî poîâczyê  sië
i korzystaê z Jabberwocky'ego, musisz udostëpniê dane niezbëdne  do poîâczenia
sië  z  serwerem  (wëzîem)  Jabbera  i  identyfikacji  Twojej osoby w systemie
bezpoôredniej komunikacji. Konto musi zostaê zaîoûone na wybranym przez Ciebie
serwerze,  a  proces  ten  okreôlany jest mianem "rejestracji". Po dopeînieniu
tych formalnoôci, uruchamiajâc Jabberwocky'ego bëdziesz od razu przechodziî do
okna  gîównego.  Okno  konta  dostëpne  jest  po wybraniu opcji "Konto" z menu
"Jabberwocky".

Okno konta zawiera dwa gadûety tekstowe, w których  naleûy  wpisaê  informacje
niezbëdne  do  rejestracji  konta  i  poîâczenia  z  serwerem  Jabbera. Gadûet
"Pamiëtaj hasîo" pozwala na zapamiëtanie danych konta,  tak  ûe  nie  bëdziesz
musiaî wprowadzaê tych danych przy kaûdym uruchamianiu programu.

Okno konta posiada 6 opisanych niûej gadûetów.

Twój identyfikator - wpisz @{" identyfikator " link "jabberID"} w  postaci  uûytkownik@serwer  lub
                     uûytkownik@serwer/reprezentacja.
Twoje hasîo -------- wpisz tu hasîo zîoûone z minimum szeôciu znaków.
Pamiëtaj hasîo ----- zapamiëtanie danych konta.
Poîâcz ------------- poîâczenie z serwerem, na którym masz juû konto.
Rejestruj ---------- pozwala na rejestracjë nowego konta na serwerze.
Poniechaj ---------- anuluje operacjë i zamyka okno.

Identyfikatory Jabbera skîadajâ sië z trzech czëôci:

uûytkownik@serwer/reprezentacja

uûytkownik:    nazwa twojego konta na serwerze;
serwer:        nazwa     serwera;     listë     serwerów     znajdziesz     na
               http://jabberview.com;
reprezentacja: opcjonalny ciâg pozwalajâcy okreôliê dane  poîâczenie;  gdy  go
               nie podasz,  zostanie  uûyty  standardowy  ciâg  "Jabberwocky";
               opcja ta  pozwala na kilka róûnych poîâczeï z  tym samym kontem
               w tym  samym  czasie za  poôrednictwem  kilku  kopii  programu-
               -klienta.

Przykîady: maurycy@jabber.org stnowak@jabber.at

@endnode

@node "window-contact" "Okno dodawania kontaktów"
@toc "windows"

@{b}@{u}Okno dodawania kontaktów@{ub}@{uu}

Okno to otwiera sië po wybraniu z menu "Lista" opcji "Dodaj kontakt" i pozwala
na  wprowadzanie  informacji  niezbëdnych do dodania nowego kontaktu do Twojej
@{" listy " link "roster"}. Okno dodawania kontaktów zawiera trzy gadûety  tekstowe,  w  których
naleûy   wpisaê   odpowiednie   dane.   Konieczne   jest   wypeînienie    pola
@{" identyfikator " link "jabberID"}, natomiast pól "Imië" i "Pozdrowienie"  -  opcjonalne.  Jeôli
nie wpiszesz niczego w pole "Imië", to na liôcie kontaktów dana  osoba  bëdzie
reprezentowana  przez  swój  identyfikator,  zamiast przez  wîasne imië. Tekst
z pola "Pozdrowienie" pojawi sië w @{" proôbie o dopisanie " link "subscription"}, wysyîanej do nowego
kontaktu.

Okno dodawania kontaktów zawiera 5 poniûej opisanych gadûetów.

Identyfikator - wpisz tutaj @{" identyfikator " link "jabberID"} o postaci uûytkownik@serwer.
Imië --------- miejsce na imië nowego kontaktu (Maurycy, Beata, Paweî itd.).
Pozdrowienie - pozdrowienie,  które  pojawi  sië  u  odbiorcy  wraz  z  proôbâ
               o dopisanie.
Dopisz ------- wysîanie proôby o dopisanie.
Poniechaj ---- anulowanie operacji.

@endnode

@node "window-subscriptions" "Okno proôby o dopisanie"
@toc "windows"

@{b}@{u}Okno proôby o dopisanie@{ub}@{uu}

Okno to otworzyê moûna wybierajâc "Dopisanie" z menu "Okna". Okno  to  otworzy
sië automatycznie,  jeôli  tylko  otrzymasz  @{" proôbë o dopisanie " link "subscription"}  od  innego
uûytkownika. Otwiera sië ono takûe przy poîâczeniu, gdy  znajdujâ  sië  proôby
jeszcze  nie rozpatrzone. Wskazanâ w oknie proôbë moûesz zaakceptowaê klikajâc
na gadûecie "Akceptuj", a jeôli chcesz proôbie danej osoby odmówiê, kliknij na
"Odrzuê". Kaûda z dwu moûliwoôci usunie të proôbë z listy.

Okno proôby o dopisanie zawiera cztery gadûety.

Proôby (lista) ---- wyôwietla listë próôb jeszcze nie  rozpatrzonych.  Wybierz
                    jednâ z  nich i  podejmij decyzjë,  aby   proôba  zniknëîa
                    z listy.
Akceptuj ---------- kliknij, aby zaakceptowaê proôbë.
Akceptuj i dopisz - aktualnie nie robi nic (opcja nie jest zaimplementowana).
Odrzuê ------------ kliknij, aby proôbë odrzuciê.

* Lista  posiada  suwak,  który  pozwala  na   obejrzenie   zawartoôci   listy
  znajdujâcej sië poza widocznym obszarem.

@endnode

@node "window-readmsg" "Okno czytania wiadomoôci"
@toc "windows"

@{b}@{u}Okno czytania wiadomoôci@{ub}@{uu}

Okno to moûna  otworzyê  klikajâc  na  ikonce  wiadomoôci  w  @{" oknie gîównym "  link "window-main"}
i wybierajâc opcjë  "Przeczytaj  wiadomoôê"  w  menu  "Lista"  lub  dwukrotnie
klikajâc  na  ikonce wiadomoôci. Okno czytania wiadomoôci zawiera trzy gadûety
informacyjne, znajdujâce sië w  górnej  czëôci  okna.  Gadûet  "Od"  wyôwietla
@{" identyfikator " link "jabberID"} nadawcy, a "Temat" zawiera informacje o treôci  podane  przez
nadawcë. Gadûet "Bîâd" lepiej niech pozostanie  pusty  ;).  Zajmujâce  znacznâ
czëôê okna pole zawiera wîaôciwâ treôê wiadomoôci.

Jeôli podczas czytania wiadomoôci pojawi sië kolejna od tego  samego  nadawcy,
moûna  jâ  odczytaê wybierajâc gadûet "Nastëpna". Zostanie on uaktywniony, gdy
dotrze  do  Ciebie  wiadomoôê  podczas  odczytywania  wiadomoôci,  która  jest
ostatnia   na   liôcie.   Oczywiôcie  gadûety  "Nastëpna"  i  "Poprzednia"  sâ
nieaktywne, gdy brak jest wiadomoôci, do  których  moûna  przejôê  korzystajâc
wîaônie  z  nich. Jabberwocky przechowuje w pamiëci otrzymane wiadomoôci aû do
czasu rozîâczenia, wiëc moûesz ponownie odczytaê tekst  klikajâc  na  wybranym
nadawcy na liôcie i wybierajâc z menu "Lista" opcjë "Przeczytaj wiadomoôê".

Aby odpisaê  nadawcy  moûesz  wybraê  zarówno  "Napisz",  jak  i  "Odpowiedz".
Niezaleûnie od wyboru wyôwietlone zostanie @{" okno pisania wiadomoôci " link "window-writemsg"} z wypeî-
nionym juû polem "Do", w które zostanie wpisany  identyfikator  nadawcy  danej
wiadomoôci. Wybranie "Odpowiedz" spowoduje umieszczenie oryginalnej wiadomoôci
w oknie pisania.

UWAGA: Gdy otwarte jest okno czytania wiadomoôci, ikonka nowej wiadomoôci  NIE
       pojawi sië na liôcie po otrzymaniu wiadomoôci. Jest to bîâd w programie
       i   zostanie   poprawiony  w  nastëpnej  wersji.   W  razie   problemów
       z odbieraniem wiadomoôci poszukaj okna czytania  schowanego  pod  innymi
       oknami.

Okno czytania wiadomoôci zawiera 9 opisanych niûej gadûetów.

Poprzednia - ponowne   odczytanie   poprzedniej   wiadomoôci.   Gadûet    jest
             nieaktywny, gdy brak jest takowej.
Nastëpna --- odczytanie nastëpnej wiadomoôci. Gadûet jest nieaktywny, gdy brak
             jest kolejnych wiadomoôci.
Od --------- wyôwietla identyfikator nadawcy wiadomoôci.
Temat ------ temat wiadomoôci okreôlony przez jej nadawcë.
Bîâd ------- wyôwietla bîëdy zwiâzane z przesîaniem wiadomoôci.
(Lista) ---- pole zawierajâce treôê wiadomoôci.
Napisz ----- otwiera   okno   pisania  wiadomoôci   pozwalajâce  na  napisanie
             i wysîanie   wiadomoôci.  W   pole   "Do"   skopiowany   zostanie
             identyfikator nadawcy oryginalnej wiadomoôci.
Odpowiedz -- otwiera  okno pisania  wiadomoôci,  które  pozwala  na  napisanie
             i wysîanie wiadomoôci. Zarówno identyfikator nadawcy, jak i treôê
             oryginalnej wiadomoôci zostanâ skopiowane w odpowiednie pola.
Zamknij ---- zamyka bieûâce okno czytania wiadomoôci.

* Lista  posiada  suwak,  który  pozwala  na   obejrzenie   zawartoôci   listy
  znajdujâcej sië poza widocznym obszarem.

@endnode

@node "window-writemsg" "Okno pisania wiadomoôci"
@toc "windows"

@{b}@{u}Okno pisania wiadomoôci@{ub}@{uu}

Okno to, otwierane po  wybraniu  opcji  "Napisz  wiadomoôê"  z  menu  "Lista",
pozwala  na   pisanie i wysyîanie wiadomoôci.  Dwukrotne klikniëcie na pozycji
z @{" listy " link "roster"} spowoduje otworzenie tego okna z  @{" identyfikatorem " link "jabberID"}  wybranej osoby
wpisanym juû w pole "Do".  Wybranie  "Napisz"  w  @{" oknie czytania wiadomoôci " link "window-readmsg"}
otworzy okno pisania, w którym wypeînione bëdâ pola "Do" i "Temat". Klikniëcie
na  gadûecie  "Odpowiedz"  z  okna czytania spowoduje to samo, przy czym tekst
wiadomoôci oryginalnej zostanie skopiowany do pola tekstowego w oknie  pisania
wiadomoôci.

Wîaôciwy identyfikator w polu "Do" jest jedynym warunkiem wysîania wiadomoôci.
Wypeînienie pola  temat nie jest obowiâzkowe, ale  uîatwia to orientowanie sië
w zbiorze wiadomoôci. Poniewaû  nie  ma  wiëkszego sensu  w  wysyîaniu pustych
wiadomoôci,  powinieneô wpisaê tekst w pole edycji zanim klikniesz na gadûecie
"Wyôlij". Wysyîanie wiadomoôci moûna anulowaê klikajâc na gadûecie  zamkniëcia
lub "Poniechaj".

Okno pisania wiadomoôci posiada 5 poniûej opisanych gadûetów.

Do -------------- wpisz tu identyfikator odbiorcy wiadomoôci.
Temat ----------- pole na ewentualny temat lub opis wiadomoôci.
(Pole tekstowe) - wpisz tu tekst wiadomoôci.
Wyôlij ---------- kliknij, aby wysîaê wiadomoôê.
Poniechaj ------- anulowanie wysyîania.

* Pole tekstowe posiada suwak, który pozwala  na  obejrzenie  zawartoôci  pola
  znajdujâcej sië poza widocznym obszarem.

@endnode

@node "window-chat" "Okno rozmowy"
@toc "windows"

@{b}@{u}Okno rozmowy@{ub}@{uu}

Okno rozmowy otworzyê moûna klikajâc na  kontakcie  na  @{" liôcie " link "roster"} i wybierajâc
opcjë "Rozmawiaj" z menu "Lista".  Okno  to  otworzy  sië  automatycznie,  gdy
otrzymasz  wypowiedú,  a  okno  nie  bëdzie  otwarte. Rozmowy z poszczególnymi
osobami toczone sâ (dla kaûdej z osób) w oddzielnych oknach.

W gadûecie informacyjnym na górze okna wyôwietlane sâ imië i/lub identyfikator
osoby,  z  którâ  rozmawiasz.  Pod  gadûetem  tym  znajdujâ  sië trzy kolejne.
"Wyczyôê" usuwa zawartoôê listy poniûej, "Zapisz" pozwala na zachowanie  tejûe
zawartoôci,  a  "Wyôlij  plik..."  umoûliwia  wysîanie pliku do osoby, z którâ
rozmawiasz. Lista pod tymi gadûetami zawiera wypowiedzi wysyîane i otrzymywane
podczas  prowadzonej  rozmowy.  Pole  tekstowe  pod listâ sîuûy  do wpisywania
i edycji wypowiedzi. Klawisz <Return> wysyîa wypowiedú.

Okno rozmowy skîada sië z 6 gîównych gadûetów, wymienionych poniûej.

(Informacyjny) -- wyôwietla  imië   i/lub   identyfikator   osoby,   z   którâ
                  rozmawiasz.
Wyczyôê --------- usuwa zawartoôê listy z przebiegiem rozmowy.
Zapisz ---------- opcja ta jeszcze nie jest zaimplementowana.
Wyôlij plik ----- opcja ta jeszcze nie jest zaimplementowana.
(Lista) --------- wyôwietla  wysyîane   i   otrzymywane   w   czasie   rozmowy
                  wypowiedzi.
(Pole tekstowe) - sîuûy ono do wpisywania wypowiedzi, wysyîanych po wciôniëciu
                  klawisza <Return>.

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola
  znajdujâcej sië poza widocznym obszarem.

@endnode

@node "window-info" "Okno informacyjne"
@toc "windows"

@{b}@{u}Okno informacyjne@{ub}@{uu}

Okno to zostaje  otwarte  po  wybraniu  z  menu  opcji  "Lista/Informacje"  po
wybraniu kontaktu z @{" listy " link "roster"} w @{" oknie gîównym " link "window-main"}. Okno  informacyjne  wyôwietla
szczegóîy @{" obecnoôci " link "Presence"}, dostëpnoôê oraz informacje na temat programu wybranego
wpisu z listy kontaktów.

Informacja: Termin "wybrany wpis" odnosi sië do wpisu z listy w oknie gîównym,
      który jest wybrany  (podôwietlony)  w  chwili  wywoîania  z  menu  opcji
      "Lista/Informacje".  Moûna  podôwietliê  inny  wpis z listy po wywoîaniu
      okna informacyjnego, ale informacje zawarte w oknie informacyjnym  nadal
      bëdâ odnosiîy sië do wpisu, dla którego zostaîy wywoîane.

Moûesz dla danego wpisu zmieniê imië  pojawiajâce  sië  na  liôcie  kontaktów.
Wprowadú  lub  zmieï  imië w polu tekstowym "Imië", a nastëpnie wybierz gadûet
"Aktualizuj", aby zapisaê zmiany wprowadzone  na  Twojej  liôcie  na  serwerze
Jabbera.

Informacje na temat klienta nie zostanâ wyôwietlone dla  danego  wpisu  dopóki
nie  wybierzesz  gadûetu  "Zapytaj".  Jeôli  wciôniesz  gadûet  "Zapytaj"  dla
kontaktu opartego o usîugi (np. koles@icq.myjabber.org), otrzymasz  informacje
na  temat  usîugi,  zamiast  informacji na temat programu uûytkownika. Jest to
ograniczenie usîugi, a nie Jabberwocky'ego czy teû JabberIM.

Okno informacyjne zawiera 14 gadûetów:

Imië ------------ Podaj lub zmieï imië, jakie ma  byê wyôwietlane  dla  danego
                  wpisu w Twojej liôcie kontaktów w oknie gîównym.
Identyfikator --- Wyôwietla @{" identyfikator " link "jabberID"}  danego  wpisu  w  Twojej  liôcie
                  kontaktów w oknie gîównym.
Grupa ----------- Aktualnie niezaimplementowane.
Aktualizuj ------ Wybierz, aby zaktualizowaê listë kontaktów Jabbera po  doko-
                  naniu jakichkolwiek zmian w polu "Imië" opisanym powyûej.
Zamknij --------- Wybierz, aby zamknâê okno informacyjne.
Obecnoôê(zakî.) - Wyôwietla informacje na temat wybranego wpisu.
  Dopisanie ----- Wyôwietla rodzaj  @{" dopisania " link "Subscription"}  wybranego  wpisu.  Dopisanie
                  moûe byê "Od", "Do", "Brak" lub "Obie".
     zmieï na --- Aktualnie niezaimplementowane.
  Status -------- Wyôwietla  obecnoôê  (dostëpnoôê)  wybranego  wpisu.  Zobacz
                  @{" obecnoôê " link "Presence"} w celu poznania moûliwych znaczników statusu.
  Uwagi --------- Wyôwietla dodatkowe informacje o dostëpnoôci wysyîane  przez
                  wybrany wpis (to pole jest przewaûnie puste).
Klient (zakî.) -- Wyôwietla na  ûâdanie  (Zapytanie)  informacje  o  programie
                  uûywanym przez wybrany wpis.
   Klient ------- Wyôwietla nazwë programu.
   Wersja ------- Wyôwietla wersjë programu.
   OS ----------- Wyôwietla system operacyjny klienta.
   Zapytaj ------ Wybierz, aby otrzymaê informacje na temat klienta  wybranego
                  wpisu.

Informacja: Funkcja aktualizacji nie dziaîa poprawnie z wpisami usîug.  Unikaj
            aktualizacji wpisów usîug z listy swoich kontaktów jeôli pracujesz
            z wersjâ wczeôniejszâ niû 1.4.

@endnode

@node "window-prefs" "Okno preferencji"
@toc "windows"

@{b}@{u}Okno preferencji@{ub}@{uu}

Okno to otwiera sië po wybraniu opcji "Preferencje" z  menu  "Ustawienia".  Na
dole  okna  znajdujâ  sië  trzy  gadûety, których dziaîanie dotyczâ wszystkich
ustawieï  preferencji. Gadûet  "Zapisz" powoduje  zachowanie  wszelkich  zmian
w  ustawieniach  i zastosowanie ich  juû w bieûâcej sesji  pracy z  programem.
"Uûyj"  natomiast pozwala na zastosowanie  zmian tylko w  bieûâcej sesji  (nie
zostanâ   one  zapisane).  "Poniechaj"   anuluje   wszelkie  zmiany   dokonane
w ustawieniach, tak ûe Jabberwocky pracowaê bëdzie wedîug starych preferencji.
Kaûdy z tych trzech gadûetów dodatkowo zamyka okno.

Lista po lewej stronie zawiera wykaz kategorii ustawieï. Klikajâc na  dowolnej
kategorii   spowodujemy   wyôwietlenie   po  prawej  stronie  dotyczâcych  jej
preferencji.  Ustawienia  zmieniaê  moûna  korzystajâ  z   opisanych   poniûej
gadûetów.

Informacja: Preferencje z zakîadek "Lokale"  oraz  "Przesyîanie  danych"  oraz
    opcja "Zaawansowane/Wysyîaj hasîo jako zwykîy tekst" sâ w  obecnej  wersji
    programu niezaimplementowane. Nie sâ uûywane, ani zapisywane.

Okno preferencji skîada sië z czterech gadûetów i listy kategorii. Elementy te
opisane sâ niûej.

Kategoria (Lista) - wyôwietla listë kategorii ustawieï. Kliknij na  kategorii,
                    aby po prawej stronie listy  zobaczyê  wîaôciwe  dla  niej
                    elementy preferencji.
Ustawienia -------- wyôwietla  ustawienia  dotyczâce   wskazanej   na   liôcie
                    kategorii.
Zapisz ------------ zapisanie zmian w preferencjach.
Uûyj -------------- uûywa wprowadzonych zmian do pracy z  programem,  ale  nie
                    zapisuje ich.
Poniechaj --------- anulowanie wszelkich zmian  w  ustawieniach  i  zamkniëcie
                    okna.

Wykaz moûliwoôci dokonywana zmian w obrëbie poszczególnych kategorii.

@{i}@{b}Ogólne (znacznik)@{ui}@{ub}
   Poîâcz przy starcie --- dziëki  tej  opcji  Jabberwocky  poîâczy  sië  przy
                           uruchamianiu  z   serwerem   i   kontem   uprzednio
                           zapisanym.
   Poîâcz po rozîâczeniu - umoûliwia   ponowne    poîâczenie    w    przypadku
                           wystâpienia nieplanowanego rozîâczenia.
   Wyôwietlaj wiadomoôci - gdy zostanie odebrana  wiadomoôê,  zostanie  otware
   uûywajâc okna rozmowy   okno rozmowy,  w  którym  to  zostanie  wyôwietlona
                           wiadomoôê. Odpowiedzi bëdâ wysyîane  jako  rozmowa,
                           nie jako wiadomoôci.
   Wyôwietlaj rozmowy ---- gdy zostanie  odebrana  rozmowa,  zostanie  otwarte
   uûywajâc okna           okno wiadomoôci, w którym to  zostanie  wyôwietlona
   wiadomoôci              rozmowa. Odpowiedú zostanie wysîana jako wiadomoôê,
                           a nie rozmowa.

@{I}@{B}Lokale@{ui} - obecnie niezaimplementowane@{ub}
   Wbudowane (znacznik) - program bëdzie korzystaî z wîasnej tablicy znaków.
   Tablica ISO ---------- ôcieûka dostëpu do pliku z innâ tablicâ znaków.
   (Okno wyboru plików) - umoûliwia  wskazanie  ôcieûki  tablicy   wspomnianej
                          w opcji "Tablica ISO".

@{I}@{B}Transfer@{ui} - obecnie niezaimplementowane@{ub}
   Port serwera HTTP  ---- ?????

@{i}@{b}Zdarzenia@{ui}@{ub}
   Zdarzenia (Lista) ---- wybierz  zdarzenie,  dla  którego   chcesz   zmieniê
                          preferencje. Ustawienia okreôlone gadûetami  poniûej
                          bëdâ  miaîy  zastosowanie  tylko  do  podôwietlonego
                          (wybranego) zdarzenia.
   Okno na wierzch *1 --- spowoduje, ûe gdy wystâpi wskazane  zdarzenie,  okno
                          Jabberwocky'ego zostanie przesuniëte  nad  wszystkie
                          pozostaîe okna.
   Ekran na wierzch *1 -- spowoduje,  ûe  gdy  wystâpi   wskazane   zdarzenie,
                          wyôwietlony zostanie ekran Jabberwocky'ego.
   Deikonifikuj *1 ------ spowoduje,  ûe  gdy  wystâpi   wskazane   zdarzenie,
                          Jabberwocky zostanie zdeikonifikowany.
   Polecenie (Tekst) ---- wpisz tu  polecenie  (wraz  ze  ôcieûkâ),  która  ma
                          zostaê   wykonana   w   razie   wystâpienia   danego
                          zdarzenia.
   (Okno wyboru plików) - umoûliwia wybór polecenia, o  którym  mowa  w  opcji
                          "Polecenie".
   Dúwiëk (Tekst) ------- wskaû dúwiëk (plik wraz ze ôcieûkâ), który ma zostaê
                          odegrany w przypadku wystâpienia danego zdarzenia.
   (Okno wyboru plików) - umoûliwia  wybór  pliku,  o  którym  mowa  w   opcji
                          "Dúwiëk".
   Testuj --------------- klikniëcie  spowoduje  odegranie  dúwiëku  wybranego
                          opcjâ "Dúwiëk".
1 = Znaczniki

@{i}@{b}Zaawansowane@{ui}@{ub}
   Proste przesyîanie hasîa - powoduje przesîanie hasîa bez kodowania.
   Raportowanie:
     Przychodzâce XML (znacznik) ---- zaznacz, aby w pliku  raportów  znalazîy
                                      sië     informacje     o      wszystkich
                                      przychodzâcych protokoîach XML.
     Wychodzâce XML (znacznik) ------ zaznacz, aby w pliku  raportów  znalazîy
                                      sië informacje o wszystkich wychodzâcych
                                      protokoîach XML.
     Bîëdy (znacznik) --------------- pozwala  na   zachowanie   w   raportach
                                      informacji zwiâzanych z bîëdami.
     Plik raportu ------------------- ôcieûka dostëpu do pliku raportów.
     (Okno wyboru plików) ----------- pozwala  na  wskazanie  ôcieûki i pliku,
                                      o których mowa w opcji "Plik raportu".

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola znajdujâcej
  sië poza widocznym obszarem.

@endnode

@node "window-sendfile" "Okno wysyîania plików"
@toc "windows"

@{b}@{u}Okno wysyîania plików@{ub}@{uu}

Okno  wysyîania  plików  otwiera  sië po wybraniu pozycji "Wyôlij plik" z menu
"Lista",  gdy  na  liôcie w  oknie gîównym  zaznaczony jest jednoczeônie jeden
z kontaktów.  Na górze okna  zostanie  wyôwietlony  @{" identyfikator " link "jabberID"}  wybranej
osoby. Poniûej identyfikatora, w pola tekstowe, wpisaê naleûy nazwë pliku oraz
(opcjonalnie)  opis. Nazwa pliku musi zawieraê równieû ôcieûkë dostëpu. Wyboru
pliku moûna dokonaê korzystajâc z gadûetu po prawej stronie pola  "Plik".  Gdy
wszystko  jest juû gotowe, moûna przesîaê plik klikajâc na przycisku "Wyôlij".
Przycisk "Ponichaj" sîuûy do zrezygnowania z wysyîania pliku.

Po  wysîaniu pliku moûliwe jest kontrolowaê procesu jego przekazywania w oknie
@{" przesyîania plików " link "window-filetrans"}, które wywoîuje sië wybierajâc opcjë "Przesyîanie plików"
z menu "Okna". Jabberwocky przesyîa pliki wykorzystujâc protokóî "HTTP".

Okno wysyîania plików zawiera szeôê poniûszych gadûetów

Do ------------ wyôwietla identyfikator  kontaktu, do którego  chcesz przesîaê
                plik.
Plik ---------- wpisz tutaj nazwë wysyîanego pliku (wraz ze ôcieûkâ).
(Okno wyboru -- umoûliwia  wybór  katalogu i  pliku  do  umieszczenia  w  polu
                "Plik".
Opis ---------- wprowadú  tu opis wysyîanego  pliku; opis  nie jest konieczny,
                pole to moûe pozostaê puste.
Wyôlij -------- kliknij, aby wysîaê plik.
Poniechaj ----- kliknij, aby  zrezygnowaê z przesyîania pliku; jeôli wciôniëty
                zostaî juû przycisk  "Wyôlij", to ten przycisk zamknie jedynie
                okno.

@endnode

@node "window-console" "Okno konsoli"
@toc "windows"

@{b}@{u}Okno konsoli@{ub}@{uu}

Okno  to  otwiera sië po wybraniu opcji "Konsola" z menu "Okna".  Okno konsoli
sîuûy   do  monitorowania  komunikatów  kontrolnych  Jabberwocky'ego  oraz  do
sprawdzania  wymiany  danych  poprzez  XML.   Znajduje  sië  w  nim takûe pole
pozwalajâce na wprowadzanie komend XML i wysyîanie ich do serwera Jabbera.  Po
nawiâzaniu  poîâczenia  caîoôê  komunikatów   przesyîanych pomiëdzy  programem
i  serwerem  przedstawiana  jest  w  oknie  konsoli  w formie zrozumiaîych dla
uûytkownika komend XML.

Zaawansowani  uûytkownicy  Jabbera  mogâ  wykorzystaê  wyôwietlane  komunikaty
w  celach  diagnostycznych.  Jeôli  znasz  komendy XML,  moûesz  wprowadzaê je
w  polu  na  dole  okna  konsoli  i wysyîaê je do serwera.  W ten sposób moûna
korzystaê  z  funkcji, które nie sâ bezpoôrednio dostëpne w programie.  Naleûy
jednak pamiëtaê, ûe korzystanie z tej opcji zalecane jest tylko wtedy, gdy wie
sië, co sië robi.  W przeciwnym wypadku (przy wpisywaniu niepoprawnych komend)
moûe  zostaê  przerwane  poîâczenie,  a nawet dojôê do utraty konta Jabbera na
danym serwerze.

Okno konsoli skîada sië z siedmiu gadûetów opisanych poniûej.

Obserwuj pracë XML (znacznik) - zaznaczenie   umoûliwia  obserwowanie  wymiany
                                danych w polu poniûej.
Zapisz... --------------------- aktualnie niezaimplementowane.
Opróúnij ---------------------- pozwala usunâê zawartoôê listy z komunikatami.
(Lista) ----------------------- wyôwietlane  sâ  tu wszelkie  komunikaty  oraz
                                dane  dotyczâce  pracy XML  (jeôli  zaznaczono
                                opcjë "Obserwuj pracë XML").
(Pole tekstowe) --------------- sîuûy do wprowadzania i edycji poleceï XML.
Wyczyôê ----------------------- umoûliwa  usuniëcie  poprzedniej  komendy  XML
                                z pola tekstowego; wysîanie komendy nie czyôci
                                tego  pola, a wiëc konieczne jest skorzystanie
                                z   tej  opcji,  inaczej  poprzednia   komenda
                                zostanie wysîana ponownie.
Wyôlij ------------------------ klikniëcie  spowoduje  przesîanie  komendy  XML
                                zawartej w polu tekstowym; po wysîaniu komendy,
                                a  przed  przesîaniem  kolejnej,  naleûy   pole
                                edycji wyczyôciê przy uûyciu opcji "Wyczyôê".

* Lista  posiada  suwak,  który  pozwala  na   obejrzenie   zawartoôci   listy
  znajdujâcej sië poza widocznym obszarem.

@endnode

@node "window-agents" "Okno listy usîug"
@toc "windows"

@{b}@{u}Okno listy usîug@{ub}@{uu}

Okno to otworzyê moûna wybierajâc opcjë "Lista usîug" z menu "Okna".  Zostanie
w nim wyôwietlona lista @{" usîug Jabbera " link "agents"} pobrana podczas procesu îâczenia  sië
z  serwerem.   W  oknie  tym  moûna  teû dokonaê rejestracji usîug, które tego
wymagajâ.  W tym celu naleûy kliknâê na gadûecie "Rejestruj".  Otworzone wtedy
zostanie @{" okno rejestracji " link "window-register"}, w którym znajdâ  sië  pola,  w  które  wprowadziê

bëdzie trzeba dane wymagane przez konkretnâ  usîugë.  Klikniëcie  na  gadûecie
"Szukaj",  gdy  wybrana  jest  usîuga  umoûliwiajâca przeszukiwanie, spowoduje
otwarcie   @{" okna szukania " link "window-search"},   w   którym  wprowadziê  bëdzie  moûna  kryteria
poszukiwaï. Moûliwoôci oraz wymagania poszczególnych usîug  umieszczone  sâ  w
kolumnach obok nazw usîug.

Kolumny opisujâce usîugë przedstawiono poniûej.

Nazwa ---------- znajduje sië tu nazwa usîugi Jabbera.
Rejestracja ---- "Tak" oznacza, ûe  dla tej usîugi  moûna dokonaê rejestracji;
                 jest  ona  niezbëdna   do  korzystania  z  usîugi  transport,
                 a w  przypadku innych (jak np. @{" Jabber User Directory " link "directory"}) jest
                 opcjonalna.
Szukaj --------- "Tak"  oznacza, ûe  usîuga dostarcza informacji, na  których
                 moûna dokonaê operacji przeszukiwania.
Konferencja ---- "Tak" oznacza, ûe usîuga umoûliwia prowadzanie konferencji.


W oknie tym znajduje sië siedem poniûej opisanych gadûetów.

(Lista) ----- wyôwietla listë  usîug Jabbera  dostëpnych na serwerze, z którym
              w danej chwili poîâczony jest Jabberwocky.
URL --------- aktualnie brak opisu.
Odwiedú  ---- aktualnie brak opisu.
Opis -------- przedstawia opis usîugi wybranej z listy, jeôli serwer  przesîaî
              wraz z listâ taki opis.
Rejestruj --- umoûliwia rejestracjë wybranej usîugi.
Szukaj ------ pozwala na poszukiwania wykonywane za  pomocâ  wskazanej  usîugi
              (zwykle jest to "Jabber User Directory").
Konferencja - aktualnie brak opisu.

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola znajdujâcej
  sië poza widocznym obszarem.

@endnode

@node "window-filetrans" "Okno przesyîania plików"
@toc "windows"

@{b}@{u}Okno przesyîania plików@{ub}@{uu}

Okno to  otworzyê moûna wybierajâc  opcjë "Przesyîanie  plików" z menu "Okna".
W   oknie    wyôwietlane   sâ   zarówno  transfery   plików   wysyîanych,  jak
i  otrzymywanych.   Moûesz  tutaj nadzorowaê wysyîkë plików.  Te z nich, które
nie   zostaîy  jeszcze  zaakceptowane  przez  odbiorcë,  oznaczone  bëdâ  jako
"offering".  Po wysîaniu pliku jego oznaczenie zmieni sië na "finished".

Okno  przesyîania  plików  otworzone  zostanie automatycznie, gdy otrzymasz od
jednego ze swoich kontaktów ofertë przesîania pliku.  Nowe przesyîki oznaczone
zostanâ jako "offered" - moûna zgodziê sië na ich otrzymanie zaznaczajâc je na
liôcie  i  klikajâc  na  gadûecie  "Akceptuj".  Nastëpnie Jabberwocky przekaûe
odpowiedni  adres do Twojej przeglâdarki internetowej korzystajâc z biblioteki
OpenURL.    Wîaôciwy   proces   przesyîania   plików   dokonywany  jest  przez
przeglâdarkë   internetowâ   przy   uûyciu   protokoîu   HTTP,   bez   udziaîy
Jabberwocky'ego.   Po przekazaniu adresu przeglâdarce, Jabberwocky zmieni opis
pliku na "connecting".

Okno przesyîania plików zawiera piëê gîównych gadûetów opisanych poniûej.

(Lista) -- wyôwietlane tu  sâ  (z  dodatkowymi opisami)  wszystkie  przesyîane
           pliki.
           Operation - "Send" oznacza plik wysyîany.
                       "Receive" oznacza plik otrzymywany.
           State ----- moûliwe sâ cztery poniûsze opisy.
                       @{i}Offering @{ui} (plik oferowany do wysîania).
                       @{i}Finished @{ui} (wysyîka pliku ukoïczona).
                       @{i}Offered @{ui} (plik oferowany do pobrania).
                       @{i}Connecting @{ui} (pobranie pliku zaakceptowane).
           File ------ wyôwietla nazwë pliku wysyîanego bâdú adres pobieranego.
           Size ------ funkcja obecnie niezaimplementowana.
Akceptuj - klikniëcie spowoduje rozpoczëcie pobierania zaznaczonego pliku.
Odrzuê --- funkcja obecnie niezaimplementowana i niedostëpna.
Cleanup -- funkcja obecnie niezaimplementowana.
Zamknij -- zamyka okno przesyîania plików.

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola znajdujâcej
  sië poza widocznym obszarem.

@endnode

@node "window-conference" "Okno konferencji Jabbera"
@toc "windows"

@{b}@{u}Okno konferencji Jabbera@{ub}@{uu}

Gdy wybierzesz z menu  "Okna"  opcjë  "Nowa  konferencja",  otworzy  sië  okno
konferencji, dziëki któremu moûesz uczestniczyê w @{" konferencji Jabbera " link "conference"}. Pole
"Temat" na górze okna pozwala na zmianë tematu danej rozmowy, ale  wypeînianie
go  nie  jest  konieczne.  Na  duûej liôcie po lewej stronie okna znajdujâ sië
wypowiedzi wraz z pseudonimami ich autorów, a maîa  lista  po  prawej  stronie
zawiera  wykaz  uczestników  konferencji.  Twój pseudonim znajduje sië na dole
okna, obok pola tekstowego. Owo pole tekstowe jest miejscem, w  którym  moûesz
edytowaê  wîasne wypowiedzi oraz wprowadzaê polecenia. Potwierdzenie polecenia
lub przesîanie tekstu nastëpuje po wciôniëciu klawisza <Return>.

Okno konferencji skîada sië z czterech opisanych niûej gadûetów.

Temat ----------- moûesz wpisaê tu temat konferencji.
(Lista 1) ------- wyôwietla wypowiedzi poszczególnych uczestników.
(Lista 2) ------- wyôwietla listë osób biorâcych udziaî w konferencji.
(Pole tekstowe) - wprowadú tu treôê wypowiedzi i naciônij <Return>.

* Listy  posiadajâ  suwaki,  które  pozwalajâ  na  obejrzenie  zawartoôci  pól
  znajdujâcych sië poza widocznym obszarem.

Dostëpne polecenia:
        /join - rozpoczëcie udziaîu w konferencji podanej  po  poleceniu  np.:
                /join users@conference.jabber.org.
        /part - opuszczenie pokoju konferencyjnego.

@endnode

@NODE "window-search" "Okno szukania"
@toc "windows"

@{B}@{U}Okno szukania@{ub}@{UU}

Okno    szukania   otwiera   sië    po   klikniëciu   na   gadûecie   "Szukaj"
w   @{" oknie listy usîug " link "window-agents"}   po   uprzednim   wybraniu  usîugi,  która  umoûliwia
przeszukiwanie.   Informacje,  które wprowadziê naleûy w oknie szukania róûniâ
sië  w  zaleûnoôci od wybranej usîugi.  Poniûsze pola sâ charakterystyczne dla
przeszukiwania  wykonanego  dla  usîugi  @{" Jabber User Directory " link "directory"}. Aby szukanie
miaîo sens naleûy wypeîniê minimum jedno pole.

Okno szukania zwykle zawiera siedem nastëpujâcych gadûetów.

(Lista) --- wyôwietlone sâ tu instrukcje dotyczâce przeszukiwania.
email ----- wpisz tutaj adres poczty elektronicznej.
first ----- wpisz tutaj imië.
last ------ wpisz tutaj nazwisko.
nick ------ wpisz tutaj pseudonim.
Szukaj ---- kliknij, aby rozpoczâê szukanie.
Poniechaj - klikniëcie  tutaj spowoduje  przerwanie  poszukiwaï i  zamkniëcie
            okna.

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola znajdujâcej
  sië poza widocznym obszarem.

@endnode

@node "window-searchresult" "Okno wyników szukania"
@toc "windows"

@{b}@{u}Okno wyników szukania@{ub}@{uu}

Okno to otwiera sië, gdy serwer  przesyîa  Ci  wyniki  wykonanych  poszukiwaï.
Wyôwietlona  zostanie  wtedy  lista wszystkich osób, które speîniajâ okreôlone
przez  Ciebie  kryteria.  Kaûda  z   pozycji   na   liôcie   zawieraê   bëdzie
@{" identyfikator " link "jabberID"} osoby i, ewentualnie, inne dostëpne informacje. Klikniëcie na
dowolnym identyfikatorze, a nastëpnie  na  gadûecie  "Dodaj  kontakt"  otworzy
@{" okno dodawania kontaktów " link "window-contact"}, które pozwala na doîâczenie  wskazanej  osoby  do
Twojej @{" listy kontaktów " link "roster"}.

Poszukiwanie osób rozpoczyna sië od wybrania usîugi  "Jabber  User  Directory"
(JUD) w @{" oknie listy usîug " link "window-agents"} i klikniëcia na gadûecie "Szukaj".

Okno wyników szukania zawiera trzy gadûety.

(Lista) ------- wyôwietlone sâ tu wyniki szukania, bëdâce rezultatem dziaîania
                usîugi Jabber  User  Directory.  Kaûda  z  pozycji  na  liôcie
                zawiera  identyfikator  osoby  oraz inne  informacje (np. imië
                i adres poczty elektronicznej).  Klikniëcie  na  danej pozycji
                spowoduje wybranie jej.
Dodaj kontakt - kliknij, aby dodaê wybranâ osobë do swojej listy kontaktów.
Poniechaj ----- anuluje operacjë i zamknie okno wyników szukania.

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola znajdujâcej
  sië poza widocznym obszarem.

@endnode

@node "window-register" "Okno rejestracji"
@toc "windows"

@{b}@{u}Okno rejestracji@{ub}@{uu}

Okno   rejestracji  otwiera   sië   po  klikniëciu  na  gadûecie  "Rejestruj"
w @{" oknie listy usîug " link "window-agents"}, w którym wybrana jest usîuga umoûliwiajâca rejestracjë.
Wprowadzan  w  oknie  informacje  niezbëdne  do  @{"rejestracji" link "register"} mogâ róûniê sië w
zaleûnoôci  od  rejestrowanej  usîugi  Jabbera.  Przedstawione poniûej pola sâ
typowe dla  usîugi  ICQ  @{" Transport " link "transports"}.  Pola  "username"  (identyfikator)  oraz
"password" (hasîo) sâ niezbëdne do rejestracji usîugi Transport.  Pozostaîe sâ
opcjonalne.

Okno rejestracji zwykle zawiera siedem poniûej opisanych gadûetów.

(Lista) -- zawiera instrukcje dotyczâce rejestracji danej usîugi.
username - wprowadú  tutaj swój  identyfikator (np. ICQ  UIN, AOL  Screenname,
           itp.).
nick -- -- wprowadû tutaj pseudonim.
email ---- wpisz poprawny adres poczty elektronicznej.
password - wprowadú swoje hasîo.
Register - kliknij tu, jeôli  wprowadziîeô wymagane dane i chesz zarejestrowaê
           usîugë.
Cancel --- przerywa rejestracjë i zamyka okno.

* Lista posiada suwak, który pozwala na obejrzenie zawartoôci pola znajdujâcej
  sië poza widocznym obszarem.

@endnode


@node "menus" "Menu"

@{b}@{u}Menu Jabberwocky'ego@{ub}@{uu}

Jabberwocky posiada typowe dla systemu Amigi okna, które pozwalajâ  na  dostëp
do wielu róûnych funkcji.

@{B}Jabberwocky/Konto -------------@{UB} otwiera  @{" okno konta " link "window-login"}, które pozwala na wpisa-
                                nie @{" identyfikatora " link "jabberID"} i hasîa konta na serwerze
                                Jabbera lub rejestracjë nowego konta.
@{B}Jabberwocky/Informacje --------@{UB} otwiera  okno  informujâce  o wersji  programu
                                i prawach autorskich.
@{B}Jabberwocky/O MUI -------------@{UB} otwiera okno informujâce o  wersji  i  prawach
                                autorskich MUI.
@{B}Jabberwocky/Pomoc -------------@{UB} wyôwietla dokumentacjë programu.
@{B}Jabberwocky/Schowaj -----------@{UB} ikonifikuje Jabberwocky'ego.
@{B}Jabberwocky/Skoïcz ------------@{UB} koïczy pracë z programem.

@{B}Lista/Dodaj kontakt -----------@{UB} otwiera  @{" okno  dodawania  kontaktów " link "window-contact"},   które
                                pozwala na poszerzanie @{" listy kontaktów " link "roster"}.
@{B}Lista/Przeczytaj wiadomoôê ----@{UB} otwiera @{" okno czytania wiadomoôci " link "window-readmsg"} i  pozwala
                                na przeczytanie informacji  przesîanych  przez
                                uprzednio wskazanâ osobë.
@{B}Lista/Napisz wiadomoôê --------@{UB} otwiera nowe @{" okno pisania wiadomoôci " link "window-writemsg"}.
@{B}Lista/Rozmawiaj ---------------@{UB} otwiera @{" okno rozmowy " link "window-chat"},  umoûliwiajâce  poga-
                                wëdkë z osobâ wybranâ wczeôniej z listy.
@{B}Lista/Informacje --------------@{UB} otwiera @{" okno informacyjne " link "window-info"}.
@{B}Lista/Wyôlij plik -------------@{UB} otwiera  @{" okno wysyîania plików " link "window-sendfile"}, które  poz-
                                wala na wysîanie pliku do  wybranego kontaktu.
@{B}Lista/Dopisz ------------------@{UB} wysyîa proôbë o @{" dopisanie " link "subscription"} do wybranej osoby.
@{B}Lista/Akceptuj proôbë ---------@{UB} nie korzystaj z tej opcji.
@{B}Lista/Usuï kontakt ------------@{UB} na staîe usuwa z @{" listy " link "roster"} wskazany kontakt.

@{B}Okna/Konsola ------------------@{UB} otwiera @{" okno konsoli " link "window-console"}.
@{B}Okna/Dopisanie ----------------@{UB} otwiera @{" okno proôby o dopisanie " link "window-subscriptions"}, które poz-
                                wala na akceptacjë lub odrzucenie  oczekujâcej
                                na decyzjë proôby o @{" dopisanie " link "subscription"}.

@{B}Okna/Lista usîug --------------@{UB} otwiera @{" okno listy usîug " link "window-agents"} zawierajâce  wykaz
                                dostëpnych   @{" usîug " link "agents"},   z   których    moûesz
                                skorzystaê lub które moûesz @{" zarejestrowaê " link "register"}.
@{B}Okna/Przesyîanie plików -------@{UB} otwiera @{" okno przesyîania plików " link "window-filetrans"}.
@{B}Okna/Nowa konferencja ---------@{UB} otwiera  @{" okno  konferencji  Jabbera " link "window-conference"}, dziëki
                                któremu  moûesz   uczestniczyê   w   grupowych
                                rozmowach zwanych konferencjami.

@{B}Ustawienia/Pokazuj poîâczonych @{UB} opcja obecnie jest dostëpna.
@{B}Ustawienia/Informuj oknem -----@{UB} opcja obecnie nie jest dostëpna.
@{B}Ustawienia/Informuj dúwiëkiem -@{UB} opcja obecnie nie jest dostëpna.
@{B}Ustawienia/Preferencje --------@{UB} otwiera  @{" okno preferencji " link "window-prefs"},  pozwalajâce  na
                                zmianë konfiguracji programu.
@{B}Ustawienia/MUI ----------------@{UB} otwiera okno preferencji MUI.
@{B}Ustawienia/Ostatnio zapisane --@{UB} wczytuje ostatnio zapisane preferencje i uûywa
                                je.
@{B}Ustawienia/Zapisz ustawienia --@{UB} zapisuje aktualne ustawienia.

@{B}ARexx/Wykonaj polecenia -------@{UB} opcja obecnie jest dostëpna.

@ENDNODE

@NODE "config" "Konfiguracja"

@{b}@{u}Konfiguracja@{ub}@{uu}

W  celu  zasiëgniëcia  informacji  na   temat   konfiguracji   Jabberwocky'ego
przeczytaj rozdziaî dotyczâcy @{" okna preferencji " link "window-prefs"}.

@endnode

@node "arexx" "Polecenia ARexx'a"

@{B}@{U}Polecenia ARexx'a@{UB}@{UU}

Jabberwocky posiada port ARexx'a i obsîuguje dziewiëê poleceï  ARexx'a,  które
mogâ byê uûywane do kontrolowania programu lub w celu uzyskania informiacji ze
statusu lub listy kontaktów. Poniewaû kompletny kurs programowania w  ARexx'ie
nie  jest  celem  tej  dokumentacji, w przypadku nieznajomoôci programowania i
uûywania ARexx'a powinieneô poczytaê dokumentacjë jëzyka ARexx dla  komputerów
Amiga.  W  dokumentacji systemu AmigaDOS znajdziesz opis zapisu uûywanego przy
opisie poniûszych poleceï w polach Format i Skîadnia

@{B}@{I}Nazwa portu ARexx'a:@{UB}@{UI} JABBERWOCKY.<x> gdzie x jest  kolejnym  numerem  programu
                     (np. JABBERWOCKY.1 JABBERWOCKY.2).

@{B}@{I}Polecenia ARexx'a:@{UB}@{UI}

@{B}CONNECT@{UB}
  Format ------ CONNECT
  Opis -------- Îâczy z kontem Jabbera okreôlonym w preferencjach.

@{B}DISCONNECT@{UB}
  Format ------ DISCONNECT
  Opis -------- Koïczy poîâczenie z serwerem Jabbera.

@{B}ISONLINE@{UB}
  Format ------ ISONLINE
  Opis -------- Zgîasza  stan  poîâczenia  Jabberwocky'ego.  Stan   Poîâczony/
                Rozîâczony jest zwracany w zmiennej ARexx'a "RC".
  Przykîad ---- ISONLINE
                IF RC THEN SAY "Jabberwocky jes poîâczony"

@{B}GETUSER@{UB}
  Format ------ GETUSER STEM <zmienna>
  Szablon ----- STEM/A
  Wëzîy STEM -- USER,SERVER,RESOURCE
  Opis -------- Zwraca informacje o uûytkowniku programu w okreôlonej zmiennej
                STEM.  Informacja  jest zwracana jako jednowymiarowa tablica o
                elementach nazwanych zgodnie z nazwami wëzîów STEM.
  Przykîad ---- GETUSER STEM info
                SAY info.SERVER

@{B}GETROSTER@{UB}
  Format ------ GETROSTER STEM <zmienna>
  Szablon ----- STEM/A
  Wëzîy STEM -- COUNT,<n> - USER,SERVER,RESOURCE,NAME,NOTE,PRESENCE
  Opis -------- Zwraca informacje o wpisach z  listy  kontaktów  w  okreôlonej
                zmiennej  STEM.  Informacja  jest  zwracana  jako dwuwymiarowa
                tablica  STEM  gdzie  pierwszy  wëzeî  zawiera  jeden  nazwany
                element  (COUNT)  i  wiele  elementów  liczbowych (<n>). Drugi
                wëzeî zawiera szeôê nazwanych elementów dla  kaûdego  elementu
                numerycznego z pierwszego wëzîa.
  Przykîad ---- GETROSTER STEM roster
                SAY roster.COUNT
                SAY roster.1.SERVER

@{B}ADDCONTACT@{UB}
  Format ------ ADDCONTACT JID <identyfikator> [@{I}NAME@{UI} <imië>] [@{I}GREET@{UI} <powitanie>]
  Szablon ----- JID/A,NAME/K,GREET/K
  Opis -------- Dodaje  do  listy  kontakt  okreôlony  przez  wymagane   sîowo
                kluczowe  (JID) i dodaje dane okreôlone przez opcjonalne sîowa
                kluczowe. Parametry muszâ byê ujëte  w  cudzysîowy  (np.  NAME
                "Imië").
  Przykîad ---- ADDCONTACT JID "uzytkownik@jabber.org" NAME "Uûytkownik" GREET "Czeôê"

@{B}SENDMESSAGE@{UB}
  Format ------ SENDMESSAGE TO <identyfikator> MSG <tekst>
  Szablon ----- TO/A,NOTE/K
  Opis --------
  Przykîad ---- SENDMESSAGE TO "uûytkownik@jabber.org" MSG "Przykîadowa wiadomoôê."

@{B}SETPRESENCE@{UB}
  Format ------ SETPRESENCE PRESENCE <status> [@{I}NOTE @{UI}<tekst>]
  Szablon ----- PRESENCE/A,NOTE/K
  Opis -------- Zmienia status dostëpnoôci na okreôlony przez  wymagane  sîowo
                kluczowe (PRESENCE) i doîâcza dodatkowy opis dostarczony przez
                opcjonalne sîowo kluczowe (NOTE). Parametry muszâ byê ujëte  w
                cudzysîowy   (np.   NOTE   "obiad").  Parametr  PRESENCE  moûe
                przyjmowaê nastëpujâce wartoôci:
                   chat   away   xa   dnd   unavailable   available
  Przykîad ---- SETPRESENCE PRESENCE "away" NOTE "Poszedîem coô zjeôê"

@{b}SENDRAW@{ub}
  Format ------ SENDRAW XML <tekst xml>
  Szablon ----- XML/A
  Opis -------- Wysyîa polecenie XML okreôlone przez wymagane  sîowo  kluczowe
                (XML).  Parametr  musi  byê poleceniem rozumianym przez serwer
                Jabbera poleceniem XML ujëtym w cudzysîowy.
  Przykîad ---- SENDRAW XML "<presence/>"

@endnode

@node "tech" "Szczegóîy techniczne"

@{b}@{u}Szczegóîy techniczne@{ub}@{uu}

  @{" Identyfikator    " link "jabberID"}

  @{" Komunikaty stanu " link "status"}

  @{" Lista            " link "roster"}

  @{" Dopisanie        " link "subscription"}

  @{" Obecnoôê         " link "presence"}

  @{" Rejestracja      " link "register"}

  @{" Usîugi           " link "agents"}

  @{" Obrazki          " link "images"}

@endnode

@NODE "jabberID" "Identyfikator"
@toc "tech"

@{b}@{u}Identyfikator@{ub}@{uu}

Wszystkie osoby w systemie Jabbera sâ rozróûniane  poprzez  specyficznâ  formë
adresu,  okreôlanâ  jako  identyfikator.  Korzystanie  z usîug îâczâcych róûne
systemy  bezpoôredniej  komunikacji  powodujâ   pewne   róûnice   w   formacie
identyfikatorów.  Przewaûnie  jest  to  nazwa usîugi poîâczona z nazwâ serwera
Jabbera   (icq.servername,   np.   icq.jabber.org).   Identyfikator    zawiera
informacje,  które  pozwalajâ  powiâzaê  uûytkownika  z wëzîem (serwerem) oraz
poîâczeniem    (reprezentacjâ).    Wîaôciwy    format    identyfikatora     to
"uûytkownik@serwer/reprezentacja"  lub ""uûytkownik@serwer" (reprezentacja nie
jest obowiâzkowa).

Poszczególne elementy identyfikatora opisane sâ poniûej.

Uûytkownik ---- nazwa twojego konta na serwerze.

Serwer -------- nazwa  serwera.  Aktualnie   jest   tylko   kilka   publicznie
                dostëpnych serwerów Jabbera.  Ich  listë  znaleúê  moûesz  pod
                adresem http://jabberview.com.

Reprezentacja - opcjonalny ciâg pozwalajâcy okreôliê dane poîâczenie. Jeôli go
                nie podasz, zostanie  uûyty  standardowy  ciâg  "Jabberwocky".
                Opcja  ta pozwala na kilka róûnych poîâczeï z tym samym kontem
                w  tym   samym   czasie   za   poôrednictwem   kilku   róûnych
                programów-klientów.

Przykîady: annajot@kanga.nu  zezik34@jabber.at  maurycy@jabber.org

@endnode

@node "status" "Komunikaty stanu"
@toc "tech"

@{b}@{u}Komunikaty stanu@{ub}@{uu}

@{u}Komunikat@{uu}                @{u}Opis@{uu}                     @{u}Zalecane dziaîanie@{uu}
Nie mogë sië poîâczyê    Bîëdna nazwa serwera     Sprawdú nazwë serwera
                                                  w identyfikatorze
                         Brak stosu TCP/IP        Uruchom stos

Sprawdú identyfikator    Bîëdny identyfikator     Ponownie wprowadú
                                                  identyfikator

Îâczenie...              Trwa îâczenie sië        Czekaj!
                         z serwerem

Poîâczenie zerwane!      ???                      ???

Poîâczenie zakoïczone    Uûytkownik zostaî        Zakoïcz prace lub poîâcz
                         rozîâczony               sië ponownie

Rejestrowanie...         Trwa rejestrowanie       Czekaj!
                         nowego konta

Rejestracja nie          Konto o podanej nazwie   Wybierz innâ nazwë konta
powiodîa sië             juû istnieje

Logowanie...             Trwa logowanie sië na    Czekaj!
                         serwer

Bîâd przesyîania         Nastâpiîo przerwanie     Poîâcz sië ponownie
                         poîâczenia na skutek
                         bîëdu protokoîu XML

Pobieranie listë...      Trwa wczytywanie listy   Czekaj!
                         Jabbera

Bîâd autoryzacji!        Bîëdny identyfikator     Ponownie wprowadú
                                                  identyfikator

Poîâczony                Zakoïczone sukcesem      Kontynuuj
                         poîâczenie z serwerem
                         i logowanie

Gdzie jest stos TCP/IP?  (chyba nie wymaga        Uruchom stos TCP/IP
                         wyjaônienia)

gui_state(msg) ?

@endnode

@node "roster" "Lista"
@toc "tech"

@{b}@{u}Lista@{ub}@{uu}

W odróûnieniu od innych systemów bezpoôredniej komunikacji, Jabber przechowuje
listë  kontaktów uûytkownika na serwerze, a nie w pliku zwiâzanym z konkretnym
programem wykorzystywanym przez uûytkownika. Jabberwocky pobiera të  listë  po
poîâczeniu sië z serwerem Jabbera i wyôwietla jâ w oknie gîównym. Tym sposobem
îâczâc sië z róûnych komputerów zawsze bëdziesz miaî  do  dyspozycji  të  samâ
listë. W  domu moûesz korzystaê z  Jabberwocky'ego, a w pracy z innego klienta
i w obu przypadkach pracowaê z tym  samym  kontem  i tâ  samâ  listâ. Niestety
oznacza  to  równieû  utratë  listy  w przypadku, gdy zniknie ona z serwera na
skutek np.  bîëdu  administratora.  Nie  ma  teû  moûliwoôci  zapisania  kopii
zapasowej  listy  na  komputerze,  z  którego  korzystamy. Zalecane jest zatem
dodatkowe przechowywanie informacji o swoich kontaktach.

Pobrana (lokalna) lista jest kopiâ listy przechowywanej  na  serwerze  i  jest
wyôwietlana w zakîadce "Lista" @{" gîównego okna " link "window-main"} programu. Gdy jednak otrzymasz
wiadomoôê od osoby nie  bëdâcej  na  liôcie  kontaktów  lub  do  takiej  osoby
napiszesz,  Jabberwocky  utworzy  czasowâ  pozycjë  na  lokalnej  liôcie. Przy
ponownym poîâczeniu pozycji tej na liôcie juû nie bëdzie, chyba  ûe  wczeôniej
nastâpi dopisanie.

Mechanizm informacji  o  dopisaniu  i  obecnoôci  wykorzystuje  dane  z  listy
uûytkownika.    Kaûda   z   pozycji  na  liôcie   posiada,   oprócz  "Imienia"
i "Identyfikatora", dane dotyczâce ewentualnego dopisania i próôb o dopisanie.
Jeôli przerwiesz poîâczenie bez zareagowania na takâ proôbë, to pojawi sië ona
w oknie proôby o dopisanie przy okazji nastëpnego poîâczenia.

Jabberwocky pokazuje status  @{" dopisania " link "subscription"}  dla  kontaktów  przy  pomocy  styli
(@{B}wytîuszczonego@{UB},  @{I}pochulonego@{ui},  normalnego)  przypisanych    kaûdemu   wpisowi
na liôcie kontaktów. Informacje o @{" obecnoôci " link "presence"} sâ wyôwietlane jako  @{" obrazki " link "images"}
(ikonki) umieszczone po lewej stronie kaûdego wpisu na liôcie kontaktów.

@ENDNODE

@node "subscription" "Dopisanie"
@toc "tech"

@{b}@{u}Dopisanie@{ub}@{uu}

@{b}@{i}Wprowadzenie:@{ub}@{ui}

Dopisanie jest  mechanizmem Jabbera,  który pozwala na  zarzâdzanie informacjâ
o dostëpnoôci (@{" obecnoôci " link "presence"}). Standardowo takie informacje nie sâ przez serwer
dostarczane,  ale zmienia sië to  po  zaakceptowanej  przez  odbiorcë  proôbie
o dopisanie (choê  proôba taka  moûe  teû  byê odrzucona). Mówiâc inaczej, aby
otrzymywaê informacje o tym, czy uûytkownik jest dostëpny (bâdú  czy  dostëpna
jest   usîuga),  musisz  wpierw  o  to  poprosiê.  Dopisanie  jest  przewaûnie
czynnoôciâ  obustronnâ,  która  czësto   okreôlana   jest   jako   odpowiednik
"uôciôniëcia  dîoni".  Dopisujâc  danego  uûytkownika  moûesz oczekiwaê, ûe on
dopisze Ciebie, tak ûe obaj bëdziecie wiedzieê o swojej obecnoôci.

PRZYKÎAD: uûytkownik1 prosi o dopisanie uûytkownika2.
          uûytkownik2 akceptuje i prosi o dopisanie uûytkownika1
          uûytkownik1 akceptuje proôbë.

Istniejâ dwa sposoby wysîania proôby o dopisanie. Pierwszy  dotyczy  sytuacji,
gdy kontaktu nie ma jeszcze na Twojej @{" liôcie " link "roster"} i polega on na wybraniu z menu
"Lista" opcji "Dodaj kontakt". Drugi sposób to klikniëcie na pozycji na liôcie
i  wybranie  opcji  "Dopisz" z  menu "Lista". Serwer  Jabbera przechowuje dane
o dopisaniach dla kaûdego  z  kontaktów  na  liôcie i  uûywa  ich  w  systemie
informowania o obecnoôci. Poniûej znajdziesz wiëcej informacji na ten temat.


@{b}@{i}Status dopisania@{ub}@{ui}

Na liôcie Jabbera przechowywane sâ takûe dane dotyczâce statusu dopisania  dla
kaûdej  z  osób  na  liôcie. Po pobraniu listy z serwera Jabberwocky rozróûnia
status poprzez rodzaj napisu (@{B}wytîuszczony@{UB}, @{I}kursywa@{UI}, zwykîy) kaûdej z pozycji.
Poniûej objaônione sâ poszczególne rodzaje napisów.

@{u}Rodzaj napisu@{uu}    @{u}Dopisanie@{uu}    @{u}Opis@{uu}
zwykîy           obie         informacje o dostëpnoôci zostaîy  wysîane  przez
                              obie strony
kursywa          od           informacje o dostëpnoôci zostaîy  wysîane  przez
                              Ciebie do danej osoby
kursywa          do           informacje  o  dostëpnoôci  zostaîy  wysîane  do
                              Ciebie przez danâ osobë
kursywa          brak         brak wymiany informacji o dostëpnoôci
wytîuszczony     proôba       proôba o dopisanie oczekuje na decyzjë

Informacje o statusie dopisania dostëpne sâ takûe w @{" oknie informacyjnym " link "window-info"}.


@{b}@{i}Dopisywanie opcjâ "Dodaj kontakt" z menu "Lista"@{ub}@{ui}

Po wybraniu opcji "Dodaj kontakt" z menu  "Lista"  i  klikniëciu  na  gadûecie
"Dopisz" w @{" oknie dodawania kontaktów " link "window-contact"}, proôba o dopisanie  zostanie  wysîana
do nowego  kontaktu.  Po  otrzymaniu  takiej  proôby  automatycznie  otworzone
zostanie @{" okno proôby o dopisanie " link "window-subscriptions"} i odbiorca  bëdzie  mógî  jâ  zaakceptowaê
lub odrzuciê  klikajâc  na  odpowiednim  gadûecie.  Akceptacja  spowoduje,  ûe
dostanie wysîana do Ciebie informacja i Jabberwocky wyôwietli na Twojej liôcie
przy danej osobie ikonkë @{" obecnoôci " link "presence"}.  Na  liôcie  osoby  akceptujâcej  Twojâ
proôbë utworzona zostanie pozycja zawierajâca Twoje  dane.  OSoba  ta  powinna
teraz  kliknâê  na  tej  pozycji i wybraê opcjë "Dopisz" znajdujâcâ sië w menu
"Lista". Gdy tak sië stanie, proôba o dopisanie zostanie odesîana  do  Ciebie,
co  spowoduje  pojawienie  sië  na  ekranie  okna  proôby  o  dopisanie. Jeôli
zaakceptujesz të proôbë, klikajâc na gadûecie "Akceptuj", informacja  zostanie
odesîana  do  nadawcy,  który  ujrzy  ikonkë  obecnoôci  na swojej liôcie przy
pozycji dotyczâcej Twojej osoby.  Od  tego  momentu  obie  osoby  bëdâ  zawsze
wiedziaîy o wzajemnej obecnoôci w systemie.


@{b}@{i}Dopisywanie opcjâ "Dopisz" z menu "Lista"@{ub}@{ui}

Otrzymawszy proôbë  o  dopisanie  od  innego  uûytkownika,  zakîadajâc  ûe  jâ
zaakceptujesz,  powinieneô  wysîaê  analogicznâ  proôbë  do  niego. W tym celu
kliknij na nowej, dotyczâcej tej osoby  pozycji  na  liôcie  i  wybierz  opcjë
"Dopisz"  z  menu  "Lista".  Proôba  zostanie  wtedy wysîana, a jej akceptacja
zaowocuje aktywacjâ ikonki @{" obecnoôci " link "presence"} przy pozycji dla tej osoby na Twojej
liôcie.

Gdy otrzymasz wiadomoôê od  osoby  nie  bëdâcej  na  Twojej  liôcie,  zostanie
stworzona  tymczasowa  pozycja, posiadajâca ikonkë wiadomoôci. Jeôli chcesz na
staîe dodaê të osobë do listy kliknij na  tej  pozycji  i  wybierz  wspomnianâ
opcjë  "Dopisz"  z  menu.   Pozycja  zostanie   zmieniona  na  staîâ, a proôba
o  dopisanie  wysîana.  Akceptacja  i  odesîanie  proôby  przez  drugâ  stronë
spowoduje aktywacjë  ikonki @{" obecnoôci " link "presence"} i wyôwietlenie  przez Jabberwocky'ego
@{" okna proôby o dopisanie " link "window-subscriptions"}. Akceptacja z Twojej strony zaktywuje dotyczâcâ Cië
ikonkë obecnoôci na liôcie drugiej osoby. Od  tego  momentu  obie  osoby  bëdâ
zawsze wiedziaîy o wzajemnej obecnoôci w systemie.

@endnode

@node "presence" "Obecnoôê"
@toc "tech"

@{b}@{u}Obecnoôê@{ub}@{uu}

System obecnoôci Jabber zapewnia dostarczanie informacji  o  obecnoôci  danych
uûytkowników  i usîug. Kaûdy wîaôciciel identyfikatora Jabbera moûe informowaê
o swojej obecnoôci dowolnego innego  uûytkownika  po  uprzednim  @{" dopisaniu " link "subscription"}.
Obecnoôê moûe byê okreôlona na dwa sposoby, a mianowicie uûytkownik  moûe  byê
"dostëpny"   (otrzymuje   on   wtedy   wszystkie  wiadomoôci  bezpoôrednio  po
przesîaniu) lub "niedostëpny" (w danej chwili nie moûe otrzymywaê wiadomoôci).

Jabberwocky   informuje   o   obecnoôci  za  pomocâ  odpowiedniego  @{" obrazka " link "images"}
(odpowiedniej ikonki) przy kaûdej pozycji na @{" liôcie " link "roster"}. Dotyczy to tylko  tych
kontaktów, które wczeôniej zostaîy dopisane. Osoby niedopisane  pozbawione  sâ
ikonki,  a  dopiero  po  otrzymaniu od nich wiadomoôci uzyskujâ wîaônie ikonkë
wiadomoôci. Jabberwocky pokazuje  teû  aktualny  status  osoby,  wykorzystujâc
w tym celu ikonki obecnoôci. Poniûej znajduje sië wykaz ikonek i ich znaczeï.

@{u}Ikonka@{uu}                 @{u}Obecnoôê@{uu}       @{u}Status@{uu}
ôwiecâca ûarówka       dostëpny       poîâczony
przygaszona ûarówka    dostëpny       chwilowo nieobecny
zgaszona ûarówka       niedostëpny    niepoîâczony
uômiechniëta twarz     dostëpny       moûe rozmawiaê
znak NA                dostëpny       nieobecny na dîuûej
znak DND               dostëpny       nie przeszkadzaê

Informacje o obecnoôci i statusie dostëpne sâ takûe w @{" oknie informacyjnym " link "window-info"}.

Informacje o Twojej dostëpnoôci wysyîane do  innych  uûytkowników  zdefiniowaê
moûesz  w  oknie  gîównym  w  zakîadce  "Obecnoôê". Dokonasz  tego korzystajâc
z gadûetu cyklicznego. Dodatkowo wypeîniê moûesz (nie jest to  konieczne) pole
"Uwagi", przeznaczone na wiadomoôci dotyczâce statusu Twojej dostëpnoôci. Bëdâ
one wyôwietlone w oknie informacyjnym.

@endnode

@node "register" "Rejestracja"

@{b}@{u}Rejestracja@{ub}@{uu}

Przed korzystaniem z wiëkszoôci @{" usîug Jabbera " link "agents"} musisz  przeprowadziê  proces
rejestracji danej usîugi. Poszczególne usîugi majâ róûne  wymagania  dotyczâce
tego procesu, ale uzyskasz stosowne informacje przy rozpoczëciu rejestracji.

Niektóre usîugi dziaîajâ jak pomosty  miëdzy  innymi  systemami  bezpoôredniej
komunikacji  typu  ICQ  i  AIM.  Systemy  owe  wymagajâ hasîa i identyfikatora
uûytkownika,  które  podaê  za  Ciebie  musi  wîaônie  usîuga  okreôlana  jako
"transport".  Nazwë   uûytkownika, hasîo i  pseudonim bëdziesz mógî wprowadziê
w  odpowiednim oknie przy rejestracji usîugi  "transport". Jabberwocky przeôle
te dane, a  na Twojej  @{" liôcie " link "roster"} pojawi sië pozycja dotyczâca  wymiany  miëdzy
systemami. Teraz moûesz dodawaê kontakty korzystajâc z tego typu pozycji.

Usîuga Jabber User Directory (JUD) nie wymaga rejestracji jeôli  chcesz  tylko
szukaê  innych  uûytkowników.  Natomiast  rejestracja  jest niezbëdna aby inne
osoby mogîy znaleúê Ciebie i nawiâzaê z Tobâ kontakt. Wiëkszoôê  wprowadzanych
podczas  rejestracji tej usîugi danych nie jest obligatoryjna, tak wiëc moûesz
upubliczniê tylko te dane, które sobie ûyczysz.

Usîugi  Jabbera  udostëpniane  przez  wykorzystywany   przez   Ciebie   serwer
wyôwietlane sâ w @{" oknie listy usîug " link "window-agents"}. Tam  teû  moûna  usîugë  zarejestrowaê,
klikajâc na jednej z nich, a nastëpnie na gadûecie "Rejestruj" na  dole  okna.
Wiëcej  na  temat  poszczególnych usîug znajdziesz w rozdziale @{" usîugi " link "agents"}.

@endnode

@node "agents" "Usîugi"
@toc "tech"

@{b}@{u}Usîugi@{ub}@{uu}

Serwer Jabbera zîoûony jest  z  pewnej  liczby  elementów.  Jego  poszczególne
czëôci  odpowiadajâ  za  podstawowe  usîugi systemu bezpoôredniej komunikacji,
przechowywanie danych i  wymianë  informacji  miëdzy  serwerami  niezbëdnâ  do
dziaîania  systemu  Jabbera. Zarówno konfiguracja tych elementów, jak i majâca
miejsce dziëki nim komunikacja realizowana jest za  pomocâ  protokoîu  Jabbera
zwanego  XML  (ang.  Extensible  Markup  Language). Wszystkie skîadowe systemu
dostëpne sâ za  pomocâ  identyfikatorów,  ale  tylko  te,  które  bezpoôrednio
wspóîpracujâ   z   klientami   (uûytkownikami)   osiâgalne   sâ  wprost  przez
programy-klienty. Okreôlane sâ one jako usîugi.

Usîugi obejmujâ miëdzy innymi  przeszukiwanie  bazy  danych  o  uûytkownikach,
wymianë  komunikatów  miëdzy  róûnymi systemami bezpoôredniej komunikacji oraz
prowadzenie konferencji. Podczas îâczenia sië z serwerem  Jabberwocky  pobiera
listë  udostëpnianych  przez  niego usîug. Informacje o usîugach i same usîugi
dostëpne sâ w @{" oknie listy usîug " link "window-agents"}, które wyôwietliê  moûna  wybierajâc  opcjë
"Lista usîug" z menu "Okna". Usîugi  ukazane  sâ  na  liôcie,  której  kolumny
wskazujâ  na  typ  oferowanej  usîugi.  Po klikniëciu na pozycji w oknie moûna
wybraê odpowiedni gadûet na dole okna. Gadûety niedostëpne  dla  danej  usîugi
bëdâ nieaktywne.

Róûne usîugi wymagajâ róûnych sposobów aktywacji  i  uûytkowania,  dlatego  te
najbardziej  popularne  opisane sâ w oddzielnych rozdziaîach. Poniûej znajduje
sië ich wykaz.

  @{" Jabber User Directory " link "directory"}

  @{" Jabber Transports     " link "transports"}

  @{" Konferencje           " link "conference"}

  @{" Inne usîugi Jabbera   " link "misc_agents"}

@endnode

@NODE "images" "Obrazki"
@toc "tech"

@{B}@{U}Obrazki@{ub}@{UU}

Podczas  uruchamiania  Jabberwocky  przeszukuje  katalog  "Jabberwocky/Images"
w poszukiwaniu   wybranych   przez   uûytkownika  obrazków  pojawiajâcych  sië
na @{" liôcie kontaktów " link "roster"}. Jeôli nie znajdzie obrazków w katalogu "Images", uûyje
wbudowanych obrazków do wyôwietlania na liôcie  kontaktów.  Obrazki  nadesîane
przez   uûytkowników   sâ   doîâczone   w   podkatalogach   katalogu  "Images"
(np. Images/Mason) i muszâ  zostaê przeniesione  do  katalogu  "Images"  jeôli
chesz, aby Jabberwocky wczytaî je podczas uruchamiania. Dodatkowe obrazki mogâ
zostaê utworzone przez uûytkownika  zgodnie  z  podanymi  poniûej  wytycznymi.
Dodatkowo    ikonki   ikonifikacji   programu   ("Jabberwocky_online.info"   i
Jabberwocky_offline.info") mogâ byê zastâpione  przez  dowolne  ikonki  (pliki
.info) wybrane przez uûytkownika.

Obrazki uûywane na liôcie kontaktów Jabberwocky'ego sâ wczytywane z normalnych
plików  IFF ILBM, zawierajâcych obrazki o szerokoôci 16 pikseli i wysokoôci 18
pikseli, wykorzystujâcych 4 bitplany  (16  kolorów).  Wielkoôê  16x18  zawiera
juû takûe  podklad,  który  powinien  byê przezroczysty podczas wyôwietlania w
programie. Trochë  wiëksze  lub  mniejsze  obrazki  mogâ byê  uûywane  w  celu
dopasowania do wielkoôci tekstu ustalonej w preferencjach MUI. Moûna uûywaê do
16 kolorów (îâcznie z kolorem oznaczonym jako  przezroczysty  kolor  tîa)  dla
kaûdego  z  obrazków.  Jabberwocky  wczyta  i  uûyje  wîaôciwych plików ILBM o
nastëpujâcych nazwach:
    
@{U}Nazwa pliku@{UU}   @{U}Przeznaczenie@{uu}
avail.iff --- obrazek @{I}dostëpny@{UI}.
away.iff ---- obrazek @{I}chwilowo nieobecny@{UI}.
chat.iff ---- obrazek @{I}dostëpny@{UI}.
dnd.iff ----- obrazek @{I}nie przeszkadzaê@{UI}.
msg.iff ----- obrazek @{I}wiadomoôê@{UI}.
unavail.iff - obrazek @{I}niedostëpny@{UI}.
xaway.iff --- obrazek @{I}nieobecny na dîuûej@{UI}.

@endnode

@node "faq" "Najczëôciej zadawane pytania (FAQ)"

@{b}@{u}Najczëôciej zadawane pytania (FAQ)@{ub}@{uu}


P: Bez problemów korzystam z Jabbera na Amidze do prowadzenia rozmów z  kolegâ
   dziaîajâcym w systemie MSN, ale nie mogë przesyîaê mu  (ani  otrzymywaê  od
   niego) plików...

O: Jest to  zapewne  problem  zwiâzany  z  usîugâ  wymiany  informacji  miëdzy
   systemami, a nie z programem Jabberwocky.  Jeôli  MSN  uûywa  innej  metody
   przesyîania  plików,  to usîuga powinna zadziaîaê jak poôrednik i przekazaê
   pliki przez serwer. Wiëkszoôê administratorów zapewne nie ûyczy sobie tego,
   wiëc opcja taka nie jest dostëpna lub zostaîa ona wyîâczona.


P: Niektórzy uûytkownicy  zauwaûyli problemy podczas  rozmów z  korzystajâcymi
   z StrICQ i Trilliana.  Wiadomoôci nie byîy  wyôwietlane,  bâdú  wyôwietlana
   byîa tylko ich czëôê.

O: Nowa wersja (beta) StrICQ uûywa nowego protokoîu ICQ, podczas gdy wiëkszoôê
   usîug Jabbera odpowiadajâcych  za  komunikacjë  z  ICQ  wciâû  korzysta  ze
   starego.  W  zwiâzku  z  tym rozmowë moûesz prowadziê tylko w jednâ stronë,
   uûywajâc starego protokoîu udostëpnianego  przez  Jabbera.  Jedynie  usîuga
   ICQv7  Transport  pozwala  na normalnâ rozmowë z osobâ posîugujâcâ sië ICQ.
   Spróbuj   poîâczyê   sië   z    posiadajâcym    usîugë    ICQv7    serwerem
   jabber.datenbank.org.

@endnode

@node "compile" "Kompilacja Jabberwocky'ego"

 Aby  skompilowaê  program  Jabberwocky  musisz  mieê  poprawnie zainstalowane
i dziaîajâce Geek Gadgets.

 Potrzebne bëdâ równieû poniûsze elementy.

MiamiSDK: http://www.nordicglobal.com/swdl.html - MiamiSDK211.lha
OpenURL: http://wuarchive.wustl.edu/~aminet/aminet.cgi?string=openurl - OpenURL.lha
MUI: http://wuarchive.wustl.edu/pub/aminet/info/www/dirs/dev_mui.html mui38dev.lha
MailText: http://sourceforge.net/projects/mailtext/ - MCC_Mailtext3_1.lha
NList: http://home.t-online.de/home/sebauer/ - MCC_NList.lha
TextEditor: http://www.diku.dk/students/duff/TextEditor/index.html - MCC_TextEditor.LZX
TextInput: http://www.vapor.com/download/pub/misc/ - textinput_293.lzx

Istniejâ  róûne  opinie  na  temat  tego,  jak wykorzystywaê GG i inkludy.  Ja
obecnie  robië to tak, ûe kopiujë  wszystkie inkludy do  oddzielnego katalogu,
a  nastëpnie  równieû  do  katalogu  gg:local/include.   W ten sposób, gdy coô
pójdzie  nie tak, moûna zawsze wróciê do  wyjôciowej sytuacji kasujâc wszystko
i ponownie przegrywajâc inkludy z zapasowego katalogu.

Niezaleûnie od tego, jak zdecydujesz sië postâpiê, bëdziesz musiaî inkludy
odpowiednio przygotowaê.

Coô  dziwnego  jest  w  inkludach MUI - bez dokonania powaûnych zmian bëdâ one
doîâczaîy  dziwne  funkcje  do kaûdego wywoîania funkcji w kaûdym obiekcie, co
powoduje  caîkowity  chaos  przy  prcesie linkowania.  Îatka proto_muimaster.h
zapobiega tym zachowaniom nie pozwalajâc na wîâczenie inline/muimaster.h.

Jabberwocky równieû definiuje ponownie MUI_NewObject, wiëc  ta  czëôê  zostaîa
zaznaczona  jako  komentarz przez inline_muimaster.h.patch. Z pewnych wzglëdów
uint32 zostaîo wygenerowane z pliku Miami FD, co  musi  byê  zastâpione  przez
ULONG przez inline_socket.h.patch

Napisaîem skrypt, który rozpakuje archiwa, stworzy potrzebne pliki i wprowadzi
niezbëdne zmiany.

@{b}SKRYPT TEN SKASUJE gg:local/include ORAZ gg:local/includesources!!!@{ub}

Nie  uruchamiaj  go  zatem,  dopóki  nie  jesteô  pewien,  ûe nie spowoduje on
zniszczeï.   Chcâc  skorzystaê  z  tego  skryptu, skopiuj src/makeinclude/* do
gg:local/  razem  z  wczeôniej  wspomnianymi archiwami i uruchom makeincludes.
Moûesz  oczywiôcie  równieû przeanalizowaê skrypt i wybraê inne, odpowiadajâce
Ci rozwiâzanie.

Jeôli  znasz  lepsze rozwiâzanie moich problemów z inkludami MUI, chciaîbym je
usîyszeê.

@endnode

@node "history" "Historia"

@{b}@{u}Historia@{ub}@{uu}

V1.4 (28.10.03)
====

* Obsîuga 8-bitowych znaków w Latin-1.
* Poprawiono  przezroczystoôê  ikonek  w  oknie  kontaktów   (dziëki   Jeffowi
  Gilpinowi).
* Poprawiono hit Enforcera podczas usuwania kontaktów  (takûe  dziëki  Jeffowi
  Glippinowi jako efekt uboczny poprawienia przezroczystoôci).
* Obsîuga wyôwietlania bîëdów w oknie kontaktów  (ale  jak  do  tej  pory  nie
  znalazîem ûadnych bîëdów wîâczajâcych to, wiëc albo to nie dziaîa, albo  nie
  mam ûadnych bîëdów).
* Poprawiono hit enforcera podczas automatycznego îâczenia  przy  uruchamianiu
  programu, a ûadne konto nie jest zdefiniowane  (bîâd  wprowadzono  w  wersji
  1.3).
* Lista kontaktów wyôwietla ikonki  zdarzeï  dopóki  wszystkie  nieprzeczytane
  wiadomoôci nie zostanâ odczytane.
* Ikonki  listy  kontaktów  mogâ byê  wczytywane  z  dysku   (dziëki   Jeffowi
  Gilpinowi).
* Zestaw ikonek dla listy kontaktów (Martin 'Mason' Merz).
* Ikonki ikonifikacji (Jeff Gilpin).
* Poprawiono domyôlnâ ikonkë ikonifikacji (dziëki Jeffowi Gilpinowi).
* Niemieckie tîumaczenie (Matthias Münch).
* Holenderskie tîumaczenie (Djordje Slocuk <s.slocuk1@chello.nl>)
* Polskie  tîumaczenie  (Kamil   Nieôcioruk   <kniescio@biotop.umcs.lublin.pl>
  i Mariusz Danilewicz <mandi@interia.pl>).
* Portugalskie tîuamczenie (Raul Silva <luarsilva@mail.telepac.pt>).
* Serbskie tîumaczenie (Djordje Slocuk <s.slocuk1@chello.nl>).
* Hiszpaïskie tîumaczenie (Roger Barranco <cebollino@lycos.es>).
* Aktywowano pomoc online (dziëki Jeffowi Gilpinowi).
* Na raz  wyôwietlana  jest tylko  jedna proôba o  dopisanie od  jednej  osoby
  (dziëki Jeffowi Gilpinowi).


V1.3
====

* Usuniëto  dwa  hity  Enforcera, o których  poinformowaî  mnie  Luca "Hexaae"
  Longone.
* Lokalizacja znakomitej wiëkszoôci okien.
* Francuskie tîumaczenie.
* Kataloïskie tîumaczenie.
* Automatyczne îâczenie przy starcie juû dziaîa.
* Preferencje raportowania sâ zapisywane i uûywane.
* Preferencje  automatycznej  ikonifikacji  przy  starcie   zostaîy   usuniëte
  (uûywane sâ preferencje MUI).
* Moûna uûywaê okien rozmów do  odbierania  wiadomoôci  i  na  odwrót  (zobacz
  preferencje)
* Usuniëto hity Eforcera.
* Usuniëto problem zwiâzany z przepeînianiem bufora.
* Drobne usprawnienia obsîugi Unicode.


V1.2
====

* Usuniëto kompromitujâcy hit Enforcera.


V1.1
====

* Kod úródîowy opublikowany na warunkach Powszechnej Licencji Publicznej GNU.
* Gürer Özen nie odpowiada juû za rozwój Jabberwocky'ego.
* Nowa dokumentacja (podziëkowania dla Jeffa Gilpina).
* Poprawki zwiâzane  z  bîëdami  na  liôcie  wystëpujâcymi  podczas  usuwania,
  dopisywania i aktualizaji kontaktów.
* Odczytywanie  wiadomoôci  przy  uûyciu  mailtext.mcc  -  konfiguracja  klasy
  dostëpna w preferencjach MUI.
* Kategoria "Zdarzenia" w preferencjach juû dziaîa.
* Lepsze sygnalizowanie kontaktów podczas procesu dopisywania.
* Dodawanie kontaktów juû nie powoduje bîëdów w imionach uûytkowników.

V1.0
====

Pierwsza publicznie dostëpna wersja.

@endnode

@node "future" "Plany na przyszîoôê"

@{b}@{u}Plany na przyszîoôê@{ub}@{uu}

* Wyeliminowanie bîëdów - jest ich duûo :)
* Lokalizacja
* API dodatków w celu rozszerzenia moûliwoôci protokoîu Jabbera.
* Zwiëkszenie liczby poleceï ARexx'a.
* Obsîuga VCard.
* Kartoteka i historia wiadomoôci.
* Poîâczenia z serwerami przy wykorzystaniu SSL/HTTP.

Moûesz  przyczyniê  sië   do   rozwoju   Jabberwocky'ego   wysyîajâc   autorom
@{b}oryginalne@{ub} opracowania  (ikonki,  znaczki  formowe  itp.),  efekty   dúwiëkowe
odpowiadajâce róúnym zdarzeniom oraz uûyteczne skrypty ARexx'a.

@endnode

@node "thanks" "Podziëkowania"

@{b}@{u}Podziëkowania@{ub}@{uu}

* Gürer Özen - za rozwijanie Jabberwocky'ego.

* Tom Parker, Matthias Münch - za dalszy rozwój  programu,  stworzenie  strony
  internetowej Jabberwocky'ego i utworzenie dedykowanej mu listy dyskusyjnej.

* Jeff Gilpin - za aktualizacjë dokumentacji.


Gürer Özen chciaîby podziëkowaê:

* Jeremie Miller oraz innym twórcom Jabbera za opracowanie  i  zaprogramowanie
  tak dobrego systemu bezpoôredniej komunikacji.

* Jacob Laursen - za przejëcie Amstera, co pozwoliîo mi poôwiëciê wiëcej czasu
  pracy nad programem Jabberwocky.

* Ralph Schmidt, Emmanuel Lesueur - za MorphOS-a, wersjë ixemul na  ppc,  gcc,
  ade, i pomoc przy portowaniu programu.

@endnode

@NODE "GNU License" "Powszechna Licencja Publiczna GNU"

@{B}@{U}Powszechna Licencja Publiczna GNU@{ub}@{UU}

                      Powszechna Licencja Publiczna GNU
                           Wersja 2, czerwiec 1991

 Copyright (C) 1989, 1991 Free Software Foundation, Inc.
 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 Zezwala sië na kopiowanie  i  rozpowszechnianie  wiernych  kopii  niniejszego
 dokumentu licencyjnego, jednak bez prawa wprowadzania zmian.

        Preambuîa

  Wiëkszoôê licencji na oprogramowanie  pomyôlana  jest  po  to,  aby  odebraê
uûytkownikowi moûliwoôê swobodnego udostëpniania  innym  i  zmieniania  danego
software'u. Natomiast w wypadku Powszechnej Licencji Publicznej GNU celem jest
zagwarantowanie  uûytkownikowi  swobody  udostëpniania   i   zmieniania   tego
bezpîatnego  oprogramowania,  a  wiëc  danie  pewnoôci, iû oprogramowanie jest
wolno dostëpne dla  wszystkich  uûytkowników.  Niniejsza  Powszechna  Licencja
Publiczna   dotyczy   wiëkszoôci   oprogramowania  wydawanego  przez  Fundacjë
Wolnodostëpnego  Oprogramowania  (Free  Software  Foundation)  oraz  wszelkich
innych programów, których autorzy zobowiâzujâ sië do jej stosowania. (Niektóre
rodzaje oprogramowania wydawanego przez Fundacjë objëte sâ Powszechnâ Licencjâ
Publicznâ  GNU  dla  Bibliotek). Uûytkownik moûe stosowaê jâ równieû do swoich
programów.

  Mówiâc o wolnodostëpnym oprogramowaniu mamy na myôli swobodë,  a  nie  cenë.
Nasze Powszechne Licencje Publiczne wprowadzono po to,  aby  zapewniê  Païstwu
swobodë  rozpowszechniania  kopii  tego  oprogramowania  (i  - jeôli ktoô chce
- pobierania za të usîugë opîaty), jak równieû  aby  udostëpniê  kod  úródîowy
oraz  umoûliwiê dokonywanie zmian tego oprogramowania lub wykorzystywania jego
fragmentów w nowych, wolnodostëpnych programach. Nie bez  znaczenia  jest  teû
sama   moûliwoôê   dotarcia   do   Païstwa  z  informacjâ  o  wszystkich  tych
udogodnieniach.

  W celu ochrony praw uûytkownika jesteômy  zmuszeni  wprowadzaê  ograniczenia
zabraniajâce komukolwiek kwestionowanie jego praw albo sugerowanie  rezygnacji
z tych praw. Ograniczenia te sprowadzajâ sië do pewnych dla Païstwa obowiâzków
w przypadku rozpowszechniania przez  Was  kopii  naszego  oprogramowania  bâdú
dokonywania w nim zmian.

  Na  przykîad,  jeôli  rozprowadzacie   Païstwo   kopie   takiego   programu,
niezaleûnie czy gratisowo, czy za opîatâ, musicie  Païstwo  odbiorcy  udzieliê
wszelkich  tych  praw,  jakie  mieliôcie  sami.  Musicie  zapewniê  mu równieû
otrzymanie  kodu  úródîowego  (lub  moûliwoôê  otrzymania)  oraz   przedstawiê
niniejsze Warunki, aby mógî on poznaê swoje prawa.

Ochrona Païstwa praw przebiega w dwóch etapach:
    1. zastrzegamy prawo wîasnoôci autorskiej do oprogramowania,
    2. oferujemy Païstwu niniejszâ  licencjë,  która  daje  Wam  sankcjonowane
       prawem zezwolenie na kopiowanie, rozpowszechnianie i/lub  modyfikowanie
       tego oprogramowania.

  Ponadto dla ochrony tak autora, jak i naszej,  pragniemy  mieê  pewnoôê,  ûe
kaûdy zrozumie, iû na niniesze wolnodostëpne oprogramowanie  nie  udziela  sië
gwarancji.  W razie dokonania w nim przez kogoô modyfikacji i puszczenia dalej
do obrotu, pragniemy, aby dalsi odbiorcy  zdawali  sobie  sprawë  z  tego,  ûe
problemy  wprowadzone  przez  inne  osoby  nie sâ wyrazem oryginalnych dziaîaï
twórców.

  I rzecz ostatnia: kaûdemu wolnodostëpnemu programowi stale zagraûajâ patenty
na oprogramowanie. Naszym pragnieniem jest unikanie takiego niebezpieczeïstwa,
kiedy  redystrybutorzy  wolnodostëpnego  programu indywidualnie uzyskujâ prawa
patentowe, nadajâc tym samym programowi charakter prawnie zastrzeûony. W  celu
zapobieûenia  takim zjawiskom jednoznacznie wyjaôniliômy, ûe kaûdy patent musi
byê wydawany albo dla swobodnego uûytku przez wszystkich,  albo  nie  wydawany
wcale.

  Poniûej  podajemy  dokîadne  zasady i warunki  kopiowania, rozpowszechniania
i modyfikowania.

                      Powszechna Licencja Publiczna GNU
        Zasady i warunki kopiowania, rozpowszechniania i modyfikowania

  0. Niniejsza  Licencja  dotyczy  programów  i  innych   prac,   na   których
     umieszczona jest pochodzâca od wîaôciciela praw autorskich informacja, ûe
     dany  program lub praca moûe byê rozpowszechniana na warunkach niniejszej
     Powszechnej Licencji Publicznej. Uûywane poniûej sîowo "Program"  oznacza
     wîaônie  takie  programy  lub  prace,  zaô  okreôlenie  "praca  oparta na
     Programie" dotyczy  albo  Programu,  albo  pochodzâcej  od  niego   pracy
     w rozumieniu  prawa autorskiego, to jest  pracy zawierajâcej  Program lub
     jego czëôê dosîownâ, bâdú zmodyfikowanâ i/lub przeîoûonâ  na  inny jëzyk.
     (W dalszym ciâgu niniejszego, pojëcie przekîadu wîâcza sië bez ograniczeï
     do terminu "modyfikacja"). Do kaûdego licencjobiorcy bëdziemy zwracaê sië
     "per Ty".

     Niniejsza  Licencja  nie  obejmuje   dziaîaï   innych   niû   kopiowanie,
     rozprowadzanie  i  modyfikowanie  -  nie mieszczâ sië one w jej zakresie.
     Czynnoôê uûywania Programu nie jest  poddana  ograniczeniom,  a  produkty
     uzyskane z Programu objëte sâ Licencjâ tylko wtedy, gdy ich treôê stanowi
     pracë opartâ na Programie (niezaleûnie  od  stworzenia  jej  przy  uûyciu
     Programu). To, czy fakt taki jest prawdâ, zaleûy od tego, co dany Program
     wykonuje.

  1. Moûesz kopiowaê i rozprowadzaê w  dowolnych  mediach  wierne  kopie  kodu
     úródîowego Programu w otrzymanej formie  pod  warunkiem,  ûe  w  widoczny
     sposób  i odpowiednio podasz na kaûdej kopii wîaôciwâ informacjë o prawie
     autorskim i zrzeczenie sië uprawnieï z tytuîu gwarancji; wszelkie  napisy
     informacyjne  na  temat  Licencji  i faktu nieudzielania gwarancji musisz
     chroniê przed uszkodzeniem, zaô wszystkim innym odbiorcom Programu musisz
     wraz z Programem wrëczaê egzemplarz niniejszej Licencji.

     Moûesz pobieraê opîatë za fizycznâ czynnoôê przekazania  kopii  i  wedîug
     wîasnej decyzji moûesz za opîatâ proponowaê ochronë gwarancyjnâ.


  2. Moûesz modyfikowaê swojâ kopië  czy  kopie  Programu  oraz  dowolne  jego
     czëôci, tworzâc przez to pracë opartâ na Programie, jak równieû  kopiowaê
     i  rozprowadzaê  takie  modyfikacje i pracë na warunkach podanych w pkt.
     1. powyûej - pod warunkiem przestrzegania caîoôci poniûszych wymogów:

       a) Musisz spowodowaê umieszczenie na zmodyfikowanych plikach  widocznej
          informacji o tym, ûe dane pliki zostaîy przez ciebie zmienione, wraz
          z datâ dokonania zmian.

       b) Musisz  doprowadziê  do  tego,  aby   kaûda   rozpowszechniana   lub
          publikowana przez ciebie praca, która w caîoôci lub  czëôci  zawiera
          Program,  albo  pochodzi  od niego  lub jego  czëôci, byîa w caîoôci
          i  bezpîatnie  licencjonowana  dla   wszelkich  stron   trzecich  na
          warunkach niniejszej Licencji.

       c) Jeûeli zmodyfikowany program podczas korzystania z niego w normalnym
          trybie odczytuje polecenia interaktywnie, musisz spowodowaê, aby  po
          uruchomieniu  (uûyty w interaktywny sposób w najzwyklejszym trybie),
          wydrukowywaî on  lub  wyôwietlaî  powiadomienie  o  odnoônym  prawie
          autorskim  i  braku  gwarancji  (ewentualnie o zapewnianiu gwarancji
          przez ciebie), oraz o tym, ûe uûytkownicy  mogâ  redystrybuowaê  ten
          program  na  niniejszych warunkach wraz z informacjâ, jak uûytkownik
          moûe zapoznaê sië z treôciâ niniejszej Licencji. (Wyjâtek: jeôli sam
          Program   jest  interaktywny,  ale  normalnie  nie  drukuje  takiego
          powiadomienia, twoja praca oparta na nim teû nie  musi  wydrukowywaê
          takiego powiadomienia).

     Niniejsze wymogi odnoszâ sië do zmodyfikowanej pracy jako caîoôci.  Jeôli
     dajâce sië ustaliê sekcje danej pracy nie pochodzâ od Programu i mogâ byê
     racjonalnie uwaûane za samodzielne i odrëbne same w sobie,  to  niniejsza
     Licencja  i  jej  warunki  nie  majâ  zastosowania  do takich sekcji przy
     rozprowadzaniu  ich  przez  ciebie  jako  odrëbne  prace.  Jeôli   jednak
     rozprowadzasz  je  jako czëôê caîoôci, bëdâcej pracâ opartâ na Programie,
     rozpowszechnianie tej caîoôci musi byê dokonywane na warunkach niniejszej
     Licencji,  której  zezwolenia  dla innych  licencjobiorców rozciâgajâ sië
     w caîej szerokoôci na të caîoôê, a tym samym i na kaûdâ indywidualnâ  jej
     czëôê, niezaleûnie od jej autorstwa.

     Dlatego teû intencjâ tego fragmentu nie jest roszczenie sobie  praw  albo
     podwaûanie  twych  praw do pracy napisanej w caîoôci przez ciebie. Chodzi
     nam  raczej o  korzystanie z prawa  kontrolowania dystrybucji  pochodnych
     i zbiorowych prac opartych na Programie.

     I jeszcze jedno: samo tylko poîâczenie z Programem (lub z pracâ opartâ na
     Programie)  innej  pracy  -  nie  opartej na Programie, w ramach wolumenu
     noônika przechowywania lub dystrybucji, nie powoduje objëcia takiej pracy
     zakresem niniejszej Licencji.

   3. Moûesz kopiowaê i rozprowadzaê  Program  (lub  opartâ  na  nim  pracë  -
      - zgodnie z pkt.2 w kodzie wynikowym lub w  formie wykonywalnej  w  myôl
      postanowieï  pkt. 1. i  2. powyûej, pod  warunkiem zrealizowania równieû
      poniûszych wymogów:

        a) Musisz doîâczyê do niego odpowiadajacy mu, kompletny i  moûliwy  do
           odczytania przez urzâdzenia cyfrowe kod úródîowy,  który  musi  byê
           rozpowszechniany  na  warunkach  pkt. 1. i 2. powyûej  i na noôniku
           zwyczajowo uûywanym dla wzajemnej wymiany oprogramowania; lub

        b) doîâczyê do  niego  pisemnâ  ofertë,  waûnâ  co  najmniej  3  lata,
           przyznajâcâ kaûdej stronie trzeciej - za opîatâ nie  przekraczajâcâ
           twego kosztu fizycznego wykonywania dystrybucji úródîa - kompletnâ,
           odczytywalnâ przez urzâdzenia cyfrowe kopië odpowiadajâcego mu kodu
           úródîowego,  rozprowadzanâ  na  warunkach  pkt. 1. i 2. powyûej, na
           noôniku zwyczajowo uûywanym do  wzajemnej  wymiany  oprogramowania;
           lub

        c) doîâczyê do niego  informacjë,  jakâ  otrzymaîeô  na  temat  oferty
           rozprowadzania  odpowiedniego  kodu   úródîowego.   (Ta   moûliwoôê
           dozwolona  jest tylko dla dystrybucji niehandlowej i jedynie wtedy,
           gdy  otrzymaîeô  dany  program  w  kodzie  wynikowym   lub   formie
           wykonywalnej  wraz  z  wymienionâ ofertâ - zgodnie z podpunktem "b"
           powyûej).

      Okreôlenie kod úródîowy dla pracy oznacza formë  pracy  preferowanâ  dla
      wprowadzania  do  niej  modyfikacji.  Dla wykonanej pracy, kompletny kod
      úródîowy  oznacza  caîy  kod  úródîowy  wszystkich   moduîów,   wszelkie
      sprzëûone  z  niâ  poôredniczâce  pliki  opisujâce  oraz  zbiory  komend
      stosowane do sterowania kompilacjâ i instalowaniem  programów.  Niemniej
      jednak,  jako  wyjâtek specjalny, dystrybuowany (w formie úródîowej albo
      binarnej) kod úródîowy nie musi obejmowaê  niczego,  co  jest  normalnie
      rozprowadzane  przy pomocy gîównych komponentów (kompilator, jâdro itd.)
      systemu operacyjnego, na którym pracuje czëôê egzekutowalna, o  ile  sam
      taki komponent towarzyszy tej czëôci.

      Jeôli dystrybucja czëôci egzekutowalnej albo kodu wynikowego realizowana
      jest  poprzez  oferowanie  dostëpu  do  kopii z wyznaczonego miejsca, to
      oferowanie równowaûnego dostëpu dla kopiowania kodu  úródîowego  z  tego
      samego  miejsca  liczy sië jako rozpowszechnianie kodu úródîowego, nawet
      gdy strony trzecie nie sâ zmuszone do kopiowania  úródîa  wraz  z  kodem
      wynikowym.

  4. Poza przypadkami jednoznacznie dozwolonymi  w  niniejszej  Licencji,  nie
     moûesz  kopiowaê,  modyfikowaê,  sublicencjonowaê   ani   rozpowszechniaê
     Programu.  We  wszystkich pozostaîych wypadkach, kaûda próba skopiowania,
     sublicencjonowania   lub   rozpowszechnienia  Programu   jest    niewaûna
     i  powoduje  automatyczne  wygaôniëcie  twoich  praw z  tytuîu  Licencji.
     Niemniej jednak, stronom, które juû  otrzymaîy od ciebie kopie albo prawa
     w ramach niniejszej Licencji, licencje nie wygasajâ  tak dîugo, jak dîugo
     strony te w peîni stosujâ sië do nich.

  5. Nie musisz akceptowaê niniejszej Licencji,  jeûeli  jej  nie  podpisaîeô.
     Niemniej jednak, nic innego nie zapewni ci  zezwolenia  na  modyfikowanie
     lub rozprowadzanie Programu i pochodzâcych od niego prac. Dziaîania takie
     sâ  prawnie  zabronione,  jeûeli  nie  przyjmujesz  niniejszej  Licencji.
     Dlatego  teû,  poprzez modyfikowanie bâdú rozpowszechnianie Programu (lub
     pracy na  nim opartej) dajesz  wyraz  swojej   akceptacji  dla   Licencji
     i wszelkich    jej   postanowieï   i   warunków   dotyczâcych  kopiowania,
     rozprowadzania i modyfikowania Programu lub opartych na nim prac.

  6. W kaûdym przypadku redystrybucji przez ciebie Programu (albo  opartej  na
     nim pracy), odbiorca automatycznie otrzymuje od pierwotnego licencjodawcy
     licencjë  na  kopiowanie,  rozpowszechnianie  i modyfikowanie Programu na
     niniejszych  zasadach  i   warunkach.  Na   korzystanie  przez   odbiorcë
     z udzielonych w niniejszej Licencji praw nie moûesz narzucaê juû dalszych
     ograniczeï. Nie jesteô stronâ odpowiedzialnâ za  kontrolë  przestrzegania
     Licencji przez osoby trzecie.

  7. Jeôli na  skutek wyroku sâdowego  lub zarzutu naruszenia patentu, jak teû
     z  kaûdej  innej  przyczyny  (nie  ograniczonej  do  kwestii patentowych)
     zostanâ  narzucone  na ciebie (niezaleûnie czy  to mocâ wyroku  sâdowego,
     umowy,  czy  w inny sposób)  warunki  sprzeczne  z  warunkami  niniejszej
     Licencji, to  nie zwalniajâ  one ciebie z  warunków  Licencji.  Jeôli nie
     moûesz  prowadziê  dystrybucji  tak,  aby  wypeîniaê  jednoczeônie  swoje
     obowiâzki  z  tytuîu niniejszej  Licencji i  inne  odnoône  obowiâzki, to
     w rezultacie nie moûesz wcale  rozprowadzaê Programu. Na  przykîad, gdyby
     licencja   patentowa   nie   zewalaîa  na  wolnâ  od  opîat  licencyjnych
     redystrybucjë  Programu  przez  wszystkie  osoby,  które  otrzymaîy kopie
     bezpoôrednio lub poôrednio od ciebie, to jedynym sposobem pozwalajâcym ci
     na  przestrzeganie i  licencji patentowej, i  Licencji niniejszej, byîoby
     caîkowite powstrzymanie sië od jakiejkolwiek dystrybucji Programu.

     Jeûeli w jakichô szczególnych okolicznoôciach któryô fragment niniejszego
     punktu  staîby  sië  niewaûny  lub  niewykonywalny, to intencjâ jest, aby
     znajdowaîa zastosowanie pozostaîa czëôê punktu,  a  treôê  caîego  punktu
     byîa stosowana w pozostaîych okolicznoôciach.

     Celem niniejszego punktu nie jest zachëcanie do naruszania  patentów  czy
     innych  praw  wîasnoôci,  albo  teû do podwaûania ich waûnoôci; niniejszy
     punkt za swój jedyny cel ma ochronë integralnoôci wolnodostëpnego systemu
     rozpowszechniania  oprogramowania,  realizowanego  za  pomocâ publicznych
     licencji. Wielu ludzi bezinteresownie wniosîo swój  wkîad  do  stworzenia
     szerokiego  zakresu oprogramowania upowszechnianego w tym systemie, majâc
     zaufanie   do    konsekwentnego    jego    stosowania;    wyîâcznie    do
     autora/ofiarodawcy  naleûy  decyzja,  czy  ûyczy  on sobie rozprowadzania
     oprogramowania za poôrednictwem innego systemu i licencjobiorca nie  moûe
     tego prawa wyboru ograniczaê.

     Intencjâ niniejszego punktu jest jasne i wyraúne przedstawienie tego,  co
     uwaûa sië za skutki, jakie rodzi pozostaîa czëôê niniejszej Licencji.

  8. W przypadku, gdy dystrybucja i/lub uûywanie Programu w niektórych krajach
     poddane  jest  ograniczeniom   patentowym   lub   zastrzeûeniom   prawami
     autorskimi,  poczâtkowy  posiadacz praw autorskich, który poddaje Program
     pod oddziaîywanie niniejszej Licencji,  moûe  dodaê  wyraúnie  zakreôlone
     geograficzne  ograniczenie rozpowszechniania wyîâczajâce te kraje, dziëki
     czemu dystrybucja dozwolona bëdzie wyîâcznie w krajach czy  wôród  krajów
     nie  objëtych  takim  wyîâczeniem.  W przypadku takim, niniejsza Licencja
     obejmuje dane ograniczenie tak, jakby byîo ono wpisane w jej treôê.

  9. W miarë potrzeby Fundacja Wolnodostëpnego Oprogramowania moûe  publikowaê
     poprawione i/lub nowe wersje Powszechnej Licencji Publicznej. Takie  nowe
     wersje  bëdâ napisane w duchu podobnym do obecnej wersji, ale mogâ róûniê
     sië w szczegóîach poruszajâcych nowe problemy czy zagadnienia.

     Kaûdej wersji nadaje sië wyróûniajâcy jâ  numer.  Jeûeli  Program  podaje
     numer   wersji   niniejszej   Licencji,  odnoszâcy  sië   do  tej  wersji
     i "wszelkich wersji nastëpnych", masz  do  wyboru  albo  stosowaê  sië do
     postanowieï  i warunków tej wersji, albo którejkolwiek wersji póúniejszej
     wydanej przez Fundacjë Wolnodostëpnego Oprogramowania. O ile Program  nie
     podaje   numeru   wersji  nin  Licencji,  moûesz  wybraê  dowolnâ  wersjë
     kiedykolwiek opublikowanâ przez Fundacjë.

 10. Jeôli chcesz wîâczyê czëôci Programu do innych wolnodostëpnych programów,
     których  warunki rozpowszechniania sâ  inne, zwróê sië pisemnie do autora
     z proôbâ o pozwolenie. W przypadku oprogramowania objëtego przez Fundacjë
     prawem autorskim, napisz do Fundacji; czasami czynimy od tego odstëpstwa.
     W  naszej  decyzji kierujemy sië dwoma celami: utrzymania wolnego statusu
     wszystkich pochodnych naszego  wolno  dostëpnego  oprogramowania  oraz  -
     generalnie   -   promowania   wspóîudziaîu   i  wielokrotnego  stosowania
     oprogramowania.

                             WYRÓB BEZ GWARANCJI

 11. PONIEWAÛ  PROGRAM  JEST  LICENCJONOWANY  BEZPÎATNIE,  NIE   JEST   OBJËTY
     GWARANCJÂ W ZAKRESIE DOZWOLONYM PRZEZ OBOWIÂZUJÂCE  PRZEPISY.  O  ILE  NA
     PIÔMIE  NIE  STANOWI  SIË  INACZEJ, POSIADACZE PRAW AUTORSKICH I/LUB INNE
     STRONY ZAPEWNIAJÂ PROGRAM W  STANIE,  W  JAKIM  JEST  ("JAK  WIDAÊ")  BEZ
     JAKIEJKOLWIEK GWARANCJI, ANI WYRAÚNEJ, ANI DOMYÔLNEJ, W TYM MIËDZY INNYMI
     DOMYÔLNYCH GWARANCJI CO  DO  PRZYDATNOÔCI  HANDLOWEJ  I  PRZYDATNOÔCI  DO
     OKREÔLONYCH  ZASTOSOWAÏ.  CAÎOÔÊ RYZYKA W ZAKRESIE JAKOÔCI I SKUTECZNOÔCI
     DZIAÎANIA PROGRAMU  PONOSISZ  SAM.  W  RAZIE  GDYBY  PROGRAM  OKAZAÎ  SIË
     WADLIWY,   PONOSISZ    KOSZT   CAÎEGO    NIEZBËDNEGO   SERWISU,   NAPRAWY
     I KORYGOWANIA.

 12. O ILE OBOWIÂZUJÂCE PRAWO NIE  STANOWI  INACZEJ  ALBO  CZEGOÔ  INNEGO  NIE
     UZGODNIONO W FORMIE PISEMNEJ, ÛADEN POSIADACZ PRAW  AUTORSKICH  ANI  INNA
     STRONA  MODYFIKUJÂCA  I/LUB  REDYSTRYBUJÂCA  PROGRAM ZGODNIE Z POWYÛSZYMI
     ZEZWOLENIAMI, W ÛADNYM WYPADKU NIE JEST ODPOWIEDZIALNA  WOBEC  CIEBIE  ZA
     SZKODY,  W  TYM  SZKODY OGÓLNE, SPECJALNE,  UBOCZNE LUB SKUTKOWE, WYNIKÎE
     Z UÛYCIA BÂDÚ NIEMOÛLIWOÔCI UÛYCIA  PROGRAMU  (W TYM,  MIËDZY INNYMI,  ZA
     UTRATË   DANYCH  LUB  POWSTANIE  DANYCH  NIEDOKÎADNYCH,  ALBO  ZA  STRATY
     PONIESIONE PRZEZ CIEBIE LUB STRONY TRZECIE, JAK TEÛ NIEDZIAÎANIE PROGRAMU
     Z INNYMI PROGRAMAMI), NAWET JEÔLI DANY POSIADACZ BÂDÚ INNA STRONA ZOSTALI
     POWIADOMIENI O MOÛLIWOÔCI POWSTANIA TAKICH SZKÓD.

                           KONIEC ZASAD I WARUNKÓW

@endnode
