source: multimedia/cdwriteutils/k3b.xml@ bb0377a

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since bb0377a was bb0377a, checked in by Robert Daniels <rdaniels@…>, 14 years ago

List dbus-qt3 as a separate dep for K3b

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7252 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY k3b-download-http "http://downloads.sourceforge.net/k3b/k3b-&k3b-version;.tar.bz2">
8 <!ENTITY k3b-download-ftp " ">
9 <!ENTITY k3b-md5sum "42538ddae0809707d3bcdbe0a6ed6a43">
10 <!ENTITY k3b-size "4.9 MB">
11 <!ENTITY k3b-buildsize "67.1 MB">
12 <!ENTITY k3b-time "4.0 SBU">
13]>
14
15<sect1 id="k3b" xreflabel="K3b-&k3b-version;">
16 <?dbhtml filename="k3b.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>K3b-&k3b-version;</title>
24
25 <indexterm zone="k3b">
26 <primary sortas="a-K3b">K3b</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to K3b</title>
31
32 <para>The <application>K3b</application> package contains a KDE-based
33 graphical interface to the <application>Cdrtools</application> and
34 <application>dvd+rw-tools</application> CD/DVD manipulation tools. It also
35 combines the capabilities of many other multimedia packages into one
36 central interface to provide a simple-to-operate application that can be
37 used to handle many of your CD/DVD recording and formatting requirements.
38 This is useful for creating audio, data, video and mixed-mode CDs as well
39 as copying, ripping and burning CDs and DVDs.</para>
40
41 <para>Though <application>K3b</application> can be used to copy almost any
42 DVD to similar medium, it does not provide a way to copy, or reproduce a
43 double-layer DVD onto single-layer medium. Of course, there is not a
44 program anywhere on any platform that can make an exact duplicate of a
45 double-layer DVD onto a single-layer disk, there are programs on some
46 platforms that can compress the data on a double-layer DVD to fit on a
47 single-layer DVD producing a duplicate, but compressed, image. If you need
48 to copy the contents of a double-layer DVD to single-layer medium, you may
49 want to look at the <ulink
50 url="http://www.mcmurchy.com/rmlcopydvd/">RMLCopyDVD</ulink>
51 package.</para>
52
53 <bridgehead renderas="sect3">Package Information</bridgehead>
54 <itemizedlist spacing="compact">
55 <listitem>
56 <para>Download (HTTP): <ulink url="&k3b-download-http;"/></para>
57 </listitem>
58 <listitem>
59 <para>Download (FTP): <ulink url="&k3b-download-ftp;"/></para>
60 </listitem>
61 <listitem>
62 <para>Download MD5 sum: &k3b-md5sum;</para>
63 </listitem>
64 <listitem>
65 <para>Download size: &k3b-size;</para>
66 </listitem>
67 <listitem>
68 <para>Estimated disk space required: &k3b-buildsize;</para>
69 </listitem>
70 <listitem>
71 <para>Estimated build time: &k3b-time;</para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">K3b Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required"><xref linkend="kdelibs"/></para>
79
80 <para>There are programs from three packages that
81 <application>K3b</application> will look for at runtime:
82 <xref linkend="cdrtools"/> (required to burn CD-ROM media),
83 <xref linkend="dvd-rw-tools"/> (required to burn or format DVD media), and
84 <xref linkend="cdrdao"/> (required to burn CD-ROM media in DAO (Disk At
85 Once) mode). If you don't need the capability provided by any of the three
86 packages, you don't have to install it. However, a warning message will be
87 generated every time you run the <command>k3b</command> program if any are
88 not installed.</para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended"><xref linkend="kdebase"/>,
92 <xref linkend="libjpeg"/>,
93 <xref linkend="kdemultimedia"/> (required for a working audio player)</para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional"><xref linkend="alsa"/>,
97 <xref linkend="cdparanoia"/>,
98 <xref linkend="ffmpeg"/>,
99 <xref linkend="flac"/>,
100 <xref linkend="hal"/> and
101 <xref linkend="dbus-qt3"/>,
102 <xref linkend="lame"/>,
103 <xref linkend="libmad"/>,
104 <xref linkend="libmusicbrainz"/>,
105 <xref linkend="libvorbis"/>,
106 <xref linkend="libxml2"/>,
107 <xref linkend="transcode"/>,
108 <ulink url="http://www.mega-nerd.com/libsndfile/">libsndfile</ulink>,
109 <ulink url="http://movix.sourceforge.net/">MoviX</ulink>,
110 <ulink url="http://www.musepack.net/">Musepack (libmpcdec)</ulink>,
111 <ulink url="http://normalize.nongnu.org/">normalize</ulink>,
112 <ulink url="ftp://ftp.lst.de/pub/people/okir/resmgr/">resmgr</ulink>,
113 <ulink url="http://www.mega-nerd.com/libsamplerate/">Secret Rabbit
114 Code (libsamplerate)</ulink>,
115 <ulink url="http://sox.sourceforge.net/">SoX</ulink>,
116 <ulink url="http://developer.kde.org/~wheeler/taglib/">TagLib</ulink>, and
117 <ulink url="http://www.vcdimager.org/">VCDImager</ulink></para>
118
119 <para>For an explanation how each package is used by
120 <application>K3b</application>, see the Requirements page at
121 <ulink url="http://k3b.plainblack.com/requirements"/>.</para>
122
123 <bridgehead renderas="sect4">Runtime Requirements for DVD Ripping and
124 Encoding</bridgehead>
125 <para role="optional"><xref linkend="transcode"/>,
126 <xref linkend="xvid"/>,
127 <xref linkend="libdvdread"/>, and
128 <xref linkend="libdvdcss"/></para>
129
130 <para condition="html" role="usernotes">User Notes:
131 <ulink url="&blfs-wiki;/k3b"/></para>
132
133 </sect2>
134
135 <sect2 role="installation">
136 <title>Installation of K3b</title>
137
138 <para>Install <application>K3b</application> by running the following
139 commands:</para>
140
141<!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
142 href="../../xincludes/kde-sysconfdir.xml"/> -->
143
144<screen><userinput>./configure --prefix=$(kde-config --prefix) \
145 --sysconfdir=/etc/kde \
146 --disable-debug \
147 --disable-dependency-tracking &amp;&amp;
148make</userinput></screen>
149
150 <para>This package does not come with a test suite.</para>
151
152 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
153
154<screen role="root"><userinput>make install</userinput></screen>
155
156 </sect2>
157
158 <sect2 role="commands">
159 <title>Command Explanations</title>
160
161 <para><parameter>--prefix=$(kde-config --prefix)</parameter>: This
162 parameter uses <command>kde-config</command> to establish the prefix of
163 the existing KDE installation and then sets the installation prefix for
164 <application>K3b</application> to the same value.</para>
165
166 <para><parameter>--disable-debug</parameter>: This option causes the package
167 to be compiled without debugging code.</para>
168
169 <para><parameter>--disable-dependency-tracking</parameter>: This option
170 speeds up one time builds.</para>
171
172 </sect2>
173
174 <sect2 role="configuration">
175 <title>Configuring k3b</title>
176
177 <sect3 id="k3b-config">
178 <title>Configuration Information</title>
179
180 <para>You will need to ensure that any user of
181 <application>K3b</application> has permission to read and write to the
182 CD/DVD/audio hardware device files. The easiest way to do this is by
183 creating groups (audio, video, cdrecord, dvdrecord, etc.,) and then add
184 users to the appropriate groups. You'll also have to ensure that the
185 <application>Udev</application> rules are set up appropriately if you
186 are using a system where the device files are created during the system
187 boot-up sequence.</para>
188
189 <para>There is a script installed (<command>k3bsetup</command>) that is
190 a front-end to the k3bsetup2 KControlModule. This script can be accessed
191 as a pull-down menu from the K3b GUI and requires
192 <systemitem class="username">root</systemitem> user privileges
193 (<systemitem class="username">root</systemitem> privileges are acquired
194 through the use of the automatically-launched <command>kdesud</command>
195 program). Though this utility can be used to set the appropriate
196 permissions for the device files, be forewarned that in a Udev
197 environment, where the device files are created during the system boot-up
198 sequence, any changes made by this utility will not be preserved across
199 system boots.</para>
200
201 </sect3>
202
203 </sect2>
204
205 <sect2 role="content">
206 <title>Contents</title>
207
208 <segmentedlist>
209 <segtitle>Installed Programs</segtitle>
210 <segtitle>Installed Libraries</segtitle>
211 <segtitle>Installed Directories</segtitle>
212
213 <seglistitem>
214 <seg>k3b and k3bsetup</seg>
215 <seg>libk3b.so, libk3bdevice.so and numerous
216 modules for the installed dependencies</seg>
217 <seg>The following subdirectories of <envar>$KDE_PREFIX</envar>/share/:
218 applnk/Settings/System, apps/k3b, doc/HTML/en/k3b</seg>
219 </seglistitem>
220 </segmentedlist>
221
222 <variablelist>
223 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
224 <?dbfo list-presentation="list"?>
225 <?dbhtml list-presentation="table"?>
226
227 <varlistentry id="k3b-prog">
228 <term><command>k3b</command></term>
229 <listitem>
230 <para>is the graphical CD/DVD program.</para>
231 <indexterm zone="k3b k3b-prog">
232 <primary sortas="b-k3b">k3b</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="k3bsetup">
238 <term><command>k3bsetup</command></term>
239 <listitem>
240 <para>is a script used to launch the k3bsetup2 KControlModule
241 for setting up the CD/DVD hardware and device files in your
242 system.</para>
243 <indexterm zone="k3b k3bsetup">
244 <primary sortas="b-k3bsetup">k3bsetup</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 </variablelist>
250
251 </sect2>
252
253</sect1>
Note: See TracBrowser for help on using the repository browser.