[kde-doc-english] [kbounce] doc: Proofread + update KBounce handbook to 16.04

Burkhard Lück lueck at hube-lueck.de
Tue May 10 12:15:40 UTC 2016


Git commit 5c161de52f81a28d0db2b688947200767b107ec9 by Burkhard Lück.
Committed on 10/05/2016 at 12:14.
Pushed by lueck into branch 'master'.

Proofread + update KBounce handbook to 16.04

remove entities kappname, package - not used anymore
bump date + releaseinfo
add screenshots, remove unused screenshots, update screenshots
remove guimenu markup in titles
remove appendix

D  +-    --    doc/button-new.png
D  +-    --    doc/button-pause.png
A  +-    --    doc/document-new.png
M  +34   -65   doc/index.docbook
M  +-    --    doc/kbounce_corridor1.png
M  +-    --    doc/kbounce_corridor2.png
A  +-    --    doc/media-playback-pause.png
D  +-    --    doc/menu-game.png
D  +-    --    doc/menu-settings.png
D  +-    --    doc/toolbar.png

http://commits.kde.org/kbounce/5c161de52f81a28d0db2b688947200767b107ec9

diff --git a/doc/button-new.png b/doc/button-new.png
deleted file mode 100644
index cb0a7cf..0000000
Binary files a/doc/button-new.png and /dev/null differ
diff --git a/doc/button-pause.png b/doc/button-pause.png
deleted file mode 100644
index 3861c1d..0000000
Binary files a/doc/button-pause.png and /dev/null differ
diff --git a/doc/document-new.png b/doc/document-new.png
new file mode 100644
index 0000000..89884d9
Binary files /dev/null and b/doc/document-new.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 10fab7d..bfffb0b 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 "&kbounce;">
-  <!ENTITY kappversion "0.11"><!--Applicaion version. Use this variable everywhere it's needed.-->
-  <!ENTITY package "kdegames">
   <!ENTITY % English "INCLUDE" > 
   <!ENTITY % addindex "IGNORE">
 ]>
@@ -37,11 +34,11 @@
 <legalnotice>&FDLNotice;</legalnotice>
 
 
-<date>2013-05-05</date><!-- Date of (re)writing, or update.-->
-<releaseinfo>&kappversion; (&kde; 4.11)</releaseinfo><!-- Application version number. Use the variable definitions within header to change this value.-->
+<date>2013-05-05</date>
+<releaseinfo>0.11 (Applications 16.04)</releaseinfo>
 
 <abstract>
-	<para>This documentation describes the game of &kbounce; version &kappversion;</para>
+	<para>This documentation describes the game of &kbounce; version 0.11</para>
 </abstract>
 
 
@@ -211,13 +208,6 @@ of the screen.  Rushing will just get you in trouble!
 <sect1 id="the-tool-bar">
 <title>The Tool Bar</title>
 
-<mediaobject>
-<imageobject>
-<imagedata format="PNG" fileref="toolbar.png"/>
-</imageobject>
-<textobject><phrase>Toolbar</phrase></textobject>
-</mediaobject>
-
 <para>
 The toolbar provides buttons for the commonly used functions.
 </para>
@@ -240,7 +230,7 @@ The toolbar provides buttons for the commonly used functions.
 <entry>
 <inlinemediaobject>
 <imageobject>
-<imagedata format="PNG" fileref="button-new.png"/>
+<imagedata format="PNG" fileref="document-new.png"/>
 </imageobject>
 <textobject><phrase>New Game Button</phrase></textobject>
 </inlinemediaobject>
@@ -268,7 +258,7 @@ and sets the level to 1.
 <entry>
 <inlinemediaobject>
 <imageobject>
-<imagedata format="PNG" fileref="button-pause.png"/>
+<imagedata format="PNG" fileref="media-playback-pause.png"/>
 </imageobject>
 <textobject>
 <phrase>Pause Button</phrase></textobject>
@@ -299,20 +289,12 @@ Pauses or resumes the current game.
 <title>The Menu Items</title>
 
 <sect2>
-<title>The <guimenu>Game</guimenu> Menu</title>
-
-<mediaobject>
-<imageobject>
-<imagedata format="PNG" fileref="menu-game.png"/>
-</imageobject>
-<textobject>
-<phrase><guimenu>Game</guimenu> Menu</phrase></textobject>
-</mediaobject>
+<title>The Game Menu</title>
 
 <variablelist>
 <varlistentry id="game-new">
-<term>
-<menuchoice><shortcut>
+<term><menuchoice>
+<shortcut>
 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
@@ -324,10 +306,9 @@ Pauses or resumes the current game.
 </varlistentry>
 
 <varlistentry id="game-end">
-<term>
-<menuchoice><shortcut>
-<keycombo action="simul">&Ctrl;<keycap>End</keycap>
-</keycombo>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>End Game</guimenuitem>
@@ -338,9 +319,10 @@ Pauses or resumes the current game.
 </varlistentry>
 
 <varlistentry id="game-pause">
-<term>
-<menuchoice><shortcut>
-<keycap>P</keycap></shortcut>
+<term><menuchoice>
+<shortcut>
+<keycap>P</keycap>
+</shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Pause</guimenuitem>
 </menuchoice></term>
@@ -350,8 +332,8 @@ Pauses or resumes the current game.
 </varlistentry>
 
 <varlistentry id="game-highscores">
-<term>
-<menuchoice><shortcut>
+<term><menuchoice>
+<shortcut>
 <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
@@ -365,7 +347,8 @@ Opens a dialog that displays different high score tables.
 </varlistentry>
 
 <varlistentry id="game-quit">
-<term><menuchoice><shortcut>
+<term><menuchoice>
+<shortcut>
 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
@@ -380,15 +363,7 @@ If a game is currently played, it's status is lost.</para>
 </sect2>
 
 <sect2 id="settings-menu">
-<title>The <guimenu>Settings</guimenu> Menu</title>
-
-<mediaobject>
-<imageobject>
-<imagedata format="PNG" fileref="menu-settings.png"/>
-</imageobject>
-<textobject>
-<phrase>Settings Menu</phrase></textobject>
-</mediaobject>
+<title>The Settings Menu</title>
 
 <variablelist>
 
@@ -451,17 +426,20 @@ of the &kde; Fundamentals.
 </chapter>
 
 <chapter id="configuration"><title>Game Configuration</title> <!-- do not change this! -->
-  <para>The &kbounce; configuration dialog allows you to select visual themes for &kbounce;.</para>
-		<para>
-			To select a new theme simply choose the theme from
-			the selection list. Each item in the list shows a small
-			preview left to the theme name. A selection is immediately applied.
-		</para>
-		<para>
-			Once you are satisfied with the theme you have selected you
-			can click the <guibutton>OK</guibutton>
-			button, located at the bottom part of this dialog.
-		</para>
+<para>The &kbounce; configuration dialog allows you to select visual themes for &kbounce;.</para>
+<para>
+To select a new theme simply choose the theme from
+the selection list. Each item in the list shows a small
+preview left to the theme name. A selection is immediately applied.
+</para>
+<para>
+You can select random background pictures from a user defined folder with images.
+</para>
+<para>
+Once you are satisfied with the theme you have selected you
+can click the <guibutton>OK</guibutton>
+button, located at the bottom part of this dialog.
+</para>
 </chapter>
 
 <chapter id="credits-and-license">
@@ -507,15 +485,6 @@ Port to KDE4 and KGameCavas</para>
 
 </chapter>
 
-<appendix id="installation">
-<title>Installation</title>
-
-&install.intro.documentation;
-
-&install.compile.documentation;
-
-</appendix>
-
 &documentation.index; 
 </book>
 <!--
diff --git a/doc/kbounce_corridor1.png b/doc/kbounce_corridor1.png
index 89f7482..b8fe6e8 100644
Binary files a/doc/kbounce_corridor1.png and b/doc/kbounce_corridor1.png differ
diff --git a/doc/kbounce_corridor2.png b/doc/kbounce_corridor2.png
index c01485d..fb4a9c3 100644
Binary files a/doc/kbounce_corridor2.png and b/doc/kbounce_corridor2.png differ
diff --git a/doc/media-playback-pause.png b/doc/media-playback-pause.png
new file mode 100644
index 0000000..7ae6d07
Binary files /dev/null and b/doc/media-playback-pause.png differ
diff --git a/doc/menu-game.png b/doc/menu-game.png
deleted file mode 100644
index 2cc2acf..0000000
Binary files a/doc/menu-game.png and /dev/null differ
diff --git a/doc/menu-settings.png b/doc/menu-settings.png
deleted file mode 100644
index 02dfee4..0000000
Binary files a/doc/menu-settings.png and /dev/null differ
diff --git a/doc/toolbar.png b/doc/toolbar.png
deleted file mode 100644
index 22461a7..0000000
Binary files a/doc/toolbar.png and /dev/null differ


More information about the kde-doc-english mailing list