[gbrainy] More work on documentation

[Jordi Mas <jmas src gnome org>]

commit e76cca4c3bdac4b21a6fcb296b3c65baaeabe252
Author: Jordi Mas <jmas softcatala org>
Date:   Mon Dec 28 13:30:04 2009 +0100

    More work on documentation

 help/C/gametypes.page    |    8 ++++----
 help/C/history.page      |    3 ++-
 help/C/introduction.page |    4 ++--
 help/C/playing.page      |   16 ++++++++--------
 help/C/preferences.page  |    4 ++--
 help/C/results.page      |    4 ++--
 help/C/scoring.page      |    2 +-
 help/Makefile.am         |    2 +-
 8 files changed, 22 insertions(+), 21 deletions(-)
---
diff --git a/help/C/gametypes.page b/help/C/gametypes.page
index b84d0f2..3c36358 100644
--- a/help/C/gametypes.page
+++ b/help/C/gametypes.page
@@ -9,9 +9,9 @@
 
 <p><app>gbrainy</app> provides the following types of games:</p>
 <list>
-	<item><p>Logic puzzles. Games designed to challenge your reasoning and thinking skills. These games are usually based on sequences of elements, visual and spatial skills or relationships between elements.</p></item>
-	<item><p>Mental calculation. Games based on arithmetical operations designed to prove your mental calculation skills. Games based on the use of multiplication, division, addition and subtraction combined in different ways.</p></item>
-	<item><p>Memory trainers. Games designed to challenge your short term memory. These games show to the player a collection of objects and asking to recall them, sometimes establishing relationships between figures, words, numbers or colors.</p></item>
-	<item><p>Verbal analogies. Games that challenge your verbal aptitude. Games that ask you to identify cause and effect, use synonyms or antonyms, or use your vocabulary.</p></item>
+	<item><p>Logic puzzles. Games designed to challenge your reasoning and thinking skills. These games are based on sequences of elements, visual and spatial reasoning or relationships between elements.</p></item>
+	<item><p>Mental calculation. Games based on arithmetical operations designed to prove your mental calculation skills. Games that ask the player to use of multiplication, division, addition and subtraction combined in different ways.</p></item>
+	<item><p>Memory trainers. Games designed to challenge your short term memory. These games show collections of objects and ask the player to recall them, sometimes establishing relationships between figures, words, numbers or colors.</p></item>
+	<item><p>Verbal analogies. Games that challenge your verbal aptitude. Games that ask the player to identify cause and effect, use synonyms or antonyms, and use his vocabulary.</p></item>
 </list>
 </page>
diff --git a/help/C/history.page b/help/C/history.page
index 5aafb2a..d43ffd9 100644
--- a/help/C/history.page
+++ b/help/C/history.page
@@ -9,7 +9,8 @@
 <title>Player's Game History</title>
 <p>You can access the <gui>Player's Game History</gui> from the main application menu.</p>
 <media type="image" mime="image/png" src="figures/history.png"></media>
-<p>In this dialog the player can see how his performance has been evolving from every game type during the last recorded game sessions.</p>. 
+<p>In this dialog the player can see how his performance has been evolving from every game type during the last recorded game sessions.</p>
+<p>By clicking on the <gui>Total</gui>, <gui>Logic</gui>, <gui>Memory</gui>, <gui>Mental Calculation</gui> and <gui>Verbal</gui> checkboxes the user can select which game types results are drawn on the Player's history graphic.</p>
 <p><app>gbrainy</app> saves the player game scores to be able to track player's score evolution. Using the <link type="topic" xref="preferences">Preferences</link> the user can select how many games sessions are recorded and how many games you have to play in order that the game gets stored. </p>
 
 </page>
diff --git a/help/C/introduction.page b/help/C/introduction.page
index e89523f..64d9e5c 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -10,6 +10,6 @@
 <p>It features different <link type="topic" xref="gametypes">game types</link> like logic puzzles, mental calculation games, memory trainers and verbal analogies designed to test different cognitive skills. </p>
 <p><app>gbrainy</app> relies heavily on the talent of previous puzzle masters ranging from classic puzzles from the ancient times to the ideas of more recent works like <link href="http://en.wikipedia.org/wiki/Terry_Stickels";>Terry Stickels</link> puzzles or the <link href="http://en.wikipedia.org/wiki/Dr._Brain";>Dr. Brain</link> classical game.</p>
 
-<p>The player choose different difficulty levels making <app>gbrainy</app> enjoyable for kids, adults or senior citizens. It also features player's game history, player's personal records, tips for the player, or fullscreen mode. <app>gbrainy</app> can be also extended easily with new games developed by third parties.</p>
-<p>There have been recent discussions within the scientific community regarding if playing brain training software improves cognitive performance. Most of the studies show that there is no or little improvement. However, you can have a good time playing games like gbrainy.</p>
+<p>The player can choose different difficulty levels making <app>gbrainy</app> enjoyable for kids, adults or senior citizens. It also features player's game history, player's personal records, tips for the player and fullscreen mode support. <app>gbrainy</app> can also be <link href="http://live.gnome.org/gbrainy/Extending";>extended</link> easily with new games developed by third parties.</p>
+<p>There have been recent discussions in the scientific community regarding if playing brain training software improves cognitive performance. Most of the studies show that there is no or little improvement. However, you can have a good time playing games like <app>gbrainy</app>.</p>
 </page>
diff --git a/help/C/playing.page b/help/C/playing.page
index 4b94328..13d4588 100644
--- a/help/C/playing.page
+++ b/help/C/playing.page
@@ -5,7 +5,7 @@
   <title type="sort">1</title>
   <link type="guide" xref="index#playing"/>
 </info>
-<title>Playing</title>
+<title>Game Session</title>
 <section id="starting" style="1column">
 	<title>Starting a game</title>
 	<p>You can start a new game by clicking on the different buttons of the application toolbar.</p>
@@ -13,10 +13,10 @@
 	<p>The following buttons are available:</p>	
 	<list>
 		<item><p><gui>All</gui>. Starts a new game playing all the available games.</p></item>
-		<item><p><gui>Logic</gui>. Starts a new game playing all the logic games.</p></item>
-		<item><p><gui>Calculation</gui>. Starts a new game playing all the calculation games.</p></item>
-		<item><p><gui>Memory</gui>. Starts a new game playing all the memory games.</p></item>
-		<item><p><gui>Verbal</gui>. Starts a new game playing all the verbal games.</p></item>
+		<item><p><gui>Logic</gui>. Starts a new game playing only logic games.</p></item>
+		<item><p><gui>Calculation</gui>. Starts a new game playing only calculation games.</p></item>
+		<item><p><gui>Memory</gui>. Starts a new game playing only memory games.</p></item>
+		<item><p><gui>Verbal</gui>. Starts a new game playing only verbal analogies games.</p></item>
 	</list>
 	<p>You have also the same functionality available under the <guiseq><gui>Game</gui> <gui>New Game</gui></guiseq> menu.</p>
 </section>
@@ -30,12 +30,12 @@
 
 	<media type="image" mime="image/png" src="figures/bottom.png"></media>
 
-	<p>Once you know the answer you have to type it in the entry field next to the <gui>Answer:</gui> label</p>.
+	<p>Once you know the answer you have to type it in the entry field next to the <gui>Answer:</gui> label.</p>
 
-	<p>Some puzzles include a tip that gives some guidance when trying to solve them. You can use the <gui>Tip</gui> button when it is enabled to get a tip.</p>
+	<p>Some puzzles include a tip that gives some guidance when trying to solve them. You can use the <gui>Tip</gui> button when it is enabled to get the tip.</p>
 
 	<p>Once you have answered the puzzle you will be informed if you did provide the right answer. You can use the <gui>Next</gui> button to go to the next puzzle.</p>
 	
-	<p>You can pause the game at any moment using the <gui>Pause</gui> button and resume it later at any point.</p>
+	<p>You can pause the game using the <gui>Pause</gui> button and resume it later at any point.</p>
 </section>
 </page>
diff --git a/help/C/preferences.page b/help/C/preferences.page
index 64f0315..5c6fe7c 100644
--- a/help/C/preferences.page
+++ b/help/C/preferences.page
@@ -16,13 +16,13 @@
 
 <section id="difficulty" style="1column">
 	<title>Difficulty Level</title>
-	<p>The difficulty level establishes the complexity of the games shown during a gaming session. Influences the number of elements to remember in memory games, the size of numbers in calculation games, makes more obvious or obfuscated logic puzzles, etc. The available difficulty levels are:</p>
+	<p>The difficulty level establishes the complexity of the games shown during a gaming session. It influences the number of elements to remember in memory games, the size of numbers in calculation games, makes more obvious or obfuscated logic puzzles, etc. The available difficulty levels are:</p>
 	<list>
 		<item><p><gui>Easy</gui>. The complexity of the games shows is the average for kids.</p></item>
 		<item><p><gui>Medium</gui>. This is the default level of the difficulty of <app>gbrainy</app>. The complexity of the games shown is considered good for a regular player.</p></item>
 		<item><p><gui>Master</gui>. Ideal for advanced players with a special talent for playing <app>gbrainy</app> alike games.</p></item>
 	</list>
-	<p>The difficulty level additionally fine tunes the scoring algorithm by been more generous when playing at the easy level or more demanding when playing at master level.</p>
+	<p>The difficulty level additionally fine tunes the scoring algorithm by being more generous when playing at the easy level or more demanding when playing at master level.</p>
 
 </section>
 
diff --git a/help/C/results.page b/help/C/results.page
index 0c500e7..8ad3fd0 100644
--- a/help/C/results.page
+++ b/help/C/results.page
@@ -9,7 +9,7 @@
 <title>Results</title>
 <p>When you finish a game session <app>gbrainy</app> shows a summary of the results of the session.</p>
 <media type="image" mime="image/png" src="figures/results.png"></media>
-<p>The results shown here are computed using the <link type="topic" xref="scoring">scoring</link> algorim that takes into account time used, tips and the number of total games.</p>
-<p>If the number of games played in the session are the minimum number defined in the prefences to store the session then the results of the game session are stored in the players' history.</p>
+<p>The results shown here are computed using the <link type="topic" xref="scoring">scoring</link> algorithm that takes into account time used, tips and the number of total games.</p>
+<p>If the number of games played in the session are the minimum number defined in the preferences to store the session then the results of the game session are stored in the players' history.</p>
 
 </page>
diff --git a/help/C/scoring.page b/help/C/scoring.page
index de9e992..58d25c3 100644
--- a/help/C/scoring.page
+++ b/help/C/scoring.page
@@ -39,7 +39,7 @@
 	<title>Computing the totals</title>
 	<p><app>gbrainy</app> keeps track of the different games types played. To compute the final score of every set of game types it sums all the results of the same game types played and then applies a factor based on the logarithm of 10 for the easy difficult level, 20 for the medium difficult level and 30 for master difficult level.</p>
 	<p>This means that to score 100% playing at medium difficult level you need to score 100% on at least 20 games of every game type played, 80 games in you have played all the games types.</p>. 	
-	<p>This may sound challenging but allows players to compare game scores from different sessions (in the player history) and allows to better show the progression of the player during all the games that has played.</p>
+	<p>This may sound challenging but allows players to compare game scores from different sessions (in the player history) and allows to track better the progression of the player during all the games that has played.</p>
 </section>
 
 </page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 268ecd0..a9ce4d7 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -20,6 +20,6 @@ DOC_PAGES = \
 	results.page \
 	history.page
 
-DOC_LINGUAS=ca
+DOC_LINGUAS=
 
 dist-hook: doc-dist-hook