summaryrefslogtreecommitdiffstats
path: root/doc/en/howto-compilation.docbook
blob: c567a4b5a870a4c7f9a95ecba0e7d541a6a041c1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<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>tdelibs-trinity-dev</literal>,
<literal>libtqt-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>
`tde-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=`tde-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>