// opis komend oglnych klienta
// (c) copyright 2001-2003 wojtek kaniewski <wojtekka@irc.pl>
// (c) copyright      2004 piotr kupisiewicz <deletek@ekg2.org>

!
	parametry:  [opcje] <polecenie>
	krotki opis: synonim dla %Texec%n

?
	parametry:  [polecenie] [zmienna]
	krotki opis: synonim dla %Thelp%n

_addtab
	parametry: 
	krotki opis: dodaje do listy dopeniania TABem

_debug
	parametry:  <tekst>
	krotki opis: wywietla podany tekst w oknie debug

_debug_dump
	parametry: 
	krotki opis: zrzuca debug do pliku

_deltab
	parametry: 
	krotki opis: usuwa z listy dopeniania TABem

_desc
	parametry: [-/opis]
	krotki opis: zmienia opis nie zmieniajc stanu

_fds
	parametry: 
	krotki opis: wywietla otwarte pliki

_msg
	parametry: 
	krotki opis: udaje, e wysya wiadomo

_queries
	parametry: 
	krotki opis: wywietla list zapyta

_query
	parametry:  <zapytanie> [parametry...]
	krotki opis: generuje zapytanie

_segv
	parametry: 
	krotki opis: wywouje naruszenie segmentacji pamici

_watches
	parametry: 
	krotki opis: wywietla list przegldanych deskryptorw

add
	parametry:  [numer] [alias] [opcje]
	krotki opis: dodaje uytkownika do listy kontaktw
	
	-f, --find [alias]  dodaje ostatnio wyszukan osob
	
	
	W przypadku opcji %T--find%n alias jest wymagany, jeli 
	w ostatnim wyszukiwaniu nie znaleziono pseudonimu. Pozostae 
	opcje wykorzystywane s zalenie od protokou. 
	W oknie rozmowy z kim spoza naszej listy kontaktw jako parametr 
	mona poda sam alias.

alias
	parametry:  [opcje]
	krotki opis: zarzdzanie aliasami
	
	  -a, --add <alias> <komenda>     dodaje alias
	
	  -A, --append <alias> <komenda>  dodaje komend do aliasu
	
	  -d, --del <alias>|*             usuwa alias
	
	 [-l, --list] [alias]             wywietla list aliasw
	
	
	W komendzie mona uy formatw od %T\%1%n do %T\%9%n i w ten sposb ustali kolejno przekazywanych argumentw.  W aliasie zoonym z wielu komend do przekazania argumentw uywamy formatu %T\%*Tn.

at
	parametry:  [opcje]
	krotki opis: planuje wykonanie komend
	
	  -a, --add [nazwa] <czas>[/czst.] <komenda>  tworzy nowy plan
	
	  -d, --del <nazwa>|*                   usuwa plan
	
	 [-l, --list] [nazwa]                   wywietla list planw
	
	
	Czas podaje si w formacie [[[yyyy]mm]dd]HH[:]MM[.SS], gdzie 
	%Tyyyy%n to rok, %Tmm%n to miesic, %Tdd%n to dzie, %THH:MM%n 
	to godzina, a %T.SS%n to sekundy. Minimalny format to %THH:MM%n 
	(dwukropek mona pomin). Po kropce mona poda sekundy, a przed 
	godzin odpowiednio: dzie miesica, miesic, rok. Jeli podanie 
	zostana czstotliwo, wyraona w sekundach lub za pomoc przyrostkw 
	takich, jak dla komendy %Ttimer%n, to komenda bdzie wykonywana 
	w zadanych odstepach czasu od momentu jej pierwszego wykonania.

beep
	parametry:  
	krotki opis: wydaje dwik

bind
	parametry:  [opcje]
	krotki opis: przypisywanie akcji klawiszom
	
	  -a, --add <sekwencja> <akcja>   przypisuje now sekwencj
	
	  -d, --del <sekwencja>           usuwa podan sekwencj
	
	 [-l, --list] [sekwencja]         wywietla przypisane sekwencje
	
	  -L, --list-default [sekwencja]  j.w. plus domylne sekwencje
	
	  -S, --set <sekwencja>           binduje klawisze pod sekwencj
	
	
	Dostpne sekwencje to: Ctrl-<znak>, Alt-<znak>, F<liczba>, Enter, 
	Backspace, Delete, Insert, Home, End, Left, Right, Up, Down, PageUp, PageDown.
	
	
	Dostpne akcje to: backward-word, forward-word, kill-word, toggle-input, 
	cancel-input, backward-delete-char, beginning-of-line, end-of-line, delete-char, 
	backward-page, forward-page, kill-line, yank, accept-line, line-discard, 
	quoted-insert, word-rubout, backward-char, forward-char, previous-history, 
	next-history, complete, quick-list, toggle-contacts, next-contacts-group, 
	ignore-query, forward-contacts-page, backward-contacts-page, forward-contacts-line, 
	backward-contacts-line, previous-only-history, next-only-history,
	backward-lastlog-page, forward-lastlog-page.
	
	Kada inna akcja bdzie traktowana jako komenda do wykonania.

clear
	parametry: 
	krotki opis: czyci ekran

conference
	parametry:  [opcje]
	krotki opis: zarzdzanie konferencjami
	
	  -a, --add [#nazwa] <numer/alias/@grupa>  tworzy now konferencj
	
	  -j, --join [#nazwa] <numer/alias>  przycza osob do konferencji
	
	  -d, --del <#nazwa>|*        usuwa konferencj
	
	  -i, --ignore <#nazwa>       oznacza konferencj jako ignorowan
	
	  -u, --unignore <#nazwa>     oznacza konferencj jako nieignorowan
	
	  -r, --rename <#old> <#new>  zmienia nazw konferencji
	
	  -f, --find <#nazwa>         wyszukuje uczestnikw w katalogu
	
	 [-l, --list] [#nazwa]        wywietla list konferencji
	
	
	Dodaje nazw konferencji i definiuje, kto bierze w niej udzia. 
	Kolejne numery, pseudonimy lub grupy mog by oddzielone przecinkiem lub spacj.

dcc
	parametry:  <komenda> [opcje]
	krotki opis: obsuga bezporednich pocze
	  
	  [r]send <numer/alias> <cieka>  wysya podany plik
	
	  get [numer/alias/#id]            akceptuje przysyany plik
	
	  resume [numer/alias/#id]         wznawia pobieranie pliku
	
	  [r]voice <numer/alias/#id>       rozpoczyna rozmow gosow
	
	  close <numer/alias/#id>          zamyka poczenie
	
	  list                             wywietla list pocze
	
	
	Poczenia bezporednie wymagaj wczonej opcji %Tdcc%n. Komendy %Trsend%n 
	i %Trvoice%n wysyaj danie poczenia si drugiego klienta z naszym i s 
	przydatne, gdy nie jestemy w stanie si z nim sami poczy.

del
	parametry:  <numer/alias>|*
	krotki opis: usuwa uytkownika z listy kontaktw

echo
	parametry:  [tekst]
	krotki opis: wywietla podany tekst

eval
	parametry:  <polecenie(a)>
	krotki opis: wykonuje podane polecenia
	
	Wykonuje podane polecenia odzdzielone spacjami. W przypadku gdy polecenie 
	zawiera spacje naley uy cudzysowiw. Ze wzgldu na budow klienta, 
	polecenia, numery i aliasy %Tnie bd%n dopeniane Tabem.

exec
	parametry:  [opcje] <polecenie>
	krotki opis: uruchamia polecenie systemowe
	
	  -m, --msg  [numer/alias]  wysya wynik do danej osoby
	
	  -b, --bmsg [numer/alias]  wysya wynik w jednej wiadomoci
	
	
	Poprzedzenie polecenia znakiem ,,%T^%n'' ukryje informacj o zakoczeniu. 
	Zapisanie opcji wielkimi literami (np. %T-B%n) spowoduje umieszczenie polecenia 
	w pierwszej linii wysyanego wyniku. Ze wzgldu na budow klienta, numery 
	i aliasy %Tnie bd%n dopeniane Tabem.

for
	parametry:  <opcje> <sesje/okna/alias>|* <polecenie>
	krotki opis: wykonuje polecenie dla danych/wszystkich sesji/okien/uytkownikw
	
	  -s, --sessions [nazwa]  wykonuje polecenie dla podanych sesji
	
	  -u, --users [nazwa]     wykonuje polecenie dla podanych uytkownikw
	
	  -w, --windows [id]      wykonuje polecenie dla podanych okien
	
	
	Mona poda ,,%T*%n'' zamiast nazwy/id, tak aby komenda bya wykonana dla wszystkich elementw.
	
	Polecenie moe zawiera elementy specjalne, tzn pola ,,%T\%1%n'' i ,,%T\%2%n''.
	
	
	Oznaczaj kolejno:
	
	  dla sesji: nazwa, uid
	
	  dla uytkownikw: alias, uid
	
	  dla okien: alias, uid

help
	parametry:  [polecenie] [zmienna]
	krotki opis: wywietla informacj o poleceniach
	
	Moliwe jest wywietlenie informacji o zmiennych, jeli jako polecenie 
	poda si %Tset%n

ignore
	parametry:  [numer/alias] [poziom]
	krotki opis: dodaje do listy ignorowanych
	
	Dostpne poziomy ignorowania:
	
	  - status - cakowicie ignoruje stan
	
	  - descr - ignoruje tylko opisy
	
	  - notify - nie wywietla zmian stanu
	
	  - msg - ignoruje wiadomoci
	
	  - dcc - ignoruje poczenia DCC
	
	  - events - ignoruje zdarzenia zwizane z uytkownikiem
	
	  - log - nie zapisuje w archiwum wiadomoci uytkownika
	
	  - * - wszystkie poziomy
	
	
	Poziomy mona czy ze sob za pomoc przecinka lub ,,%T|%n''.

last
	parametry:  [opcje] <alias>|*
	krotki opis: wywietla lub czyci ostatnie wiadomoci
	
	  -c, --clear [numer/alias]      czyci podane wiadomoci lub wszystkie
	
	  -s, --stime [numer/alias]      wywietla czas wysania wiadomoci
	
	  -n, --number <n> [numer/alias] wywietla %Tn%n ostatnich wiadomoci
	
	  [numer/alias]                  wywietla ostatnie wiadomoci
	
	
	W przypadku opcji %T--stime%n czas wywietlany jest ,,inteligentnie'' zgodnie 
	ze zmienn %Ttime_deviation.%n

list
	parametry:  [alias|@grupa|opcje|metakontakt|sesja/alias]
	krotki opis: zarzdzanie list kontaktw
	
	Wywietlanie osb o podanym stanie "list [-a|-A|-B|-i|-I|-d|-m|-n|-o|-O]":
	
	  -a, --active           dostpne
	
	  -A, --away             zajte
	
	  -n, --notavail         niedostpne
	  -i, --inactive         niedostpne
	
	  -I, --invisible        niewidoczne
	
	  -B, --blocked          blokujce nas
	
	  -d, --description      osoby z opisem
	
	  -m, --member <@grupa>  osoby nalece do danej grupy
	
	  -o, --offline          osoby dla ktrych jestemy niedostpni
	
	  -O, --online           osoby dla ktrych zawsze jestemy widoczni
	
	Wywietlanie czonkw grupy: "list @grupa". Wywietlanie osb spoza grupy: "list !@grupa".

metacontact
	parametry:  [opcje]
	krotki opis: zarzdzanie metakontaktami
	
	  -a, --add <nazwa>      dodaje metakontakt o podanej nazwie
	
	  -d, --del <nazwa>      usuwa metakontakt o podanej nazwie
	
	  -i, --add-item <nazwa> <nazwa_sesji> <nazwa_kontaktu> <prio>	dodaje do metakontaktu kontakt
	
	  -r, --del-item <nazwa> <nazwa_sesji> <nazwa_kontaktu>	usuwa z metakontaktu kontakt
	
	  -l, --list             wywietla list wszystkich metakontaktw
	
	  <nazwa>                wywietla list kontaktw danego metakontaktu
	
	
	Przykadowe dodanie metakontaktu moe wyglda nastpujco:
	
	metacontact -a metakontakt
	
	metacontact -i metakontakt sesja nazwa_uytkownika 1
	
	
	Metakontakty pozwalaj na stworzenie kontaktu zawierajcego inne kontakty. 
	query metakontakt otwiera rozmow z osob, ktra jest aktualnie dostpna 
	i ma najwikszy priorytet. W przypadku, w ktrym aden z kontaktw nie jest 
	dostpny, wiadomo kierowana jest do osoby o najwikszym priorytecie.
	
	
	Funkcje korzystajce z metakontaktw to:
	
	  query <nazwa>        rozpoczyna rozmow
	
	  list <nazwa>         pokazuje aktualny stan metakontaktu.%n

on
	parametry:  [opcje]
	krotki opis: zarzdzanie zdarzeniami
	
	  -a, --add <zdarzenie> <priorytet> <zaoenia> <komenda>  dodaje zdarzenie
	
	  -d, --del <numer>|*         usuwa zdarzenie o podanym numerze
	
	 [-l, --list] [numer]         wywietla list zdarze
	
	
	Dostpne zdarzenia mona znale w pliku events.txt w dokumentacji programu.
	
	
	Zaoenie mog by nastpujce:
	
	  ,,%T=%n''  - jest takie same i wielkoci liter nie maj znaczenia
	
	  ,,%T==%n'' - jest takie same i wielkoci liter maj znaczenie
	
	  ,,%T+%n''  - pierwszy cig zawiera si w drugim, wielko liter nie ma znaczenia
	
	  ,,%T++%n'' - pierwszy cig zawiera si w drugim, wielko liter ma znaczenie
	
	
	Zaoenia mona czy poprzez ,,|'' (lub) i ,,&'' (i). S to standardowe 
	operatory logiczne.Zaprzeczenia tworzymy przez dodanie ,,%T!%n'' przed 
	zaoeniem, np. ,,%T!+%n''. Mona uywa \%1 zamiast nazwy nadawcy oraz \%2 
	zamiast ewentualnych parametrw. Gdy potrzeba uy spacji w zaoeniu naley 
	cae zaoenie uj w cudzysw. 
	
	
	W zaoeniach mona uywa:
	
	  \%1  - jako uid sprawcy
	
	  \%2  - jako pseudonim sprawcy, jeeli nie istnieje na licie kontaktw to uid
	
	  \%3  - tre wiadomoci, opis czy te inne dane przekazane przez wydarzenie
	
	
	Przykadowe zaoenie moe mie posta: ,,%T\%1=nick&\%1!=nick2|\%2+tekst%n''
	
	
	W przypdakach, w ktrych chcemy, aby zdarzenie dotyczyo wszystkich moliwych 
	sytuacji naley zamiast zaoenia uy ,,%T*%n''. Nazwy zdarze mog by 
	rodzielone przecinkiem.
	
	
	  - * - wszystkie zdarzenia
	
	
	W przypadku gdy istnieje wiele zdarze pasujcych do kryterium (np. * i nick) 
	wykonywane bdzie to z wikszym priorytetem. Mona poda wicej komend, 
	oddzielajc je rednikiem. W komendzie, %T\%1%n zostanie zastpione numerkiem 
	sprawcy zdarzenia, a jeli istnieje on na naszej licie kontaktw, %T\%2%n 
	bdzie zastpione jego pseudonimem. Zamiast %T\%3%n i %T\%4%n wpisana bdzie 
	tre wiadomoci, opis uytkownika, cakowita ilo nowych wiadomoci e-mail 
	lub nazwa pliku - w zalenoci od zdarzenia. Format %T\%4%n rni si od %T\%3%n 
	tym, e wszystkie niebiezpieczne znaki, ktre mogyby zosta zinterpretowane 
	przez shell, zostan poprzedzone backslashem. Uywanie %T\%3%n w przypadku 
	komendy ,,exec'' jest %Tniebezpieczne%n i, jeli naprawd musisz wykorzysta 
	tre wiadomoci lub opis, uyj %T"\%4"%n (w cudzysowach).

play
	parametry:  <plik>
	krotki opis: odtwarza plik dwikowy

plugin
	parametry:  [-|+][nazwa][opcje] [prio]
	krotki opis: aduje lub usuwa rozszerzenie ekg2
	
	  -d, --default     ustawia domylne priorytety pluginom
	
	Usuwa lub dodaje plugin ekg2. Drugi parametr pozwala ustawi priorytet
	pluginu, co pozwala ustawi kolejno przetwarzania instrukcji przez
	pluginy.

query
	parametry:  <numer|alias|@grupa|metakontakt|sesja/alias|sesja/numer> [wiadomo]
	krotki opis: wcza rozmow
	
	Mona poda wiksz ilo odbiorcw oddzielajc ich numery lub pseudonimy 
	przecinkiem (ale bez odstpw). W takim wypadku zostanie rozpoczta rozmowa grupowa.

queue
	parametry:  [opcje]
	krotki opis: zarzdzanie wiadomociami do wysania po poczeniu
	
	  -c, --clear [numer/alias]  usuwa podane wiadomoci lub wszystkie
	
	  [numer/alias]              wywietla kolejk wiadomoci
	
	
	Podajc numer lub alias, naley poda ten, ktry by uywany przy wysyaniu 
	wiadomoci, lub nazw okna, w ktrym wiadomoci byy wysyane.

quit
	parametry:  [powd/-]
	krotki opis: wychodzi z programu
	
	Podanie ,,%T-%n'' zamiast powodu spowoduje wyczyszczenie bez wzgldu na ustawienia 
	zmiennych.

reload
	parametry:  
	krotki opis: wczytuje pliki konfiguracyjny, pluginy oraz sesje

save
	parametry:  
	krotki opis: zapisuje ustawienia programu
	
	Aktualny stan zostanie zapisany i bdzie przywrcony przy nastpnym uruchomieniu 
	programu. 

say
	parametry:  [tekst]
	krotki opis: wymawia tekst
	
	  -c, --clear  usuwa z bufora tekst do wymwienia
	
	
	Polecenie wymaga zdefiniowana zmiennej %Tspeech_app%n

session
	parametry:  [opcje]
	krotki opis: zarzdzanie sesjami
	
	 <uid>               informacje o sesji
	
	  -a, --add <uid>    tworzy now sesj
	
	  -d, --del <uid>    usuwa sesj
	
	 [-l, --list]        wywietla list
	
	 [-g, --get] [<uid>] <opcja>
	
	                     wywietla opcj sesji
	
	 [-s, --set] [<uid>] <opcja> <warto>
	
	                     zmienia opcj sesji
	
	 [-s, --set] [<uid>] -<opcja>
	
	                     usuwa opcj sesji
	
	 [-w, --sw] <uid>    zmienia aktualn sesj
	
	
	Pamitaj o tym, e uid ma posta <prefix>:<uid> np. %Tgg:12345%n.

set
	parametry:  [-]<zmienna> [[+/-]warto]
	krotki opis: wywietla lub zmienia ustawienia
	
	Uycie %Tset -zmienna%n czyci zawarto zmiennej. Dla zmiennych bdcymi 
	mapami bitowymi mona okreli, czy warto ma by dodana (poprzedzone plusem), 
	usunita (minusem) czy ustawiona (bez prefiksu). Warto zmiennej mona wzi 
	w cudzysw.
	
	Jeeli chcemy przeczy warto zmiennej typu bool uywamy %T,t'%n zamiast ustawianej 
	wartoci.
	
	Poprzedzenie opcji parametrem %T-a%n lub %T--all%n spowoduje wywietlenie wszystkich, 
	nawet aktualnie nieaktywnych zmiennych.
	
	Parametr %T-q%n lub %T--quiet%n spowoduje, e informacja o nowej wartoci zmiennej nie zostanie
	wywietlona i nie zaznaczy zmiany konfiguracji.

status
	parametry:  [opcje]
	krotki opis: wywietla aktualny stan
	
	  <uid> wywietla aktualny stan dla konkretnej sesji

tabclear
	parametry:  [opcje]
	krotki opis: czyci list nickw do dopenienia
	
	  -o, --offline  usuwa tylko nieobecnych

timer
	parametry:  [opcje]
	krotki opis: zarzdzanie timerami
	
	  -a, --add [nazwa] [*/]<czas> <komenda>  tworzy nowy timer
	
	  -d, --del <nazwa>|*                 zatrzymuje timer
	
	 [-l, --list] [nazwa]                 wywietla list timerw
	
	
	Czas, po ktrym wykonana zostanie komenda, podaje si w sekundach. Mona te 
	uy przyrostkw %Td%n, %Th%n, %Tm%n, %Ts%n, oznaczajcych dni, godziny, 
	minuty, sekundy, np. 5h20m. Timer po jednorazowym uruchomieniu jest usuwany, 
	chyba e czas poprzedzimy wyraeniem ,,%T*/%n''. Wtedy timer bdzie uruchamiany 
	w zadanych odstpach czasu, a na licie bdzie oznaczony gwiazdk.

unignore
	parametry:  <numer/alias>|*
	krotki opis: usuwa z listy ignorowanych osb

version
	parametry: 
	krotki opis: wywietla wersj programu

window
	parametry:  <komenda> [numer_okna]
	krotki opis: zarzdzanie oknami
	
	  active               przecza do pierwszego okna,
	
	                       w ktrym co si dzieje
	
	  clear                czyci aktualne okno
	
	  kill [numer_okna]    zamyka aktualne lub podane okno
	
	  last                 przecza do ostatnio wywietlanego
	
	                       okna
	
	  list                 wywietla list okien
	
	  move <docelowe> [rdowe] przesuwa okno
	opcja <docelowe> moe przyj wartoci ,,left'' i ,,right''
	
	  new [nazwa]          tworzy nowe okno
	
	  next                 przecza do nastpnego okna
	
	  prev                 przecza do poprzedniego okna
	
	  switch <numer_okna>  przecza do podanego okna
	
	  refresh              odwiea aktualne okno

