kplayer/doc/en/howto-compilation.docbook

<sect1 id="howto-compilation">
<title>Compiling from source</title>

<para>First, download and install development packages for &kde;, Qt, and X11.
Those should be available in your distribution, for example in Debian the
package names are <literal>kdelibs4-dev</literal>,
<literal>libqt3-mt-dev</literal> and <literal>xlibs-dev</literal>. You may need
other development packages as well.</para>

<sect2 id="howto-compilation-sources">
<title>Getting sources</title>

<sect3 id="howto-compilation-release">
<title>Official release</title>

<para>Download the latest <literal>.tar.bz2</literal> from the
<ulink url="http://sourceforge.net/project/showfiles.php?group_id=71710">Files
section</ulink> of &kplayer; project at SourceForge. Then extract it</para>

<para><userinput><command>tar</command> <option>xjf</option>
<filename>kplayer-0.6.2.tar.bz2</filename></userinput></para>

<para>The code will be in the <filename>kplayer-0.6.2</filename>
subdirectory</para>

<para><userinput><command>cd</command>
<filename>kplayer-0.6.2</filename></userinput></para>

</sect3>

<sect3 id="howto-compilation-cvs">
<title>Current CVS</title>

<para>Login to SourceForge CVS</para>

<para><userinput><command>cvs</command>
<option>-d:pserver:anonymous@kplayer.cvs.sourceforge.net:/cvsroot/kplayer</option>
login</userinput></para>

<para>and hit &Enter; if it asks for a password. Then download the code</para>

<para><userinput><command>cvs</command> <option>-z3</option>
<option>-d:pserver:anonymous@kplayer.cvs.sourceforge.net:/cvsroot/kplayer</option>
co <option>-P</option> kplayer</userinput></para>

<para>The code will be in the <filename>kplayer</filename> subdirectory</para>

<para><userinput><command>cd</command>
<filename>kplayer</filename></userinput></para>

</sect3>

</sect2>

<sect2 id="howto-compilation-compilation">
<title>Compile, install, run</title>

<para>Create the <filename>configure</filename> script</para>

<para><userinput><command>make</command> <option>-f</option>
<filename>Makefile.dist</filename></userinput></para>

<para>and run it</para>

<para><userinput><command>./configure</command> <option>--prefix</option>
`kde-config --prefix`</userinput></para>

<para>If at this point you are getting errors about missing libraries, you will
probably need to install more development packages from your distribution. The
<filename>configure</filename> script is very verbose, you will be able to tell
which package you need from its output. If you need even more information, look
in the <filename>config.log</filename> file. You will need to go to the bottom
and then scroll a page or two up to get to the point where it reported the
error. If everything fails, ask for help on the
<ulink url="http://sourceforge.net/forum/forum.php?forum_id=244388">&kplayer;
user forum</ulink>. Do not forget to include the full output of
<filename>configure</filename> and the <filename>config.log</filename>
file.</para>

<para>Once <command>configure</command> succeeds, compile the code</para>

<para><userinput><command>make</command></userinput></para>

<para>If this step fails, you can again ask for help on the
<ulink url="http://sourceforge.net/forum/forum.php?forum_id=244388">&kplayer;
user forum</ulink> providing the full output of <command>make</command>.</para>

<para>Once <command>make</command> finishes, install the program</para>

<para><userinput><command>su</command> <option>-c</option>
'<command>make</command> install'</userinput></para>

<para>and run it</para>

<para><userinput><command>kplayer</command></userinput></para>

<para>This last command will also produce quite verbose output on your console.
This is the output you need to send in if you ever
<link linkend="howto-bug-reporting">submit a bug report</link> or ask for
help.</para>

</sect2>

<sect2 id="howto-compilation-notes">
<title>Notes</title>

<sect3 id="howto-compilation-mandrake">
<title>Mandrake 10</title>

<para>At least some Mandrake 10 versions put <filename>libGL.la</filename> in
the wrong place, so if the <filename>configure</filename> script cannot find it,
you will have to create a symbolic link</para>

<para><userinput><command>ln</command> <option>-s</option>
<filename>/usr/lib/libGL.la</filename>
<filename>/usr/X11R6/lib/libGL.la</filename></userinput></para>

<para>Ales Tosovsky wrote a detailed HOWTO
<ulink url="http://linux.tosovsky.info/exec.php?show=kplayer">in Czech</ulink>
about compiling &kplayer; on Mandrake 10 and translated it into <ulink
url="http://linux.tosovsky.info/exec.php?show=kplayeren">English</ulink>.</para>

</sect3>

<sect3 id="howto-compilation-fedora">
<title>Fedora Core 2 on x86_64</title>

<para>Fred successfully compiled &kplayer; on x86_64 using Fedora Core 2 and
2.6.6-1.435.2.3smp kernel. Here is how he ran
<command>configure</command>:</para>

<para><userinput><command>./configure</command> <option>--prefix=`kde-config
--prefix`</option> <option>--enable-libsuffix=64</option>
<option>--with-qt-includes=/usr/lib64/qt-3.3/include</option>
<option>--with-qt-libraries=/usr/lib64/qt-3.3/lib</option></userinput></para>

<para>all on one line of course.</para>

</sect3>

</sect2>

</sect1>