Incremental fixes to clock-* pages

4 files changed, 33 insertions, 14 deletions

diff --git a/gnome-help/C/clock-calendar.page b/gnome-help/C/clock-calendar.page
index 02b2ce19..3b5bb558 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 eaa8f40b..e6a41026 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 48d92af1..2b256ac8 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 efe329af..fd17af5f 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>