<!--
   userbook.xml
-->

<chapter id="faq">
   <title>
      Frequently Asked Questions 
   </title>
   <sect1 id="faq-install">
      <title>Installation</title>
      <qandaset>
         <qandaentry>
            <question>
               <para>
                  Where can I find EKG2 sources ?
               </para>
            </question>
            <answer>
               <para>
	          You should visit <ulink url="http://ekg2.org">/http://ekg2.org</ulink>.
		  There is some Files section and you can download from there everyday
		  snapshots. You can also use CVS, which makes you able to have current
		  version of program (for instance. if somebody fixed some segvault problem 
		  with EKG2 10 minutes ago). Way of using CVS is described on webpage.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
  	          I have CVS EKG2, but when I'm doing ./autogen some errors about 
		  missing libtoolize, libttol, aclocal, autoheader, automake, autoconf,
		  autom4te appear. What should I do ?
               </para>
            </question>
            <answer>
               <para>
     		  First of all check if you have installed newest versions of 
		  those tools (maybe you should browse <filename>/usr/ports/devel
		  </filename>). If you have installed everything it means that 
		  EKG2 can't find them. It is caused by missing simlinks connected
		  with those tools. Usually they are in <filename>/usr/local/bin
		  </filename> and I suggest to make some symlinks like <command>ln
		    -s libtoolize19 libtoolize</command> and do this with every tool.
	  	  I suggest to do it always with autotools.
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
  	          In BSD system when I'm executing <command>./configure</command> libgadu
		  or/and expat is disabled. What should I do ? 
               </para>
            </question>
            <answer>
               <para>
		  FreeBSD has other localization of library files and sometimes it is hard
		  to find them. It is recommended to add arguments --with-libgadu=/usr/local
		  or/and --with-expat=/usr/local. Of course you have to have them installed.
               </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> can be found on <ulink
                     url="http://dev.null.pl/ekg/">http://dev.null.pl/ekg/</ulink>
	          (libgadu should be compiled with <parameter>--enable-shared</parameter>
	     	  parametr).
               </para>
               <para>
		   <emphasis>expat</emphasis> can be found in official ports tree or in system
		   sources (in newest versions like FreeBSD 5.3.x or newer).
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
		  In BSD system when I'm trying to compile program some errors about libintl.h
		  from gettext.h apper.     
               </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 is installed in system. What should I do ?
               </para>
            </question>
            <answer>
               <para>
		  Unfortunatly it is caused by diffrent localization of libraries
		  (diffrent then in Linux systems). The easier solution is to add
		  to <command>./autogen.sh</command> or <command>./configure option
                     --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>Usage</title>
      <qandaset>
         <qandaentry>
            <question>
               <para>
		  Where are some variables like proxy, server etc ?     
               </para>
            </question>
            <answer>
               <para>
		  Variables like this ones are specific for every protocol and
		  they are in session variables.     
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
               <para>
                  How can I remove variable ?
               </para>
            </question>
            <answer>
               <para>
                  <command>set -variable</command>
               </para>
            </answer>
         </qandaentry>
         <qandaentry>
            <question>
	       <para>
		  EKG2 doesn't show my nickname when I'm sending messages.
      		  What should I do ?		  
               </para>
            </question>
            <answer>
               <para>
                  You should add alias variable to session.
               </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
-->
