[kde-doc-english] [kbreakout] doc: Proofread + update KBreakout handbook to 16.04

[Burkhard Lück]

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

Proofread + update KBreakout handbook to 16.04

remove entities kbreakout, kappname, package - defined in kdoctools or not used anymore
bump date + releaseinfo
add screenshots
remove appendix
replace kappname with kbreakout
fix wrong shortcuts
add info about Fire on mouse click

A  +-    --    doc/gameboard.png
M  +23   -29   doc/index.docbook

http://commits.kde.org/kbreakout/bd967fe1166a2cebf3eb0ce50c71887a9b44a308

diff --git a/doc/gameboard.png b/doc/gameboard.png
new file mode 100644
index 0000000..1705272
Binary files /dev/null and b/doc/gameboard.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 53a6281..126a574 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 kbreakout "<application>KBreakout</application>">
-<!ENTITY kappname "&kbreakout;">
-<!ENTITY package "kdegames">
 <!ENTITY % English "INCLUDE"> 
 <!ENTITY % addindex "IGNORE">
 ]>
@@ -35,12 +32,12 @@
     
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2013-05-03</date>
-<releaseinfo>1.0.0 (&kde; 4.11)</releaseinfo>
+<date>2016-05-09</date>
+<releaseinfo>1.2.0 (Applications 16.04)</releaseinfo>
 
 <abstract>
 <para>
-&kappname;, a Breakout-like game.</para>
+&kbreakout;, a Breakout-like game.</para>
 </abstract>
 
 <keywordset>
@@ -59,9 +56,20 @@
 <title>Introduction</title>
 
 <para>
-&kappname; is a Breakout-like game.
+&kbreakout; is a Breakout-like game.
 </para>
 
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata fileref="gameboard.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>&kbreakout; gameboard</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
 <para>
 The object of the game is to destroy as many bricks as possible without losing the ball.
 </para>
@@ -82,6 +90,11 @@ Some bricks have a special behavior, or may let a gift fall down when hit. The g
 To fire the ball press the spacebar, to move the bar use the mouse or the arrow keys. The ball will bounce in the direction of the side of the bar it bounced on hit, the more it bounces near the left end of the bar the more it will bounce toward the left, the same applies for the right side; if it bounces in the middle of the bar it will bounce straight toward the top.
 </para>
 
+<para>
+If you enable the option <guilabel>Fire on mouse click</guilabel> in the settings dialog, you can click with the &LMB; to fire.
+Enabling the option will make the game steal the mouse cursor, pause the game to get the cursor back.
+</para>
+
 </chapter>
 
 <chapter id="rules-strategies-tips">
@@ -599,7 +612,7 @@ Starts a new game.
 <varlistentry>
 <term><menuchoice>
 <shortcut>
-<keycap>&Esc;</keycap>
+<keycap>P</keycap>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Pause</guimenuitem>
@@ -682,7 +695,7 @@ of the &kde; Fundamentals.
 <row>
 <entry>Pause/Resume</entry>
 <entry>
-<keycap>&Esc;</keycap>
+<keycap>P</keycap>
 </entry>
 </row>
 <row>
@@ -729,7 +742,7 @@ of the &kde; Fundamentals.
 <title>Credits and License</title>
 
 <para>
-&kappname;
+&kbreakout;
 </para>
 <para>
 Program copyright 2008 by Fela Winkelmolen <email>fela.kde at gmail.com</email>
@@ -745,25 +758,6 @@ Documentation copyright 2008 by Fela Winkelmolen <email>fela.kde at gmail.com</emai
 
 </chapter>
 
-<appendix id="installation">
-<title>Installation</title>
-
-<sect1 id="getting-kbreakout">
-<title>How to obtain &kappname;</title>
-
-&install.intro.documentation;
-
-</sect1>
-
-<sect1 id="compilation">
-<title>Compilation and Installation</title>
-
-&install.compile.documentation;
-
-</sect1>
-</appendix>
-
-
 &documentation.index; 
 </book>
 <!--