// opis komend dla protokou 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 zajty

_autoback
	parametry:
	krotki opis: zmienia stan na dostpny

add
	parametry: <JID> [nazwa]
	krotki opis: dodaje uytkownika do naszego rostera, jednoczenie proszc o autoryzacj

admin
	parametry: [konferencja pole warto]
	krotki opis: zmienia konfiguracj pokoju
	
	Zmienia konfiguracj pokoju MUC: ustawia `pole` na `warto` dla pokoju
	`konferencja`.
	
	Jeeli nie podano adnych argumentw, wywietla wszystkie pola oraz ich
	wartoci dla aktualnego pokoju.
	
	Przykad (zmie typ pokoju na `persistent`):
	  /admin xmpp:test@conference.example.com --muc#roomconfig_persistentroom 1

auth
	parametry: <opcje> <JID>
	krotki opis: obsuga autoryzacji
	
	<akcja> <JID>
	
	  -a, --accept <JID>    autoryzuje JID
	
	  -d, --deny <JID>      odmawia udzielenia autoryzacji lub j odbiera
	
	  -r, --request <JID>   wysya danie autoryzacji
	
	  -c, --cancel <JID>    wysya danie cofnicia autoryzacji
	
	  -j, --reject <JID>	odrzuca danie autoryzacji
	
	  -l, --list		wywietla oczekujce dania
	
	  -p, --probe		wysya pytanie o obecno uytkownika

away
	parametry: [opis/-]
	krotki opis: zmienia stan na zajty
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

back
	parametry: [opis/-]
	krotki opis: zmienia stan na dostpny
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

ban
	parametry: <kana> <JID> [powd]
	krotki opis: banuje JID z kanau lub wywietla list banw
	
	Jeeli nie podano JID wywietla list zbanowanych uzytkownikw.
	W przeciwnym wypadku banuje dany JID z okrelonego kanau.

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 <cieka do zdjecia>
	
	Jeli ktry z parametrw nie zostanie podany, jego warto zostanie
	wyczyszczona w katalogu publicznym. Podanie parametru ,,%T-%n''
	wyczyci %Twszystkie%n pola.

chat
	parametry:
	krotki opis: wysya 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 gocia
	
	Odbiera uytkownikowi prawa moderatora kanau oraz prawo wysyania
	wiadomoci jeeli kana jest moderowany.

devoice
	parametry: [kana] [nick]
	krotki opis: degraduje nick do roli gocia
	
	Odbiera uytkownikowi prawa moderatora kanau oraz prawo wysyania
	wiadomoci jeeli kana jest moderowany.

disconnect
	parametry:  [opis/-]
	krotki opis: rozcza si od serwera
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

dnd
	parametry: [opis/-]
	krotki opis: zmienia stan na nie przeszkadza
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

ffc
	parametry: [opis/-]
	krotki opis: zmienia stan na chtny do rozmowy
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

kick
	parametry: [kana] [nick]
	krotki opis: wyrzuca nick z kanau

invisible
	parametry: [opis/-]
	krotki opis: zmienia stan na zajty
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

join
	parametry: <konferencja> [nick]
	krotki opis: przycza do konferencji
	
	Przycza do konferencji. Jeeli podana konferencja nie istnieje,
	zakada now konferencj. Opcjonalnie ustawia nick uytkownika w
	konferencji.

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

msg
	parametry:
	krotki opis: wysya pojedyncz wiadomo
	
	Wszyscy odbiorcy to * zamiast nadawcy. Poprzedzenie wiadomoci
	wielolinijkowej cigiem zdefiniowanym w zmiennej subject_prefix spowoduje
	potraktowanie pierwszej linijki jako tematu.

modify
	parametry: <alias> <opcje>
	krotki opis: zmienia wpisy w licie kontaktw
	
	Opcje mog by nastpujce:
	
	-n, --nickname <pseudonim>     wpis w licie kontaktw

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

part
	parametry: <konferencja>
	krotki opis: opuszcza konferencj

passwd
	parametry:
	krotki opis: zmienia haso

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: rozcza i czy si ponownie

reply
	parametry: <#reply-id> ...
	krotki opis: odpisuje na wtek
	
	Wysya wiadomo jako kontynuacj wskazanego przez reply-id wtku.
	Moliwe jest podanie tematu jak w msg, w przeciwnym razie temat
	zostanie utworzone w oparciu o temat wtku (poprzedzony
	subject_reply_prefix).

tmsg
	parametry: <uid/nick> <id-watku> ...
	krotki opis: wysya wiadomo wtkowan
	
	Dziaa podobnie jak msg, z tym, e dodatkowy, drugi parametr zawiera
	identyfikator wtku dla wiadomoci.

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

unban
	parametry: <konferencja> <JID>
	krotki opis: zdejmuje ban na dany JID z kanau
	
	Jeeli nie podano JID wywietla list zbanowanych uzytkownikw.
	W przeciwnym wypadku usuwa ban danego JID z okrelonego kanau.

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 "gos" nickowi
	
	Nadaje uytkownikowi uprawnienia do wysyania wiadomoci w
	konferencji, nawet jeli konferencja jest moderowana.
	
	Uwaga: ustawienie voice na uzytkowniku bdcym moderatorem spowoduje
	odebraniu mu praw administratora.

xa
	parametry: [opis/-]
	krotki opis: zmienia stan na bardzo zajty
	
	Jeeli nie podano opisu to bdzie szukany losowy opis.
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie opisu.

xml
	parametry:
	krotki opis: wysya polecenie xml
	
	Polecenie musi by zakodowanie w UTF-8, a wszystkie znaki specjalne uywane w XML
	(& < >) musz by zamienione na odpowiadajce im sekwencje.

// $Id$
