[bijiben] help: Tidy up help pages

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit aef0b1cfb050b7d666a4e4be3bd39dfd152ea26e
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sat May 4 13:05:18 2013 +0100

    help: Tidy up help pages
    
    Tidy up tags, styles, wording and indentation.

 help/C/collections.page |   12 ++++++------
 help/C/colors.page      |    2 ++
 help/C/create.page      |    8 +++++---
 help/C/delete.page      |    6 ++++--
 help/C/formatting.page  |   16 +++++++++-------
 help/C/search.page      |    2 +-
 help/C/share.page       |    2 +-
 7 files changed, 28 insertions(+), 20 deletions(-)
---
diff --git a/help/C/collections.page b/help/C/collections.page
index 4f8de06..0302209 100644
--- a/help/C/collections.page
+++ b/help/C/collections.page
@@ -25,18 +25,18 @@
   <title>Collections</title>
 
   <p>You can add notes to collections in <app>Bijiben</app> to help you
-  organize them. To view the <gui>Collections</gui> dialog:</p>
+  organize them. To view your <gui>Collections</gui>:</p>
 
   <list>
     <item>
       <p>Open a note, open
-      <guiseq><gui style="button">More options…</gui><gui style="menuitem">Collections</gui></guiseq>.</p>
+      <guiseq><gui style="button">More
+      options…</gui><gui style="menuitem">Collections</gui></guiseq>.</p>
     </item>
     <item>
-      <p>From the main view, click on the <gui style="button">Selection
-      view</gui> button, select the notes which you want to add to the
-      collection then press the <gui style="button">collections</gui>
-      button.</p>
+      <p>In the <em>notes view</em>, go into the <em>selection mode</em>.
+      Select the notes which you want to add to the collection then press the
+      <gui style="button">Collections</gui> button.</p>
     </item>
   </list>
 
diff --git a/help/C/colors.page b/help/C/colors.page
index d246cb6..de9267a 100644
--- a/help/C/colors.page
+++ b/help/C/colors.page
@@ -24,6 +24,8 @@
 
   <title>Change note color</title>
 
+  <p>You can change the color of an individual note or a number of notes:</p>
+
   <list>
     <item>
       <p>Open a note and press the <gui style="button">Note color</gui>
diff --git a/help/C/create.page b/help/C/create.page
index 9adb879..3507494 100644
--- a/help/C/create.page
+++ b/help/C/create.page
@@ -28,15 +28,17 @@
   <p>You can create a new note in three different ways:</p>
   <list>
     <item>
-      <p>Press <gui style="button">New</gui> button to create a blank note.</p>
+      <p>Press the <gui style="button">New</gui> button to create a blank
+      note.</p>
     </item>
     <item>
       <p>Drag and drop text to the <em>notes view</em> to create a note
       containing this text.</p>
     </item>
     <item>
-      <p>Open a note, select some text and click on the link icon to create a
-      note containing this text.</p>
+      <p>Open a note, select some text and press the
+      <gui style="button">Link</gui> button to create a note containing this
+      text.</p>
     </item>
   </list>
 
diff --git a/help/C/delete.page b/help/C/delete.page
index 0f4d725..010d9d5 100644
--- a/help/C/delete.page
+++ b/help/C/delete.page
@@ -5,6 +5,8 @@
 
   <info>
     <link type="guide" xref="index#delete"/>
+    <revision pkgversion="3.8" date="2013-05-04" status="review"/>
+
 
     <credit type="author">
       <name>Pierre-Yves Luyten</name>
@@ -32,8 +34,8 @@
       options…</gui><gui style="menuitem">Delete this Note</gui></guiseq>.</p>
     </item>
     <item>
-      <p>In the <em>notes view</em>, enter the <em>selection mode</em>. Select
-      the notes that you want to delete, then press the
+      <p>In the <em>notes view</em>, go into the <em>selection mode</em>.
+      Select the notes that you want to delete, then press the
       <gui style="button">Trash</gui> button.</p>
     </item>
   </list>
diff --git a/help/C/formatting.page b/help/C/formatting.page
index c9629a5..07df741 100644
--- a/help/C/formatting.page
+++ b/help/C/formatting.page
@@ -18,22 +18,24 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Change the text style.</desc>
+    <desc>Apply different formatting options to the text.</desc>
   </info>
 
-  <title>Format the note</title>
+  <title>Change the text style</title>
 
   <p>You can format your note in <app>Bijiben</app>:</p>
 
   <list>
     <item>
-      <p>Select the text that you want to format and press on <gui>Bold</gui>,
-      <gui>Italic</gui> or <gui>Strike</gui>.
-      button.</p>
+      <p>Select the text that you want to format and press
+      <gui style="button">Bold</gui>, <gui style="button">Italic</gui> or
+      <gui style="button">Strike</gui>.</p>
     </item>
     <item>
-      <p>To create a list, select <gui>Bullets</gui> for an unordered list or
-      <gui>Numbered List</gui> for ordered list from the gear menu.</p>
+      <p>To create a list, select <guiseq><gui style="button">More
+      options…</gui><gui style="menuitem">Bullets</gui></guiseq> for an
+      unordered list or <guiseq><gui style="button">More
+      options…</gui><gui>Numbered List</gui></guiseq> for an ordered list.</p>
     </item>
   </list>
 
diff --git a/help/C/search.page b/help/C/search.page
index 940fcce..c059393 100644
--- a/help/C/search.page
+++ b/help/C/search.page
@@ -39,7 +39,7 @@
 
   <!-- TODO talk about sorting notes by colour -->
 
-  <p>You can also sort notes into
+  <p>You can also sort notes using <link xref="colors">colors</link> and
   <link xref="collections">collections</link>.</p>
 
 </page>
diff --git a/help/C/share.page b/help/C/share.page
index 9f5d13a..e2edf03 100644
--- a/help/C/share.page
+++ b/help/C/share.page
@@ -24,6 +24,6 @@
   <title>Share a note</title>
 
   <p>Open a note, then click on the <gui style="button">Share note</gui> button
-  to send it.</p>
+  to send it by email. Your default email client will start up.</p>
 
 </page>