source: kde/core/arts.xml@ 3b11616

<sect1 id="kde-core-arts" xreflabel="aRts-&arts-version;">
<?dbhtml filename="arts.html" dir="kde"?>
<title>aRts-&arts-version;</title>

<sect2><title>Introduction to <application><acronym>aRts</acronym></application></title>

<para>The Analog Real-time Synthesizer (<acronym>aRts</acronym>)
provides sound support for <acronym>KDE</acronym>. It provides necessary 
libraries for kdelibs.</para> 

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&arts-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&arts-download-ftp;"/></para></listitem>
<listitem><para>Download size: &arts-size;</para></listitem>
<listitem><para>Estimated Disk space required: &arts-buildsize;</para></listitem>
<listitem><para>Estimated build time: &arts-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title><application>aRts</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="qt"/></para></sect4>
<sect4><title>Recommended</title>
<para><xref linkend="alsa"/>, <xref linkend="audiofile"/> and <xref
linkend="libvorbis"/></para></sect4> 
<sect4><title>Optional</title>
<para><xref linkend="pkgconfig"/>, <xref
linkend="GLib2"/> and <xref linkend="libmad"/></para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>aRts</application></title>

<para>Before starting the build, ensure you have the 
<envar>QTDIR</envar> environment variable set:</para>
<screen><userinput><command>export QTDIR=/opt/qt</command></userinput></screen>

<para>Install <application>aRts</application> by running the
following commands:</para>

<screen><userinput><command>./configure --prefix=&kde-dir; --disable-debug \
     --disable-dependency-tracking &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sfn &kde-dir; /opt/kde</command></userinput></screen>

<note><para>Another configure option is <command>--enable-final</command>. 
This option can speed up the build process, but requires a lot of memory.  If
you have less than 256MB of RAM, this option may cause swapping and 
significantly slow compilation.</para></note>

</sect2>

<sect2><title>Command explanations</title>
<para><command>--prefix=&kde-dir;</command> : This option tells the
process to install the package in <filename
class="directory">&kde-dir;</filename>. We put aRts here because this
package is required before installing <acronym>KDE</acronym>.</para>

<para><command>--disable-debug</command> : This option causes the
system to be compiled without debugging code.
</para>

<para><command>--disable-dependency-tracking</command> : This option speeds
up one time builds.</para>

<para><command>ln -sfn &kde-dir; /opt/kde</command> : This command creates
a link for access to <acronym>KDE</acronym>. If a newer version of
<acronym>KDE</acronym> is released, the new
system can be built by changing the <command>--prefix</command> location
and then set up by changing the link as this command does.
</para>

</sect2>

<sect2><title>Configuring aRts</title>

<sect3><title>Configuration Information</title>

<para>The library directory <filename class="directory">/opt/kde/lib</filename> 
should appear in <filename>/etc/ld.so.conf</filename> 
so that ldd can find the shared libraries. The following command will add it 
if it is missing:</para>

<screen><userinput><command>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
# Begin kde addition to /etc/ld.so.conf

/opt/kde/lib

# End kde addition
EOF
ldconfig</command></userinput></screen>

</sect3>

</sect2>
</sect1>