[kde-doc-english] [kdiamond] doc: Proofread + update KDiamond handbook to 16.04

[Burkhard Lück]

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

Proofread + update KDiamond handbook to 16.04

remove entities kdiamond, kappname, package - defined in kdoctools or not used anymore
bump date + releaseinfo
add screenshots
remove appendix
fix formatting

A  +-    --    doc/gameboard.png
M  +21   -28   doc/index.docbook

http://commits.kde.org/kdiamond/8dd5046a01683d00820f22fc20f416ab82b1f274

diff --git a/doc/gameboard.png b/doc/gameboard.png
new file mode 100644
index 0000000..77b6e13
Binary files /dev/null and b/doc/gameboard.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 001b405..220e276 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 kdiamond "<application>KDiamond</application>">
-<!ENTITY kappname "&kdiamond;">
-<!ENTITY package "kdegames">
 <!ENTITY % English "INCLUDE"> 
 <!ENTITY % addindex "IGNORE">
 ]>
@@ -27,8 +24,8 @@
     
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2013-05-05</date>
-<releaseinfo>1.4 (&kde; 4.11)</releaseinfo>
+<date>2016-05-09</date>
+<releaseinfo>1.5 (Applications 16.04)</releaseinfo>
 
 <abstract>
 <para>
@@ -51,6 +48,17 @@
 &kdiamond; is a single player puzzle 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 build lines of three similar diamonds.
 </para>
@@ -110,7 +118,8 @@ Starts a new game. It creates a random board using the current difficulty level.
 <term><menuchoice>
 <shortcut><keycap>P</keycap></shortcut>
 <guimenu>Game</guimenu>
-<guimenuitem>Pause</guimenuitem></menuchoice></term>
+<guimenuitem>Pause</guimenuitem>
+</menuchoice></term>
 <listitem>
 <para>
 Pauses the game time. Click on the menu item again to make the game resume. Note that the board disappears when the game is paused as it would be unfair if you could search for good moves without the time pressure.
@@ -124,7 +133,8 @@ Pauses the game time. Click on the menu item again to make the game resume. Note
 <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
-<guimenuitem>Show High Scores</guimenuitem></menuchoice></term>
+<guimenuitem>Show High Scores</guimenuitem>
+</menuchoice></term>
 <listitem>
 <para>
 Shows a dialog containing the High Scores for the various difficulty levels.
@@ -179,8 +189,10 @@ Highlight a diamond which can be moved.
 </varlistentry>
 
 <varlistentry>
-<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
-Notifications...</guimenuitem></menuchoice></term>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Notifications...</guimenuitem>
+</menuchoice></term>
 <listitem><para>This item displays a standard &kde; notifications configuration
 dialog, where you can change the notifications (sounds, visible messages,
 &etc;) used by &kdiamond;.</para></listitem>
@@ -280,25 +292,6 @@ Documentation copyright 2008, 2009, 2010 by Stefan Majewsky <email>majewsky at gmx.
 
 </chapter>
 
-<appendix id="installation">
-<title>Installation</title>
-
-<sect1 id="getting-kdiamond">
-<title>How to obtain &kdiamond;</title>
-
-&install.intro.documentation;
-
-</sect1>
-
-<sect1 id="compilation">
-<title>Compilation and Installation</title>
-
-&install.compile.documentation;
-
-</sect1>
-</appendix>
-
-
 &documentation.index; 
 </book>
 <!--