składnia komendy on:

on [zdarzenie] [user] [akcja]; [akcja1]; [...]

	zdarzenie:
		msg, chat - wiadomość od kogoś;
		avail - zmiana przez kogoś statusu na 'dostępny';
		away  -            -//-               'zajęty';
		invisible -        -//-               'niewidoczny';
		disconnect -       -//-	              'niedostępny';
		dcc - otrzymanie od kogoś dcc;
		sigusr1, sigusr2 - otrzymanie podanego sygnału;
		delivered, queued - wiadomość dostarczona lub zakolejkowana;
		* - wszystkie zdarzenia;
	zdarzenia można łączyć ze sobą operatorem '|'.

	user - nazwa użytkownika z listy lub uin, * oznacza dowolnego 
	       użytkownika, przy czym, jeżeli użytkownik ma przypisaną
               indywidualną akcję - ta z * nie brana jest pod uwagę.
	
	akcja:
		clear - usuń dane zdarzenie (lub jedną flagę);
		beep - wysyła \007 na terminal czyli zwykłe beepnięcie;
		play [plik] - odtwórz dany dźwięk 
		chat [user] [tekst] - wyślij tekst do danego usera;
		msg  [user] [tekst] -            -//- 
		blink_leds [sekwencja] - zapalaj kontorlki NumLock, CapsLock
		      i ScrollLock na klawiaturze 'w rytm' podanej sekwencji.
                      kombinacje diod oddzielane są od siebie przecinkami,
                      jeżeli po kombinacji wystąpi znak '/' - po nim podany
                      musi być odstęp czasu do kolejnej kombinacji.
                      kombinacje tworzy się dodając do siebie bity:
                      1 - NumLock,  2 - ScrollLocl, 4 - CapsLock i tak np.
                      podświetlenie NumLock i CapsLock to 1+4 czyli 5.
		beeps_spk [sekwencja] - odgrywa sekwencję na sprzętowym 
                      głośniczku. tony są oddzielane przecinkami, odstępy czasu,
                      tak jak przy blink_leds występuję po znaku '/'.
		command [komenda] - wywołuje komendę klienta
		exec [komenda] - wywołuje polecenie systemowe

		dodatkowo przy blink_leds i beeps_spk, jeżeli sekwencja zacznie
		się od znaku '$', będzie ona poszukiwana w themes (przykładem
		jest standardowe blah.led dla blink_leds).

		akcje można łączyć ze sobą, oddzielając je średnikiem (możliwe
		nie więcej niż 10 akcji).

		jeśli w akcji wystąpi %1, jest zastępowane przez numer sprawcy
		zdarzenia. %2 jest jego pseudonimem, jeśli figuruje w naszej
		liście kontaktów, lub numerkiem w przeciwnym razie. %3
		występuje tylko przy wiadomościach i zawiera jej treść.
		%4 jest tym samym co %3, lecz wszystkie niebezpieczne znaki,
		które mogłyby zostać zinterpretowane przez shella zostają
		poprzedzone backslashem. dlatego chcąc wkleić treść wiadomości
		do akcji ,,exec'' należy użyć %4.

akcje blink_leds oraz beeps_spk muszą mieć dostęp do /dev/console, więc
uruchamiany jest specjalny daemon (ioctld) z prawami roota. po wyjściu 
z ekg, daemon ten jest zabijany. aby je włączyć, należy uruchomić skrypt
configure z parametrem --enable-ioctld.

przykłady:
	on msg drg blink_leds 1, 4, 2, 7/20000, 7, 7, 7
	on avail|away drg beeps_spk 1000, 900, 800; blink_leds 7, 5, 1
	on drg clear
	on disconnect kupa msg dupa nic z tego; blink_leds 7
	on chat * blink_leds 4, 1, 2
	on * * blink_leds $blah.led
	on msg|chat * msg %1 nie ma mnie. zostaw wiadomość.
	on sigusr1 * disconnect

$Id: on.txt,v 1.15 2002/10/16 12:27:10 wojtekka Exp $