[gnome-taquin] Update help.

[Arnaud B. <arnaudb src gnome org>]

commit 2947aeb8a6af8059741cefc7fac58eb05c887e0b
Author: Arnaud Bonatti <arnaud bonatti gmail com>
Date:   Wed Jan 23 16:31:48 2019 +0100

    Update help.

 help/C/15-Puzzle.page    | 46 ++++++++++++++++++++++++++++++++++------------
 help/C/16-Puzzle.page    | 40 ++++++++++++++++++++++++++++++----------
 help/C/beginning.page    | 18 ++++++++++++------
 help/C/shortcuts.page    |  2 +-
 help/C/start-screen.page |  6 +++---
 5 files changed, 80 insertions(+), 32 deletions(-)
---
diff --git a/help/C/15-Puzzle.page b/help/C/15-Puzzle.page
index 9ab445d..4ce7aae 100644
--- a/help/C/15-Puzzle.page
+++ b/help/C/15-Puzzle.page
@@ -4,12 +4,12 @@
 
   <info>
     <link type="guide" xref="index#play" />
-    <revision pkgversion="3.15" version="0.1" date="2014-09-11" status="final"/>
+    <revision pkgversion="3.31" version="0.2" date="2019-01-23" status="final"/>
 
     <credit type="author copyright">
       <name>Arnaud Bonatti</name>
       <email>arnaud bonatti gmail com</email>
-      <years>2014</years>
+      <years>2014-2019</years>
     </credit>
 
     <desc></desc>
@@ -30,7 +30,7 @@
   <section id="15-end">
     <title>End of the game</title>
     <p>At the end of the game, <app>Taquin</app> notifies you and displays the complete image.</p>
-    <p>You can click the <gui>Start Over</gui> button to go to the <link xref="start-screen">Start 
Screen</link>.</p>
+    <p>You can click the <gui>New Game</gui> button in the headerbar to go to the <link 
xref="start-screen">Start Screen</link>. Alternatively, you can restart the game by clicking on the button 
with a counter of moves done, and then on the <gui>Restart</gui> entry.</p>
   </section>
 
   <section id="15-mouse">
@@ -38,13 +38,24 @@
 
     <p>To make a move:</p>
     <steps>
-      <item><p>Click on a tile on the same row or column as the empty space.</p>
-      <note><p>If you click on a tile that cannot move, the game notifies you that the move is 
impossible.</p>
+      <item>
+        <p>Click on a tile on the same row or column as the empty space.</p>
+      <note>
+        <p>If you click on a tile that cannot move, the game notifies you that the move is impossible.</p>
       </note>
       </item>
-      <item><p>You can always undo a move by clicking the <gui>Undo</gui> button at the left of the header 
bar.</p>
+      <item>
+        <p>You can always undo your move. For that, click on the button with a counter of moves done in the 
headerbar, and click the <gui>Undo</gui> entry in the menu that appears.</p>
       </item>
-      <item><p>At the end of the game, or when you want to switch games, click the <gui>Start Over</gui> 
button to go to the <link xref="start-screen">Start Screen</link>.</p>
+    </steps>
+
+    <p>Whether you finished the current game or not:</p>
+    <steps>
+      <item>
+        <p>To start a new game –possibly with other options–, click the <gui>New Game</gui> button in the 
headerbar to go to the <link xref="start-screen">Start Screen</link>.</p>
+      </item>
+      <item>
+        <p>Alternatively, you may want to restart the game. For that, click in the headerbar on the button 
with a counter of moves done, and click the <gui>Restart</gui> entry in the menu that appears.</p>
       </item>
     </steps>
 
@@ -56,14 +67,25 @@
 
     <p>To make a move:</p>
     <steps>
-      <item><p>Use the <key>Left</key>, <key>Right</key>, <key>Up</key> and <key>Down</key> arrows to go at 
the tile you want to move. The currently selected tile is indicated with four arrows around the board, on 
each side of its row and column.</p></item>
-      <item><p>Use the <key>Space</key> key to move the selected tile in the direction of the empty 
space.</p>
-      <note><p>If you click on a tile that cannot move, the game notifies you that the move is 
impossible.</p>
+      <item>
+        <p>Use the <key>Left</key>, <key>Right</key>, <key>Up</key> and <key>Down</key> arrows to go at the 
tile you want to move. The currently selected tile is indicated with four arrows around the board, on each 
side of its row and column.</p>
+        <p>Use the <key>Space</key> key to move the selected tile in the direction of the empty space.</p>
+      <note>
+        <p>If you click on a tile that cannot move, the game notifies you that the move is impossible.</p>
       </note>
       </item>
-      <item><p>You can always undo a move with the <keyseq><key>Ctrl</key><key>Z</key></keyseq> keys.</p>
+      <item>
+        <p>You can always undo your move. For that, use the <keyseq><key>Ctrl</key><key>Z</key></keyseq> 
keys sequence.</p>
+      </item>
+    </steps>
+
+    <p>Whether you finished the current game or not:</p>
+    <steps>
+      <item>
+        <p>To start a new game –possibly with other options–, use the 
<keyseq><key>Ctrl</key><key>N</key></keyseq> keys sequence to go to the <link xref="start-screen">Start 
Screen</link>.</p>
       </item>
-      <item><p>At the end of the game, or when you want to switch games, use the 
<keyseq><key>Ctrl</key><key>N</key></keyseq> keys to go to the <link xref="start-screen">Start 
Screen</link>.</p>
+      <item>
+        <p>Alternatively, you may want to restart the game. For that, use the 
<keyseq><key>Shift</key><key>Ctrl</key><key>N</key></keyseq> keys sequence.</p>
       </item>
     </steps>
 
diff --git a/help/C/16-Puzzle.page b/help/C/16-Puzzle.page
index c0a071a..0298da1 100644
--- a/help/C/16-Puzzle.page
+++ b/help/C/16-Puzzle.page
@@ -4,12 +4,12 @@
 
   <info>
     <link type="guide" xref="index#play" />
-    <revision pkgversion="3.15" version="0.1" date="2014-09-11" status="final"/>
+    <revision pkgversion="3.31" version="0.2" date="2019-01-23" status="final"/>
 
     <credit type="author copyright">
       <name>Arnaud Bonatti</name>
       <email>arnaud bonatti gmail com</email>
-      <years>2014</years>
+      <years>2014-2019</years>
     </credit>
 
     <desc></desc>
@@ -30,7 +30,7 @@
   <section id="16-end">
     <title>End of the game</title>
     <p>At the end of the game, <app>Taquin</app> notifies you and displays the complete image.</p>
-    <p>You can click the <gui>Start Over</gui> button to go to the <link xref="start-screen">Start 
Screen</link>.</p>
+    <p>You can click the <gui>New Game</gui> button in the headerbar to go to the <link 
xref="start-screen">Start Screen</link>. Alternatively, you can restart the game by clicking on the button 
with a counter of moves done, and then on the <gui>Restart</gui> entry.</p>
   </section>
 
   <section id="16-mouse">
@@ -38,11 +38,21 @@
 
     <p>To make a move:</p>
     <steps>
-      <item><p>Click on one of the arrows displayed around the board. The row or column at the end of which 
this arrow is moves in this direction, and the tile that was next to the arrow is placed at the opposite 
side.</p>
+      <item>
+        <p>Click on one of the arrows displayed around the board. The row or column at the end of which this 
arrow is moves in this direction, and the tile that was next to the arrow is placed at the opposite side.</p>
       </item>
-      <item><p>You can always undo a move by clicking the <gui>Undo</gui> button at the left of the header 
bar.</p>
+      <item>
+        <p>You can always undo your move. For that, click on the button with a counter of moves done in the 
headerbar, and click the <gui>Undo</gui> entry in the menu that appears.</p>
       </item>
-      <item><p>At the end of the game, or when you want to switch games, click the <gui>Start Over</gui> 
button to go to the <link xref="start-screen">Start Screen</link>.</p>
+    </steps>
+
+    <p>Whether you finished the current game or not:</p>
+    <steps>
+      <item>
+        <p>To start a new game –possibly with other options–, click the <gui>New Game</gui> button in the 
headerbar to go to the <link xref="start-screen">Start Screen</link>.</p>
+      </item>
+      <item>
+        <p>Alternatively, you may want to restart the game. For that, click in the headerbar on the button 
with a counter of moves done, and click the <gui>Restart</gui> entry in the menu that appears.</p>
       </item>
     </steps>
 
@@ -54,12 +64,22 @@
 
     <p>To make a move:</p>
     <steps>
-      <item><p>Use the <key>Left</key>, <key>Right</key>, <key>Up</key> and <key>Down</key> arrows to go at 
the row or the column you want to move. The currently selected row and column are indicated with two lights 
around the board.</p></item>
-      <item><p>Use the <keyseq><key>Ctrl</key><key>Left</key></keyseq> or 
<keyseq><key>Ctrl</key><key>Right</key></keyseq> keys to move a row, or the 
<keyseq><key>Ctrl</key><key>Up</key></keyseq> and <keyseq><key>Ctrl</key><key>Down</key></keyseq> keys to 
move a column.</p>
+      <item>
+        <p>Use the <key>Left</key> and <key>Right</key> arrows to change the selected column, and the 
<key>Up</key> and <key>Down</key> arrows to change the selected row. The currently selected row and column 
are indicated with lights around the board.</p>
+        <p>Use the <keyseq><key>Shift</key><key>Left</key></keyseq> and 
<keyseq><key>Shift</key><key>Right</key></keyseq> keys sequences to swipe the selected row, or the 
<keyseq><key>Shift</key><key>Up</key></keyseq> and <keyseq><key>Shift</key><key>Down</key></keyseq> keys 
sequences to swipe the selected column.</p>
       </item>
-      <item><p>You can always undo a move with the <keyseq><key>Ctrl</key><key>Z</key></keyseq> keys.</p>
+      <item>
+        <p>You can always undo your move. For that, use the <keyseq><key>Ctrl</key><key>Z</key></keyseq> 
keys sequence.</p>
+      </item>
+    </steps>
+
+    <p>Whether you finished the current game or not:</p>
+    <steps>
+      <item>
+        <p>To start a new game –possibly with other options–, use the 
<keyseq><key>Ctrl</key><key>N</key></keyseq> keys sequence to go to the <link xref="start-screen">Start 
Screen</link>.</p>
       </item>
-      <item><p>At the end of the game, or when you want to switch games, use the 
<keyseq><key>Ctrl</key><key>N</key></keyseq> keys to go to the <link xref="start-screen">Start 
Screen</link>.</p>
+      <item>
+        <p>Alternatively, you may want to restart the game. For that, use the 
<keyseq><key>Shift</key><key>Ctrl</key><key>N</key></keyseq> keys sequence.</p>
       </item>
     </steps>
 
diff --git a/help/C/beginning.page b/help/C/beginning.page
index 2e66812..1f55866 100644
--- a/help/C/beginning.page
+++ b/help/C/beginning.page
@@ -4,12 +4,12 @@
 
   <info>
     <link type="guide" xref="index#play" />
-    <revision pkgversion="3.15" version="0.1" date="2014-09-11" status="final"/>
+    <revision pkgversion="3.31" version="0.2" date="2019-01-23" status="final"/>
 
     <credit type="author copyright">
       <name>Arnaud Bonatti</name>
       <email>arnaud bonatti gmail com</email>
-      <years>2014</years>
+      <years>2014-2019</years>
     </credit>
 
     <desc></desc>
@@ -22,16 +22,22 @@
   <p>The game is played using the mouse. To make a move:</p>
 
   <steps>
-    <item><p>Click on a tile on the same row or column as the empty space.</p>
-    <note><p>If you click on a tile that cannot move, the game notifies you that the move is impossible.</p>
+    <item>
+      <p>Click on a tile on the same row or column as the empty space.</p>
+    <note>
+      <p>If you click on a tile that cannot move, the game notifies you that the move is impossible.</p>
     </note>
     </item>
-    <item><p>You can always undo a move by clicking the <gui>Undo</gui> button on the left of the header 
bar.</p>
+    <item>
+      <p>You can always undo your move. For that, click on the button with a counter of moves done in the 
headerbar, and click the <gui>Undo</gui> entry in the menu that appears.</p>
     </item>
-    <item><p>At the end of the game, or when you want to switch games, click the <gui>Start Over</gui> 
button to go to the <link xref="start-screen">Start Screen</link>.</p>
+    <item>
+      <p>To start a new game –whether you finished the current game or not–, click the <gui>New Game</gui> 
button in the headerbar to go to the <link xref="start-screen">Start Screen</link>.</p>
     </item>
   </steps>
 
+  <p>You can also <link xref="15-Puzzle#15-keyboard">play with the keyboard</link> if you prefer.</p>
+
   <p>After the first time it is opened, <app>Taquin</app> displays a puzzle with the same rules and 
dimensions as the last one played when it is opened, so it could be a <link xref="16-Puzzle">16-Puzzle</link> 
game.</p>
 
 </page>
diff --git a/help/C/shortcuts.page b/help/C/shortcuts.page
index 4a4abd6..3830d39 100644
--- a/help/C/shortcuts.page
+++ b/help/C/shortcuts.page
@@ -23,7 +23,7 @@
     <title>In-game shortcuts</title>
     <table frame="all" rules="cols" shade="rows">
       <tr>
-        <td><p>Show new-game screen</p></td>
+        <td><p>Show the Start Screen</p></td>
         <td><p><keyseq><key>Ctrl</key><key>N</key></keyseq></p></td>
       </tr>
       <tr>
diff --git a/help/C/start-screen.page b/help/C/start-screen.page
index c1ee751..c950f3c 100644
--- a/help/C/start-screen.page
+++ b/help/C/start-screen.page
@@ -4,12 +4,12 @@
 
   <info>
     <link type="guide" xref="index#play" />
-    <revision pkgversion="3.15" version="0.1" date="2014-09-11" status="final"/>
+    <revision pkgversion="3.31" version="0.2" date="2019-01-23" status="final"/>
 
     <credit type="author copyright">
       <name>Arnaud Bonatti</name>
       <email>arnaud bonatti gmail com</email>
-      <years>2014</years>
+      <years>2014-2019</years>
     </credit>
 
     <desc></desc>
@@ -17,6 +17,6 @@
 
   <title>Start Screen</title>
   <p>The <em>Start Screen</em> is the place to select your options and launch a new game, either a <link 
xref="15-Puzzle">15-Puzzle</link> or a <link xref="16-Puzzle">16-Puzzle</link>.</p>
-  <p>It can be accessed at any time from a game by pressing the <gui>Start Over</gui> button.</p>
+  <p>It can be accessed at any time from a game by pressing the <gui>New Game</gui> button.</p>
 
 </page>