Attached is a patch to add Amarok-1.4.8 to the book, if it is desired.
Being the most popular audio player for KDE, I think it should go in.
I have a few specific questions, but any feedback at all is appreciated.
1) Amarok includes an internal copy of sqlite, and uses this as it's
default database. Given LFS's, and maybe BLFS's (not quite sure),
prediliction towards using system-installed versions of packages vs.
embedded version, should I make sqlite a required dep and add the
switch to use it, or leave as-is?
2) kdemultimedia is required for cd-ripping support (through the
audiocd: protocol) and k3b is required for burning support. I'm on the
fence as to whether these should be optional or recommended. Opinions?
3) Amarok does have several other engines than xine, but I did not list
them. Most are unmaintained, and I think should be left out. The only
other well-supported engine is helix, from {real,helix}player. I
haven't tested this engine, and grepping through the xml files, I saw
nothing else that referenced it. Should I bump xine down to
recommended and add a link to the helix site?
--
Robert Daniels
Index: multimedia/audioutils/audioutils.xml
===================================================================
--- multimedia/audioutils/audioutils.xml (revision 7200)
+++ multimedia/audioutils/audioutils.xml (working copy)
@@ -29,5 +29,6 @@
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="cdparanoia.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="freetts.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="audacious.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="amarok.xml"/>
</chapter>
Index: multimedia/audioutils/amarok.xml
===================================================================
--- multimedia/audioutils/amarok.xml (revision 0)
+++ multimedia/audioutils/amarok.xml (revision 0)
@@ -0,0 +1,218 @@
+<?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 amarok-download-http "http://mirrors.isc.org/pub/kde/stable/amarok/1.4.8/src/amarok-1.4.8.tar.bz2";>
+ <!ENTITY amarok-download-ftp "ftp://ftp.kde.org/pub/kde/stable/amarok/1.4.8/src/amarok-1.4.8.tar.bz2";>
+ <!ENTITY amarok-md5sum "7f65c4a8f3f0ff9042a5b5dd21b36cc8">
+ <!ENTITY amarok-size "13 MB">
+ <!ENTITY amarok-buildsize "129 MB">
+ <!ENTITY amarok-time "3.6 SBU">
+]>
+
+<sect1 id="amarok" xreflabel="amarok-&amarok-version;">
+ <?dbhtml filename="amarok.html"?>
+
+ <sect1info>
+ <othername>$LastChangedBy: randy $</othername>
+ <date>$Date: 2007-04-04 14:42:53 -0500 (Wed, 04 Apr 2007) $</date>
+ </sect1info>
+
+ <title>Amarok-&amarok-version;</title>
+
+ <indexterm zone="amarok">
+ <primary sortas="a-Amarok">Amarok</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title>Introduction to Amarok</title>
+
+ <para><application>Amarok</application> is an audio player for KDE.
+ Features include a context browser, Magnatunes and last.fm integration,
+ support for multimedia devices, and scripting through Ruby.</para>
+
+ <bridgehead renderas="sect3">Package Information</bridgehead>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Download (HTTP): <ulink url="&amarok-download-http;"/></para>
+ </listitem>
+ <listitem>
+ <para>Download (FTP): <ulink url="&amarok-download-ftp;"/></para>
+ </listitem>
+ <listitem>
+ <para>Download MD5 sum: &amarok-md5sum;</para>
+ </listitem>
+ <listitem>
+ <para>Download size: &amarok-size;</para>
+ </listitem>
+ <listitem>
+ <para>Estimated disk space required: &amarok-buildsize;</para>
+ </listitem>
+ <listitem>
+ <para>Estimated build time: &amarok-time;</para>
+ </listitem>
+ </itemizedlist>
+
+ <bridgehead renderas="sect3">amarok Dependencies</bridgehead>
+
+ <bridgehead renderas="sect4">Required</bridgehead>
+ <para role="required"><xref linkend="kdelibs"/>,
+ <xref linkend="ruby"/>,
+ <xref linkend="xine-lib"/>, and
+ <ulink url="http://developer.kde.org/~wheeler/taglib/";>TagLib</ulink></para>
+
+ <bridgehead renderas="sect4">Recommended</bridgehead>
+ <para role="recommended"><xref linkend="kdebase"/></para>
+
+ <bridgehead renderas="sect4">Optional</bridgehead>
+ <para role="optional"><xref linkend="kdemultimedia"/>,
+ <xref linkend="k3b"/>,
+ <xref linkend="sdl"/>,
+ <ulink url="http://sqlite.org/";>SQLite</ulink>,
+ <xref linkend="postgresql"/>,
+ <xref linkend="mysql"/>,
+ <xref linkend="faad2"/> or <ulink url="http://mpeg4ip.sourceforge.net/";>mpeg4ip</ulink>,
+ <ulink url="http://sourceforge.net/projects/libvisual/";>libvisual</ulink>,
+ <ulink url="http://www.musicbrainz.org/products/tunepimp/download.html";>TunePimp</ulink>,
+ <ulink url="http://www.gtkpod.org/libgpod.html";>libgpod</ulink>,
+ <ulink url="http://ifp-driver.sourceforge.net/libifp/";>libifp</ulink>,
+ <ulink url="http://libnjb.sourceforge.net/";>libnjp</ulink>,
+ <ulink url="http://libmtp.sourceforge.net/";>libmtp</ulink>,
+ <ulink url="http://linux-karma.sourceforge.net/";>libkarma</ulink> (requires
+ <ulink url="http://linux-karma.sourceforge.net/";>omfs</ulink>)</para>
+
+ <para condition="html" role="usernotes">User Notes:
+ <ulink url="&blfs-wiki;/amarok"/></para>
+
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of amarok</title>
+
+ <para>Install <application>Amarok</application> by running the following
+ commands:</para>
+
+<screen><userinput>./configure --prefix=$(kde-config --prefix) \
+ --sysconfdir=/etc/kde \
+ --disable-debug \
+ --disable-dependency-tracking &&
+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="commands">
+ <title>Command Explanations</title>
+
+ <para><parameter>--prefix=$(kde-config --prefix)</parameter>: This
+ parameter uses <command>kde-config</command> to establish the prefix of
+ the existing KDE installation and then sets the installation prefix for
+ <application>K3b</application> to the same value.</para>
+
+ <para><parameter>--disable-debug</parameter>: This option causes the package
+ to be compiled without debugging code.</para>
+
+ <para><parameter>--disable-dependency-tracking</parameter>: This option
+ speeds up one time builds.</para>
+
+ <para><parameter>--without-included-sqlite</parameter>: This option forces
+ the use of a system-installed copy of sqlite.</para>
+
+ <para><parameter>--enable-mysql</parameter>: This option enables use of a
+ MySQL database for music collections.</para>
+
+ <para><parameter>--enable-postresql</parameter>: This option enables use of a
+ PostgreSQL database for music collections.</para>
+
+ <para>Support for other optional dependencies may require passing options
+ to the <command>configure</command> script. Refer to the output from
+ <command>./configure --help</command> for additional information.</para>
+
+ </sect2>
+
+ <sect2 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Programs</segtitle>
+ <segtitle>Installed Libraries</segtitle>
+ <segtitle>Installed Directories</segtitle>
+
+ <seglistitem>
+ <seg>amarok, amarokapp, amarokcollectionscanner,
+ amarok_daapserver.rb, and amarok_proxy.rb</seg>
+ <seg>libamarok.so, and several modules
+ for installed dependencies</seg>
+ <seg><envar>$KDE_PREFIX</envar>/share/apps/amarok and
+ <envar>$KDE_PREFIX</envar>/share/doc/HTML/*/amarok</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="amarok-prog">
+ <term><command>amarok</command></term>
+ <listitem>
+ <para>is a wrapper for amarokapp to speed up
+ command line argument passing</para>
+ <indexterm zone="amarok amarok-prog">
+ <primary sortas="b-amarok">amarok</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="amarokapp">
+ <term><command>amarokapp</command></term>
+ <listitem>
+ <para>is the amarok audio player</para>
+ <indexterm zone="amarok amarokapp">
+ <primary sortas="b-amarokapp">amarokapp</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="amarokcollectionscanner">
+ <term><command>amarokcollectionscanner</command></term>
+ <listitem>
+ <para>is used to scan a directory structure and build a collection</para>
+ <indexterm zone="amarokcollectionscanner">
+ <primary sortas="b-amarokcollectionscanner">amarokcollectionscanner</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="amarok_daapserver.rb">
+ <term><command>amarok_daapserver.rb</command></term>
+ <listitem>
+ <para>is a DAAP server for Amarok</para>
+ <indexterm zone="amarok amarok_daapserver.rb">
+ <primary sortas="b-amarok_daapserver.rb">amarok_daapserver.rb</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="amarok_proxy.rb">
+ <term><command>amarok_proxy.rb</command></term>
+ <listitem>
+ <para>is a proxy server for DAAP and Last.fm</para>
+ <indexterm zone="amarok amarok_proxy.rb">
+ <primary sortas="b-amarok_proxy.rb">amarok_proxy.rb</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
+</sect1>
Index: general.ent
===================================================================
--- general.ent (revision 7200)
+++ general.ent (working copy)
@@ -655,6 +655,7 @@
<!ENTITY CDParanoia-version "III-9.8">
<!ENTITY freetts-version "1.2.1">
<!ENTITY audacious-version "1.3.2">
+<!ENTITY amarok-version "1.4.8">
<!-- Chapter 40 -->
<!ENTITY ffmpeg-version "svn_20070606">
--
http://linuxfromscratch.org/mailman/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
