// opis komend dla protokołu jabber
// (c) copyright 2001-2003 wojtek kaniewski <wojtekka@irc.pl>
// (c) copyright      2004 piotr kupisiewicz <deletek@ekg2.org>
// (c) copyright      2004 tomasz torcz <zdzichu@ekg2.org>

_autoaway
	parametry:
	krotki opis: zmienia stan na zajęty

_autoback
	parametry:
	krotki opis: zmienia stan na dostępny

add
	parametry: <JID> [nazwa]
	krotki opis: dodaje użytkownika do naszego rostera, jednocześnie prosząc o autoryzację

admin
	parametry: [konferencja pole wartość]
	krotki opis: zmienia konfigurację pokoju
	
	Zmienia konfigurację pokoju MUC: ustawia `pole` na `wartość` dla pokoju
	`konferencja`.
	
	Jeżeli nie podano żadnych argumentów, wyświetla wszystkie pola oraz ich
	wartości dla aktualnego pokoju.
	
	Przykład (zmień typ pokoju na `persistent`):
	  /admin xmpp:test@conference.example.com --muc#roomconfig_persistentroom 1

auth
	parametry: <opcje> <JID>
	krotki opis: obsługa autoryzacji
	
	<akcja> <JID>
	
	  -a, --accept <JID>    autoryzuje JID
	
	  -d, --deny <JID>      odmawia udzielenia autoryzacji lub ją odbiera
	
	  -r, --request <JID>   wysyła żądanie autoryzacji
	
	  -c, --cancel <JID>    wysyła żądanie cofnięcia autoryzacji
	
	  -j, --reject <JID>	odrzuca żądanie autoryzacji
	
	  -l, --list		wyświetla oczekujące żądania
	
	  -p, --probe		wysyła pytanie o obecność użytkownika

away
	parametry: [opis/-]
	krotki opis: zmienia stan na zajęty
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

back
	parametry: [opis/-]
	krotki opis: zmienia stan na dostępny
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

ban
	parametry: <kanał> <JID> [powód]
	krotki opis: banuje JID z kanału lub wyświetla listę banów
	
	Jeżeli nie podano JID wyświetla listę zbanowanych uzytkowników.
	W przeciwnym wypadku banuje dany JID z określonego kanału.

bookmark
	parametry: <opcje>
	krotki opis: zarzadzanie zakladkami serwer-side (jabber:iq:private)
	
	Zarzadza zakladkami (dodaje/modyfikuje/usuwa/wyswietla).
	Ustawienie zmiennej sesyjnej auto_bookmark_sync zalecane.
	
	 -d, --display                       wyswietla.
	
	 -g, --get                           pobiera, bez wyswietlania
	
	 -c, --clear                         czysci
	
	 -p, --put                           wysyla liste lokalna na serwer (automatycznie robione po dodaniu/modyfikacji/usunieciu)
	
	 -a, --add  --url <url> [-- nazwa]   dodaje nowy wpis do zakladek ze stronami WWW
	
	 -a, --add  --conf <jid>             dodaje nowy wpis do zakladek z konferencjami
	
	            [--autojoin 1]           czy automatycznie sie dolaczac po polaczeniu do serwera [niezaimplentowane w ekg2, ale wiele klientow umie :)]
	
	            [--nick nasznick]
	
	            [--pass haslo]
	
	            [-- nazwa]
	
	 -m, --modify                       NIE ZAIMPLEMENTOWANE, modyfikuje :)
	
	 -r, --remove                       NIE ZAIMPLEMENTOWANE, usuwa :)

change
	parametry: <opcje>
	krotki opis: zmienia informacje w katalogu publicznym
	
	  -f, --fullname <imię i nazwisko>
	
	  -n, --nick <pseudonim>
	
	  -b, --born <data urodzenia>	(zapisana wg. ISO 8601, tj. rrrr-mm-dd)
	
	  -c, --city <miasto>
	
	  -d, --description <opis>
	
	  -C, --country <kraj>
	
	  -p, --photo <ścieżka do zdjecia>
	
	Jeśli któryś z parametrów nie zostanie podany, jego wartość zostanie
	wyczyszczona w katalogu publicznym. Podanie parametru ,,%T-%n''
	wyczyści %Twszystkie%n pola.

chat
	parametry:
	krotki opis: wysyła wiadomość w ramach rozmowy

connect
	parametry:
	krotki opis: łączy się z serwerem

del
	parametry: [nazwa]
	krotki opis: usuwa z naszego rostera

deop
	parametry: [kanał] [nick]
	krotki opis: degraduje nick do roli gościa
	
	Odbiera użytkownikowi prawa moderatora kanału oraz prawo wysyłania
	wiadomości jeżeli kanał jest moderowany.

devoice
	parametry: [kanał] [nick]
	krotki opis: degraduje nick do roli gościa
	
	Odbiera użytkownikowi prawa moderatora kanału oraz prawo wysyłania
	wiadomości jeżeli kanał jest moderowany.

disconnect
	parametry:  [opis/-]
	krotki opis: rozłącza się od serwera
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

dnd
	parametry: [opis/-]
	krotki opis: zmienia stan na nie przeszkadzać
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

ffc
	parametry: [opis/-]
	krotki opis: zmienia stan na chętny do rozmowy
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

kick
	parametry: [kanał] [nick]
	krotki opis: wyrzuca nick z kanału

invisible
	parametry: [opis/-]
	krotki opis: zmienia stan na zajęty
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

join
	parametry: <konferencja> [nick]
	krotki opis: przyłącza do konferencji
	
	Przyłącza do konferencji. Jeżeli podana konferencja nie istnieje,
	zakłada nową konferencję. Opcjonalnie ustawia nick użytkownika w
	konferencji.

lastseen
	parametry:
	krotki opis: pobiera informację o czasie wylogowania się danego jid

msg
	parametry:
	krotki opis: wysyła pojedynczą wiadomość
	
	Wszyscy odbiorcy to * zamiast nadawcy. Poprzedzenie wiadomości
	wielolinijkowej ciągiem zdefiniowanym w zmiennej subject_prefix spowoduje
	potraktowanie pierwszej linijki jako tematu.

modify
	parametry: <alias> <opcje>
	krotki opis: zmienia wpisy w liście kontaktów
	
	Opcje mogą być następujące:
	
	-n, --nickname <pseudonim>     wpis w liście kontaktów

nick
	parametry: [konferencja] <nick>
	krotki opis: zmienia nick użytkownika
	
	Zmienia nick użytkownika w danej konferencji. Jeżeli nie podano
	konferencji, zmienia nick na konferencji w aktualnym oknie.

op
	parametry: <konferencja> <nick>
	krotki opis: nadaje nickowi uprawnienia moderatora

part
	parametry: <konferencja>
	krotki opis: opuszcza konferencję

passwd
	parametry:
	krotki opis: zmienia hasło

privacy
	parametry: <opcje>
	
	Zarzadza lista ignorowanych serwer-side (%gjabber:iq:privacy%n).
	Ustawienie zmiennej sesyjnej %Tauto_privacylist_sync%n wymagane.
	Ustawienie zmiennej sesyjnej %Tprivacy_list%n zalecane (jesli nie, zakladamy ze korzystasz z listy %Tekg2%n).
	Jesli w parametrach nie ma podanej listy, to operujemy na liscie
	zdefiniowanej w %Tprivacy_list%n.
	
	%RKOMENDA EKSPERYMENTALNA, PROSZE INFORMOWAC O WSZYSTKICH BUGACH, Z DOKLADNYM OPISEM.%n
	
	
	  [--lists]                                         wyswietla listy dostepne na serwerze
	
	  [--get] lista                                     wyswietla liste.
	
	  --session lista                                   ustawia lista jako aktywna, jesli podano %T-%n deaktywuje aktualna liste.
	
	  --default lista                                   ustawia liste jako domyslna, jesli podano %T-%n kasuje ustawienia.
	
	  --unset lista                                     kasuje liste %r(NIEODWRACALNE!!)%n
	
	  --sync                                            %g[WEWNETRZNA KOMENDA]%n Wysyla liste lokalna do serwera (automatycznie robione po dodaniu/zmianie/usunieciu)
	
	  --set <co> [--order numerek] [-zabron] [+dozwol]  dodaje wpis do listy
	
	  	<co>              albo xmpp:osoba albo @grupa albo %Tnone%n, %Tfrom%n, %Tto%n, %Tboth%n gdy definiujemy poziom autoryzacji
	
		[--order numerek] ustawia ktory to ma byc element na liscie.
	
		[-zabron]         Parametr moze byc powtorzony wielokrotnie, znak minusa, a nastepnie jedna z opcji: iq, msg, pin, pout lub gwiazdka jesli wszystkie.
	
		[+pozwol]         Parametr moze byc powtorzony wielokrotnie, znak plusa, a nastepnie jedna z opcji: iq, msg, pin, pout lub gwiazdka dla okreslenia ze wszystkie.
	
		%r!!! UWAGA !!! Po dodaniu pierwszego elementu do listy, jest wymagane aktywowanie listy przez %g/privacy --session lista%n
	
	 --remove #id                                       usuwa wpis z numerem id z listy.
	
	 --modify                                           zmienia wpis, NIEZAIMPLEMENTOWANE.
	

reconnect
	parametry:
	krotki opis: rozłącza i łączy się ponownie

reply
	parametry: <#reply-id> ...
	krotki opis: odpisuje na wątek
	
	Wysyła wiadomość jako kontynuację wskazanego przez reply-id wątku.
	Możliwe jest podanie tematu jak w msg, w przeciwnym razie temat
	zostanie utworzone w oparciu o temat wątku (poprzedzony
	subject_reply_prefix).

tmsg
	parametry: <uid/nick> <id-watku> ...
	krotki opis: wysyła wiadomość wątkowaną
	
	Działa podobnie jak msg, z tym, że dodatkowy, drugi parametr zawiera
	identyfikator wątku dla wiadomości.

topic
	parametry:  [konferencja] <nowy temat>
	krotki opis: ustawia topic MUC

unban
	parametry: <konferencja> <JID>
	krotki opis: zdejmuje ban na dany JID z kanału
	
	Jeżeli nie podano JID wyświetla listę zbanowanych uzytkowników.
	W przeciwnym wypadku usuwa ban danego JID z określonego kanału.

userinfo
	parametry:
	krotki opis: pobiera informacje z katalogu Jabbera o danym jid

ver
	parametry:
	krotki opis: pobiera informację o sytemie operacyjnym i wersji klienta Jabbera danego jid

voice
	parametry: <konferencja> <nick>
	krotki opis: daje "głos" nickowi
	
	Nadaje użytkownikowi uprawnienia do wysyłania wiadomości w
	konferencji, nawet jeśli konferencja jest moderowana.
	
	Uwaga: ustawienie voice na uzytkowniku będącym moderatorem spowoduje
	odebraniu mu praw administratora.

xa
	parametry: [opis/-]
	krotki opis: zmienia stan na bardzo zajęty
	
	Jeżeli nie podano opisu to będzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

xml
	parametry:
	krotki opis: wysyła polecenie xml
	
	Polecenie musi być zakodowanie w UTF-8, a wszystkie znaki specjalne używane w XML
	(& < >) muszą być zamienione na odpowiadające im sekwencje.

// $Id$
