path: root/doc/C/menuref.sgml

<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->

<chapter id="menuref">
  <title>Menu Reference</title>
  <para>
    <application>Evolution</application>'s menus may not hold the
    secret to happiness, they do hold every ability that
    <application>Evolution</application> has. This section will serve
    as a reference for all those menus, and the capabilites that they
    offer you.
  </para>
  <para>
    In addition, the editor tools for messages, appointments, and
    contacts all have menu bars of their own. 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>Settings</guimenu>,
    <guimenu>Message</guimenu>, <guimenu>Folder</guimenu>and
    <guimenu>Help</guimenu>.

  </para>
  <para>
    Menus in <application>Evolution</application> are
    context-sensitive, which means that they vary depending on what
    you're doing.  If you're reading your mail, you'll have
    mail-related menus; for your calendar, you'll have
    calendar-related menu items.  Some menus, of course, like
    <guimenu>Help</guimenu> and <guimenu>File</guimenu> don't much, if
    at all, because they have more universal functions.  But you'd
    never mark an address card as "read," or set the recurrence for an
    email message you've recieved. depending on whether you're looking
    at mail, contacts, or calendar information. 
  </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-exec">
   <title>Executive Summary Menus</title>
   <para>
     We'll leave this section blank until the UI stabilizes a little
     more.
   </para>
  </sect1>



  <sect1 id="menuref-mail">
    <title>Mail Menus</title>
    <para>
       <application>Evolution</application> Mail has more specialized
       menus, and more specialized menu items, than any other part of
       the application.
    </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 Mail 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 Mail Settings 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>Virtual Folder Editor</guimenuitem></term>
        <listitem><para>
              Create, edit, and delete Virtual Folders (<glossterm>vFolders</glossterm>)
               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> 
               Tools for setting up all your mail account preferences.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Manage Subscriptions</guimenuitem></term>
        <listitem><para>
               Tools for newsgroup and IMAP folder subscriptions.
           </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Forget Passwords</guimenuitem></term>
        <listitem><para>
              This item will cause <application>Evolution</application>
          to forget what your password is.
            </para></listitem>
      </varlistentry>
      
    </variablelist>
       </para>
    </sect2>

    <sect2 id="menuref-mail-folder">
      <title>The Mail Folder Menu</title>
      <para>
          The items in this menu relate to 
          <application>Evolution</application> mail folders.
      </para>
      <para>
          You can:
          <variablelist>

      <varlistentry>
        <term><guimenuitem>Mark all as Read</guimenuitem></term>
        <listitem><para>
          <application>Evolution</application> keeps track of which messages 
          you've seen;  to mark everything in a folder as read, choose this item.
          You can mark a single message as read by right-clicking it in the message bar.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Delete All</guimenuitem></term>
        <listitem><para>
          This is a favorite item of everyone with too much junk-mail: one click, and it 
          deletes every message in the current folder. 
        </para></listitem>
      </varlistentry>


      <varlistentry>
        <term><guimenuitem>Expunge</guimenuitem></term>
        <listitem><para>
                 Empties the trash folder, erasing messages permanently. 
                 Once you've done this, they're gone for good.
           </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Configure Folder</guimenuitem></term>
        <listitem><para>
              Use this item to set the file format in which
              <application>Evolution</application> stores mail. You
              can choose from standard UNIX-style
              <systemitem><filename>mbox</filename></systemitem>
              files, or the
              <systemitem><filename>mh</filename></systemitem> format.
              Converting large mailboxes may take a long time, and
              it's a good idea to have a backup copy beforehand.
           </para></listitem>
      </varlistentry>

    </variablelist>
       </para>
    </sect2>

  <sect2 id="menuref-mail-message">
      <title>The Mail Message Menu</title>
      <para>
          The items in this menu relate to
          <application>Evolution</application> mail messages. Most of
          them require you to have a message selected, and are also
          available by right-clicking on a message in the message
          list.
      </para>
      <para>
          <variablelist>


      <varlistentry>
        <term><guimenuitem>Open in New Window</guimenuitem></term>
        <listitem><para>
           Displays the selected message in a new window.
       </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Edit Message</guimenuitem></term>
        <listitem><para>
          Open the selected message in the message composer.  You
              can only edit a message you have written: drafts and messages in 
              the <guilabel>Sent</guilabel> box. 
       </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Print Message</guimenuitem></term>
        <listitem><para>
           Displays the <interface>Print Preview</interface> window, 
               ready for printing.
       </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>Copy Message</guimenuitem></term>
        <listitem><para>
           Copy the selected  message to another folder.
          </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>

   <sect2 id="menuref-mail-messagelistheader">
      <title>The Message Heading Right-Click Menu</title>
      <para>
         At the top of the message list is the message list heading
         bar; you can click on an individual heading &mdash;
         <guilabel>Subject</guilabel>, for example, to have the
         message list sorted by that attribute.  However, if you right
         click on a heading, you'll get the following menu:
      </para>

      <para>
          <variablelist>

      <varlistentry>
          <term><guimenuitem>Sort Ascending</guimenuitem></term>
          <listitem><para>
         Sort the list, in ascending order, by the attribute you clicked.
          </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Sort Descending</guimenuitem></term>
          <listitem><para>
         Sort the list in descending order.
          </para></listitem>
        </varlistentry>
  
      <varlistentry>
          <term><guimenuitem>Unsort</guimenuitem></term>
          <listitem><para>
         Undo any sorting by this attribute, and leave the message list sorted 
                 by the previous one.
          </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Group by this Field</guimenuitem></term>
          <listitem><para>
         Instead of sorting the messages, group them in boxes. 
          </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Group by Box</guimenuitem></term>
          <listitem><para> If you have your messages grouped in
          boxes, you can arrange the boxes as well, by choosing
          this item.  </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Remove this column</guimenuitem></term>
          <listitem><para>
         Choose this to remove the column from the message list display.
          </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Field Chooser</guimenuitem></term>
          <listitem><para>
         Opens a palette of columns. You can drag the columns
         you want from the palette into position in the
         message list heading bar; red arrows appear
         when you get close enough to a possibile position.</para>
                 
              <para>
                 Your options are: 
                 <itemizedlist>
                     <listitem><para>
                         <guiicon>An Envelope</guiicon> which indicates whether a message has been read (closed for unread, open for read).
                     </para></listitem>

                     <listitem><para>
                         <guiicon>An Exclamation Point</guiicon> for priority
                     </para></listitem>

                     <listitem><para>
                         <guiicon>A Penguin</guiicon> which indicates something, although I'm not sure what.
                     </para></listitem>

                     <listitem><para>
                         <guiicon>A Paper Clip</guiicon> which indicates that there is an attachment to the message.
                     </para></listitem>

                     <listitem><para>
                         <guilabel>From</guilabel>, for the <guilabel>From</guilabel> field of a message.
                     </para></listitem>
                     <listitem><para>
                         <guilabel>Subject</guilabel>, for the <guilabel>Subject</guilabel> field of a message.
                     </para></listitem>

                     <listitem><para>
                         <guilabel>Date</guilabel>, for the date and time a message was sent.
                     </para></listitem>

                     <listitem><para>
                         <guilabel>Received</guilabel>, for the date and time you got the message. 
                     </para></listitem>

                     <listitem><para>
                         <guilabel>To</guilabel>, for the <guilabel>To</guilabel> field.
                     </para></listitem>

                     <listitem><para>
                         <guilabel>Size</guilabel>, for a message's size.
                     </para></listitem>
          </itemizedlist>
             </para>   

          </listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Alignment</guimenuitem></term>
          <listitem><para> Use this item to decide upon the
          alignment of the message attributes within their
          columns.  </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Best Fit</guimenuitem></term>
          <listitem><para>
         Alters the width of the message list columns to maximize the amount of information displayed.
          </para></listitem>
        </varlistentry>

      <varlistentry>
          <term><guimenuitem>Format Columns...</guimenuitem></term>
          <listitem><para>
         This item is not yet available.
          </para></listitem>
        </varlistentry>


      <varlistentry>
          <term><guimenuitem>Customize
          Views...</guimenuitem></term> <listitem><para> Opens a
          dialog box that lets you choose a complex set of
          arrangements for your message list, so you can combine
          sorting and grouping in as many ways as you like.
          </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 separate text file.
          </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 Now</guimenu></term>
          <listitem><para>
          Sends the message immediately.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guimenu>Send Later</guimenu></term>
          <listitem><para>
          Queue 
          </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.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Find Regex</guimenuitem></term>
        <listitem><para>
               If you are familiar with <glossterm>regular expressions</glossterm>,
                often called "regexes," you can search for something more complicated, 
               using wildcards and boolean logic.
        </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 separate 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-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-settings">
      <title>The Calendar Settings Menu</title>
      <para>
         This menu is empty.
      </para>
    </sect2>

  </sect1>

  <sect1 id="menuref-cal-editor">
    <title>The Appointment Editor Menus</title>
    <para>
    The appointment editor has its own menus, to help you use its
    wide-ranging abilities.
    </para>
    
    <sect2 id="menuref-cal-editor-file">
      <title>The Appointment Editor's File Menu</title>
      <para>
         This menu contains several items, including a <guisubmenu>New</guisubmenu> submenu
         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. See <xref linkend="usage-print">
        for details on printing and the Print Preview function.
        </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 Appointment 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 Appointment 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 Appointment 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 Appointment 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 Appointment Editor's Tools Menu</title>
      <para>
         This menu contains four items, including the
         <guisubmenu>Forms</guisubmenu> submenu, which allows you to
         alter calendar forms and create your own entries.  None of
         this works yet, though.

         <variablelist>

      <varlistentry>
        <term><guimenuitem>Spelling</guimenuitem></term>
        <listitem><para>
              Checks the spelling of your calendar entry.
           </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><guimenuitem>Check Names</guimenuitem></term>
        <listitem><para> Checks the names listed here against
        those in your address book.
            </para></listitem>
      </varlistentry>


      <varlistentry>
        <term><guimenuitem>Address Book</guimenuitem></term>
        <listitem><para>
             FIXME: ?
           </para></listitem>
      </varlistentry>


      <varlistentry>
        <term><guisubmenu>Forms</guisubmenu> Submenu</term>
        <listitem><para>
               The Forms submenu lets you alter the
           appearance of Calendar Forms. 
           </para></listitem>
      </varlistentry>
    </variablelist>

      </para>
    </sect2>

    <sect2 id="menuref-cal-editor-actions">
      <title>The Appointment Editor's Actions Menu</title>
      <para>
        This menu contains:

         <variablelist>
      <varlistentry>
        <term><guimenuitem>Schedule Meeting</guimenuitem></term>
        <listitem><para>
              Brings up the <interface>Meeting Invitation</interface> window, 
              described in <xref linkend="usage-calendar-apts">.
           </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 Appointment Editor's File Menu</title>
      <para>
         This menu is empty.
      </para>
    </sect2>

  </sect1>

  <sect1>
    <title>Contact Manager Menus</title>
    <para>
     The contact manager has six menus: <guimenu>File</guimenu>,
     <guimenu>Edit</guimenu>, <guimenu>View</guimenu>,
     <guimenu>Setting</guimenu>s, <guimenu>Tools</guimenu>, and
     <guimenu>Help</guimenu>.
    </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 View 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> / <guimenuitem>As Minicards</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 contains one item:

        <variablelist>
      <varlistentry>
        <term><guimenuitem>Search for
        Contacts</guimenuitem></term> <listitem><para> Brings up
        the in-depth search window. <xref
        linkend="contact-search"> describes how to use this
        feature.  </para></listitem>
            </varlistentry>
        </variablelist>
      </para>
    </sect2>



   <sect2 id="menuref-contact-actions">
      <title>Contact Manager Tools Menu</title>
      <para>
         This menu contains only one item:

        <variablelist>
      <varlistentry>
        <term><guimenuitem>New Directory Server</guimenuitem></term> <listitem><para> Brings up
        the in-depth search window. <xref
        linkend="config-prefs-contact-ldap-add"> describes how to use this
        feature.  </para></listitem>
            </varlistentry>
        </variablelist>

      </para>
    </sect2>
  </sect1>

  <sect1 id="menuref-contact-editor">
    <title>The Contact Editor Menus</title>
    <para>
       This window has only one menu: the file menu.
    </para>
   
   <sect2 id="menuref-contact-editor-file">
      <title>Contact Editor File Menu</title>
      <para>
         This menu contains five items:
         <variablelist>

      <varlistentry>
      <term><guimenuitem>Save</guimenuitem></term>
      <listitem><para>
             
           </para></listitem>
      </varlistentry>   

      <varlistentry>
      <term><guimenuitem>Save As</guimenuitem></term>
      <listitem><para>
              Allows you to save the contact as an external 
              file in the <glossterm linkend="vcard">VCard</glossterm> format. 
           </para></listitem>
      </varlistentry>   

      <varlistentry>
      <term><guimenuitem>Print</guimenuitem></term>
      <listitem><para>
             Prints the current contact.
           </para></listitem>
      </varlistentry>   


      <varlistentry>
      <term><guimenuitem>Delete</guimenuitem></term>
      <listitem><para>
             Deletes the current contact.
           </para></listitem>
      </varlistentry>   

  
      <varlistentry>
      <term><guimenuitem>Close</guimenuitem></term>
      <listitem><para>
              Closes the Contact Editor without saving.
           </para></listitem>
      </varlistentry>   

    </variablelist>  
      </para>
    </sect2>
  </sect1>
  

</chapter>