source: kde/kf5-apps/k3b.xml

trunk
Last change on this file was 4aef12a, checked in by Bruce Dubbs <bdubbs@…>, 12 days ago

Update to plasma-5.24.5.
Also fix k3b xml.

  • Property mode set to 100644
File size: 6.8 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 "&kf5apps-download-http;/k3b-&kf5apps-version;.tar.xz">
8 <!ENTITY k3b-download-ftp " ">
9 <!ENTITY k3b-md5sum "e30998771fd09a90da87393712a2d78b">
10 <!ENTITY k3b-size "10 MB">
11 <!ENTITY k3b-buildsize "118 MB">
12 <!ENTITY k3b-time "1.1 SBU (using parallelism=4)">
13]>
14
15<sect1 id="k3b" xreflabel="k3b-&kf5apps-version;">
16 <?dbhtml filename="k3b.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>k3b-&kf5apps-version;</title>
23
24 <indexterm zone="k3b">
25 <primary sortas="a-K3b">K3b</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to K3b</title>
30
31 <para>
32 The <application>K3b</application> package contains a KF5-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 It is used for creating audio, data, video and mixed-mode CDs as well
39 as copying, ripping and burning CDs and DVDs.
40 </para>
41
42 <para>
43 Though <application>k3b</application> can be used to copy almost any
44 DVD to similar medium, it does not provide a way to copy, or reproduce a
45 double-layer DVD onto single-layer medium. Of course, there is not a
46 program anywhere on any platform that can make an exact duplicate of a
47 double-layer DVD onto a single-layer disk, there are programs on some
48 platforms that can compress the data on a double-layer DVD to fit on a
49 single-layer DVD producing a duplicate, but compressed, image. If you need
50 to copy the contents of a double-layer DVD to single-layer medium, you may
51 want to look at the
52 <ulink url="http://www.mcmurchy.com/rmlcopydvd/">RMLCopyDVD</ulink> package.
53 </para>
54
55 &lfs111_checked;
56
57 <bridgehead renderas="sect3">Package Information</bridgehead>
58 <itemizedlist spacing="compact">
59 <listitem>
60 <para>
61 Download (HTTP): <ulink url="&k3b-download-http;"/></para>
62 </listitem>
63 <listitem>
64 <para>
65 Download (FTP): <ulink url="&k3b-download-ftp;"/>
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download MD5 sum: &k3b-md5sum;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download size: &k3b-size;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated disk space required: &k3b-buildsize;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Estimated build time: &k3b-time;
86 </para>
87 </listitem>
88 </itemizedlist>
89
90 <bridgehead renderas="sect3">K3b Dependencies</bridgehead>
91
92 <bridgehead renderas="sect4">Required</bridgehead>
93 <para role="required">
94 <xref linkend="kf5-frameworks"/>,
95 <xref linkend="libkcddb"/>,
96 <xref linkend="libsamplerate"/>, and
97 <xref linkend="shared-mime-info"/>
98 </para>
99
100 <para role="required">
101 The CD/DVD drive is detected at run time using <xref linkend="udisks2"
102 role="runtime"/>, which must therefore be installed before running
103 <command>k3b</command>.
104 </para>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="libburn"/>,
109 <xref linkend="libdvdread"/>, and
110 <xref linkend="taglib"/>
111 </para>
112
113 <para role="recommended">
114 There are programs from three packages that
115 <application>k3b</application> will look for at runtime:
116 <xref role="runtime" linkend="cdrtools"/> (required to burn CD-ROM media),
117 <xref role="runtime" linkend="dvd-rw-tools"/> (required to burn or format
118 DVD media), and <xref role="runtime" linkend="cdrdao"/> (required to burn
119 CD-ROM media in DAO (Disk At Once) mode). If you don't need the
120 capability provided by any of the three packages, you don't have to
121 install it. However, a warning message will be generated every time you
122 run the <command>k3b</command> program if any are not installed.
123 </para>
124
125 <bridgehead renderas="sect4">Optional Runtime </bridgehead>
126 <para role="optional">
127 <xref linkend="ffmpeg"/>
128 </para>
129
130 <bridgehead renderas="sect4">Optional</bridgehead>
131 <para role="optional">
132 <xref linkend="flac"/>,
133 <xref linkend="lame"/>,
134 <xref linkend="libmad"/>,
135 <xref linkend="libsndfile"/>,
136 <xref linkend="libvorbis"/>,
137 <xref linkend="libmusicbrainz"/>, and
138 <ulink url="http://www.musepack.net/">Musepack (libmpcdec)</ulink>
139 </para>
140
141 <para condition="html" role="usernotes">User Notes:
142 <ulink url="&blfs-wiki;/k3b"/>
143 </para>
144 </sect2>
145
146 <sect2 role="installation">
147 <title>Installation of K3b</title>
148
149 <para>
150 Install <application>K3b</application> by running the following
151 commands:
152 </para>
153
154<screen><userinput>mkdir build &amp;&amp;
155cd build &amp;&amp;
156
157cmake -DCMAKE_INSTALL_PREFIX=$KF5_PREFIX \
158 -DCMAKE_BUILD_TYPE=Release \
159 -DBUILD_TESTING=OFF \
160 -Wno-dev .. &amp;&amp;
161make</userinput></screen>
162
163 <para>
164 This package does not come with a test suite.
165 </para>
166
167 <para>
168 Now, as the <systemitem class="username">root</systemitem> user:
169 </para>
170
171<screen role="root"><userinput>make install</userinput></screen>
172
173 </sect2>
174
175 <sect2 role="content">
176 <title>Contents</title>
177
178 <segmentedlist>
179 <segtitle>Installed Programs</segtitle>
180 <segtitle>Installed Libraries</segtitle>
181 <segtitle>Installed Directories</segtitle>
182
183 <seglistitem>
184 <seg>
185 k3b
186 </seg>
187 <seg>
188 libk3bdevice.so,
189 libk3blib.so,
190 and numerous plugin modules for the installed dependencies
191 </seg>
192 <seg>
193 $KF5_PREFIX/share/{,kxmlgui5/}k3b and
194 $KF5_PREFIX/share/doc/HTML/*/k3b
195 </seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="k3b-prog">
205 <term><command>k3b</command></term>
206 <listitem>
207 <para>
208 is the graphical CD/DVD program
209 </para>
210 <indexterm zone="k3b k3b-prog">
211 <primary sortas="b-k3b">k3b</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 </variablelist>
217
218 </sect2>
219
220</sect1>
Note: See TracBrowser for help on using the repository browser.