// mały opis dostępnych zmiennych
// (c) copyright 2001-2006 wojtek kaniewski <wojtekka@irc.pl>
//                         adam wysocki <gophi@ekg.chmurka.net>

uin
	typ: liczba
	domyślna wartość: brak

	określa numer GG, z którego ma korzystać klient. niezbędna do
	połączenia z serwerem. automatycznie ustawiana po udanej
	rejestracji, gdy wcześniej była pusta.

password
	typ: tekst
	domyślna wartość: brak

	hasło użytkownika. niezbędne do połączenia z serwerem. automatycznie
	ustawiane po udanej rejestracji, gdy wcześniej było puste.

email
	typ: tekst
	domyślna wartość: brak

	adres e-mail użytkownika. automatycznie ustawiany po udanej rejestracji,
	gdy wcześniej był pusty.

audio_device
	typ: tekst
	domyślna wartość: "/dev/dsp"

	urządzenie dźwiękowe, którego należy używać przy rozmowach głosowych.
	jeśli poprzedzi się je minusem ,,-'', sygnał z wejścia urządzenia nie
	będzie wysyłany podczas rozmowy głosowej.

auto_away
	typ: liczba
	domyślna wartość: 600

	wartość określająca, po jakim czasie stan użytkownika zostanie
	zmieniony na ,,zajęty''. podaje się w sekundach. jeśli równa 0,
	nie będzie automatycznej zmiany.

auto_away_keep_descr
	typ: bool
	domyślna wartość: 1

	określa, czy zachowywać opis przy automatycznym przejściu w stan
	,,zajęty'' niezależnie od wartości zmiennej ,,keep_reason''.

auto_back
	typ: liczba
	domyślna wartość: 0

	wartość określająca, czy stan ma być automatycznie zmieniany na
	dostępny, jeśli obecny stan ,,zajęty'' został ustawiony automatycznie.
	jeśli równa 1, stan jest zmieniany na dostępny przy wysłaniu
	jakiejkolwiek wiadomości. jeśli równa 2, przy wciśnięciu klawisza.

auto_conference
	typ: bool
	domyślna wartość: 1

	określa, czy w momencie wysyłania wiadomości za pomocą /chat lub
	/query do wielu użytkowników ma być automatycznie utworzona
	konferencja.

auto_find
	typ: bool
	domyślna wartość: 0

	określa, czy osoby, których nie mamy na liście kontaktów, a wysłały
	do nas wiadomość, mają być automatycznie wyszukane w katalogu.

auto_reconnect
	typ: liczba
	domyślna wartość: 10

	w przypadku nieudanego połączenia, określa po ilu sekundach program
	ma ponowić próbę. jeśli równa 0, nie próbuje więcej.

auto_save
	typ: liczba
	domyślna wartość: 0

	po jakim czasie automatycznie zapisać ustawienia, w sekundach.
	jeśli 0, nie zapisuje automatycznie.

aspell
	typ: bool
	domyślna wartość: 0

	określa, czy słownik ma zostać włączony. 
	więcej o samym słowniku w slownik.txt.	

aspell_lang
	typ: tekst
	domyślna wartość: "pl"

	określa język wykorzystywany przez słownik.

aspell_encoding
	typ: tekst
	domyślna wartość: "iso8859-2"

	określa kodowanie używane przez słownik.

away_reason
	typ: tekst
	domyślna wartość: brak

	domyślny opis stanu zajętego, ustawiany przy zmianie bez podania 
	parametru.

back_reason
	typ: tekst
	domyślna wartość: brak

	domyślny opis stanu dostępnego, ustawiany przy zmianie bez podania 
	parametru.

backlog_overlap
	typ: liczba
	domyślna wartość: 0

	ilość zachodzących na siebie podczas przewijania (Page Up, Page 
	Down) linii. musi być mniejsza od rozmiaru okienka, w przeciwnym 
	wypadku wartość zostanie zignorowana. działa tylko w interfejsie 
	ncurses.

backlog_size
	typ: liczba
	domyślna wartość: 1000

	ilość linii, która będzie zapisywana w buforze ekranu (tym, który
	jest przewijany klawiszami Page Up i Page Down). nie może być
	mniejsza niż ilość linii na ekranie. działa tylko w interfejsie
	ncurses.

beep
	typ: bool
	domyślna wartość: 1

	określa, czy klient ma beepać w różnych sytuacjach. wyłączenie tej
	opcji spowoduje, że żadne zdarzenia związane z GG nie będą podnosiły 
	alarmu. niestety nie obejmuje to zdarzeń związanych z wprowadzanym 
	tekstem i przy tab-completion może się to przytrafić.

beep_msg
	typ: bool
	domyślna wartość: 1

	czy beepać przy nadchodzących wiadomościach. wyłączenie ,,beep''
	wyłącza również tę opcję.

beep_chat
	typ: bool
	domyślna wartość: 1

	czy beepać przy rozmowach. wyłączenie ,,beep'' wyłącza również tę
	opcję.

beep_notify
	typ: bool
	domyślna wartość: 1

	czy beepać przy zmianie stanu któregoś ze znajomych. wyłączenie
	,,beep'' wyłącza również tę opcję.

beep_mail
	typ: bool
	domyślna wartość: 1

	czy beepać przy nadejściu nowej poczty. wyłączenie ,,beep'' wyłącza
	również tę opcję.

beep_title
	typ: liczba
	domyślna wartość: 0

	czy informację o beepaniu umieścić również w pasku tytułowym? działa
	tylko w interfejsie ncurses na terminalu xterm. wartość 1 włącza
	informowanie w pasku, wartość 2 włącza informowanie w pasku i wyłącza
	zwykły sygnał dźwiękowy.

check_mail
	typ: liczba
	domyślna wartość: 0

	określa, czy ekg ma sprawdzać, czy nadeszła nowa poczta i informować
	o tym na pasku stanu. wartość 1 odpowiada sprawdzaniu skrzynki typu
	mbox, a wartość 2 skrzynki typu Maildir. dodanie wartości 4 oznacza,
	że oprócz informowania na pasku stanu, będziemy otrzymywać krótką
	informację o nadejściu poczty w aktualnym oknie. wszystkie dostępne
	wartości to: 0, 1, 2, 5, 6.

check_mail_frequency
	typ: liczba
	domyślna wartość: 15
	
	określa w sekundach, jak często sprawdzać, czy nie ma nowej poczty.

check_mail_folders
	typ: tekst
	domyślna wartość: brak

	zawiera pliki (mbox) lub katalogi (Maildir) rozdzielone przecinkiem lub
	spacją, które ekg ma sprawdzać, poza główną skrzynką pocztową. może to
	być ścieżka bezwzględna lub względem katalogu domowego.
	główna w przypadku mbox to ta zapisana w zmiennej systemowej MAIL lub
	/var/mail/user przy braku tej zmiennej. dla Maildir z kolei, to katalog
	Maildir w katalogu domowym użytkownika.

completion_notify
	typ: liczba
	domyślna wartość: 1

	określa, czy po pojawieniu się któregoś ze znajomych jego nick
	ma być dopisywany do listy dopełniania klawiszem Tab. jeśli jest
	równa 2, jest również usuwany po przejściu w stan niedostępny.
	dodanie wartości 4 spowoduje, że dopisywani będą także ci, którzy
	pojawią się na liście ze stanem ,,zajęty''. dodanie wartości 8 spowoduje
	dopisywanie także tych, którzy mają stan ,,niewidoczny''. wszystkie dostępne
	wartości to: 0, 1, 2, 5, 6, 9, 10, 13, 14.

ctrld_quits
	typ: bool
	domyślna wartość: 1

	określa, czy wciśnięcie Ctrl-D w ostatnim okienku, nie będąc
	w trybie, rozmowy klient na zakończyć działanie. ma znaczenie
	tylko dla interfejsu readline.

contacts
	typ: liczba
	domyślna wartość: 2

	określa, czy okienko z listą obecnych ma być wyświetlone z prawej
	strony ekranu, jeśli jest równe 1. jeśli jest równe 2, informacje
	o zmianie stanu nie są wyświetlane, ignorując wartość zmiennej
	,,display_notify''. działa tylko w interfejsie ncurses.

contacts_groups
	typ: tekst
	domyślna wartość: brak

	oddzielone przecinkiem grupy, które można przełączać w liście
	kontaktów klawiszem F4. domyślnie wyświetlani są wszyscy użytkownicy.

contacts_options
	typ: tekst
	domyślna wartość: brak

	opcje listy kontaktów oddzielone przecinkiem lub spacją. domyślne
	ustawienia to ,,right, frame, margin=1, nowrap, nodescr, order=0123''.
	możliwe stany to: 0 - dostępni, 1 - zajęci, 2 - niewidoczni, 3 -
	blokujący, 4 - niedostępni). można pominąć niektóre stany -- nie
	będą po prostu wyświetlane na liście.
	
	lista dostępnych opcji:
	- left, right, top, bottom - położenie listy kontaktów na ekranie,
	- frame, noframe - lista oddzielona ramką od głównego okna lub nie,
	- framecolor=n - kolor ramki oddzielającej od głównego okna
	- margin=n, nomargin - margines między listą a głównym oknem lub brak,
	- wrap, nowrap - treść listy będzie zawijana lub ucinana,
	- descr, nodescr - opisy stanu będą lub nie będą wyświetlane,
	- order=n - kolejność wyświetlanych stanów.
	
contacts_size
	typ: liczba
	domyślna wartość: 8
	
	określa szerokość okienka z listą kontaktów.

datestamp
	typ: tekst
	domyślna wartość: "%Y-%m-%d"

	w interfejsie ncurses określa format daty wyświetlanej, jeśli 
	jest włączona opcja display_daychanges i od ostatniej aktywności 
	w oknie zmienił się dzień. dokładny opis formatu zawiera strona 
	manuala strftime(3).

dcc
	typ: bool
	domyślna wartość: 0

	włącza lub wyłącza bezpośrednie połączenia między klientami. zmiana
	tej opcji wymaga ponownego połączenia z serwerem, by przesłać nowy
	adres IP lub jego brak.

dcc_ip
	typ: tekst
	domyślna wartość: brak

	określa adres IP, który jest wysyłany serwerowi. jeśli przypisze
	się tej zmiennej wartość ,,auto'', adres będzie ustalany 
	automatycznie. jeśli chcemy bezproblemowo łączyć się z klientami
	z tej samej sieci LAN, dobrze jest podać adres IP sieci LAN zamiast
	zewnętrznego.

dcc_backups
	typ: bool
	domyślna wartość: 0

	włącza lub wyłącza zapisywanie nowych plików pod nowymi nazwami 
	w przypadku, jeśli plik o podanej nazwie już istnieje. nowe nazwy 
	są tworzone przez dodanie do nazwy pliku sufiksu .1, .2 itp. aż 
	do .1000.

dcc_dir
	typ: tekst
	domyślna wartość: brak

	określa katalog, do którego będą zapisywane pobierane pliki.

dcc_filter
	typ: bool
	domyślna wartość: 1

	określa czy klient będzie filtrował połączenia bezpośrednie z adresów
	innych niż w liście kontaktów. zmienna ta może być przydatna, gdy
	osoba, która chce nam przesłać plik znajduje się za źle
	skonfigurowanym firewallem, nie potrafi ustawić przekierowania portów
	lub podobnych sytuacjach. należy wtedy chwilowo ją wyłączyć.

dcc_limit
	typ: tekst
	domyślna wartość: 30/30

	określa limit bezpośrednich połączeń w danym przedziale czasu.
	liczba przed ukośnikiem określa maksymalną ilość połączeń, a liczba
	po ukośniku ilość sekund. po przekroczeniu tego progu bezpośrednie
	połączenia zostają wyłączone, by zapobiec atakom polegającym na
	wyczerpaniu zasobów klienta. zwykle po ponownym włączeniu
	bezpośrednich połączeń należy połączyć się ponownie z serwerem.

dcc_port
	typ: liczba
	domyślna wartość: 1550

	port, na którym ekg będzie oczekiwać na połączenia bezpośrednie.

display_ack
	typ: liczba
	domyślna wartość: 3

	określa, czy i które powiadomienia o wysłaniu wiadomości mają
	być wyświetlane. 0 - żadne, 1 - wszystkie, 2 - tylko kiedy wiadomość
	dotarła do adresata, 3 - tylko kiedy adresat jest niedostępny i
	wiadomość została zachowania na serwerze.

display_color
	typ: liczba
	domyślna wartość: 1

	wartość 0 wyłącza wyświetlanie kolorów, wartość 1 włącza. wartość
	2 ma znaczenie tylko w interfejsie ncurses i powoduje wyświetlanie
	kolorów wszędzie poza paskiem stanu i nagłówkiem okna.

display_color_map
	typ: tekst
	domyślna wartość: "nTgGbBrR"

	określa, jakie kolory będą przypisane różnym atrybutom tekstu.
	musi zawierać 8 znaków zgodnych ze spisem z pliku docs/themes.txt.
	każdy z nich określa kolejno kolor dla:
	- brak atrybutów,
	- pogrubiony,
	- pochyły,
	- pochyły+pogrubiony,
	- podkreślony,
	- podkreślony+pogrubiony,
	- podkreślony+pochyły,
	- podkreślony+pochyły+pogrubiony.

display_crap
	typ: bool
	domyślna wartość: 1

	mówi, czy w oknie rozmowy mają być wyświetlane komunikaty niezwiązane
	z rozmówcą. jeśli jest równe 0, w oknie rozmowy są wyświetlane tylko
	wiadomości i informacje o zmianie stanu rozmówcy. ma znaczenie tylko
	w interfejsie ncurses.

display_daychanges
	typ: bool
	domyślna wartość: 1

	określa, czy w interfejsie ncurses będą wyświetlane zmiany daty. zmiana 
	jest wyświetlana tylko wtedy, kiedy w oknie nastąpi jakaś aktywność. 
	zobacz też opis zmiennej datestamp.

display_notify
	typ: liczba
	domyślna wartość: 1

	wartość 0 powoduje ignorowanie zmian stanu znajomych, wartość
	1 powoduje wyświetlanie wszystkich zmian, wartość 2 wyświetla
	tylko zmiany z niedostępnego na dostępny i na odwrót. dodanie
	4 sprawia, że podczas wyświetlania brane są pod uwagę także
	osoby z włączonym trybem ,,tylko dla znajomych'', które mają
	nas na liście kontaktów, a my ich nie mamy. w interfejsie ncurses
	większy priorytet ma zmienna ,,contacts'', która przy wartości
	2 ukrywa zmiany stanu. wszystkie dostępne wartości to 0, 1, 2, 5, 6.

display_pl_chars
	typ: bool
	domyślna wartość: 1

	jeśli włączone, wyświetlane są polskie literki na terminalu.
	w przeciwnym wypadku, zamieniane są na odpowiadające im literki
	ASCII.

display_sent
	typ: bool
	domyślna wartość: 1

	jeśli włączone, wyświetlane są również wysyłane wiadomości. należy
	zwrócić uwagę, że przy make_window = 2, wysłanie wiadomości utworzy
	automatycznie okienko rozmowy, a przy make_window = 1 tylko wtedy,
	gdy nie będzie żadnych wolnych okienek.

display_welcome
	typ: bool
	domyślna wartość: 1

	mówi, czy ekg ma wyświetlić tekst powitalny po uruchomieniu.

display_token
	typ: bool
	domyślna wartość: 1

	zmienna dostępna tylko gdy w systemie jest biblioteka pozwalająca
	dekodować pliki GIF. wyłączenie jej spowoduje działanie ekg tak,
	jakby biblioteki nie było, tj. zapisywanie tokenów do pliku.

display_transparent
	typ: bool
	domyślna wartość: 1

	mówi, czy w interfejsie ncurses tło ma być przezroczyste. zmiany
	odniosą skutek po ponownym uruchomieniu.

emoticons
	typ: bool
	domyślna wartość: 1

	uruchamia rozwijanie emotikonów w zdefiniowane teksty. więcej
	szczegółów w pliku docs/files.txt w sekcji 5-tej.

encryption
	typ: liczba
	domyślna wartość: 0

	włącza szyfrowanie wiadomości. jeśli w systemie jest zainstalowana
	biblioteka OpenSSL, możliwe jest używanie szyfrowania zgodnego z SIM
	opisanym na stronie http://gg.wha.la/crypt/. wartość 0 wyłącza 
	szyfrowanie. wartość 1 włącza. ustawienie wartości 2 sprawia, że 
	wysyłane są wiadomości niezaszyfrowane, ale odbierane szyfrowane 
	są deszyfrowane. ustawienie 3 sprawia, że wiadomości odbierane nie 
	są deszyfrowane, za to są szyfrowane wysyłane.

enter_scrolls
	typ: bool
	domyślna wartość: 0

	jeśli włączone, wciśnięcie klawisza Enter w pustej linii spowoduje
	przesunięcie ekranu o jedną linię. ma znaczenie tylko w interfejsie
	ncurses.

events_delay
	typ: liczba
	domyślna wartość: 3

	określa, po ilu sekundach od połączenia z serwerem zaczną działać
	zdarzenia ,,on'', dźwięki związane ze zmianami stanu i będą wyświetlane
	informacje o niedostępności osób. Chodzi o to, aby nie traktować
	początkowych informacji o stanie osób po połączeniu jako zmianę
	ich stanu.

header_size
	typ: liczba
	domyślna wartość: 0

	określa rozmiar nagłówka okna wyświetlanego na górze ekranu.
	maksymalna ilość linii to 5.

ignore_unknown_sender
	typ: bool
	domyślna wartość: 0

	określa, czy będą ignorowane wiadomości od osób, których nie mamy
	na swojej liście kontaktów.

ignore_empty_msg
	typ: bool
	domyślna wartość: 0

	określa, czy będą ignorowane puste wiadomości, zawierające jedynie
	obrazek, co może mieć miejsce, jeśli ktoś sprawdza, czy jesteśmy
	niewidoczni.

image_size
	typ: int
	domyślna wartość: 255

	maksymalny rozmiar akceptowanych przez nas obrazków w KiB. maksymalnie 
	255. istotne jedynie po włączeniu ,,receive_images''.

ioctld_enable
	typ: liczba
	domyślna wartość: 1

	jeśli 1, odpalany jest lokalny daemon ioctld, który lokalnie mruga
	diodkami i piszczy speakerem, jeżeli 2, odpalany jest daemon
	tcp/ip na porcie ioctld_net_port, do którego przekazywane są
	akcje blink_leds i beeps_spk. dzięki temu, używając ioctld-client.c
	z ekg/contrib, można lokalnie blinkać i beepać mając odpalone ekg
	na zdalnym hoście. jeżeli zaś 0, ioctld nie jest uruchamiany wcale.

ioctld_net_port
	typ: liczba
	domyślna wartość: 22004

	port, na którym nasłuchiwać będzie daemon ioctld przy ioctld_enable
	równym 2.

irssi_set_mode
	typ: bool
	domyślna wartość: 0

	jeśli 1, to podczas wykonania komendy /set arg1 wyświetlane
	będą wszystkie ustawienia, które w swojej nazwie zawierają arg1
	(domyślnie arg1 musi być równe tej nazwie). /set arg1 arg2,
	przypisujące zmiennej arg1 wartość arg2 pozostaje bez zmian.
	pomysł zaczerpnięty z irssi.

keep_reason
	typ: liczba
	domyślna wartość: 0

	jeśli włączona, komendy ,,away'', ,,back'', ,,invisible'', ,,quit''
	i ,,disconnect'' bez podanego powodu przejmą aktualny opis. zostanie
	on wraz ze stanem zapisany bez wyraźnego wydawania komendy zapisu 
	konfiguracji. wartość 2 powoduje zapisywanie opisu bez stanu.
	
last
	typ: liczba
	domyślna wartość: 0

	wskazuje, czy zapisywać ostatnie wiadomości do podręcznego bufora
	(,,last_size'' musi być większe od 0). dla 1, będzie zapisywać tylko
	last_size wszystkich wiadomości przychodzących, dla 2, last_size
	wiadomości od każdego usera. dostępna jest jeszcze logiczna
	wartość 4, która pozwala logować wiadomości wysłane. dostępne są
	w takim razie wartości 0, 1, 2, 5 i 6.
	
last_size
	typ: liczba
	domyślna wartość: 0

	wskazuje, ile ma być zapisywanych wiadomości dla komendy ,,last''.

local_ip
	typ: tekst
	domyślna wartość: brak

	określa adres IP, z którego następują wszelkiego rodzaju połączenia,
	na przykład z serwerem GG. w przypadku błędnie wpisanej wartości, 
	zostanie ona usunięta.

log
	typ: liczba
	domyślna wartość: 0

	określa, czy i w jaki sposób będą logowane wysyłane i otrzymywane
	wiadomości. dla 0, nie będą. dla 1, będą logowane w pliku, który
	określa zmienna ,,log_path'' lub ,,~/.gg/history'' w przypadku
	jej braku. dla 2, będą logowane w katalogu wskazanym przez zmienną
	,,log_path'', a nazwa pliku będzie numerem rozmówcy. jeśli mamy
	wkompilowaną obsługę skompresowanych logów, dodanie wartości 4
	wymusi kompresję logów. nie będzie ona działała, jeśli istnieje
	już nieskompresowany log. należy go wcześniej skompresować
	poleceniem gzip. wszystkie dostępne wartości to: 0, 1, 2, 5, 6.

log_ignored
	typ: liczba
	domyślna wartość: 0

	określa, czy logujemy ignorowane wiadomości oraz zmiany stanu.

log_status
	typ: liczba
	domyślna wartość: 0

	określa, czy będą logowane zmiany stanu ludzi z listy (zmienna
	,,log'' musi być różna od 0). jeśli jest równa 2, zmiany bez opisu
	nie będą logowane.
	
log_path
	typ: tekst
	domyślna wartość: brak

	ścieżka, gdzie będą zachowywane wysyłane i otrzymane wiadomości.

log_timestamp
	typ: tekst
	domyślna wartość: brak

	określa format czasu zapisywanego w historii. w przypadku braku,
	zmiennej, zapisuje w postaci ilości sekund od 1 stycznia 1970r.
	UTC. dokładny opis formatu zawiera strona manuala strftime(3).

make_window
	typ: liczba
	domyślna wartość: 2

	określa, czy będą tworzone nowe okienka dla nowych rozmów. dla 1 będzie
	wykorzystane pierwsze wolne okno (na którym z nikim jeszcze się nie
	rozmawia), lub tworzone nowe w przypadku braku wolnych. dla 2
	bezwarunkowo utworzone zostanie nowe okno. jeśli zostanie dodana 
	wartość 4, to wiadomości wysyłane przez /msg będą widoczne w oknie 
	stanu.

mesg
	typ: liczba
	domyślna wartość: 2

	ustala, czy zezwalamy na wysyłanie do nas komunikatów za pomocą write,
	talk lub wall. dla 0 nie wyrażamy na to zgody, dla 1 zezwalamy na
	pisanie na nasz terminal. w przypadku wartości 2 używane są ustawienia
	sprzed uruchomienia ekg.

msg_as_chat
	typ: int
	domyślna wartość: 0

	określa, czy wiadomości wysyłane przy pomocy polecenia /msg mają być 
	przesyłane tak, jakby były wysyłane przy pomocy polecenia /chat. dla 
	wartości 1 inne różnice między /msg a /chat (np. nie otwieranie nowego 
	okna rozmowy) nie są zmieniane. wartość 2 oznacza traktowanie polecenia 
	/msg jako /chat we wszystkich aspektach. zmienna została wprowadzona w 
	celu zapewnienia kompatybilności z klientami IRC - obecnie praktycznie 
	żaden klient nie wysyła wiadomości tak, jak robi to polecenie /msg, a 
	niektórzy użytkownicy, przyzwyczajeni do polecenia /msg w klientach IRC, 
	nie chcą zmieniać przyzwyczajeń.

nick
	typ: tekst
	domyślna wartość: brak

	ustala nasz nick, wyświetlany przy wysyłanych przez nas wiadomościach 
	w oknie rozmowy. w przypadku, kiedy mamy swój numerek zapisany na liście, 
	będzie wyświetlana pozycja z listy.

proxy
	typ: tekst
	domyślna wartość: brak

	adres i port serwera proxy, oddzielone dwukropkiem. jeśli nie podano
	portu, domyślnie jest przyjmowany 8080. jeśli serwer proxy wymaga
	autoryzacji, należy poprzedzić go nazwą użytkownika, dwukropkiem,
	hasłem i małpą (np. ,,jan:tajnehasło@serwer'')

proxy_forwarding
	typ: tekst
	domyślna wartość: brak

	adres i port (oddzielone dwukropkiem) serwera pośredniczącego
	(routera, proxy lub czegoś innego) przekierowany na port 1550
	naszego komputera.

query_commands
	typ: bool
	domyślna wartość: 1

	możliwość wydawania długich poleceń podczas rozmowy z użytkownikiem
	bez poprzedzania ich znakiem '/'.

quit_reason
	typ: tekst
	domyślna wartość: brak

	domyślny opis stanu niewidocznego, ustawiany przy zmianie bez podania
	parametru oraz stanu niedostępnego, ustawiany przy wychodzeniu.

random_reason
	typ: liczba
	domyślna wartość: 0

	określa, czy przy zmianie stanu i połączeniu ma być losowany opis (z 
	~/.gg/quit.reasons dla komend ,,quit'', ,,disconnect'', ,,invisible'', 
	~/.gg/away.reasons dla ,,away'' i ~/.gg/back.reasons dla ,,back'').
	dla 0 nie jest losowany, dla 1 losowany jest opis dotyczący stanu
	zajęty, dla 2 niedostępny, dla 4 dostępny, dla 8 niewidoczny.
	wartości te można ze sobą dodawać, np. 11 będzie dotyczyć stanów
	niedostępny, zajęty oraz niewidoczny. jeżeli z jakichś przyczyn
	nie powiedzie się odczyt, opis będzie pobierany ze zmiennych
	,,away_reason'' lub ,,quit_reason'', o ile nie są puste.

reason_limit
	typ: bool
	domyślna wartość: 0

	określa, czy opisy stanu muszą mieścić się w określonym przez
	protokół limicie. jeśli opcja jest aktywna i długość opisu
	przekracza tą długość, komendy /away, /back i /invisible nie
	zostaną wykonane.

receive_images
	typ: bool
	domyślna wartość: 0

	określa, czy chcemy otrzymywać obrazki. włączenie tej opcji przy 
	wyłączonej opcji ,,ignore_empty_msg'' może ujawnić nas dla użytkowników
	sprawdzających, czy jesteśmy niewidoczni. otrzymywane obrazki będą
	zapisywane w katalogu określonym zmienną dcc_dir.

regex_flags
	typ: int
	domyślna wartość: 0

	mapa bitowa określająca flagi podczas przetwarzania wyrażeń regularnych 
	w poleceniu /list --regexp. 1 oznacza używanie podstawowych wyrażeń, 2 
	uwzględnianie rozmiaru znaków.

save_question
	typ: bool
	domyślna wartość: 1

	określa, czy ma być zadawane pytanie o zapis zmienionej konfiguracji
	przy wyjściu z programu.

save_password
	typ: bool
	domyślna wartość: 1

	określa, czy hasło ma być zapisywane w pliku konfiguracyjnym. opcja
	ta może przydać się, gdy boimy się administratora przeglądającego
	pliki użytkowników.

server
	typ: tekst
	domyślna wartość: brak

	adresy IP serwerów, z którym klient powinien próbować się połączyć,
	pomijając właściwą procedurę łączenia się. przydane podczas awarii
	głównego serwera. adresy należy oddzielać przecinkami, średnikami
	lub spacjami. po dwukropku można podać port serwera. jeśli adres i
	port serwera zostaną poprzedzone tekstem ,,tls:'', klient spróbuje
	wynegocjować bezpieczne połączenie TLS z serwerem. jeśli zmiennej
	przypisze się wartość ,,tls'', spyta główny serwer o adres serwera
	obsługującego połączenia TLS i spróbuje się z nim połączyć.

server_save
	typ: bool
	domyślna wartość: 0

	określa, czy ekg ma zapamiętywać serwer, z którym ostatnio udało
	się połączyć. w przypadku włączenia tej zmiennej, zmienna ,,server''
	będzie automatycznie uaktualniana, a zawartość wpisana przez
	użytkownika zostanie usunięta.

slash_messages
	typ: bool
	domyślna wartość: 1

	określa, czy wiadomości zaczynające się od ,,/'' mają być traktowane 
	w pewnych warunkach jak wiadomości. wyłączenie tej opcji sprawia, że 
	wszystko, co zostanie wpisane w oknie rozmowy a zaczyna się od ,,/'' 
	zostanie potraktowane jak komenda.

sms_away
	typ: liczba
	domyślna wartość: 0

	włączenie tej opcji powoduje wysyłanie otrzymanych wiadomości na
	telefon komórkowy podczas nieobecności (stan ,,zajęty''). wymaga
	zdefiniowania zmiennych ,,sms_number'' i ,,sms_send_app''.
	jeżeli wartością jest 1, to zmienna ,,sms_away_limit'' (jeśli różna
	od 0) dotyczyć będzie łącznej liczby wiadomości wysłanych na telefon
	komórkowy. wartość 2, z kolei, wskazuje na to, że limit dotyczy
	ilości wiadomości od każdej osoby. dodanie wartości 4, spowoduje,
	że funkcja będzie także aktywna, gdy jesteśmy niewidoczni.

sms_away_limit
	typ: liczba
	domyślna wartość: 0

	określa limit wiadomości, które mogą zostać wysłane na telefon
	komórkowy podczas naszej nieobecności. jeśli 0, to wiadomości nie
	są limitowane.	

sms_max_length
	typ: liczba
	domyślna wartość: 100

	maksymalna długość przekazywanych wiadomości. powyżej tego limitu
	wiadomość zostanie ucięta. jeśli równa 0, nie ma limitu.

sms_number
	typ: tekst
	domyślna wartość: brak

	numer telefonu komórkowego, na który mają być wysyłane wiadomości
	podczas nieobecności.

sms_send_app
	typ: tekst
	domyślna wartość: brak

	pełna ścieżka do programu wysyłającego SMSy. program musi za
	pierwszy parametr przyjmować numer odbiorcy, za drugi parametr
	treść wiadomości. do tego celu nadaje się program Mikołaja
	Rydzewskiego ze strony http://ceti.pl/~miki/

sort_windows
	typ: bool
	domyślna wartość: 0

	włączenie tej opcji spowoduje przesuwanie okien przy usunięciu
	któregoś ze środka i likwidowanie luk w numeracji. na przykład,
	gdy mamy okna 1,2,3, to po usunięciu drugiego otrzymamy 1,2
	zamiast 1,3.

sound_app
	typ: tekst
	domyślna wartość: brak

	pełna ścieżka do programu odtwarzającego pliki zdefiniowane w
	zmiennych ,,sound_{msg,chat,sysmsg}_file''. program musi brać
	za pierwszy (i jedyny) parametr nazwę pliku. wavplay i mpg123
	doskonale się nadają.

sound_msg_file
	typ: tekst
	domyślna wartość: brak

	plik dźwiękowy odtwarzany po otrzymaniu wiadomości.

sound_chat_file
	typ: tekst
	domyślna wartość: brak

	plik dźwiękowy odtwarzany w czasie rozmowy.

sound_notify_file
	typ: tekst
	domyślna wartość: brak

	plik dźwiękowy odtwarzany po zmianie stanu któregoś ze znajomych.

sound_sysmsg_file
	typ: tekst
	domyślna wartość: brak

	plik dźwiękowy odtwarzany po otrzymaniu wiadomości systemowej.

sound_mail_file
	typ: tekst
	domyślna wartość: brak

	plik dźwiękowy odtwarzany po otrzymaniu nowej wiadomości e-mail.

speech_app
	typ: tekst
	domyślna wartość: brak

	aplikacja używana do odczytywania tekstów wyświetlanych na ekranie.
	jej ustawienie powoduje również zmianę motywu na taki, który jest
	łatwiejszy do wymówienia.

status_window
	typ: liczba
	domyślna wartość: 0

	określa okno, do którego kierowane są zmiany stanu innych osób. 0 - 
	okno rozmowy z osobą, której dotyczy zmiana (lub okno stanu, jeśli 
	nie ma otwartego okna rozmowy z tą osobą), 1 - bieżące okno, 2 - 
	okno stanu.

statusbar_size
	typ: liczba
	domyślna wartość: 1

	określa rozmiar paska stanu w liniach w zakresie od 1 do 5.

statusbar_fgcolor
	typ: liczba
	domyślna wartość: 7

	określa kolor tekstu w pasku stanu. z reguły jest nadpisany
	przez themik, więc ta zmienna jest mało przydatna.

statusbar_bgcolor
	typ: liczba
	domyślna wartość: 4

	określa kolor tła pasku stanu. domyślnie niebieski.

tab_command
	typ: tekst
	domyślna wartość: "chat"

	komenda, która będzie wstawiana w linii poleceń z kolejną
	dostępną (patrz zmienna ,,completion_notify'') osobą z listy
	kontaktów po wciśnięciu klawisza Tab.

theme
	typ: tekst
	domyślna wartość: brak

	zawiera nazwę pliku określającego motyw.

time_deviation
	typ: liczba
	domyślna wartość: 300

	określa zakres rozbieżności czasu odbieranych względem czasu
	systemowego w sekundach, który jest traktowany jako chwila
	aktualna. ma to wpływ na wyświetlanie timestampów przy odbieranych
	wiadomościach. jeśli czas odebranej wiadomości mieści się w +/-
	podanego zakresu, timestamp nie jest wyświetlany.

timestamp
	typ: tekst
	domyślna wartość: "%H:%M "

	w interfejsie ncurses określa format czasu wyświetlanego na
	początku każdej linii. dokładny opis formatu zawiera strona
	manuala strftime(3).

userlist_backup
	typ: bool
	domyślna wartość: 0

	określa, czy przed zaimportowaniem listy kontaktów z serwera 
	zapisać aktualną listę w pliku ~/.gg/userlist.pid (gdzie pid 
	to numer procesu ekg). jeżeli zaimportowana zostanie także 
	konfiguracja, to aktualna konfiguracja zostanie zapisana w 
	pliku ~/.gg/config.pid.

wap_enabled
	typ: bool
	domyślna wartość: 2

	jeśli wkompilowano obsługę WAP, pozawala tymczasowo wyłączyć tę
	usługę. wartość 1 używa poprzedniego formatu zapisu do pliku
	WAP.

windows_save
	typ: liczba
	domyślna wartość: 0

	określa, czy ustawienie okienek ma być zachowywane. jeśli wynosi 0,
	okienka nie są zachowywane. dla wartości 1 są zachowywane przy 
	wychodzeniu z programu. ustawienie 2 powoduje zapis tylko przy 
	użyciu polecenia /save wartość 3 natomiast sprawia, że ustawienie 
	okienek jest zapisywane zarówno przy wychodzeniu z programu, jak 
	przy /save. warto wspomnieć, że polecenie /reload nie przywraca 
	stanu okienek. zmienna ma znaczenie tylko w interfejsie ncurses.

status
	typ: liczba, zmienna wewnętrzna, ukryta

	określa stan klienta (zajęty/niewidoczny/tylko dla przyjaciół)
	po uruchomieniu i pierwszym połączeniu. zachowywana przy poleceniu
	,,save''.

reason
	typ: tekst, zmienna wewnętrzna, ukryta

	określa opis stanu klienta. zachowywana przy poleceniu ,,save''.
	jest usuwana przy każdej zmianie stanu lub wyjściu z klienta,
	chyba że włączona jest zmienna ,,keep_reason''.

interface
	typ: tekst, zmienna wewnętrzna, ukryta

	określa domyślny interfejs programu. jej wartość jest zmieniana
	przez podanie parametru -f w wywołaniu programu i automatycznie
	zapisywana.

password_cp1250
	typ: bool, zmienna wewnętrzna, ukryta

	przy włączonej opcji nie będzie przeprowadzana konwersja hasła
	ze standardu ISO-8859-2 na CP1250.

protocol
	typ: liczba, zmienna wewnętrzna, ukryta

	określa wersję klienta, którą przedstawia się ekg. może być używana
	do udawania nowszego klienta, gdy biblioteka jeszcze jej nie zna.
	zmienna ta nie powinna być używana przez zwykłych użytkowników.

last_sysmsg
	typ: liczba, zmienna wewnętrzna, ukryta

	określa numer ostatniej wiadomości systemowej.

windows_layout
	typ: tekst, zmienna wewnętrzna, ukryta

	zawiera informacje o okienkach. wpis każdego okna jest rozdzielony
	znakiem ,,|''. jeśli okno nie ma przypisanej rozmowy, wpis jest
	pusty. jeśli okno nie istnieje, wpis zawiera ,,-''.


$Id: vars.txt,v 1.181.2.6 2007-04-28 20:02:20 porridge Exp $
