glfs/multimedia/audioutils/audacious.xml
Wayne Blaszczyk c4ee35e6f8 Added new package. libnotify-0.4.5
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8131 af4574ff-66df-0310-9fd7-8a98e5e911e0
2009-11-14 05:57:22 +00:00

251 lines
9.2 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY audacious-download-http "http://distfiles.atheme.org/audacious-&audacious-version;.tbz2">
<!--<!ENTITY audacious-download-ftp "&gentoo-ftp-repo;/audacious-&audacious-version;.tbz2">-->
<!ENTITY audacious-download-ftp " ">
<!ENTITY audacious-md5sum "ea7a8ee2e8f1a301b40ccf40788ab0eb">
<!ENTITY audacious-size "1.3 MB">
<!ENTITY audacious-buildsize "81 MB (typical)">
<!ENTITY audacious-time "2.3 SBU">
<!ENTITY audacious-plugins-version "1.5.1">
<!ENTITY audacious-plugins-download "http://distfiles.atheme.org/audacious-plugins-&audacious-plugins-version;.tbz2">
<!ENTITY audacious-plugins-md5sum "b237754a615cf9a3d77a93bf18de26fc">
<!ENTITY audacious-plugins-size "2.1 MB">
]>
<sect1 id="audacious" xreflabel="Audacious-&audacious-version;">
<?dbhtml filename="audacious.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Audacious-&audacious-version;</title>
<indexterm zone="audacious">
<primary sortas="a-Audacious">Audacious</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Audacious</title>
<para><application>Audacious</application> is a Gtk+-2 based audio
player.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&audacious-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&audacious-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &audacious-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &audacious-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &audacious-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &audacious-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<title>Required</title>
<listitem>
<para>Plugins: <ulink url="&audacious-plugins-download;"/></para>
</listitem>
<listitem>
<para>Md5 sum: &audacious-plugins-md5sum;</para>
</listitem>
<listitem>
<para>Size: &audacious-plugins-size;</para>
</listitem>
</itemizedlist>
<!-- 404
<para>Additional plugins can be downloaded from <ulink
url="http://audacious-media-player.org/index.php?title=Plugins"/>.
Note that these third-party plugins are not supported by the
<application>Audacious</application> development team.</para> -->
<bridgehead renderas="sect3">Audacious Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="libglade"/> and
<xref linkend="libmcs"/></para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="optional"><xref linkend="dbus"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pcre"/> or
<ulink url="http://www.geocities.jp/kosako3/oniguruma/">Oniguruma</ulink>,
<ulink url="http://www.mega-nerd.com/libsamplerate/">Secret Rabbit Code</ulink>
(a.k.a. libsamplerate),
<xref linkend="doxygen"/>, and
<xref linkend="gtk-doc"/></para>
<bridgehead renderas="sect4">Optional (for Plugins)</bridgehead>
<para role="optional"><ulink url="http://adplug.sourceforge.net/">AdPlug</ulink>,
<xref linkend="alsa"/>,
<xref linkend="arts"/>,
<ulink url="http://www.gnu.org/software/libcdio/">libcdio</ulink>,
<xref linkend="curl"/>,
<xref linkend="esound"/>,
<ulink url="http://jackit.sourceforge.net/">JACK</ulink>,
<xref linkend="lame"/>,
<xref linkend="libmad"/>,
<ulink url="http://www.musepack.net/">libmpcdec</ulink> (requires
<ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
<ulink url="http://www.mega-nerd.com/libsndfile/">libsndfile</ulink>,
<xref linkend="libvorbis"/>,
<ulink url="http://www.lirc.org">LIRC</ulink>,
<ulink url="http://www.webdav.org/neon/">neon-0.28.3</ulink> for online mpg3 and ogg radio,
<ulink url="http://xmms-projectm.sourceforge.net/">projectM</ulink>,
<ulink url="http://pulseaudio.org/">PulseAudio</ulink>,
<ulink url="http://www.hunz.org/">rocklight</ulink> (only for IBM Thinkpads),
<xref linkend="sdl"/>,
<ulink url="http://developer.kde.org/~wheeler/taglib/">TagLib</ulink>), and
<ulink url="http://www.wavpack.com/">WavPack</ulink></para>
<bridgehead renderas="sect4">Optional (for Ugly Plugins)</bridgehead>
<para role="optional"><xref linkend="libnotify"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/audacious"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Audacious</title>
<para>Install <application>Audacious</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<!-- target no longer present
<para>If you wish to create the SDK documentation, issue the following
command: <command>make documentation-build</command>.</para> -->
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 -D README /usr/share/doc/audacious-&audacious-version;/README</userinput></screen>
<!--
<para>If you created the SDK documentation, install it by issuing the
following commands as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>install -v -m755 -d /usr/share/gtk-doc/html/{,lib}audacious &amp;&amp;
install -v -m644 doc/audacious/html/* \
/usr/share/gtk-doc/html/audacious &amp;&amp;
install -v -m644 doc/libaudacious/html/* \
/usr/share/gtk-doc/html/libaudacious</userinput></screen> -->
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><option>--enable-one-plugin-dir</option> and
<option>--disable-user-plugin-dir</option>: These options are used to
determine how the plugins are stored. Review the ouput from
<command>./configure --help</command> for information.</para>
<para><option>--enable-chardet</option>: This option is used to enable
character set detection support.</para>
<para><option>--enable-samplerate</option>: This option is used to enable
libsamplerate support.</para>
</sect2>
<sect2 role="installation">
<title>Installation of Audacious Plugins</title>
<para>Install the required plugins package by unpacking the tarball, changing
into the newly created directory, and issuing the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>audacious, audacious-arts-helper and audtool</seg>
<seg>libaudacious.so and numerous Container, Effect, General, Input,
Output, Visualization, and amidi-plug plugin modules</seg>
<seg>/usr/include/audacious, /usr/lib/audacious,
/usr/share/audacious, /usr/share/doc/audacious-&audacious-version;
<!-- and /usr/share/gtk-doc/html/audacious --></seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="audacious-prog">
<term><command>audacious</command></term>
<listitem>
<para>is a Gtk2 port of <application>XMMS</application> based on the
<application>Beep Media Player</application>.</para>
<indexterm zone="audacious audacious-prog">
<primary sortas="b-audacious">audacious</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libaudacious">
<term><filename class='libraryfile'>libaudacious.so</filename></term>
<listitem>
<para>contains functions that are used by
<command>audacious</command> to render its
graphical interface.</para>
<indexterm zone="audacious libaudacious">
<primary sortas="c-libaudacious">libaudacious.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>