r5731 - in trunk/BOOK: introduction/welcome multimedia/cdwriteutils

randy at linuxfromscratch.org randy at linuxfromscratch.org
Thu Mar 16 09:32:26 PST 2006


Author: randy
Date: 2006-03-16 10:32:23 -0700 (Thu, 16 Mar 2006)
New Revision: 5731

Added:
   trunk/BOOK/multimedia/cdwriteutils/k3b.xml
Modified:
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
   trunk/BOOK/multimedia/cdwriteutils/cdwriteutils.xml
Log:
Added new package K3b to BLFS

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-03-16 16:24:25 UTC (rev 5730)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-03-16 17:32:23 UTC (rev 5731)
@@ -45,6 +45,9 @@
       <para>March 16th, 2006</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Added new package K3b.</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Created two XInclude files to replace instances of
           identical text in several KDE packages.</para>
         </listitem>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2006-03-16 16:24:25 UTC (rev 5730)
+++ trunk/BOOK/introduction/welcome/credits.xml	2006-03-16 17:32:23 UTC (rev 5731)
@@ -233,7 +233,7 @@
         gnome-audio, gnome-backgrounds, gnome-menus, gnome-volume-manager,
         GNOME Doc Utils, GNOME Keyring Manager, GnuCash (many additions),
         GOffice, HAL, Heimdal, HTML Tidy, ISO Codes, JadeTeX, Java Access
-        Bridge, LessTif (rewrite), libexif, libgail-gnome, libgnomecups,
+        Bridge, K3b, LessTif (rewrite), libexif, libgail-gnome, libgnomecups,
         Libidn, libmpeg2, libmusicbrainz, MPlayer (extensive overhaul), NSS,
         Other Programming Tools, PDL, Perl Modules, pilot-link, Poppler, PyXML,
         Samba 3 (many additions), SANE (original instructions by Alex Kloss),

Modified: trunk/BOOK/multimedia/cdwriteutils/cdwriteutils.xml
===================================================================
--- trunk/BOOK/multimedia/cdwriteutils/cdwriteutils.xml	2006-03-16 16:24:25 UTC (rev 5730)
+++ trunk/BOOK/multimedia/cdwriteutils/cdwriteutils.xml	2006-03-16 17:32:23 UTC (rev 5731)
@@ -35,5 +35,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cdrdao.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="udftools.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dvd+rw-tools.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="k3b.xml"/>
 
 </chapter>

Added: trunk/BOOK/multimedia/cdwriteutils/k3b.xml
===================================================================
--- trunk/BOOK/multimedia/cdwriteutils/k3b.xml	                        (rev 0)
+++ trunk/BOOK/multimedia/cdwriteutils/k3b.xml	2006-03-16 17:32:23 UTC (rev 5731)
@@ -0,0 +1,248 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!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 k3b-download-http "http://prdownloads.sourceforge.net/k3b/k3b-0.12.14.tar.bz2">
+  <!ENTITY k3b-download-ftp  " ">
+  <!ENTITY k3b-md5sum        "51ef4fdf98365a285489dc1e11a07a3c">
+  <!ENTITY k3b-size          "4.0 MB">
+  <!ENTITY k3b-buildsize     "73.6 MB">
+  <!ENTITY k3b-time          "4.1 SBU">
+]>
+
+<sect1 id="k3b" xreflabel="K3b-&k3b-version;">
+  <?dbhtml filename="k3b.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+    <keywordset>
+      <keyword role="package">k3b-&k3b-version;.tar</keyword>
+      <keyword role="ftpdir">k3b</keyword>
+    </keywordset>
+  </sect1info>
+
+  <title>K3b-&k3b-version;</title>
+
+  <indexterm zone="k3b">
+    <primary sortas="a-K3b">K3b</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to K3b</title>
+
+    <para>The <application>K3b</application> package contains a KDE-based
+    graphical interface to the <application>Cdrtools</application> and
+    <application>dvd+rw-tools</application> CD/DVD manipulation tools. It also
+    combines the capabilities of many other multimedia packages into one
+    central interface to provide a simple-to-operate application that can be
+    used to handle many of your CD/DVD recording and formatting requirements.
+    This is useful for creating audio, data, video and mixed-mode CDs as well
+    as copying, ripping and burning CDs and DVDs.</para>
+
+    <para>Though <application>K3b</application> can be used to copy almost any
+    DVD to similar medium, it does not provide a way to copy, or reproduce a
+    double-layer DVD onto single-layer medium. Of course, there is not a
+    program anywhere on any platform that can make an exact duplicate of a
+    double-layer DVD onto a single-layer disk, there are programs on some
+    platforms that can compress the data on a double-layer DVD to fit on a
+    single-layer DVD producing a duplicate, but compressed, image. If you need
+    to copy the contents of a double-layer DVD to single-layer medium, you may
+    want to look at the <ulink
+    url="http://www.mcmurchy.com/rmlcopydvd/">RMLCopyDVD</ulink>
+    package.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&k3b-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&k3b-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &k3b-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &k3b-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &k3b-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &k3b-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">K3b Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="kdelibs"/> and
+    <xref linkend="cdrtools"/></para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended"><xref linkend="kdebase"/>,
+    <xref linkend="libjpeg"/>,
+    <xref linkend="kdemultimedia"/> (required for a working audio player), and
+    <xref linkend="dvd-rw-tools"/> (required if you need to burn or format DVD
+    media)</para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional"><xref linkend="alsa"/>,
+    <xref linkend="cdparanoia"/>,
+    <xref linkend="cdrdao"/>,
+    <xref linkend="ffmpeg"/>,
+    <xref linkend="flac"/>,
+    <xref linkend="hal"/>,
+    <xref linkend="lame"/>,
+    <xref linkend="libmad"/>,
+    <xref linkend="libmusicbrainz"/>,
+    <xref linkend="libvorbis"/>,
+    <xref linkend="libxml2"/>,
+    <xref linkend="transcode"/>,
+    <ulink url="http://www.mega-nerd.com/libsndfile/">libsndfile</ulink>,
+    <ulink url="http://movix.sourceforge.net/">MoviX</ulink>,
+    <ulink url="http://www.musepack.net/">Musepack (libmpcdec)</ulink>,
+    <ulink url="http://www1.cs.columbia.edu/~cvaill/normalize/">normalize</ulink>,
+    <ulink url="ftp://ftp.lst.de/pub/people/okir/resmgr/">resmgr</ulink>,
+    <ulink url="http://www.mega-nerd.com/libsamplerate/">Secret Rabbit
+    Code (libsamplerate)</ulink>,
+    <ulink url="http://sox.sourceforge.net/">SoX</ulink>,
+    <ulink url="http://developer.kde.org/~wheeler/taglib/">TagLib</ulink>, and
+    <ulink url="http://www.vcdimager.org/">VCDImager</ulink></para>
+
+    <para>For an explanation how each package is used by
+    <application>K3b</application>, see the Requirements page at
+    <ulink url="http://k3b.plainblack.com/requirements"/>.</para>
+
+    <bridgehead renderas="sect4">Runtime Requirements for DVD Ripping and
+    Encoding</bridgehead>
+    <para role="optional"><xref linkend="transcode"/>,
+    <xref linkend="xvid"/>,
+    <xref linkend="libdvdread"/>, and
+    <xref linkend="libdvdcss"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of K3b</title>
+
+    <para>Install <application>K3b</application> by running the following
+    commands:</para>
+
+    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
+    href="../../xincludes/kde-sysconfdir.xml"/>
+
+<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>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring k3b</title>
+
+    <sect3 id="k3b-config">
+      <title>Configuration Information</title>
+
+      <para>You will need to ensure that any user of
+      <application>K3b</application> has permission to read and write to the
+      CD/DVD/audio hardware device files. The easiest way to do this is by
+      creating groups (audio, video, cdrecord, dvdrecord, etc.,) and then add
+      users to the appropriate groups. You'll also have to ensure that the
+      <application>Udev</application> rules are set up appropriately if you
+      are using a system where the device files are created during the system
+      boot-up sequence.</para>
+
+      <para>There is a script installed (<command>k3bsetup</command>) that is
+      a front-end to the k3bsetup2 KControlModule. This script can be accessed
+      as a pull-down menu from the K3b GUI and requires
+      <systemitem class="username">root</systemitem> user privileges
+      (<systemitem class="username">root</systemitem> privileges are acquired
+      through the use of the automatically-launched <command>kdesud</command>
+      program). Though this utility can be used to set the appropriate
+      permissions for the device files, be forewarned that in a Udev
+      environment, where the device files are created during the system boot-up
+      sequence, any changes made by this utility will not be preserved across
+      system boots.</para>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>k3b and k3bsetup</seg>
+        <seg>libk3b.so, libk3baudiometainforenamerplugin.so,
+        libk3baudioprojectcddbplugin.so, libk3bdevice.so and numerous
+        modules for the installed dependencies</seg>
+        <seg>The following subdirectories of $KDE_PREFIX/share/:
+        [applnk/Settings/System, apps/k3b, doc/HTML/en/k3b]</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="k3b-prog">
+        <term><command>k3b</command></term>
+        <listitem>
+          <para>is the graphical CD/DVD program.</para>
+          <indexterm zone="k3b k3b-prog">
+            <primary sortas="b-k3b">k3b</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="k3bsetup">
+        <term><command>k3bsetup</command></term>
+        <listitem>
+          <para>is a script used to launch the k3bsetup2 KControlModule
+          for setting up the CD/DVD hardware and device files in your
+          system.</para>
+          <indexterm zone="k3b k3bsetup">
+            <primary sortas="b-k3bsetup">k3bsetup</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/multimedia/cdwriteutils/k3b.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date




More information about the blfs-book mailing list