From 9a4bae9fbd7c58980a5bc571febaf12636079ebb Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Sun, 16 Feb 2014 18:20:20 -0600 Subject: Add new section in help handbook for k3bsetup help and add respective desktop file with appropriate DocPath. This is in support of bug report 1930. --- doc/dcop.docbook | 4 +- doc/index.docbook | 295 ++++++++++++++++++------------------------------------ doc/k3bsetup.png | Bin 0 -> 87985 bytes 3 files changed, 99 insertions(+), 200 deletions(-) create mode 100644 doc/k3bsetup.png (limited to 'doc') diff --git a/doc/dcop.docbook b/doc/dcop.docbook index 82b05a6..0958946 100644 --- a/doc/dcop.docbook +++ b/doc/dcop.docbook @@ -1,6 +1,6 @@ The &k3b; &DCOP; Interface - &k3b; features, like many other &kde; applications as well, a + &k3b; features, like many other &tde; applications as well, a &DCOP; interface which makes it possible to control a part of it's functionality from ⪚ a shellscript. To use these &DCOP; functions you can either use the @@ -16,7 +16,7 @@ -Besides the generic &DCOP; functions available to all &kde; +Besides the generic &DCOP; functions available to all &tde; applications, &k3b;'s DCOP interface mainly consists of two parts as described below. diff --git a/doc/index.docbook b/doc/index.docbook index 781f91e..22d3ab8 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1,17 +1,16 @@ K3b"> -cdrdao"> -DVD+RW-Tools"> -mkisofs"> -cdrecord"> -K3bSetup"> - - - - + K3b"> + cdrdao"> + DVD+RW-Tools"> + mkisofs"> + cdrecord"> + K3bSetup"> + + + + - ]> @@ -22,41 +21,34 @@ The &k3b; Handbook - - Carsten - Niehaus - - - Jakob - Petsovits - - +CarstenNiehaus +JakobPetsovits +&tde-authors; - - - 2003-2004 +2003-2004 Carsten Niehaus + +&tde-copyright-date; +&tde-team; + &FDLNotice; -2005-06-21 -0.03.00 - - +Reviewed: &tde-release-date; +&tde-release-version; - &k3b; is a CD and DVD burning application for &kde; with a comfortable user interface. +&k3b; is a CD and DVD burning application for &tde; with a comfortable user interface. -KDE -kdeextragear +TDE cdrecord DVD CD @@ -72,18 +64,47 @@ Introduction - &k3b; is a CD and DVD burning application for Linux systems - optimized for &kde;. It provides a comfortable user interface - to perform most CD/DVD burning tasks like creating an Audio CD - from a set of audio files or copying a CD. - While the experienced user can take influence in all steps - of the burning process, the beginner may find comfort - in the automatic settings and the reasonable &k3b; defaults - which allow a quick start. The actual burning in K3b is done - by the command line utilities - cdrecord, - cdrdao, and - growisofs. +&k3b; is a CD and DVD burning application for Linux systems +optimized for &tde;. It provides a comfortable user interface +to perform most CD/DVD burning tasks like creating an Audio CD +from a set of audio files or copying a CD. +While the experienced user can take influence in all steps +of the burning process, the beginner may find comfort +in the automatic settings and the reasonable &k3b; defaults +which allow a quick start. The actual burning in K3b is done +by the command line utilities +cdrecord, +cdrdao, and +growisofs. + + + + +Pre-setup +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 cdrecord, +growisofs and cdrdao. If preferred, one can +tell &k3b; to use the burning user group and point it to the +optical drive. Below is an image of the configuration window where these settings +are possible. + + + + + + + + + + + + + @@ -91,151 +112,34 @@ &k3b-commands; - HOWTOs for a quickstart to &k3b; +HOWTOs for a quickstart to &k3b; - &k3b-audiocd-howto; - &k3b-cdcopy-howto; +&k3b-audiocd-howto; +&k3b-cdcopy-howto; - &k3b-dcop; - - -Questions and Answers - - - -&reporting.bugs; -&updating.documentation; - - - - - - Compiling &k3b; fails with undefined type "struct KComboBox". - - - - - The QTDesigner tool uic is not able to find the kde widget plugins. - To solve this run qtconfig and add - $TDEDIR/lib/trinity/plugins to the - plugin search path (replace $TDEDIR with your kde base dir). - - - - - - - - - - - -Credits and License - - -&k3b; - - - Program copyright 1999-2005 Sebastian Trueg trueg@k3b.org - and the K3b team - - -Contributors: - - Thomas Froescher tfroescher@k3b.org - -Christian Kvasny chris@k3b.org - -Klaus-Dieter Krannich kd@k3b.org - - - - - - Documentation Copyright © 2003-2004 Carsten Niehaus cniehaus@kde.org - - - - -&underFDL; - - - -&underGPL; - - - -Installation - - -How to obtain &k3b; - - - - - - The main information site for &k3b; is - www.k3b.org. - 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. - - - - - + Requirements - In order to successfully use &k3b;, you need &kde; >= 3.1 and &Qt; >= 3.1. +To use &k3b; you need &tde;. - &cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO) - mode based on a textual description of the CD contents (toc-file). +&cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO) +mode based on a textual description of the CD contents (toc-file). - &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. - &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. - Optionally &k3b; can make use of all these libraries: +Optionally &k3b; can make use of all these libraries: @@ -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. - - -You can find a list of changes to &k3b; at http://www.k3b.org. - - - - -Compilation and Installation + - - - + +Credits and License -&install.compile.documentation; + +&k3b; + + +Program copyright 1999-2005 Sebastian Trueg trueg@k3b.org +and the K3b team + + +Contributors: + +Thomas Froescher + +Christian Kvasny + +Klaus-Dieter Krannich + + + - +&underFDL; +&underGPL; - + -&documentation.index; - - diff --git a/doc/k3bsetup.png b/doc/k3bsetup.png new file mode 100644 index 0000000..ace96f7 Binary files /dev/null and b/doc/k3bsetup.png differ -- cgit v1.2.1