r5614 - in trunk/BOOK: introduction/welcome kde/add

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sun Jan 29 13:48:07 PST 2006


Author: randy
Date: 2006-01-29 14:48:06 -0700 (Sun, 29 Jan 2006)
New Revision: 5614

Modified:
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/kde/add/kdemultimedia.xml
Log:
Added instructions to build the Akode package, added a patch to fix a build issue with libtunepimp, and adjusted the dependencies in the Kdemultimedia instructions

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-01-29 18:09:17 UTC (rev 5613)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-01-29 21:48:06 UTC (rev 5614)
@@ -45,10 +45,15 @@
       <para>January 29th, 2006</para>
       <itemizedlist>
         <listitem>
-          <para>[randy] - Updated all the links to files on the Anduin server
-          to use entities.</para>
+          <para>[randy] - Added instructions to build the Akode package, added
+          a patch to fix a build issue with libtunepimp, and adjusted the
+          dependencies in the Kdemultimedia instructions.</para>
         </listitem>
         <listitem>
+          <para>[randy] - Updated all the links to files located on the Anduin
+          server to use entities.</para>
+        </listitem>
+        <listitem>
           <para>[andy] - Updated glib2 to 2.8.6.</para>
         </listitem>
       </itemizedlist>

Modified: trunk/BOOK/kde/add/kdemultimedia.xml
===================================================================
--- trunk/BOOK/kde/add/kdemultimedia.xml	2006-01-29 18:09:17 UTC (rev 5613)
+++ trunk/BOOK/kde/add/kdemultimedia.xml	2006-01-29 21:48:06 UTC (rev 5614)
@@ -10,6 +10,14 @@
   <!ENTITY kdemultimedia-size          "5.3 MB">
   <!ENTITY kdemultimedia-buildsize     "114 MB">
   <!ENTITY kdemultimedia-time          "8.8 SBU">
+
+  <!ENTITY akode-version       "svn_060128">
+  <!ENTITY akode-download-http "&sources-anduin-http;/a/akode-&akode-version;.tar.bz2">
+  <!ENTITY akode-download-ftp  "&sources-anduin-ftp;/a/akode-&akode-version;.tar.bz2">
+  <!ENTITY akode-md5sum        "7ea67354104ca421bb269cae4df3f5bd">
+  <!ENTITY akode-size          "493 KB">
+  <!ENTITY akode-buildsize     "12.1 MB">
+  <!ENTITY akode-time          "0.4 SBU">
 ]>
 
 <sect1 id="kdemultimedia" xreflabel="kdemultimedia-&kde-version;">
@@ -33,15 +41,123 @@
   <sect2 role="package">
     <title>Introduction to Kdemultimedia</title>
 
-    <para><application>Kdemultimedia</application> provides serveral
+    <para><application>Kdemultimedia</application> provides several
     <application>KDE</application> programs to work with sound.  Programs
     include applications for a Jukebox, a soundcard mixer, a midi and karaoke
     player, and a recording application for
     <application>aRts</application>.</para>
 
+    <para>In this version of <application>Kdemultimedia</application>, some
+    of the functionality provided by the package has been moved off into a
+    separate project named <application>Akode</application>. In order for
+    <application>Kdemultimedia</application> to provide the removed
+    functionality, you must install the <application>Akode</application>
+    package first. Instructions to install <application>Akode</application>
+    follow. If you wish to skip the <application>Akode</application>
+    installation, go straight to the
+    <xref linkend="kdemultimedia-instructions"/>.</para>
+
+  </sect2>
+
+  <sect2 role="package" id="akode" xreflabel="Akode-&akode-version;">
+    <title>Akode-&akode-version;</title>
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing='compact'>
       <listitem>
+        <para>Download (HTTP): <ulink url="&akode-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&akode-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &akode-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &akode-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &akode-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &akode-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect4">Downloading the SVN Sources</bridgehead>
+
+    <para>If you have <xref linkend="subversion"/> installed and you wish to
+    download the sources straight from the KDE respository, issue the following
+    commands to check out a copy of <application>Akode</application>:</para>
+
+<screen><userinput>export PACKAGE_VERSION="svn-$(date +%y%m%d)" &&
+
+svn -N co \
+    svn://anonsvn.kde.org/home/kde/trunk/kdesupport \
+    akode-$PACKAGE_VERSION &&
+svn    co \
+    svn://anonsvn.kde.org/home/kde/trunk/kdesupport/akode \
+    akode-$PACKAGE_VERSION/akode &&
+svn    co \
+    svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin \
+    akode-$PACKAGE_VERSION/admin</userinput></screen>
+
+    <para>If you wish to create a tarball of the files you just downloaded,
+    issue the following commands:</para>
+
+<screen><userinput>tar cf akode-$PACKAGE_VERSION.tar akode-$PACKAGE_VERSION
+bzip2 akode-$PACKAGE_VERSION.tar</userinput></screen>
+
+    <bridgehead renderas="sect3">Akode Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional"><xref linkend="pkgconfig"/>,
+    <xref linkend="flac"/>,
+    <xref linkend="speex"/>,
+    <xref linkend="libmad"/>,
+    <xref linkend="alsa"/>,
+    <xref linkend="libvorbis"/>,
+    <ulink url="http://www.mega-nerd.com/libsamplerate/">Secret Rabbit
+    Code</ulink> (a.k.a. libsamplerate),
+    <ulink url="http://0pointer.de/lennart/projects/polypaudio/">polypaudio</ulink>,
+    <ulink url="http://jackit.sourceforge.net/">JACK</ulink>, and
+    <ulink url="http://www.mplayerhq.hu/homepage/design7/dload.html#cvs">FFmpeg
+    </ulink>(must be a CVS version, and support is experimental)</para>
+
+    <bridgehead renderas="sect3">Installation of Akode</bridgehead>
+
+    <para>Install <application>Akode</application> by issuing the following
+    commands:</para>
+
+<screen><userinput>make -f Makefile.cvs &&
+./configure --prefix=&kde-dir; \
+    --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>
+
+  <para>The <command>make -f Makefile.cvs</command> command is used to create
+  the autotools files. The tarball was created by checking out the sources from
+  the KDE SVN repository and includes an
+  <filename class='directory'>admin</filename> directory containing an
+  additional <filename>Makefile</filename>, shell scripts and other support
+  files used to create the autotools files. Running this command
+  does everything required to essentially create a distribution directory ready
+  to use for package installation.</para>
+
+  </sect2>
+
+  <sect2 id="kdemultimedia-instructions"
+         xreflabel="Kdemultimedia Instructions">
+    <title>Resuming the Kdemultimedia Instructions</title>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing='compact'>
+      <listitem>
         <para>Download (HTTP): <ulink url="&kdemultimedia-download-http;"/></para>
       </listitem>
       <listitem>
@@ -61,6 +177,15 @@
       </listitem>
     </itemizedlist>
 
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Required patch (if <application>libtunepimp</application>
+        >= 0.4.x is installed): <ulink
+        url="&patch-root;/kdemultimedia-&kde-version;-libtunepimp_0.4.x-1.patch"/></para>
+      </listitem>
+    </itemizedlist>
+
     <bridgehead renderas="sect3">Kdemultimedia Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
@@ -68,29 +193,34 @@
 
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended"><xref linkend="libjpeg"/>,
-    <xref linkend="libxml2"/>,
-    <xref linkend="alsa"/>, and
-    <xref linkend="libmad"/></para>
+    <xref linkend="libxml2"/>, and
+    <xref linkend="alsa"/></para>
+    <!-- <xref linkend="libmad"/> moved to Akode -->
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="cdparanoia"/>,
+    <para role="optional"><xref linkend="akode"/>,
+    <xref linkend="cdparanoia"/>,
     <xref linkend="lame"/>,
     <xref linkend="audiofile"/>,
-    <xref linkend="libogg"/>,
     <xref linkend="libvorbis"/>,
     <xref linkend="xine-lib"/>,
-    <xref linkend="flac"/>,
-    <xref linkend="speex"/>,
-    <xref linkend="sdl"/>,
-    <xref linkend="libmusicbrainz"/>,
-    <xref linkend="gstreamer"/>
-    (with <ulink url="http://developer.kde.org/~wheeler/juk.html">KGst</ulink>),
-    <ulink url="http://developer.kde.org/~wheeler/taglib/">TagLib</ulink>,
-    <ulink url="http://jackit.sourceforge.net/">JACK</ulink>,
-    <ulink url="http://0pointer.de/lennart/projects/polypaudio/">polypaudio</ulink>,
-    <ulink url="http://www.mega-nerd.com/libsamplerate/">Secret Rabbit Code</ulink>,
-    <ulink url="http://www.musicbrainz.org/products/trmgen/download.html">TRM Generator</ulink>, and
-    <ulink url="http://www.musicbrainz.org/products/tunepimp/download.html">TunePimp</ulink></para>
+    <xref linkend="flac"/> (built with <xref linkend="libogg"/> support),
+    <xref linkend="gstreamer"/>,
+    <ulink url="http://www.theora.org/">Theora</ulink>,
+    <ulink url="http://developer.kde.org/~wheeler/taglib/">TagLib</ulink>, and
+    <ulink url="http://www.musicbrainz.org/products/tunepimp/download.html">TunePimp</ulink>
+    (requires <xref linkend="libmusicbrainz"/>)</para>
+    <!-- moved to Akode
+    <ulink url="http://0pointer.de/lennart/projects/polypaudio/">polypaudio</ulink>
+    <ulink url="http://www.mega-nerd.com/libsamplerate/">Secret Rabbit Code</ulink>
+    <ulink url="http://jackit.sourceforge.net/">JACK</ulink>
+    <xref linkend="speex"/>, moved to Akode
+    -->
+    <!-- <xref linkend="sdl"/>, not used any longer -->
+    <!-- <xref linkend="libogg"/>, no good without vorbis, so is redundant -->
+    <!-- Uses internal copy now
+    <ulink url="http://www.musicbrainz.org/products/trmgen/download.html">TRM Generator</ulink>
+    -->
 
   </sect2>
 
@@ -104,7 +234,8 @@
       kdelibs.</para>
     </note>
 
-<screen><userinput>./configure --prefix=&kde-dir; --sysconfdir=/etc/kde \
+<screen><userinput>patch -Np1 -i ../kdemultimedia-&kde-version;-libtunepimp_0.4.x-1.patch &&
+./configure --prefix=&kde-dir; --sysconfdir=/etc/kde \
     --disable-debug --disable-dependency-tracking &&
 make</userinput></screen>
 
@@ -123,9 +254,14 @@
       <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
-        <seg>artsbuilder, juk, kaboodle, kmid, kmix, krec, kscd, and noatun</seg>
+        <seg>artsbuilder, artscontrol, juk, kaboodle, kaudiocreator, kmid,
+        kmix, kmixctrl, krec, kscd, midisend, mpeglibartsplay, noatun,
+        workman2cddb.pl, yaf-cdda, yaf-mpgplay, yaf-splay, yaf-tplay,
+        yaf-vorbis, and yaf-yuv</seg>
         <seg>Numerous kdemultimedia specific libraries</seg>
-        <seg>Several subdirectories of $KDE_PREFIX/{include,share}</seg>
+        <seg>The following subdirectories in $KDE_PREFIX: include/[libkcddb,
+        mpeglib, noatun], lib/mcop/Noatun, and
+        share/apps/[too many to list]</seg>
       </seglistitem>
     </segmentedlist>
 




More information about the blfs-book mailing list