Added regular expressions to glossary. Explanation should be removed from

2000-08-31  Aaron Weber  <aaron@helixcode.com>

	* C/apx-gloss.sgml: Added regular expressions to glossary.
	Explanation should be removed from other portions of the book now.

	* C/usage-mainwindow.sgml: Revisions, minor.

	* C/apx-menuref.sgml: Now named menuref.sgml, to reflect its new
	status as a part.

	* C/evolution-guide.sgml: Structural alterations: Menuref is now a
	part, not an appendix.

	* C/apx-menuref.sgml: Added contextual menus for mail.

svn path=/trunk/; revision=5140

1 files changed, 1196 insertions, 0 deletions

diff --git a/help/C/menuref.sgml b/help/C/menuref.sgml
new file mode 100644
index 0000000000..b4ae8d4f83
--- /dev/null
+++ b/help/C/menuref.sgml
@@ -0,0 +1,1196 @@
+<!--
+<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
+-->
+
+<chapter id="menuref">
+  <title>Menu Reference</title>
+  <para>
+    This section will serve as a reference for every capability that
+    <application>Evolution</application> has.  When menu items are
+    repeated in <application>Evolution</application>, they're repeated
+    here too.
+  </para>
+  <para>
+    From left to right, the menus available to you when you are
+    reading mail are: <guimenu>File</guimenu>,
+    <guimenu>Edit</guimenu>, <guimenu>View</guimenu>,
+    <guimenu>Tools</guimenu>, <guimenu>Actions</guimenu>, and
+    <guimenu>Help</guimenu>.  The last of these doesn't change, but
+    the rest of them have contents that will change depending on
+    whether you're looking at mail, contacts, or calendar information.
+    In addition, the editor tools for messages, appointments, and
+    contacts all have menu bars.
+
+  </para>
+  <sect1 id="menuref-universal">
+    <title>Menus that are the same everywhere</title>
+    <para>
+      The <guimenu>File</guimenu> and <guimenu>Help</guimenu> menus in
+      the main <application>Evolution</application> window do not
+      change, because they refer to universal items.  Other menus have
+      contents that change depending on context.
+    </para>
+   
+ <sect2 id="menuref-universal-file">
+      <title>File Menu</title>
+      <para>
+	<variablelist>
+
+	  <varlistentry>
+	    <term><guisubmenu>New...</guisubmenu> Submenu</term>
+	    <listitem><para>
+		<itemizedlist>
+		  <listitem><para>
+		      <guimenuitem>Folder</guimenuitem> &mdash;
+		       Create a new folder. See <xref 
+		       linkend="usage-mainwindow-folderbar">
+		       for more information about folders.
+		    </para></listitem>
+		  <listitem><para>
+		      <guimenuitem>Shortcut</guimenuitem> &mdash;
+		       Create a new Shortcut in the Shortcut Bar.
+		    </para></listitem>
+		  <listitem><para>
+		      <guimenuitem>Mail Message</guimenuitem> &mdash;
+		       Compose a new mail message. Covered in
+		       <xref linkend="usage-mail-getnsend-send">.
+		    </para></listitem>
+		  <listitem><para>
+		      <guimenuitem>Appointment</guimenuitem> &mdash;
+		       Enter a new appointment in your calendar. See <xref
+			linkend="usage-calendar-apts-basic"> for more information.
+		    </para></listitem>
+		  <listitem><para>
+		      <guimenuitem>Task</guimenuitem> &mdash;
+		       Enter a new to-do item in your taskpad. Covered in 
+		       <xref linkend="usage-calendar-todo">.
+		    </para></listitem>
+		</itemizedlist>
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Go to Folder</guimenuitem></term>
+	    <listitem><para>
+               View the items in a particular folder.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Create New Folder</guimenuitem></term>
+	    <listitem><para>
+		 This item doesn't belong here any more.
+	      </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Print Message</guimenuitem></term>
+	    <listitem><para>
+		 Print the current message.
+	      </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Exit</guimenuitem></term>
+	    <listitem><para>
+		 Quit using <application>Evolution</application>.
+	      </para></listitem>
+	  </varlistentry>
+	</variablelist>
+       </para>
+    </sect2>
+
+    <sect2 id="menuref-universal-help">
+      <title>The Help Menu</title>
+      <para>
+      <variablelist>
+	<varlistentry>
+	  <term><guimenuitem>Help Index</guimenuitem></term>
+	  <listitem><para>
+             Displays the table of contents for this document.
+           </para></listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guimenuitem>Getting Started</guimenuitem></term>
+	  <listitem><para>
+              A quick look around, and a summary of the things
+              <application>Evolution</application> can do for you.
+           </para></listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guimenuitem>Using the Mailer</guimenuitem></term>
+	  <listitem><para>
+              An in-depth tour of <application>Evolution</application> Mail.
+           </para></listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guimenuitem>Using the Calendar</guimenuitem></term>
+	  <listitem><para>
+             A step-by-step guide to using the Calendar.
+           </para></listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guimenuitem>Using the Contact Manager</guimenuitem></term>
+	  <listitem><para>
+            Find your way around the Contact Manager.
+           </para></listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guimenuitem>Submit Bug Report</guimenuitem></term>
+	  <listitem><para>
+             If you don't report them, they can't fix them.  Select this item to let the 
+             developers know what's wrong.
+           </para></listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term><guimenuitem>About Evolution</guimenuitem></term>
+	  <listitem><para>
+              Displays a window with information about the application and its authors.
+              This has the same information as <xref linkend="authors">.
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+       </para>
+    </sect2>
+  </sect1>
+
+
+  <sect1 id="menuref-mail">
+    <title>Mail Menus</title>
+    <para>
+       All the menus for mail. FIXME: this paragraph needs content.
+    </para>
+   
+    <sect2 id="menuref-mail-edit">
+      <title>The Edit Menu</title>
+      <para>
+        This menu is currently empty.
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-mail-view">
+      <title>The View Menu</title>
+      <para>
+        This menu lets you control the way
+        <application>Evolution</application> displays your information
+        for you.
+        <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Show Shortcut Bar</guimenuitem></term>
+	    <listitem><para>
+              Toggle the shortcut bar on and off with this item.             
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Show Folder Bar</guimenuitem></term>
+	    <listitem><para>
+             Toggle the folder bar on and off with this item. 
+             See <xref linkend="usage-mainwindow-folderbar"> for 
+             more information about the folder bar.             
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Threaded Message List</guimenuitem></term>
+	    <listitem><para>
+               This item controls whether your message list is displayed by thread 
+               or by other criteria.  The default order is by date; see
+               <xref linkend="usage-mail-listorder"> for information about the
+               order of the message list.
+            </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-mail-tools">
+      <title>The Tools Menu</title>
+      <para>
+      <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Mail Filters</guimenuitem></term>
+	    <listitem><para>
+             Edit your mail filters here.  
+             See <xref linkend="usage-mail-organize-filters">
+             for more information about mail filtering.
+           </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>vFolder Editor</guimenuitem></term>
+	    <listitem><para>
+              Create, edit, and delete vFolders with this tool. 
+              To learn about using vFolders with mail, see 
+              <xref linkend="usage-mail-organize-vfolders">.
+           </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Mail Configuration</guimenuitem></term>
+	    <listitem><para>
+             This is a poorly named tool.  You can set your identity, 
+             and everything else related to your mail account, here.
+           </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Forget Passwords</guimenuitem></term>
+	    <listitem><para>
+             Although it's really an Action (FIXME), this item will cause 
+             <application>Evolution</application> to forget what your
+             password is.
+           </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Configure Folder</guimenuitem></term>
+	    <listitem><para>
+              Another FIXME item, this allows you to set the file format
+              in which <application>Evolution</application> stores mail.
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+       </para>
+    </sect2>
+
+    <sect2 id="menuref-mail-actions">
+      <title>The Actions Menu</title>
+      <para>
+          When you select one of the actions from this menu,
+          <application>Evolution</application> will do your bidding,
+          usually to the item you have selected.
+      </para>
+      <para>
+          The actions you can perform are:
+          <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Edit Message</guimenuitem></term>
+	    <listitem><para>
+	      Select a message in the drafts folder before you select this 
+	      item.  You can only edit a message you have written. FIXME: POOR
+	      description of BROKEN behavior. 
+	   </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>View Message</guimenuitem></term>
+	    <listitem><para>
+	       Displays the selected message in a new window.
+	   </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Mark all Messages Read</guimenuitem></term>
+	    <listitem><para>
+	      <application>Evolution</application> keeps track of which messages 
+	      you've seen;  When you don't need to read all those messages, select this item.
+	      You can mark a single message as read by right-clicking it in the message bar.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Expunge</guimenuitem></term>
+	    <listitem><para>
+                   Emtpies the trash folder, erasing messages permanently. 
+                   Once you've done this, don't come crying to me if you
+                   want a message back.
+	       </para></listitem>
+	  </varlistentry>
+	</variablelist>
+       </para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="menuref-mail-editor">
+    <title>The Message Composer Menus</title>
+    <para>
+      The message composition window has its own set of menus:
+      <guimenu>File</guimenu>, which controls operations on files and
+      data, <guimenu>Edit</guimenu>, for text editing,
+      <guimenu>Format</guimenu>, which controls the file format of
+      messages you send, <guimenu>View</guimenu>, to set how you view
+      the message, and <guimenu>Insert</guimenu>, which holds tools
+      for embedding files and other items in messages.  Here's what's in them:
+    </para>
+    <sect2 id="menuref-mail-editor-file">
+      <title>The Message Composer's File Menu</title>
+      <para>
+        <variablelist>
+	  <varlistentry>
+	      <term><guimenu>Open</guimenu></term>
+	      <listitem><para>
+		 Open a text file or a draft mail message.
+	      </para></listitem>
+	    </varlistentry>
+
+	    <varlistentry>
+	      <term><guimenu>Save</guimenu></term>
+	      <listitem><para>
+		 Save a mail message as a text file.
+	      </para></listitem>
+	    </varlistentry>
+
+	    <varlistentry>
+	      <term><guimenu>Save As</guimenu></term>
+	      <listitem><para> 
+		Choose a file name and location for
+		a message you want to save as a text file.
+	      </para></listitem>
+	    </varlistentry>
+
+	    <varlistentry>
+	      <term><guimenu>Save in Folder</guimenu></term>
+	      <listitem><para>
+		 Save a message as a draft, rather than 
+		 as a seperate text file. (FIXME: should be removed, and 
+		 functionality subsumed under "Save As").
+	      </para></listitem>
+	    </varlistentry>
+
+	    <varlistentry>
+	      <term><guimenu>Insert Text File</guimenu></term>
+	      <listitem><para>
+		   Open a text file and insert it into 
+		   the current message. (FIXME: belongs under "Insert").
+	      </para></listitem>
+	    </varlistentry>
+	  
+	    <varlistentry>
+	      <term><guimenu>Send</guimenu></term>
+	      <listitem><para>
+		  Sends the message immediately.
+	      </para></listitem>
+	    </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenu>Close</guimenu></term>
+	    <listitem><para>
+		 Closes the message composer.  If you have not done so, 
+		 <application>Evolution</application>
+		 will ask you if you want to save your message.
+	      </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+    <sect2 id="menuref-mail-editor-edit">
+      <title>The Message Composer's Edit Menu</title>
+      <para>
+          The <guimenu>Edit</guimenu> menu in the message composer
+          contains the following items.  Keyboard shortcuts are listed
+          next to the items in the menus themselves.
+
+        <variablelist>
+
+	  <varlistentry>
+	    <term><guimenuitem>Undo</guimenuitem></term>
+	    <listitem><para>
+                Undoes the last action you performed.
+	    </para></listitem>
+	  </varlistentry>
+
+    	  <varlistentry>
+	    <term><guimenuitem>Redo</guimenuitem></term>
+	    <listitem><para>
+               If you change your mind about Undoing something, 
+               you can always use this item.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Cut</guimenuitem></term>
+	    <listitem><para>
+                Removes the selected text from the text entry window and 
+                retains it in the system "clipboard" memory, ready for pasting.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Copy</guimenuitem></term>
+	    <listitem><para>
+              Copies selected text to the system clipboard without deleting it.
+              The text can then be inserted elsewhere with the 
+              <guimenuitem>Paste</guimenuitem> command.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Paste</guimenuitem></term>
+	    <listitem><para>
+                Inserts the contents of the system clipboard at the 
+                location of the cursor.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Find</guimenuitem></term>
+	    <listitem><para>
+               Enter a phrase and find your match in your message body.
+               As with <guimenuitem>Find Regex</guimenuitem>, 
+               <guimenuitem>Find Again</guimenuitem>, and
+               <guimenuitem>Replace</guimenuitem>, <application>Evolution</application>
+                will offer you the option to search forwards or backwards, and.
+
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Find Regex</guimenuitem></term>
+	    <listitem><para>
+               If you are familiar with regular expressions, often called 
+               "regexes," you can search for something more complicated, 
+               using wildcards and boolean logic. If you're not familiar with 
+               them, there are numerous resources for you on the web.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Find Again</guimenuitem></term>
+	    <listitem><para>
+              Repeats your last search.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Replace</guimenuitem></term>
+	    <listitem><para>
+               Enter a word or phrase and the word or phrase with which you'd like
+               to replace it.  
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Properties</guimenuitem></term>
+	    <listitem><para>
+               This item brings up the Message Composer Properties Capplet, 
+               a portion of the GNOME Control Center that determines the 
+               key bindings for the message composer.  Help for this capplet is 
+               available directly from the Control Center.
+               (FIXME: Write that help doc too) (FIXME: this is in the wrong place!)
+	    </para></listitem>
+	  </varlistentry>
+
+	</variablelist>
+      </para>
+    </sect2>
+    <sect2 id="menuref-mail-composer-format">
+      <title>The Message Composer's Format Menu</title>
+      <para> 
+        The <guimenu>Format</guimenu> menu has only one item:
+        <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>HTML</guimenuitem></term>
+	    <listitem><para>
+                 Toggles HTML mode for the message composer.  When selected, 
+                 the message is displayed and sent in HTML.  If you have written a 
+                 message in HTML and turn HTML off, most formatting will be lost.
+                 <application>Evolution</application> will attempt to preserve spacing
+                 and to remove formatting gracefully, however.
+	    </para></listitem>
+	  </varlistentry>
+	</variablelist>
+       </para>
+    </sect2>
+    <sect2 id="menuref-mail-composer-view">
+      <title>The Message Composer's View Menu</title>
+      <para>
+        The <guimenu>View</guimenu> menu controls the way messages are
+        displayed, and how much of the message, its headers, and
+        attachments appear.  It contains:
+        <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Show Attachments</guimenuitem></term>
+	    <listitem><para> 
+              Toggles the display of attachments.  When this item is selected,
+              <application>Evolution</application> will create a seperate pane
+              of the composition window to show what attachments you are appending
+              to the message. 
+	    </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+    <sect2 id="menuref-mail-composer-insert">
+      <title>The Message Composer's Insert Menu</title>
+      <para>
+        The <guimenu>Insert</guimenu> menu holds tools that allow you
+        to include images, horizontal rules, and other objects
+        in the body of your message. The tools are:
+        <variablelist>
+
+	  <varlistentry>
+	    <term><guimenuitem>Image</guimenuitem></term>
+	    <listitem><para> 
+               This tool will prompt you to select an image file to 
+               insert into your HTML message.  For text messages, this
+               is the same as attaching an image file.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Link</guimenuitem></term>
+	    <listitem><para> 
+               Opens the <interface>link creation window</interface>, 
+               which lets you specify the URL and text description
+               for a link in your message.  This only works with HTML 
+               messages.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Rule</guimenuitem></term>
+	    <listitem><para>    
+             Opens the<interface> horizontal rule creation dialog</interface>, which lets you
+	     create an HTML horizontal rule.  For more information,
+	     see <xref linkend="usage-mail-getnsend-send-html">.
+             This tool only works with HTML messages.
+	     </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Text File</guimenuitem></term>
+	    <listitem><para>
+	       Open a text file and insert it into the current message.
+               This tool works with both plain text and HTML messages.
+	      </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+  </sect1>
+  <sect1 id="menuref-mail-context">
+    <title>Contextual Menus in Evolution Mail</title>
+    <para>
+      The following menus appear when you right-click on something:
+    </para>
+
+    <sect2 id="menuref-mail-context-message">
+      <title>Right-click menu for messages in the message list</title>
+      <para>
+        <variablelist>
+
+	  <varlistentry>
+	    <term><guimenuitem>Open in New Window</guimenuitem></term>
+	    <listitem><para>
+	       Open a new window to read this message.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Edit this Message</guimenuitem></term>
+	    <listitem><para>
+              Available only for messages you have
+	      written and saved to the <guilabel>Drafts</guilabel>
+              or <guilabel>Outbox</guilabel> folders, this opens the
+              message in a message composition window, so you can alter it.
+	    </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Print</guimenuitem></term>
+	    <listitem><para>
+	       Opens the Print Preview window in preparation
+               for printing the message.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Reply to Sender</guimenuitem></term>
+	    <listitem><para>
+	       Opens a message composition window addressed to the
+               author of the  message.  Covered in detail in 
+               <xref linkend="usage-mail-getnsend-send-reply">.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Reply to All</guimenuitem></term>
+	    <listitem><para>
+	        Opens a message composition window addressed to the
+                author of the  message and all known recipients.
+                Covered in detail in <xref linkend="usage-mail-getnsend-send-reply">.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Forward</guimenuitem></term>
+	    <listitem><para>
+	       Appends the body of the selected message to a new message.
+               Covered in detail in  <xref linkend="usage-mail-getnsend-fwd">.               
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Delete Message</guimenuitem></term>
+	    <listitem><para>
+	       Marks a message for deletion.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Move Message</guimenuitem></term>
+	    <listitem><para>
+	       Choose a folder in which to place this message.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>VFolder on Subject</guimenuitem></term>
+	    <listitem><para>
+	       This item, and the three that follow it, will create vFolders 
+               which you may customize further or save as-is. This one will
+               create a vFolder which will display all messages that contain the 
+               subject line of the selected message.                
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>VFolder on Sender</guimenuitem></term>
+	    <listitem><para>
+	       Creates a vFolder to hold all messages from the sender of
+               the selected message.
+	      </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>VFolder on Recipients</guimenuitem></term>
+	    <listitem><para>
+	       Creates a VFolder to hold all messages addressed to the 
+               recipient of the selected message.
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Filter on Subject</guimenuitem></term>
+	    <listitem><para>
+	       This item, and the three that follow it, will create Filters 
+               for which you must select actions.  You may keep the criteria as 
+               they are, or alter them as you wish. This one will
+               create a filter which will affect all messages that contain the 
+               subject line of the selected message.                
+	      </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Filter on Sender</guimenuitem></term>
+	    <listitem><para>
+	       Creates a Filter which affects all messages from the sender of
+               the selected message.
+	      </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Filter on Recipients</guimenuitem></term>
+	    <listitem><para>
+	       Creates a filter which will affect all messages addressed to the 
+               recipient of the selected message.
+	      </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+  </sect1>
+  
+  <sect1 id="menuref-cal">
+    <title>The Calendar Menus</title>
+    <para>
+      The Main window of the calendar has the same menus as the main
+      window of the mail client.  However, their contents vary in a
+      number of ways.
+    </para>
+    <sect2 id="menuref-cal-edit">
+      <title>The Calendar Edit Menu</title>
+      <para>
+         The contents of the Edit menu are currently so borked that I
+         refuse to document them right now. (That means FIXME). They
+         should be:
+
+         <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Item</guimenuitem></term>
+	    <listitem><para>
+              Description
+           </para></listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term><guimenuitem>Item</guimenuitem></term>
+	    <listitem><para>
+              Description
+           </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	  <term><guimenuitem>Item</guimenuitem></term>
+	  <listitem><para>
+              Description
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+    <sect2 id="menuref-cal-view">
+      <title>The Calendar View Menu</title>
+      <para>
+        The Calendar's <guimenu>View</guimenu> menu contains the following items:
+
+         <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Show Shortcut Bar</guimenuitem></term>
+	    <listitem><para>
+              Toggle the Shortcut Bar on and off with this item.              
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Show Folder Bar</guimenuitem></term>
+	    <listitem><para>
+             Toggle the folder bar on and off with this item. 
+             See <xref linkend="usage-mainwindow-folderbar"> for 
+             more information about the folder bar.     
+           </para></listitem>
+	  </varlistentry>
+		  
+	  <varlistentry>
+	  <term><guimenuitem>View By Day</guimenuitem></term>
+	  <listitem><para>
+             Switch to the day view for your calendar.
+           </para></listitem>
+	  </varlistentry>	  
+
+	  <varlistentry>
+	  <term><guimenuitem>View Five Days</guimenuitem></term>
+	  <listitem><para>
+             View five calendar days at once. 
+           </para></listitem>
+	  </varlistentry>	  
+
+	  <varlistentry>
+	  <term><guimenuitem>View by Week</guimenuitem></term>
+	  <listitem><para>
+             Switch the calendar view to full week mode.
+           </para></listitem>
+	  </varlistentry>
+  
+	  <varlistentry>
+	  <term><guimenuitem>View By Month</guimenuitem></term>
+	  <listitem><para>
+             Look at a month at a time.
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-tools">
+      <title>The Calendar Tools Menu</title>
+      <para>
+         This menu is empty.
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-actions">
+      <title>The Calendar Actions Menu</title>
+      <para>
+         This menu is empty.
+      </para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="menuref-cal-editor">
+    <title>The Appointment Editor Menus</title>
+    <para>
+    FIXME: Insert Content Here.
+    </para>
+    
+    <sect2 id="menuref-cal-editor-file">
+      <title>The Appintment Editor's File Menu</title>
+      <para>
+         This menu contains several items, including a <guisubmenu>New</guisubmenu> 
+         that is identical to that in the 
+         <link linkend="menuref-universal-file">main window's file menu</link>.
+         Its other contents are:
+         <variablelist>
+
+	  <varlistentry>
+	    <term><guimenuitem>Send</guimenuitem></term>
+	    <listitem><para>
+             Opens a mail message with the appointment attached to it.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Save</guimenuitem></term>
+	    <listitem><para>
+              Save this appointment in the existing location and name. If you have not yet
+              chosen a location and name, this is the same as <guimenuitem>Save As</guimenuitem>.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Save As</guimenuitem></term>
+	    <listitem><para>
+              Choose a location and name for this appointment, and save it.
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Delete</guimenuitem></term>
+	    <listitem><para>
+              Deletes the appointment.
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Move to Folder</guimenuitem></term>
+	    <listitem><para>
+              Chose a folder, and move the appointment into it.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Copy to Folder</guimenuitem></term>
+	    <listitem><para>
+              Chose a folder, and put a copy of the appointment into it.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Page Setup Submenu</guimenuitem></term>
+	    <listitem><para>
+             This menu contains two items:
+                <itemizedlist>
+		  <listitem><para>
+                   <guimenuitem>Memo Style</guimenuitem> &mdash;
+                    FIXME: What does this do?
+                   </para></listitem>
+
+		  <listitem><para>
+                    <guimenuitem>Define Print Styles</guimenuitem> &mdash;
+                    FIXME: What does this do?
+                  </para></listitem>
+		</itemizedlist>
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Print Preview</guimenuitem></term>
+	    <listitem><para>
+              Shows you what your appointment will look like if you print it.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Print</guimenuitem></term>
+	    <listitem><para>
+              Prints the appointment without preview.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Properties</guimenuitem></term>
+	    <listitem><para>
+             FIXME: What does this do?
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Close</guimenuitem></term>
+	    <listitem><para>
+             Close the appointment editor window.
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-edit">
+      <title>The Appintment Editor's Edit Menu</title>
+      <para>
+         FIXME: this menu is copied and pasted entirely from somewhere
+         else.
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-view">
+      <title>The Appintment Editor's View Menu</title>
+      <para>
+         This menu allows you to look at different appointments, and
+         set the way you look at them, without having to move back to
+         the <interface>Main Window</interface>. It contains:
+         <variablelist>
+
+	  <varlistentry>
+	    <term><guisubmenu>Previous</guisubmenu></term>
+	    <listitem><para>
+               The items in this submenu will take you to appointments
+               prior to the current one. (FIXME: describe).
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guisubmenu>Next</guisubmenu></term>
+	    <listitem><para>
+               The items in this submenu will take you to appointments
+               scheduled to occur after the current one. (FIXME: describe).
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Calendar</guimenuitem></term>
+	    <listitem><para>
+               FIXME: What does this item do?
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guisubmenu>Toolbars</guisubmenu></term>
+	    <listitem><para>
+             The <guisubmenu>Toolbars</guisubmenu> submenu 
+             allows you to choose which toolbars
+             are displayed in the 
+             <interface>Appointment Editor</interface>. They are:
+             <itemizedlist>
+		  <listitem><para>
+                    <guimenuitem>Standard</guimenuitem> &mdash;
+                    Toggle the standard toolbar on and off.
+                   </para></listitem>
+
+		  <listitem><para>
+                    <guimenuitem>Formatting</guimenuitem> &mdash;
+                    Toggle the formatting toolbar on and off.
+                   </para></listitem>
+	
+		  <listitem><para>
+                    <guimenuitem>Customize</guimenuitem> &mdash;
+                    Select the contents of the formatting and standard toolbars.
+                   </para></listitem>
+		</itemizedlist>
+            </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-insert">
+      <title>The Appintment Editor's Insert Menu</title>
+      <para>
+        This menu contains: (FIXME: Insert Content Here)
+        <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>File</guimenuitem></term>
+	    <listitem><para>
+             Choose a file to append to your appointment or appointment request.
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Item</guimenuitem></term>
+	    <listitem><para>
+             FIXME: ?
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Object</guimenuitem></term>
+	    <listitem><para>
+             FIXME: ?
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-format">
+      <title>The Appintment Editor's Format Menu</title>
+      <para>
+         This menu contains two items, neither of which
+         have any functionality yet:
+         <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Font</guimenuitem></term>
+	    <listitem><para>
+             FIXME: ?
+           </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guimenuitem>Paragraph</guimenuitem></term>
+	    <listitem><para>
+             FIXME: ?
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-tools">
+      <title>The Appintment Editor's Tools Menu</title>
+      <para>
+         
+         This menu contains four items, none of which
+         have any functionality yet:
+         <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Item</guimenuitem></term>
+	    <listitem><para>
+            FIXME: ?
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Item</guimenuitem></term>
+	    <listitem><para>
+             FIXME: ?
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-actions">
+      <title>The Appintment Editor's Actions Menu</title>
+      <para>
+        This menu contains:
+
+         <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Invite Attendees</guimenuitem></term>
+	    <listitem><para>
+              Invite the listed attendees to the current event (via email).
+              You may be prompted to specify an invitation message.
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Cancel Invitation</guimenuitem></term>
+	    <listitem><para>
+              Cancels the event, notifying all attendees.  You may be prompted 
+              to specify an invitation message.
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Forward as vCalendar</guimenuitem></term>
+	    <listitem><para>
+              Opens the message composer with the current event attached.
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Forward as Text</guimenuitem></term>
+	    <listitem><para>
+              Opens the message composer with a text description of the current
+              event included in the message body.
+           </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+
+    <sect2 id="menuref-cal-editor-help">
+      <title>The Appintment Editor's File Menu</title>
+      <para>
+         This menu is empty.
+      </para>
+    </sect2>
+
+  </sect1>
+
+  <sect1>
+    <title>Contact Manager Menus</title>
+    <para>
+      Insert Content Here (FIXME).
+    </para>
+
+    <sect2 id="menuref-contact-edit">
+      <title>Contact Manager Edit Menu</title>
+      <para>
+         This menu is empty.
+      </para>
+    </sect2>
+
+
+    <sect2 id="menuref-contact-view">
+      <title>Contact Manager Edit Menu</title>
+      <para>
+        This menu contains the following items:
+
+         <variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>Show Shortcut Bar</guimenuitem></term>
+	    <listitem><para>
+              Toggle the Shortcut Bar on and off with this item.              
+           </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guimenuitem>Show Folder Bar</guimenuitem></term>
+	    <listitem><para>
+             Toggle the folder bar on and off with this item. 
+             See <xref linkend="usage-mainwindow-folderbar"> for 
+             more information about the folder bar.     
+           </para></listitem>
+	  </varlistentry>
+		  
+	  <varlistentry>
+	  <term><guimenuitem>As Table</guimenuitem></term>
+	  <listitem><para>
+             View your contacts as a table.  
+             When in table-view mode, this menu item reads 
+             <guimenuitem>As Minicards</guimenuitem>, and changes the view
+             back to the minicard format.
+           </para></listitem>
+	  </varlistentry>	  
+	</variablelist>      
+      </para>
+    </sect2>
+
+   <sect2 id="menuref-contact-tools">
+      <title>Contact Manager Tools Menu</title>
+      <para>
+         This menu is empty.
+      </para>
+    </sect2>
+
+
+
+   <sect2 id="menuref-contact-actions">
+      <title>Contact Manager Tools Menu</title>
+      <para>
+         This menu is broken. (FIXME).
+      </para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="menuref-contact-editor">
+    <title>The Contact Editor Menus</title>
+    <para>
+      Most, if not all, of the menu items for this section are still
+      inoperable, but there are vast numbers of them, especially in
+      the <guimenu>Actions</guimenu> menu.  When available, I will 
+      describe them.
+    </para>
+  </sect1>
+  
+
+</chapter>
+
+
+
+
+
+
+