glfs/multimedia/cdwriteutils/k3b.xml
Bruce Dubbs 43bb741c89 Finish checking KDE.
Tags and text updates.


git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12800 af4574ff-66df-0310-9fd7-8a98e5e911e0
2014-02-28 23:16:23 +00:00

236 lines
7.3 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 k3b-download-http "&sourceforge-repo;/k3b/k3b-&k3b-version;.tar.bz2">
<!ENTITY k3b-download-ftp " ">
<!ENTITY k3b-md5sum "c86113af31a2032e57fd2f302b5f637a">
<!ENTITY k3b-size "13 MB">
<!ENTITY k3b-buildsize "350 MB">
<!ENTITY k3b-time "3.0 SBU">
]>
<sect1 id="k3b" xreflabel="K3b-&k3b-version;">
<?dbhtml filename="k3b.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</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.
It is used 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>
&lfs75_checked;
<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">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Required patch:
<ulink url="&patch-root;/k3b-&k3b-version;-ffmpeg2-1.patch"/>
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">K3b Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="kde-runtime"/>,
<xref linkend="libkcddb"/>, and
<xref linkend="libsamplerate"/>
</para>
<para>
There are programs from three packages that
<application>K3b</application> will look for at runtime:
<ulink url="http://cdrecord.berlios.de/private/cdrecord.html">Cdrtools</ulink>
(required to burn CD-ROM media), <xref linkend="dvd-rw-tools"/>
(required to burn or format DVD media), and <xref linkend="cdrdao"/>
(required to burn CD-ROM media in DAO (Disk At Once) mode). If you
don't need the capability provided by any of the three packages, you don't
have to install it. However, a warning message will be generated every time
you run the <command>k3b</command> program if any are not installed.
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="ffmpeg"/>,
<xref linkend="libdvdread"/>,
<xref linkend="libjpeg"/>, and
<xref linkend="taglib"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="flac"/>,
<xref linkend="lame"/>,
<xref linkend="libmad"/>,
<xref linkend="libsndfile"/>,
<xref linkend="libvorbis"/>,
<xref linkend="libmusicbrainz"/>,
<ulink url="http://www.musepack.net/">Musepack (libmpcdec)</ulink>, and
<ulink url="http://www.vcdimager.org/">VCDImager</ulink>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/k3b"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of K3b</title>
<para>
Install <application>K3b</application> by running the following
commands:
</para>
<screen><userinput>patch -Np1 -i ../k3b-&k3b-version;-ffmpeg2-1.patch &amp;&amp;
mkdir build &amp;&amp;
cd build &amp;&amp;
cmake -DCMAKE_INSTALL_PREFIX=&kde-dir; \
-DSYSCONF_INSTALL_DIR=/etc/kde \
-Wno-dev .. &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>
k3b and k3bsetup
</seg>
<seg>
libk3b.so, libk3bdevice.so and numerous
modules for the installed dependencies
</seg>
<seg>
The following subdirectories of <envar>&kde-dir;</envar>/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 on
your system.
</para>
<indexterm zone="k3b k3bsetup">
<primary sortas="b-k3bsetup">k3bsetup</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>