<chapter id="installation">
<title>Installation</title>

<para>This chapter describes obtaining and building &quanta;.</para>


<sect1 id="acquiring-qunata">
<title>Acquiring &quanta;</title>

<sect2 id="binary-packages">
<title>&quanta; binary packages</title>

<para>Many linux distros are bundling &quanta;.  Please check your favorite vendors site for a
package tailored to your distro.  If that fails, see <ulink url="http://www.linux-easy.com/daily/">Linux Easy</ulink>
 for a <ulink url="http://www.redhat.com">RedHat</ulink> oriented rpm of the latest cvs source.</para>
</sect2>

<sect2 id="source-code">
<title>&quanta; source code</title>
<sect3 id="source-code-stable">
<title>&quanta; releases</title>
<para>Release versions of the &quanta; source code can be obtained from the <ulink url="http://quanta.sourceforge.net">
SourceForge home page</ulink>.  Once downloaded, simply unpack it into a directory and then go to <link linkend="source-code-building">
Building the source</link> to finish.</para>
</sect3>

<sect3 id="source-code-cvs">
<title>&quanta; CVS access</title>
<para>If you have to have access to the very latest features (and potentially, bugs), you can obtain &quanta;
via anonymous CVS with the following:</para>

<informalexample>
<screen>
<prompt>%</prompt><userinput><command>cvs</command> <option>-d:pserver:anonymous@anoncvs.kde.org:/home/kde login</option></userinput>
<prompt>CVS login:</prompt><userinput>&lt;enter&gt;</userinput>
<prompt>%</prompt><userinput><command>cvs</command> <option>-d:pserver:anonymous@anoncvs.kde.org:/home/kde co quanta</option></userinput>
</screen>
<para>A short download later, you should have a quanta directory under your current working directory.</para>
<para>To finish things up, <command>cd</command> to the quanta/admin directory and type:</para>
<screen>
<prompt>%</prompt><userinput><command>cvs</command> <option>update -P -C -d -R -r KDE_3_0_BASE</option></userinput>
</screen>
<para>A short while later, all these files will be updated.  One last bit before we can <link linkend="source-code-building">
build the source</link>.</para>
<screen>
<prompt>%</prompt><userinput><command>make</command> <option>-f Makefile.cvs</option></userinput>
</screen>
<para>This creates a number of files necessary to build the source.  From here go to <link linkend="source-code-building">
Building the source</link> to finish.</para>
</informalexample>
</sect3>
</sect2>
</sect1>

<sect1 id="source-code-building">
<title>Building the source</title>
<para>If you acquired &quanta; source from CVS, be sure to read <link linkend="source-code-cvs">this.</link></para>

<para>&quanta; uses automake and autoconf to ease installation from source.  If you're familiar with
these, skip to <link linkend="source-code-building-considerations">&quanta; build considerations</link>, otherwise,
please read the following.</para>

<para>To install quanta you need  KDE 3 and Qt 3.0.x, and run:</para>
<informalexample>
<screen>
<prompt>%</prompt><userinput><command>test</command> <option>`echo $<envar>KDEDIR</envar>` &amp;&amp; echo "KDEDIR ok" || echo "KDEDIR not exported"</option></userinput>
<prompt>%</prompt><userinput><command>test</command> <option>`echo $<envar>QTDIR</envar>` &amp;&amp; echo "QTDIR ok" || echo "QTDIR not exported"</option></userinput>
a
b
</screen>
<para>If these don't return KDEDIR ok and QTDIR ok, you need to set them permanently or in a script that you call to execute &quanta;
and before you continue with the build process.</para>
<para>Once these are verified to be set, run the following:</para>
<screen>
<prompt>%</prompt><userinput><command>./configure</command></userinput>
<prompt>%</prompt><userinput><command>make</command></userinput>
<prompt>%</prompt><userinput><command>make install (as root)</command></userinput>
...

*************** Important *************************

 Add <filename>path-to-kde3-bin-directory</filename> to your <envar>PATH</envar>

 Please report bugs with our web form at
 http://bugs.kde.org
    Crediting original team members
 Alexander Yakovlev <email>yshurik@kde.org</email>
 Dmitry Poplavsky   <email>dima@kde.org</email>
    Current maintainers are
 Eric Laffoon       <email>sequitur@kde.org</email>
 Andras Mantia      <email>amantia@freemail.hu</email>

 The Quanta developers wish you fun with Quanta.
****************************************************
</screen>
</informalexample>
<sect2 id="source-code-building-considerations">
<title>Considerations when building</title>
<para>It's reasonable that you would want to customize the location of the &quanta; files on your system.
  To this end, autoconf has a number of options that can be passed to the configure script to control
this setup.  To get a complete listing of these options, type <command>./configure</command> <option>
--help</option>.  These are straight forward and will not be covered here.</para>

<para>If you're having trouble with &quanta; running properly, you should check your path to ensure that
the kde3 bin directory is in there.  Also, be sure that you don't have any older versions of KDE laying about
that appear in %PATH before your kde3 bin directory.  The same holds true for Qt.
</para>
</sect2>
</sect1>
</chapter>
