<!--
   userbook.xml
-->

<chapter id="faq">
   <title>
      Często Zadawane Pytania
   </title>
   <sect1 id="faq-install">
      <title>Instalacja</title>
      <qandaset>
         <qandaentry>
            <question>
               <para>
                  Skąd ściągnąć źródła EKG2 ?
               </para>
            </question>
            <answer>
               <para>
                  Zapraszam na <ulink url="http://ekg2.org">/http://ekg2.org/</ulink>
                  do dzialu Pliki i stamtąd można ściagać codzinne snapshoty. Można
                  również skorzystać z CVS'a który pozwala być na bieżąco z
                  aktualizacjami (np. jak sie okaże że 10 minut temu naprawiono błąd
                  powodujące Segmentation Fault naszego EKG2). Sposób postępowania
                  jest oczywisty bo wszystko ładnie zostało opisane na stronce, więc
                  nie będę powielał.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Plugin gg/irca/jabbera mi nie działa, co zrobić ?
               </para>
            </question>
            <answer>
               <para>
                  Po pierwsze sprawdź czy komenda <command>/plugins</command>
		  pokazuje odpowiedni plugin, jeśli tak, to coś kręcisz ;>
		  Jeśli nie spróbuj <command>/plugins +nazwawtyczki</command>.
		  Jeśli nie podawałeś opcji --prefix do <command>./configure</command>
		  czy <command>./autogen.sh</command> to sprawdź, czy w katalogu
		  <filename>/usr/local/lib/ekg2/plugins</filename> znajdują się pliki
		  <filename>*.so</filename> i <filename>*.la</filename> dla odpowiedniego
		  pluginu (np: <filename>gg.so</filename>, <filename>gg.la</filename>)
		  Jeśli nie ma, to albo odpowiednie pluginy nie zostały skompilowane,
		  albo coś ze ścieżkami na tym systemie jest nie tak.
		  Możesz też spróbować dodać (jako root oczywiście) do
		  <filename>/etc/ld.so.conf</filename> ścieżkę: 
		  <filename>/usr/local/lib</filename> następnie wydać komendę
		  <command>ldconfig</command>.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Mam wersję CVS EKG2 ale przy wykonywaniu ./autogen.sh pojawiaja mi
                  się błedy o brakującym libtoolize, libtool, aclocal, autoheader,
                  automake, autoconf, autom4te. Co z tym zrobic?
               </para>
            </question>
            <answer>
               <para>
                  Wpierw upewnij się, że masz zainstalowane w systemie najnowsze
                  wersje tychże narzędzi (proponuje przejrzeć zawartość
                  <filename>/usr/ports/devel</filename> w ich poszukiwaniu a jeśli
                  nie umiesz instalować z portsów to polecam <command>man
                     ports</command>). Jeśli pomimo tego, iż masz zainstalowane te
                  narzędzia pojawiają Ci się błedy oznacza to, iż nie widzi ich w
                  systemie. Jest to zapewne spowodowane tym, że nie ma symlinków
                  odnoszących sie do w/w narzędzi. Wszystkie one znajdują się
                  standardowo w katalogu <filename>/usr/local/bin</filename> i
                  proponuje porobić symlinki do tychże narzędzi. Np. <command>ln
                     -s libtoolize19 libtoolize</command> i tak po kolei dla
                  wszystkich innych narzędzi. A najlepiej, na przyszłość, dla
                  wszystkich narzędzi zakończonych liczbami a nie mających
                  symlinków do wersji bez liczb, a w szczególności dla tych
                  wszystkich auto-narzędzi.   
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  W systemie BSD, przy wywołaniu <command>./configure</command>
                  jak i <command>./autogen.sh</command> pojawia mi się, iż libgadu
                  czy też expat (biblioteka jabbera) sa wyłaczone (disabled).  Co
                  robić?
               </para>
            </question>
            <answer>
               <para>
                  Jako, że FreeBSD ma inną lokalizację plików bibliotecznych czasem,
                  aczkolwiek nie zawsze, nie widzi odpowiednich bibliotek. Polecam
                  wtedy dodac opcje --with-libgadu=/usr/local jak również
                  --with-expat=/usr/local. Oczywiście powyższe tzreba mieć w systemie
                  skompilowane jeśli ich nie posiadamy.
               </para>
               <programlisting role="shell">
<![CDATA[
$ ./autogen.sh --with-libgadu=/usr/local --with-expat=/usr/local 
$ ./configure --with-libgadu=/usr/local --with-expat=/usr/local
]]>
               </programlisting>
               <para>
                  <emphasis>libgadu</emphasis> znajdziemy na stronie <ulink
                     url="http://dev.null.pl/ekg/">http://dev.null.pl/ekg/</ulink>
                  (libgadu powinniśmy oczywiście skompilować z opcją
                  <parameter>--enable-shared</parameter>).
               </para>
               <para>
                  <emphasis>expat</emphasis> znajdziemy w oficjalnym drzewie portów lub też, w
                  najnowszych wersjach FreeBSD (FreeBSD 5.3.x), w źródłach
                  systemu.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  W systemie BSD przy kompilacji pokazuje mi się błąd o braku
                  libintl.h z pakietu gettext.h:
               </para>
               <screen>
<![CDATA[
gcc -DHAVE_CONFIG_H -I. -I. -I../.. -I../../libltdl -g -O2 -Wall -MT main.lo -M
D -MP -MF .deps/main.Tpo -c main.c  -fPIC -DPIC -o .libs/main.o
In file included from ../../ekg/themes.h:27,
                 from main.c:41:
../../gettext.h:26:22: libintl.h: No such file or directory
]]>
               </screen>
               <para>
                  gettext jest zainstalowany w systemie. Co robić?
               </para>
            </question>
            <answer>
               <para>
                  Niestety ale znowu jest to spowodowane tym, iż BSD mają nieco
                  inne położenie bibliotek systemowych niż linuksy. Najprostszym
                  rozwiązaniem jest dopisać przy <command>./autogen.sh</command>
                  lub <command>./configure opcji
                     --with-libintl-prefix=/usr/local/include</command>
               </para>
               <programlisting role="shell">
<![CDATA[
$ ./autogen.sh --with-libintl-prefix=/usr/local/include
$ ./configure --with-libintl-prefix=/usr/local/include
]]>
               </programlisting>
            </answer>
         </qandaentry>
      </qandaset>
   </sect1>
   <sect1 id="faq-usage">
      <title>Użytkowanie</title>
      <qandaset>
         <qandaentry>
            <question>
               <para>
                  Gdzie podziały się niektóre zmienne (proxy, server) ?
               </para>
            </question>
            <answer>
               <para>
                  Jako, że są to zmienne specyficzne dla każdego protokołu
                  umieszczone są w zmiennych sesyjnych.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Jak usunąć zmienną?
               </para>
            </question>
            <answer>
               <para>
                  <command>set -zmienna</command>
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  ekg źle rozpoznaje płeć!
               </para>
            </question>
            <answer>
               <para>
                  Wpisz imię do listy kontaktów.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Jak zrobić, żeby ekg pokazywało mój pseudonim przy wysyłaniu
                  wiadomości?
               </para>
            </question>
            <answer>
               <para>
                  Dopisać alias do sesji.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Po zmianie wielkości terminala przestają mi działać strzałki!
               </para>
            </question>
            <answer>
               <para>
                  Masz starą wersję biblioteki ncurses. Zainstaluj nowszą
                  wersję lub poproś o to administratora systemu.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Jak wyświetlać wiadomości, które wysyłam?
               </para>
            </question>
            <answer>
               <para>
                  Należy ustawić wartość zmiennej
                  <varname>display_sent</varname> na <literal>1</literal>.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Nie mam kolorów w ekg, co robić?
               </para>
            </question>
            <answer>
               <para>
                  Najprawdopodobniej masz ustawiony nieprawidłowy typ
                  terminala. Spróbuj wpisać <command>export TERM=ansi</command>
                  (lub <command>setenv TERM ansi</command> dla powłoki *csh)
                  przed uruchomieniem ekg. Jeśli to nie pomoże, zamiast
                  <literal>ansi</literal> spróbuj podać
                  <literal>screen</literal>, <literal>linux</literal>,
                  <literal>xterm-color</literal> lub
                  <literal>color_xterm</literal>.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Jak dodać kogoś do listy kontaktów w GG?
               </para>
            </question>
            <answer>
               <para>
                  <command>/add gg:1234567 Pseudonim</command>
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Przy dodawaniu kogoś do listy kontaktów w GG dostaję błąd
                  <computeroutput>invalid id</computeroutput>, co zrobić?
               </para>
            </question>
            <answer>
               <para>
                  Upewnij się, że plugin gg jest załadowany. Polecenie
                  <command>/plugin +gg</command> powinno pomóc.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Po wydaniu polecenia <command>/plugin +gg</command> program
                  mówi, że nie może odnaleźć pluginu
               </para>
            </question>
            <answer>
               <para>
                  Upewnij się, że plugin gg jest skompilowany (w katalogu
                  <filename>${prefix}/lib/ekg2/plugins/</filename> powinny
                  znajdować się pliki <filename>gg.so</filename> i
                  <filename>gg.la</filename>) oraz, że ekg2 zostało
                  skompilowane z obsługą libgadu (w jednej z ostatnich linijek
                  wyświetlonych przez polecenie <command>./configure</command>,
                  powinno się wyświetlić <computeroutput>libgadu:
                     enabled</computeroutput>)
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Mam libgadu a mimo to <command>./configure</command>
                  wyświetla <computeroutput>libgadu: disabled</computeroutput>
               </para>
            </question>
            <answer>
               <para>
                  Upewnij się, że <command>./configure</command> może odnaleźć
                  pliki nagłówkowe biblioteki libgadu (m. in.
                  <filename>libgadu.h</filename> oraz bibliotekę
                  <filename>libgadu.so.3</filename>:
                  <itemizedlist>
                     <listitem>
                        <simpara>
                           katalog w którym znajduje się libgadu.so.3 powinien
                           być dopisany do pliku
                           <filename>/etc/ld.so.conf</filename>; jeśli go tam
                           nie ma, to należy go dopisać i uruchomić program
                           <command>ldconfig</command> jako root
                        </simpara>
                     </listitem>
                     <listitem>
                        <simpara>
                           jeżeli to nie pomaga, a
                           <filename>libgadu.so.3</filename> znajduje się w
                           niestandardowym miejscu, można spróbować zrobić
                           symboliczny link do tego pliku w
                           <filename>/usr/lib</filename>
                        </simpara>
                     </listitem>
                  </itemizedlist>
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Mam libgadu, plugin gg jest skompilowany, mimo to przy próbie
                  załadowania pluginu ekg2 wyświetla, że nie może go odnaleźć
               </para>
            </question>
            <answer>
               <para>
                  Upewnij się, że ekg2 może odnaleźć bibliotekę libgadu.so.3 -
                  odpowiednie kroki zostały przedstawione w pytaniu powyżej.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  W moim systemie nie ma pliku
                  <filename>libgadu.so.3</filename>
               </para>
            </question>
            <answer>
               <para>
                  Pobierz najnowsze libgadu, które można znaleźć pod adresem
                  <ulink url="http://dev.null.pl/ekg/libgadu-current.tar.gz">
                     http://dev.null.pl/ekg/libgadu-current.tar.gz </ulink>,
                  rozpakuj, skonfiguruj poleceniem <command>./configure
                     --enable-shared</command>, skompiluj poleceniem
                  <command>make</command> i jako root zainstaluj poleceniem
                  <command>make install</command>
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  Jak ustawić tryb prywatny dla sesji Gadu-Gadu?
               </para>
            </question>
            <answer>
               <para>
                  Wystarczy ustawić zmienną sesyjną <varname>private</varname>
                  na <literal>1</literal>, na przykład <command>/session
                     gg:997997 private 1</command>
               </para>
            </answer>
         </qandaentry>
      </qandaset>
   </sect1>
</chapter>
<!--
   vim: filetype=docbk encoding=iso-8859-2
-->
