source: multimedia/libdriv/libmikmod.xml@ e8a29f69

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY libmikmod-download-http "http://mikmod.raphnet.net/files/libmikmod-&libmikmod-version;.tar.gz">
  <!ENTITY libmikmod-download-ftp  "ftp://ftp.raphnet.net/pub/libmikmod/libmikmod-&libmikmod-version;.tar.gz">
  <!ENTITY libmikmod-md5sum        "705106da305e8de191549f1e7393185c">
  <!ENTITY libmikmod-size          "611 KB">
  <!ENTITY libmikmod-buildsize     "9.6 MB">
  <!ENTITY libmikmod-time          "0.28 SBU">
]>

<sect1 id="libmikmod" xreflabel="libmikmod-&libmikmod-version;">
<sect1info>
  <othername>$LastChangedBy$</othername>
  <date>$Date$</date>
</sect1info>

<?dbhtml filename="libmikmod.html"?>
<title>libmikmod-&libmikmod-version;</title>

<sect2>
<title>Introduction to <application>libmikmod</application></title>

<para>
<application>libmikmod</application> is a sound library capable of
playing audio samples as well as tracker modules. Supported module
formats include <acronym>MOD</acronym>, <acronym>S3M</acronym>,
<acronym>XM</acronym>, <acronym>IT</acronym>, <acronym>MED</acronym>,
<acronym>MTM</acronym> and <acronym>669</acronym>.</para>

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

<sect3>
<title><application>libmikmod</application> dependencies</title>

<sect4>
<title>Optional</title>
<para><xref linkend="alsa"/>, 
      <xref linkend="esound"/>, 
      <ulink url="http://www.perex.cz/~perex/ultra/">libGUS</ulink>, 
      <ulink url="http://osalp.sourceforge.net/">AFlib</ulink> and 
      <ulink url="http://www.anime.net/~sam9407/">SAM9407 driver</ulink></para>
</sect4>
</sect3>

</sect2>

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

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

<screen><userinput><command>sed -i -e "s/VERSION=10/VERSION=11/" \
       -e "s/sys_asoundlib/alsa_asoundlib/" \
       -e "s/snd_cards/snd_card_load/g" \
       -e "s|sys/asoundlib.h|alsa/asoundlib.h|g" \
       -e "s/^LIBOBJS/#LIBOBJS/" \
    configure.in &amp;&amp;
autoconf &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
chmod 755 /usr/lib/libmikmod.so.2.0.4</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><command>sed -i -e ...</command>: This increments the package micro 
version and also modifies the <application>ALSA</application> header search
routine so that the package properly discovers the 
<application>ALSA</application> library.  It also fixes a problem 
which makes <application>autoconf</application> fail.</para>

<para><command>autoconf</command>: This generates a new 
<command>configure</command> script, required because of the changes to
<filename>configure.in</filename>.</para>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>libmikmod</application> package contains
<command>libmikmod-config</command> and the 
<filename class="libraryfile">libmikmod</filename> library.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>libmikmod-config</title>
<para><command>libmikmod-config</command> provides version information,
compiler and linker flags to programs that utilize libmikmod.</para></sect3>

<sect3><title>libmikmod</title>
<para><filename class="libraryfile">libmikmod</filename> provides
the functionality that is required to play various tracker module files.
</para></sect3>

</sect2>

</sect1>