@ -1,17 +1,16 @@
<?xml version="1.0" ?>
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY k3b "<application>K3b</application>">
<!ENTITY k3b "<application>K3b</application>">
<!ENTITY cdrdao "<application>cdrdao</application>">
<!ENTITY cdrdao "<application>cdrdao</application>">
<!ENTITY dvdtools "<application>DVD+RW-Tools</application>">
<!ENTITY dvdtools "<application>DVD+RW-Tools</application>">
<!ENTITY mkisofs "<application>mkisofs</application>">
<!ENTITY mkisofs "<application>mkisofs</application>">
<!ENTITY cdrecord "<application>cdrecord</application>">
<!ENTITY cdrecord "<application>cdrecord</application>">
<!ENTITY k3bsetup "<application>K3bSetup</application>">
<!ENTITY k3bsetup "<application>K3bSetup</application>">
<!ENTITY k3b-commands SYSTEM "commands.docbook">
<!ENTITY k3b-commands SYSTEM "commands.docbook">
<!ENTITY k3b-audiocd-howto SYSTEM "audiocd-howto.docbook">
<!ENTITY k3b-audiocd-howto SYSTEM "audiocd-howto.docbook">
<!ENTITY k3b-cdcopy-howto SYSTEM "cdcopy-howto.docbook">
<!ENTITY k3b-cdcopy-howto SYSTEM "cdcopy-howto.docbook">
<!ENTITY k3b-dcop SYSTEM "dcop.docbook">
<!ENTITY k3b-dcop SYSTEM "dcop.docbook">
<!ENTITY kappname "&k3b;">
<!ENTITY kappname "&k3b;">
<!ENTITY package "kdeextragear-1">
<!ENTITY % addindex "IGNORE">
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE">
<!ENTITY % English "INCLUDE">
]>
]>
@ -22,41 +21,34 @@
<title>The &k3b; Handbook</title>
<title>The &k3b; Handbook</title>
<authorgroup>
<authorgroup>
<author>
<author><firstname>Carsten</firstname><surname>Niehaus</surname></author>
<firstname>Carsten</firstname>
<author><firstname>Jakob</firstname><surname>Petsovits</surname></author>
<surname>Niehaus</surname>
<author>&tde-authors;</author>
</author>
<author>
<firstname>Jakob</firstname>
<surname>Petsovits</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</authorgroup>
<copyright>
<copyright>
<year>2003-2004</year><year>2003-2004</year>
<holder>Carsten Niehaus</holder>
<holder>Carsten Niehaus</holder>
</copyright>
</copyright>
<copyright>
<year>&tde-copyright-date;</year>
<holder>&tde-team;</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Translators: put here the copyright notice of the translation -->
<legalnotice>&FDLNotice;</legalnotice>
<legalnotice>&FDLNotice;</legalnotice>
<date>2005-06-21</date>
<date>Reviewed: &tde-release-date;</date>
<releaseinfo>0.03.00</releaseinfo>
<releaseinfo>&tde-release-version;</releaseinfo>
<!-- Abstract about this handbook -->
<abstract>
<abstract>
<para>
<para>
&k3b; is a CD and DVD burning application for &k de; with a comfortable user interface.&k3b; is a CD and DVD burning application for &t de; with a comfortable user interface.
</para>
</para>
</abstract>
</abstract>
<keywordset>
<keywordset>
<keyword>KDE</keyword>
<keyword>TDE</keyword>
<keyword>kdeextragear</keyword>
<keyword>cdrecord</keyword>
<keyword>cdrecord</keyword>
<keyword>DVD</keyword>
<keyword>DVD</keyword>
<keyword>CD</keyword>
<keyword>CD</keyword>
@ -72,18 +64,47 @@
<title>Introduction</title>
<title>Introduction</title>
<para>
<para>
&k3b; is a CD and DVD burning application for Linux systems
&k3b; is a CD and DVD burning application for Linux systems
optimized for &kde;. It provides a comfortable user interface
optimized for &tde;. It provides a comfortable user interface
to perform most CD/DVD burning tasks like creating an Audio CD
to perform most CD/DVD burning tasks like creating an Audio CD
from a set of audio files or copying a CD.
from a set of audio files or copying a CD.
While the experienced user can take influence in all steps
While the experienced user can take influence in all steps
of the burning process, the beginner may find comfort
of the burning process, the beginner may find comfort
in the automatic settings and the reasonable &k3b; defaults
in the automatic settings and the reasonable &k3b; defaults
which allow a quick start. The actual burning in K3b is done
which allow a quick start. The actual burning in K3b is done
by the command line utilities
by the command line utilities
<application>cdrecord</application>,
<application>cdrecord</application>,
<application>cdrdao</application>, and
<application>cdrdao</application>, and
<application>growisofs</application>.
<application>growisofs</application>.
</para>
</chapter>
<chapter id="pre-setup"><title>Pre-setup</title>
<para>When you run &k3b; for the first time, you may find &k3b; informing you
that no optical writer drivers have been found, meaning you will not be able to
write to any optical discs. There is no need to panic as &k3b; will open a
configuration window which will help you get various tools used by &k3b; up and
running. This includes viewing the user group that owns those applications. You
should not need to change this as &k3b; will apply the correct permissions on external
programs itself. These programs are generally <command>cdrecord</command>,
<command>growisofs</command> and <command>cdrdao</command>. If preferred, one can
tell &k3b; to use the <guilabel>burning</guilabel> user group and point it to the
optical drive. Below is an image of the configuration window where these settings
are possible.
</para>
<para>
<screenshot>
<screeninfo></screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="k3bsetup.png" format="PNG"/>
</imageobject>
<textobject>
<phrase></phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</para>
</chapter>
</chapter>
@ -91,151 +112,34 @@
&k3b-commands;
&k3b-commands;
<chapter id="howtos">
<chapter id="howtos">
<title>HOWTOs for a quickstart to &k3b;</title><title>HOWTOs for a quickstart to &k3b;</title>
&k3b-audiocd-howto;&k3b-audiocd-howto;
&k3b-cdcopy-howto;&k3b-cdcopy-howto;
</chapter>
</chapter>
<!-- now the desciption of the DCOP-Interface -->
&k3b-dcop;
&k3b-dcop;
<chapter id="requirements">
<chapter id="faq">
<title>Questions and Answers</title>
<!-- (OPTIONAL but recommended) This chapter should include all of the silly
(and not-so-silly) newbie questions that fill up your mailbox. This chapter
should be reserved for BRIEF questions and answers! If one question uses more
than a page or so then it should probably be part of the
"Using this Application" chapter instead. You should use links to
cross-reference questions to the parts of your documentation that answer them.
This is also a great place to provide pointers to other FAQ's if your users
must do some complicated configuration on other programs in order for your
application work. -->
&reporting.bugs;
&updating.documentation;
<qandaset id="faqlist">
<qandaentry>
<question>
<para>
Compiling &k3b; fails with undefined type "struct KComboBox".
</para>
</question>
<answer>
<para>
The QTDesigner tool <application>uic</application> is not able to find the kde widget plugins.
To solve this run <application>qtconfig</application> and add
<filename class="directory">$<envar>TDEDIR</envar>/lib/trinity/plugins</filename> to the
plugin search path (replace $<envar>TDEDIR</envar> with your kde base dir).
</para>
</answer>
</qandaentry>
<!-- This is a template for a new Q&A-set
<qandaentry>
<question>
<para>
QUESTION
</para>
</question>
<answer>
<para>
ANSWER
</para>
</answer>
</qandaentry>
-->
</qandaset>
</chapter>
<chapter id="credits">
<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->
<title>Credits and License</title>
<para>
&k3b;
</para>
<para>
Program copyright 1999-2005 Sebastian Trueg <email>trueg@k3b.org</email>
and the K3b team
</para>
<para>
Contributors:
<itemizedlist>
<listitem><para>Thomas Froescher <email>tfroescher@k3b.org</email></para>
</listitem>
<listitem><para>Christian Kvasny <email>chris@k3b.org</email></para>
</listitem>
<listitem><para>Klaus-Dieter Krannich <email>kd@k3b.org</email></para>
</listitem>
</itemizedlist>
</para>
<para>
Documentation Copyright © 2003-2004 Carsten Niehaus <email>cniehaus@kde.org</email>
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL; <!-- FDL: do not remove -->
<!-- Determine which license your application is licensed under,
and delete all the remaining licenses below:
(NOTE: All documentation are licensed under the FDL,
regardless of what license the application uses) -->
&underGPL; <!-- GPL License -->
</chapter>
<appendix id="installation">
<title>Installation</title>
<sect1 id="getting-kapp">
<title>How to obtain &k3b;</title>
<!-- This first entity contains boiler plate for applications that are
part of KDE CVS. You should remove it if you are releasing your
application -->
<!-- &install.intro.documentation; ok, removed -->
<para>
The main information site for &k3b; is
<ulink url="http://www.k3b.org/">www.k3b.org</ulink>.
For the most current version of &k3b;, feedback and
community help as well as &k3b; news and other information,
this is the place to go.
</para>
</sect1>
<sect1 id="requirements">
<title>Requirements</title>
<title>Requirements</title>
<para>
<para>
In order to successfully use &k3b;, you need &kde; >= 3.1 and &Qt; >= 3.1 .To use &k3b; you need &tde;.
</para>
</para>
<para>
<para>
&cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO)&cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO)
mode based on a textual description of the CD contents (toc-file).mode based on a textual description of the CD contents (toc-file).
</para>
</para>
<para>
<para>
&cdrecord;/&mkisofs;: Records any kind of CD-Rs. &cdrecord; contains all of &cdrdao;'s features and extended functionality and therefore is &k3b;'s standard choice for CD burning. In some cases, &cdrdao; reaches better audio CD burning quality though.&cdrecord;/&mkisofs;: Records any kind of CD-Rs. &cdrecord; contains all of &cdrdao;'s features and extended functionality and therefore is &k3b;'s standard choice for CD burning. In some cases, &cdrdao; reaches better audio CD burning quality though.
</para>
</para>
<para>
<para>
&dvdtools;: The &dvdtools; are used to burn and format DVD+R(W) and DVD-R(W) media.&dvdtools;: The &dvdtools; are used to burn and format DVD+R(W) and DVD-R(W) media.
</para>
</para>
<para>
<para>
Optionally &k3b; can make use of all these libraries:Optionally &k3b; can make use of all these libraries:
</para>
</para>
<para>
<para>
@ -303,38 +207,33 @@ files. eMovix contains all the software to boot from a CD and automatically
play every video file localized in the CD root.
play every video file localized in the CD root.
</para>
</para>
<!-- For a list of updates, you may refer to the application web site
</chapter>
or the ChangeLog file, or ... -->
<para>
You can find a list of changes to &k3b; at <ulink
url="http://www.k3b.org">http://www.k3b.org</ulink>.
</para>
</sect1>
<sect1 id="compilation">
<title>Compilation and Installation</title>
<!-- This entity contains the boilerplate text for standard -->
<chapter id="credits">
<!-- compilation instructions. If your application requires any -->
<title>Credits and License</title>
<!-- special handling, remove it, and replace with your own text. -->
&install.compile.documentation;
<para>
&k3b;
</para>
<para>
Program copyright 1999-2005 Sebastian Trueg <email>trueg@k3b.org</email>
and the K3b team
</para>
<para>
Contributors:
<itemizedlist>
<listitem><para>Thomas Froescher</para>
</listitem>
<listitem><para>Christian Kvasny</para>
</listitem>
<listitem><para>Klaus-Dieter Krannich</para>
</listitem>
</itemizedlist>
</para>
</sect1>
&underFDL;
&underGPL;
</appendix>
</chapter >
&documentation.index;
</book>
</book>
<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
vim:tabstop=2:shiftwidth=2:expandtab
-->
Darrell Anderson
10 years ago
