// mały opis dostępnych zmiennych // (c) copyright 2001-2006 wojtek kaniewski // adam wysocki 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=501623''. możliwe stany to: 0 - dostępni, 1 - zajęci, 2 - niewidoczni, 3 - blokujący, 4 - niedostępni, 5 - poGGadaj ze mną, 6 - nie przeszkadzać. 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. dnd_reason typ: tekst domyślna wartość: brak domyślny opis stanu nie przeszkadzać, ustawiany przy zmianie bez podania parametru. 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. ffc_reason typ: tekst domyślna wartość: brak domyślny opis stanu poGGadaj ze mną, ustawiany przy zmianie bez podania parametru. files_mode_config typ: int domyślna wartość: 600 określa tryby dostępu do plików konfiguracyjnych ekg (config, userlist, debug, history, kolejka wiadomości, pliki wymieniane z ekgwap). wartość nie wpływa na tryby plików tworzonych podczas generowania crashdumpów oraz na tryby katalogów tworzonych podczas używania ekg. UWAGA: nieprawidłowe użycie tej zmiennej może umożliwić dostęp do konfiguracji (w tym hasła) oraz archiwum osobom niepowołanym. przed użyciem przeczytaj man chmod. files_mode_received typ: int domyślna wartość: 600 określa tryby dostępu do plików tworzonych przez ekg podczas odbierania danych od innych użytkowników (dcc oraz obrazki). domyślna wartość 600 oznacza, że pliki są dostępne jedynie dla użytkownika, który uruchomił ekg. więcej na temat uprawnień: man chmod. 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ń. mouse typ: bool domyślna wartość: 0 ustala, czy ma być włączona obsługa myszy w ekg. działa tylko z interfejsem ncurses. zmiana wartości tej zmiennej może też (ale nie musi) zmieniać widoczność lub kształt kursora myszy. więcej informacji na temat obsługi myszy w ekg znajduje sie w pliku docs/mysz.txt oraz pod adresem . 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$