[kde-doc-english] [dragon] doc: Update dragon docs to KF5

Burkhard Lück lueck at hube-lueck.de
Thu Jul 7 06:44:20 UTC 2016 

Git commit 997677ab2c08b89ca00de8c993031a7337bdc126 by Burkhard Lück.
Committed on 07/07/2016 at 06:43.
Pushed by lueck into branch 'master'.

Update dragon docs to KF5

proofread
remove obsolete entities
use entity dragon from general.entities
bump date + releaseinfo
fix wrong shortcuts
new screenshots
update man docbooks and replace obsolete kde3 options with reference to qt5options + kf5options
REVIEW:128322

M  +9    -12   doc/index.docbook
M  +-    --    doc/main.png
M  +12   -61   doc/man-dragon.1.docbook
M  +-    --    doc/playmedia.png

http://commits.kde.org/dragon/997677ab2c08b89ca00de8c993031a7337bdc126

diff --git a/doc/index.docbook b/doc/index.docbook
index 176237e..7300185 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,8 +1,5 @@
 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
-  <!ENTITY kappname "&dragonplayer;">
-  <!ENTITY dragonplayer "<application>Dragon Player</application>">
-
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE"><!-- change language only here -->
 ]>
@@ -10,7 +7,7 @@
 <book id="dragon" lang="&language;">
 
 <bookinfo>
-<title>The &dragonplayer; Handbook</title>
+<title>The &dragon; Handbook</title>
 
 <authorgroup>
 <author>
@@ -41,12 +38,12 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2013-05-11</date>
-<releaseinfo>2.0 (&kde; 4.11)</releaseinfo>
+<date>2016-06-2016</date>
+<releaseinfo>Applications 16.04</releaseinfo>
 
 <abstract>
 <para>
-&dragonplayer; is a simple video player by &kde;.
+&dragon; is a simple video player by &kde;.
 </para>
 </abstract>
 
@@ -67,7 +64,7 @@
 <title>Introduction</title>
 
 <screenshot>
-<screeninfo>&dragonplayer; Screenshot</screeninfo>
+<screeninfo>&dragon; Screenshot</screeninfo>
 <mediaobject>
 <imageobject><imagedata fileref="main.png" format="PNG"/></imageobject>
 <textobject><phrase>Screenshot</phrase></textobject>
@@ -76,7 +73,7 @@
 
 
 <para>
-&dragonplayer; is a simple media player using &phonon; technology. &dragonplayer; is a no frills media player that excels at playing DVDs and movie files without getting in your way.
+&dragon; is a simple media player using &phonon; technology. &dragon; is a no frills media player that excels at playing DVDs and movie files without getting in your way.
 </para>
 
 </chapter>
@@ -84,7 +81,7 @@
 <chapter id="select-media">
 <title>Select a Media</title>
 
-<para>If you start &dragonplayer; from the application launcher or use <guibutton>Play Media</guibutton> 
+<para>If you start &dragon; from the application launcher or use <guibutton>Play Media</guibutton>
 (<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>) from the toolbar or from the <guimenu>Play</guimenu> 
 menu this window is displayed:</para>
 
@@ -135,7 +132,7 @@ These settings are stored together with the playback position for each video fil
 <term>
 Navigation
 </term>
-<listitem><para>The shortcut <keycap>PgUp</keycap> brings you 10% forward, <keycap>PgDown</keycap> 10% backward.
+<listitem><para>The shortcut <keycap>PgUp</keycap> brings you 10% forward / <keycap>+</keycap> 10 seconds forward and <keycap>PgDown</keycap> brings you 10% backward / <keycap>-</keycap> 10 seconds backward.
 Use <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Menu Toggle</guimenuitem></menuchoice> (<keycap>R</keycap>) to switch to the video menu and select another chapter to play.
 <menuchoice><guimenu>Play</guimenu><guimenuitem>Play/Pause</guimenuitem></menuchoice> (<keysym>Space</keysym>) allows you to pause and resume playback if a movie is loaded. <menuchoice><guimenu>Play</guimenu><guimenuitem>Stop</guimenuitem></menuchoice> (<keycap>S</keycap>) stops playback.
 Go to the previous or next chapter of a video with <guimenuitem>Previous Chapter</guimenuitem> (<keycap>,</keycap>) or <guimenuitem>Next Chapter</guimenuitem> (<keycap>.</keycap>) from the <guimenu>Play</guimenu> menu.
@@ -176,7 +173,7 @@ These menu items from the <guimenu>Settings</guimenu> menu are active if there a
 <title>Credits and License</title>
 
 <para>
-&dragonplayer;
+&dragon;
 </para>
 
 <para>Program copyright 2004 Max B. Howell <email>max.howell at methylblue.com</email></para>
diff --git a/doc/main.png b/doc/main.png
index b9b47cf..ad70d03 100644
Binary files a/doc/main.png and b/doc/main.png differ
diff --git a/doc/man-dragon.1.docbook b/doc/man-dragon.1.docbook
index a162c88..03c9dae 100644
--- a/doc/man-dragon.1.docbook
+++ b/doc/man-dragon.1.docbook
@@ -5,12 +5,13 @@
 
 <refentry lang="&language;">
 <refentryinfo>
-<title>KDE User's Manual</title>
+<title>Dragon Player User's Manual</title>
 <author><firstname>Praveen</firstname><surname>Arimbrathodiyil</surname>
 <contrib>Dragon Player man page.</contrib>
 <email>pravi.a at gmail.com</email></author>
-<date>2012-03-16</date>
-<productname>K Desktop Environment</productname>
+<date>2016-06-29</date>
+<releaseinfo>Applications 16.04</releaseinfo>
+<productname>KDE Applications</productname>
 </refentryinfo>
 
 <refmeta>
@@ -25,9 +26,8 @@
 <!-- body begins here -->
 <refsynopsisdiv id='synopsis'>
 <cmdsynopsis>
-  <command>dragon</command>    <arg choice="opt"><replaceable>Qt-options</replaceable></arg>
-    <arg choice="opt"><replaceable>KDE-options</replaceable></arg>
-    <arg choice="opt"><replaceable>URL</replaceable></arg>
+  <command>dragon</command>
+  <arg choice="opt"><replaceable>URL</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -38,59 +38,6 @@ player plays audio and video in different formats.</para>
 
 </refsect1>
 
-<refsect1 id="generic_options"><title>Generic Options</title>
-<variablelist>
-  <varlistentry>
-  <term><option>--help</option></term>
-  <listitem>
-<para>Show help about options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--help-qt</option></term>
-  <listitem>
-<para>Show Qt specific options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--help-kde</option></term>
-  <listitem>
-<para>Show KDE specific options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--help-all</option></term>
-  <listitem>
-<para>Show all options.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--author</option></term>
-  <listitem>
-<para>Show author information.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>-v, --version</option></term>
-  <listitem>
-<para>Show version information.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--license</option></term>
-  <listitem>
-<para>Show license information.</para>
-  </listitem>
-  </varlistentry>
-  <varlistentry>
-  <term><option>--</option></term>
-  <listitem>
-<para>End of options.</para>
-  </listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
 <refsect1 id="options"><title>Options</title>
 <variablelist>
   <varlistentry>
@@ -108,11 +55,15 @@ player plays audio and video in different formats.</para>
 
 <refsect1>
 <title>See Also</title>
-<para>More detailed user documentation is available from <ulink
+<simplelist>
+<member>More detailed user documentation is available from <ulink
 url="help:/dragonplayer">help:/dragonplayer</ulink>
 (either enter this <acronym>URL</acronym> into &konqueror;, or run
 <userinput><command>khelpcenter</command>
-<parameter>help:/dragonplayer</parameter></userinput>).</para>
+<parameter>help:/dragonplayer</parameter></userinput>).</member>
+<member>kf5options(7)</member>
+<member>qt5options(7)</member>
+</simplelist>
 </refsect1>
 
 <refsect1 id="copyright"><title>Copyright</title>
diff --git a/doc/playmedia.png b/doc/playmedia.png
index f691fe0..c99c94d 100644
Binary files a/doc/playmedia.png and b/doc/playmedia.png differ

More information about the kde-doc-english mailing list