[gnome-games] Some face lift to gnomine help.

[Baptiste Mille-Mathias <baptistem src gnome org>]

commit 1f2f4efd25dafa2f56befb582b8c4907293ad6ee
Author: Baptiste Mille-Mathias <baptistem gnome org>
Date:   Mon Feb 20 17:39:11 2012 +0100

    Some face lift to gnomine help.
    
    merge play.page and rule.page into rules.page.
    update flags.page to be more complete.

 gnomine/help/C/bug-filing.page           |    1 -
 gnomine/help/C/{face.page => faces.page} |   10 +-----
 gnomine/help/C/flags.page                |   44 +++++++++++++++++++-----------
 gnomine/help/C/new-game.page             |    3 +-
 gnomine/help/C/play.page                 |   34 -----------------------
 gnomine/help/C/rule.page                 |   19 -------------
 gnomine/help/C/rules.page                |   41 +++++++++++++++++++++++++++
 7 files changed, 72 insertions(+), 80 deletions(-)
---
diff --git a/gnomine/help/C/bug-filing.page b/gnomine/help/C/bug-filing.page
index d434708..8e38ecc 100644
--- a/gnomine/help/C/bug-filing.page
+++ b/gnomine/help/C/bug-filing.page
@@ -4,7 +4,6 @@
 
   <info>
     <link type="guide" xref="index#get-involved"/>
-    <link type="seealso" xref="commandline"/>
     <revision pkgversion="3.4" version="0.1" date="2012-02-06" status="review"/>
     <credit type="editor copyright">
       <name>Tiffany Antopolski</name>
diff --git a/gnomine/help/C/face.page b/gnomine/help/C/faces.page
similarity index 81%
rename from gnomine/help/C/face.page
rename to gnomine/help/C/faces.page
index 55d6be0..d5c6739 100644
--- a/gnomine/help/C/face.page
+++ b/gnomine/help/C/faces.page
@@ -1,8 +1,8 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="face">
+      id="faces">
   <info>
-    <link type="guide" xref="index#play"/>
+    <link type="guide" xref="index#tips"/>
     <revision version="0.1" date="2011-12-11" status="stub"/>
 
     <credit type="author copyright">
@@ -15,12 +15,6 @@
 
   <title>The meaning of the faces</title>
 
-  <comment>
-    <cite date="2011-12-11" href="mailto:baptistem gnome org">Baptiste Mille-Mathias</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
-
   <table shade="rows">
     <tr>
       <td><media type="image" mime="image/svg" src="figures/face-smile.svg"/></td>
diff --git a/gnomine/help/C/flags.page b/gnomine/help/C/flags.page
index ae31649..bacb3c8 100644
--- a/gnomine/help/C/flags.page
+++ b/gnomine/help/C/flags.page
@@ -1,8 +1,8 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      type="topic" style="question"
       id="flags">
   <info>
-    <link type="guide" xref="index#tips"/>
+    <link type="guide" xref="index#play"/>
     <revision version="0.1" date="2012-02-06" status="stub"/>
 
     <credit type="author copyright">
@@ -10,7 +10,7 @@
       <email>tiffany antopolski gmail com</email>
       <years>2012</years>
     </credit>
-    
+
     <credit type="author">
       <name>Baptiste Mille-Mathias</name>
       <email>baptistem gnome org</email>
@@ -22,19 +22,31 @@
 
   <title>Flags</title>
 
-  <p>Flags are used to mark tiles you suspect to hide a mine. Putting a flag 
-  on a tile also prevents you of clicking on it and it explods.</p>
-  <p>To put a flag on a tile, right-click on this tile, and a red flag will 
-  appear.</p> 
-  <p>The number of flags available is equal to the number of mines you have find
-  .</p>
-  
-  <p>If you're unsure if a tile hides a mine or not you can use the type of 
-  flags "I'm not sure", these flags are blue. These flags are not enabled by 
-  default. To enable it, choose <guiseq><gui>Settings</gui><gui>Preferences</gui>
-  </guiseq>, and tick <gui>Use "I'm not sure" flags</gui>.
-  </p>
-  <p>To put a "I'm not sure" flag on a tile, right-click twice on this tile, and
+  <section id="flags-usage">
+   <title>What are flags?</title>
+
+   <p>Flags are used to mark tiles you suspect to hide a mine. Putting a flag 
+   on a tile also prevents you of clicking on it and it explods.</p>
+  </section>
+
+  <section id="flags-put">
+   <title>Put a flag on a tile.</title>
+   <p>To put a flag on a tile, right-click on this tile, and a red flag will 
+   appear.</p> 
+   <p>The number of flags available is equal to the number of remaining mines 
+   you have find.</p>
+  </section>
+
+  <section id="flags-blue">
+   <title>Use of "I'm not sure" flag.</title>
+
+   <p>If you're unsure if a tile hides a mine or not, you can use the type of 
+   flags "I'm not sure", these flags are blue. These flags are not enabled by 
+   default. To enable it, choose <guiseq><gui>Settings</gui><gui>Preferences</gui>
+   </guiseq>, and tick <gui>Use "I'm not sure" flags</gui>.
+   </p>
+   <p>To put a "I'm not sure" flag on a tile, right-click twice on this tile, and
    a red flag will appear.</p>
+  </section>
   
 </page>
diff --git a/gnomine/help/C/new-game.page b/gnomine/help/C/new-game.page
index af2f25b..565059a 100644
--- a/gnomine/help/C/new-game.page
+++ b/gnomine/help/C/new-game.page
@@ -16,8 +16,7 @@
 
   <title>Start a new game</title>
 
-
-  <p>To start a new game click <guiseq><gui>Game</gui><gui>New</gui>
+  <p>To start a new game, click <guiseq><gui>Game</gui><gui>New</gui>
     </guiseq>. If you have a game on-going, it will be lost.</p>
   <p>Each time you start a new game, you will be asked to <link xref="difficulty">select your preferred difficulty level</link>.</p>
 
diff --git a/gnomine/help/C/rules.page b/gnomine/help/C/rules.page
new file mode 100644
index 0000000..d051394
--- /dev/null
+++ b/gnomine/help/C/rules.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="rule">
+
+  <info>
+    <link type="guide" xref="index#play"/>
+    <link type="seealso" xref="flags"/>
+    <revision version="0.1" date="2011-12-08" status="stub"/>
+
+    <credit type="author copyright">
+      <name>Baptiste Mille-Mathias</name>
+      <email>baptistem gnome org</email>
+      <years>2011</years>
+    </credit>
+
+  </info>
+
+  <title>Game rules</title>
+
+  <p>The aim of <app>gnomine</app> is to discover the mines hidden under tiles without make them explose.</p>
+  <p>At start, the <app>gnomine</app> board is full of tiles and you have to put flags on those you suspect to have mines.</p>
+
+  <steps>
+   <item>
+    <p>The games begins with a game board full of tiles, the size of the board depends on the level of difficulty you choose.</p>
+   </item>
+   <item>
+    <p>Click on a first tile to uncover it and discover what's under:</p>
+    <list>
+     <item><p>A colored number, which represent the number of mines in the adjacent tiles surrounding the current tile. 
+     That gives you an indication where mines are, and so where you have to put <link xref="flags"/>.</p></item>
+     <item><p>A blank title which means there is no mine around.</p></item>
+     <item><p>A mine, in which case you lose.</p></item>
+    </list>
+   </item>
+   <item>
+    <p>Do again the previous step until you find all the mines remaining on the board.</p>
+   </item>
+  </steps>
+
+</page>