Put in lots of orderedlists...more SGML, less for the user to read.

2001-07-03  Kevin Breit  <battery841@mediaone.net>

	* C/usage-mail.sgml: Put in lots of orderedlists...more SGML, less
	for the user to read.  They'll thank me in droves later.

svn path=/trunk/; revision=10764

1 files changed, 147 insertions, 54 deletions

diff --git a/doc/C/usage-exec-summary.sgml b/doc/C/usage-exec-summary.sgml
index 77f84e8230..cccf6c409f 100644
--- a/doc/C/usage-exec-summary.sgml
+++ b/doc/C/usage-exec-summary.sgml
@@ -3,8 +3,8 @@
     <para>
        My Evolution is designed to show you a
        summary of important information: the appointments for a given
-       day, important email, and so forth. To see your My Evolution. 
-       , click on the <guibutton>My Evolution</guibutton>
+       day, important email, and so forth. To see your My Evolution, 
+       click on the <guibutton>My Evolution</guibutton>
        button in the shortcut bar, or select the
        <guilabel>My Evolution</guilabel> folder in the folder
        bar.
@@ -14,40 +14,24 @@
       <title>Introducing My Evolution</title>
       <para>
         The first thing you'll want to do with My Evolution
-        is add a service. Click the <guibutton>Add Service</guibutton>
-        button in the toolbar, then select one of the available
-        services.  Services may vary depending upon your system, but
-        most installations will have at least the following options:
+        is add a service. Go to
+      <menuchoice>
+	<guimenu>Tools</guimenu>
+	<guimenuitem>My Evolution Settings</guimenuitem>
+      </menuchoice>
+      then select one of the available
+      services.  Services may vary depending upon your system, but
+      most installations will have at least the following options:
+      <variablelist>
 
-        <variablelist>
-
-          <varlistentry>
-             <term>Calendar</term>
-             <listitem>
-               <para>
-                  Pending appointments and other events for that day.
-               </para>
-             </listitem>
-           </varlistentry>
-
-          <varlistentry>
-             <term>Inbox</term>
-             <listitem>
-               <para>
-                 Information about your mail, such as the number of
-                 new messages you have waiting.
-               </para>
-             </listitem>
-           </varlistentry>
-
-          <varlistentry>
-             <term>To Do</term>
-             <listitem>
-               <para>
-                 A short summary of your task pad.
-               </para>
-             </listitem>
-           </varlistentry>
+	<varlistentry>
+	  <term>Mail</term>
+	  <listitem>
+	    <para>
+	      Display amount of unread email in your selected folders.
+	    </para>
+	  </listitem>
+	</varlistentry>
 
           <varlistentry>
              <term>RDF Summary</term>
@@ -61,27 +45,136 @@
              </listitem>
            </varlistentry>
 
-        </variablelist>
-
-     </para>
+	<varlistentry>
+	  <term>Weather</term>
+	  <listitem>
+	    <para>
+	      Shows you the current weather for the cities of your choice.
+	    </para>
+	  </listitem>
+	</varlistentry>
 
-     <para>
-       Each service appears in a small box on the screen; you can
-       remove the service by clicking the <guibutton>x</guibutton>
-       button in the upper right, or bring up a settings dialog by
-       clicking the little wrench icon below that.
-     </para>
-   </sect1>
-<!-- 
-   <sect1 id="exec-services-detail">
-     <title>Services in Detail</title>
+	<varlistentry>
+	  <term>Schedule</term>
+	  <listitem>
+	    <para>
+	      Lets you see the events for the day.
+	    </para>
+	  </listitem>
+	</varlistentry>
+      </variablelist>
+    </para>
+    <para>
+      <application>Evolution</application> comes with ... enabled by
+      default.
+    </para>
+    <sect2 id="new-components">
+      <title>Adding New Components</title>
+      <para>
+	To add a new service:
+	<orderedlist numeration="arabic">
+	  <listitem>
+	    <para>
+	      Choose
+	      <menuchoice>
+		<guimenu>Tools</guimenu>
+		<guimenuitem>My Evolution Settings</guimenuitem>
+	      </menuchoice>
+	      from the menubar.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Select the service you wish to add by clicking on the respective
+	      tab.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Choose <guibutton>OK</guibutton> when finished configuring the
+	      item.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+    </sect2>
+    <sect2 id="delete-components">
+      <title>Deleting Components</title>
+      <para>
+	Of course, there are possibly some components which you'd prefer not too
+	view in your My Evolution.
+	To remove a component:
+	<orderedlist numeration="arabic">
+	  <listitem>
+	    <para>
+	      Choose
+	      <menuchoice>
+		<guimenu>Tools</guimenu>
+		<guimenuitem>My Evolution Settings</guimenuitem>
+	      </menuchoice>
+	      from the menubar.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click the <guilabel>Enable</guilabel> button in the component you
+	      would like to disable.
+	      <!-- This is incorrect.  I am going to ask Iain if he could throw
+	      in an Enable button -->
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+    </sect2>
+    <sect2 id="modifying-components">
+      <title>Modifying Components</title>
       <para>
-          This section will show you how to use several
-          <application>Evolution</application> services, once they
-          become available.  Wait for updates.  FIXME
+	Chances are, the components that you setup aren't going to be setup for
+	your needs.  For instance, you may choose that you want to use different
+	city choices than the default settings.
+	<application>Evolution</application> lets you configure all the
+	components in My Evolution.
       </para>
-     
-    </sect1>
--->
+      <sect3 id="modifying-components-mail">
+	<title>Modifying Mail</title>
+	<para>
+	  To modify mail:
+	  <orderedlist numeration="arabic">
+	    <listitem>
+	      <para>
+		Choose
+		<menuchoice>
+		  <guimenu>Tools</guimenu>
+		  <guimenuitem>My Evolution Settings</guimenuitem>
+		</menuchoice>
+		from the menubar.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Click the <guilabel>Mail</guilabel> tab at the top of the
+		window.
+	      </para>
+	    </listitem>
+	  </orderedlist>
+	</para>
+	<para>
+	  The <guilabel>Mail</guilabel> service window is broken up into two
+	  sections.  The left section is where your mail folders are listed.
+	  The right section shows which folders are displayed.
+	</para>
+	<para>
+	  To add a folder to be displayed, click on a folder in the
+	  <guilabel>All folders</guilabel> section and click the
+	  <guibutton>Add</guibutton> button.
+	</para>
+	<para>
+	  To remove a folder from the service, click on the folder in the
+	  <guilabel>Display folders</guilabel> section and click the
+	  <guibutton>Remove</guibutton> button.
+	</para>
+      </sect3>
+    </sect2>
+  </sect1>
 </chapter>