Use orderedlist to describe the steps to add the applet to a panel

9 files changed, 294 insertions, 77 deletions

diff --git a/battstat/docs/C/index.docbook b/battstat/docs/C/index.docbook
index 675e632b..361d2bfa 100644
--- a/battstat/docs/C/index.docbook
+++ b/battstat/docs/C/index.docbook
@@ -231,13 +231,36 @@
 
     <sect2 id="battstat-introduction-add">
       <title>To Add &applet; to a Panel</title>
-      <para>To add <application>&applet;</application> to a panel,
-      right-click on the panel, then choose <guimenuitem>Add to
-      Panel</guimenuitem>.  Select <application>&applet;</application>
-      in the <application>Add to Panel</application> dialog, then
-      click <guibutton>Add</guibutton>.</para>
       <para>
-        The layout of the <application>&applet;</application> applet varies depending on the size and type of panel in which the applet resides.
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
+      <para>
+        The layout of the <application>&applet;</application> applet varies
+        depending on the size and type of panel in which the applet resides.
       </para>
     </sect2>
 
diff --git a/charpick/help/C/index.docbook b/charpick/help/C/index.docbook
index 84d2ff3a..cc21f701 100644
--- a/charpick/help/C/index.docbook
+++ b/charpick/help/C/index.docbook
@@ -226,14 +226,36 @@
        encoding so you can use the palette to display or copy any Unicode
        character.</para>
 
-       <sect2 id="charpick-introduction-add">       
-         <title>To Add &applet; to a Panel</title>
-	 <para>To add <application>&applet;</application> to a panel,
-	 right-click on the panel, then choose <guimenuitem>Add to
-	 Panel</guimenuitem>.  Select <application>&applet;</application>
-	 in the <application>Add to Panel</application> dialog, then
-	 click <guibutton>Add</guibutton>.</para>
-       </sect2> 
+    <sect2 id="charpick-introduction-add">
+      <title>To Add &applet; to a Panel</title>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
+    </sect2>
   </sect1>
 <!-- ================ Usage ================================ -->
   <sect1 id="charpick-usage"> 
diff --git a/cpufreq/help/C/index.docbook b/cpufreq/help/C/index.docbook
index 599a9a15..459cedd8 100644
--- a/cpufreq/help/C/index.docbook
+++ b/cpufreq/help/C/index.docbook
@@ -161,13 +161,36 @@
 	 </figure> 
     <!-- ==== End of Figure ======================================= -->
     <para>The <application>&applet;</application> provides a convenient way to monitor the CPU Frequency Scaling for each CPU.
-		</para> 
-	 <para>To add <application>&applet;</application> to a panel, right-click on the panel to open the panel popup menu, then choose 
-		<menuchoice> 
-		  <guimenu>Add to Panel</guimenu> 
-		  <guimenuitem>CPU Frequency Scaling Monitor</guimenuitem> 
-		</menuchoice>.</para> 
-	
+		</para>
+
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
+
     <note><para>
      Unfortunately, CPU frequency scaling can currently only be monitored on
      Linux machines that have support in the kernel. It can however, support the
diff --git a/drivemount/help/C/index.docbook b/drivemount/help/C/index.docbook
index f38b3585..26147262 100644
--- a/drivemount/help/C/index.docbook
+++ b/drivemount/help/C/index.docbook
@@ -6,7 +6,7 @@
   <!ENTITY manrevision "2.12">
   <!ENTITY date "July 2015">
   <!ENTITY app "<application>Disk Mounter</application>">
-  <!ENTITY appname "Disk Mounter">
+  <!ENTITY applet "Disk Mounter">
 ]>
 <!-- 
       (Do not remove this comment block.)
@@ -20,10 +20,11 @@
 <!-- please do not change the id; for translations, change lang to -->
 <!-- appropriate code -->
   <articleinfo> 
-    <title>&appname; Manual</title>
+    <title>&applet; Manual</title>
     <abstract role="description">
-      <para>&appname; enables you to quickly mount or unmount various 
-        types of drives and file systems from a panel.</para>
+      <para>The &applet; applet enables you to quickly mount or unmount
+        various types of drives and file systems from a panel.
+      </para>
     </abstract>
     <copyright>
       <year>2015</year>
@@ -121,7 +122,7 @@
 
     <revhistory>
       <revision> 
-	<revnumber>&appname; Applet Manual V&manrevision;</revnumber>
+	<revnumber>&applet; Applet Manual V&manrevision;</revnumber>
 	<date>&date;</date> 
 	<revdescription> 
           <para role="author">MATE Documentation Team</para>
@@ -129,7 +130,7 @@
 	</revdescription> 
       </revision> 
       <revision> 
-	<revnumber>&appname; Applet Manual V2.11</revnumber>
+	<revnumber>&applet; Applet Manual V2.11</revnumber>
 	<date>&date;</date>
 	<revdescription>
           <para role="author">Trent Lloyd</para>
@@ -137,7 +138,7 @@
 	</revdescription>
       </revision>
       <revision>
-	<revnumber>&appname; Applet Manual V2.10</revnumber>
+	<revnumber>&applet; Applet Manual V2.10</revnumber>
 	<date>February 2004</date> 
 	<revdescription> 
           <para role="author">Sun GNOME Documentation Team</para>
@@ -166,7 +167,7 @@
       </revision> 
     </revhistory> 
 
-    <releaseinfo>This manual describes version &appversion; of &appname;.
+    <releaseinfo>This manual describes version &appversion; of &applet;.
     </releaseinfo>
     <legalnotice>
       <title>Feedback</title>
@@ -188,14 +189,14 @@
     <title>Introduction</title>
 
     <figure id="drivemountapplet-fig"> 
-      <title>&appname;</title> 
+      <title>&applet;</title>
       <screenshot> 
         <mediaobject> 
           <imageobject><imagedata
             fileref="figures/drivemount-applet_example.png" format="PNG"/> 
           </imageobject>
           <textobject> 
-            <phrase>The &appname;.</phrase> 
+            <phrase>The &applet; applet.</phrase>
           </textobject> 
         </mediaobject> 
       </screenshot> 
@@ -209,11 +210,34 @@
     </para>
 
     <sect2 id="drivemount-intro-add">
-     <title>To Add &appname; to a Panel</title>
-     <para>To add &app; to a panel, right-click on the panel, then choose
-     <guimenuitem>Add to Panel</guimenuitem>.  Select &app; in the
-     <application>Add to Panel</application> dialog, then click
-     <guibutton>Add</guibutton>.</para>
+      <title>To Add &applet; to a Panel</title>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
     </sect2>
  
     <sect2 id="drivemount-intro-mount">
diff --git a/geyes/docs/C/index.docbook b/geyes/docs/C/index.docbook
index 92d5bbda..900249ea 100644
--- a/geyes/docs/C/index.docbook
+++ b/geyes/docs/C/index.docbook
@@ -210,9 +210,9 @@
 
 <!-- ============= Document Body ============================= -->
 <!-- ============= Introduction ============================== -->
-<sect1 id="geyes-introduction">
-<title>Introduction</title>
-<!-- ==== Figure ============================================= -->
+  <sect1 id="geyes-introduction">
+    <title>Introduction</title>
+    <!-- ==== Figure ============================================= -->
 	 <figure id="geyes-fig"> 
 		<title>&applet; Applet</title> 
 		<screenshot> 
@@ -226,16 +226,46 @@
 		</screenshot> 
 	 </figure> 
     <!-- ==== End of Figure ======================================= -->
-<para>The <application>&applet;</application> applet provides an entertaining
-way to track the movement of the mouse pointer around your screen. The applet
-is an image of one or more eyes that follow the mouse pointer around the
-screen.</para>
-<para>To add <application>&applet;</application> to a panel,
-right-click on the panel, then choose <guimenuitem>Add to
-Panel</guimenuitem>.  Select <application>&applet;</application>
-in the <application>Add to Panel</application> dialog, then
-click <guibutton>Add</guibutton>.</para>
-</sect1>
+    <para>The <application>&applet;</application> applet provides an entertaining
+    way to track the movement of the mouse pointer around your screen. The applet
+    is an image of one or more eyes that follow the mouse pointer around the
+    screen.</para>
+
+    <sect2 id="battstat-introduction-add">
+      <title>To Add &applet; to a Panel</title>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
+      <para>
+        The layout of the <application>&applet;</application> applet varies
+        depending on the size and type of panel in which the applet resides.
+      </para>
+    </sect2>
+  </sect1>
 <!-- ============= Preferences  ================================ -->
 <sect1 id="geyes-settings">
 <title>Preferences</title>
diff --git a/mateweather/docs/C/index.docbook b/mateweather/docs/C/index.docbook
index 1f997bbd..dffb56d3 100644
--- a/mateweather/docs/C/index.docbook
+++ b/mateweather/docs/C/index.docbook
@@ -399,11 +399,33 @@ customizable.</para>
 
     <sect2 id="mateweather-introduction-add">
       <title>To Add &applet; to a Panel</title>
-      <para>To add <application>&applet;</application> to a panel,
-      right-click on the panel, then choose <guimenuitem>Add to
-      Panel</guimenuitem>.  Select <application>&applet;</application>
-      in the <application>Add to Panel</application> dialog, then
-      click <guibutton>Add</guibutton>.</para>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
     </sect2>
 
       
diff --git a/multiload/docs/C/index.docbook b/multiload/docs/C/index.docbook
index 813e66da..273724e1 100644
--- a/multiload/docs/C/index.docbook
+++ b/multiload/docs/C/index.docbook
@@ -237,18 +237,40 @@
 	<listitem><para>Disk load</para></listitem>
       </itemizedlist>
 
-      <sect2 id="multiload-introduction-add">
-        <title>To Add &applet; to a Panel</title>
-	<para>To add <application>&applet;</application> to a panel,
-	right-click on the panel, then choose <guimenuitem>Add to
-	Panel</guimenuitem>.  Select <application>&applet;</application>
-	in the <application>Add to Panel</application> dialog, then
-	click <guibutton>Add</guibutton>.</para>
-        <para>
-          The layout of the <application>&applet;</application> varies
-          depending on the size and type of panel in which the applet resides.
-        </para>
-      </sect2>
+    <sect2 id="multiload-introduction-add">
+      <title>To Add &applet; to a Panel</title>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
+      <para>
+        The layout of the <application>&applet;</application> varies
+        depending on the size and type of panel in which the applet resides.
+      </para>
+    </sect2>
 
   </sect1>
 
diff --git a/netspeed/help/C/index.docbook b/netspeed/help/C/index.docbook
index 62c34d69..ac4f6145 100644
--- a/netspeed/help/C/index.docbook
+++ b/netspeed/help/C/index.docbook
@@ -257,12 +257,34 @@ of the network device.
       </informaltable>
     </sect2>
     <sect2>
-      <title>To Add Netspeed to a Panel</title>
-      <para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose  <menuchoice>
-	  <guimenu>Add to Panel</guimenu>
-	  <guisubmenu>Network</guisubmenu>
-	  <guimenuitem>&applet;</guimenuitem>
-	</menuchoice>.</para>
+      <title>To Add &applet; to a Panel</title>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
     </sect2>
   </sect1>
   <sect1 id="netspeed_applet-settings"> 
diff --git a/stickynotes/docs/C/index.docbook b/stickynotes/docs/C/index.docbook
index cbb03002..7a52c2dc 100644
--- a/stickynotes/docs/C/index.docbook
+++ b/stickynotes/docs/C/index.docbook
@@ -219,11 +219,40 @@ Template last modified Mar 12, 2002
   notes are saved and reopened in the same position with the same
   dimensions and style.</para>
 
-  <para>To add <application>&applet;</application> to a panel,
-  right-click on the panel, then choose <guimenuitem>Add to
-  Panel</guimenuitem>.  Select <application>&applet;</application>
-  in the <application>Add to Panel</application> dialog, then
-  click <guibutton>Add</guibutton>.</para>
+    <sect2 id="stickynotes-introduction-add">
+      <title>To Add &applet; to a Panel</title>
+      <para>
+        To add <application>&applet;</application> to a panel, perform the
+        following steps:
+      </para>
+      <orderedlist>
+        <listitem>
+          <para>
+            Right-click on the panel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Choose <guimenuitem>Add to Panel</guimenuitem>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Scroll down the list of items in the <guilabel>Add to Panel</guilabel>
+            dialog, then select <guilabel>&applet;</guilabel>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Click <guibutton>Add</guibutton>.
+          </para>
+        </listitem>
+      </orderedlist>
+      <para>
+        The layout of the <application>&applet;</application> applet varies
+        depending on the size and type of panel in which the applet resides.
+      </para>
+    </sect2>
 </sect1>
     
 <sect1 id="stickynotes-usage">