source: kde/kf5-apps/k3b.xml

trunk
Last change on this file was 8558044, checked in by Pierre Labastie <pierre.labastie@…>, 6 weeks ago

Remove spaces at the end of lines

I know it is somewhat useless, but I don't like them for
two reasons: first they cannot be seen, and I do not like things I
cannot see. Second, git highlights them, and this is disturbing...

  • Property mode set to 100644
File size: 6.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 "&kf5apps-download-http;/k3b-&kf5apps-version;.tar.xz">
8 <!ENTITY k3b-download-ftp " ">
9 <!ENTITY k3b-md5sum "43f8a86887670d148123a8ec80b80a29">
10 <!ENTITY k3b-size "10 MB">
11 <!ENTITY k3b-buildsize "118 MB">
12 <!ENTITY k3b-time "1.2 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 &lfs110a_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="ffmpeg"/>,
109 <xref linkend="libburn"/>,
110 <xref linkend="libdvdread"/>, and
111 <xref linkend="taglib"/>
112 </para>
113
114 <para role="recommended">
115 There are programs from three packages that
116 <application>k3b</application> will look for at runtime:
117 <xref role="runtime" linkend="cdrtools"/> (required to burn CD-ROM media),
118 <xref role="runtime" linkend="dvd-rw-tools"/> (required to burn or format
119 DVD media), and <xref role="runtime" linkend="cdrdao"/> (required to burn
120 CD-ROM media in DAO (Disk At Once) mode). If you don't need the
121 capability provided by any of the three packages, you don't have to
122 install it. However, a warning message will be generated every time you
123 run the <command>k3b</command> program if any are not installed.
124 </para>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 <xref linkend="flac"/>,
129 <xref linkend="lame"/>,
130 <xref linkend="libmad"/>,
131 <xref linkend="libsndfile"/>,
132 <xref linkend="libvorbis"/>,
133 <xref linkend="libmusicbrainz"/>, and
134 <ulink url="http://www.musepack.net/">Musepack (libmpcdec)</ulink>
135 </para>
136
137 <para condition="html" role="usernotes">User Notes:
138 <ulink url="&blfs-wiki;/k3b"/>
139 </para>
140 </sect2>
141
142 <sect2 role="installation">
143 <title>Installation of K3b</title>
144
145 <para>
146 Install <application>K3b</application> by running the following
147 commands:
148 </para>
149
150<screen><userinput>mkdir build &amp;&amp;
151cd build &amp;&amp;
152
153cmake -DCMAKE_INSTALL_PREFIX=$KF5_PREFIX \
154 -DCMAKE_BUILD_TYPE=Release \
155 -DBUILD_TESTING=OFF \
156 -Wno-dev .. &amp;&amp;
157make</userinput></screen>
158
159 <para>
160 This package does not come with a test suite.
161 </para>
162
163 <para>
164 Now, as the <systemitem class="username">root</systemitem> user:
165 </para>
166
167<screen role="root"><userinput>make install</userinput></screen>
168
169 </sect2>
170
171 <sect2 role="content">
172 <title>Contents</title>
173
174 <segmentedlist>
175 <segtitle>Installed Programs</segtitle>
176 <segtitle>Installed Libraries</segtitle>
177 <segtitle>Installed Directories</segtitle>
178
179 <seglistitem>
180 <seg>
181 k3b
182 </seg>
183 <seg>
184 libk3bdevice.so,
185 libk3blib.so,
186 and numerous plugin modules for the installed dependencies
187 </seg>
188 <seg>
189 $KF5_PREFIX/share/{,kxmlgui5/}k3b and
190 $KF5_PREFIX/share/doc/HTML/*/k3b
191 </seg>
192 </seglistitem>
193 </segmentedlist>
194
195 <variablelist>
196 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
197 <?dbfo list-presentation="list"?>
198 <?dbhtml list-presentation="table"?>
199
200 <varlistentry id="k3b-prog">
201 <term><command>k3b</command></term>
202 <listitem>
203 <para>
204 is the graphical CD/DVD program
205 </para>
206 <indexterm zone="k3b k3b-prog">
207 <primary sortas="b-k3b">k3b</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 </variablelist>
213
214 </sect2>
215
216</sect1>
Note: See TracBrowser for help on using the repository browser.