[gnome-user-docs] Incremental fixes to clock-* pages

[Michael Hill <mdhill src gnome org>]

commit 59c6966962dd99f55f9b04bceec1d37df7208064
Author: Michael Hill <mdhill gnome org>
Date:   Wed Sep 30 16:19:41 2015 -0400

    Incremental fixes to clock-* pages

 gnome-help/C/clock-calendar.page |   13 ++++++++-----
 gnome-help/C/clock-set.page      |    7 ++++---
 gnome-help/C/clock-world.page    |   25 ++++++++++++++++++++-----
 gnome-help/C/clock.page          |    2 +-
 4 files changed, 33 insertions(+), 14 deletions(-)
---
diff --git a/gnome-help/C/clock-calendar.page b/gnome-help/C/clock-calendar.page
index 02b2ce1..3b5bb55 100644
--- a/gnome-help/C/clock-calendar.page
+++ b/gnome-help/C/clock-calendar.page
@@ -50,11 +50,14 @@
     <item>
       <p>Click the date for which you want to see your appointments from the
       calendar.</p>
-    </item>
-    <item>
-      <p>Existing appointments will be displayed on the right. As appointments
-      are added to the calendar, they will appear in the clock's appointment
-      list.</p>
+
+    <note>
+       <p>A small dot is shown under each date that has an appointment.</p>
+    </note>
+
+      <p>Existing appointments will be displayed to the left of the calendar.
+      As appointments are added to the calendar, they will appear in the
+      clock's appointment list.</p>
     </item>
   </steps>
 
diff --git a/gnome-help/C/clock-set.page b/gnome-help/C/clock-set.page
index eaa8f40..e6a4102 100644
--- a/gnome-help/C/clock-set.page
+++ b/gnome-help/C/clock-set.page
@@ -21,7 +21,8 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Click the clock on the top bar and go into the <gui>Date &amp; Time Settings</gui> to alter the 
date/time.</desc>
+    <desc>Use the <gui>Date &amp; Time Settings</gui> to alter the date or
+    time.</desc>
   </info>
 
 <title>Change the date and time</title>
@@ -31,8 +32,8 @@
 
   <steps>
     <item>
-      <p>Open the <gui xref="shell-introduction#activities">Activities</gui> overview and
-      start typing <gui>Date &amp; Time</gui>.</p>
+      <p>Open the <gui xref="shell-introduction#activities">Activities</gui>      
+      overview and start typing <gui>Date &amp; Time</gui>.</p>
     </item>
     <item>
       <p>Click on <gui>Date &amp; Time</gui> to open the control center.</p>
diff --git a/gnome-help/C/clock-world.page b/gnome-help/C/clock-world.page
index 48d92af..2b256ac 100644
--- a/gnome-help/C/clock-world.page
+++ b/gnome-help/C/clock-world.page
@@ -20,6 +20,8 @@
 
   <title>Add a world clock</title>
 
+  <p>Use <app>Clocks</app> to add times in other cities.</p>
+
   <note>
     <p>This requires the <app>Clocks</app> application to be installed.</p>
     <p>Most distributions come with <app>Clocks</app> installed by default.
@@ -27,14 +29,27 @@
     package manager.</p>
  </note>
 
-  <p>Use <app>Clocks</app> to add times in other cities.</p>
-
   <p>To add a world clock:</p>
 
   <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
+    <item>
+      <p>Click on the clock on the top bar.</p>
+    </item>
+    <item>
+      <p>Click the <gui>Add world clocks...</gui> link under the calendar to
+      launch <app>Clocks</app>.</p>
+
+    <note>
+       <p>If you already have one or more world clocks, click on one and
+       <app>Clocks</app> will launch.</p>
+    </note>
+
+    </item>
+    <item>
+      <p>Existing appointments will be displayed on the right. As appointments
+      are added to the calendar, they will appear in the clock's appointment
+      list.</p>
+    </item>
   </steps>
 
 </page>
diff --git a/gnome-help/C/clock.page b/gnome-help/C/clock.page
index efe329a..fd17af5 100644
--- a/gnome-help/C/clock.page
+++ b/gnome-help/C/clock.page
@@ -18,8 +18,8 @@
 
     <desc>
       <link xref="clock-set">Set date and time</link>,
-      <link xref="clock-timezone">timezone</link>,
       <link xref="clock-world">world clocks</link>,
+      <link xref="clock-timezone">timezone</link>,
       <link xref="clock-calendar">calendar and appointments</link>…
     </desc>
   </info>