path: root/doc/C/usage-mail.sgml

<chapter id="usage-mail">
  <title>Using Evolution for Email</title>
  <abstract>
    <title> A Guide to the Evolution Mailer</title>
    <para>
       <application>Evolution</application> email is like other email
       programs in all the ways that matter:
     <itemizedlist>
       <listitem>
         <para>
           It can sort and organize your mail in a wide variety of ways with
           folders, searches, and filters.
         </para>
       </listitem>
       <listitem>
         <para>
          It can send and receive mail in HTML or as plain text, and
          makes it easy to send and recieve multiple file attachments.
         </para>
       </listitem>
       <listitem>
         <para>
           It supports multiple mail sources, including <glossterm
           linkend="imap">IMAP</glossterm>, <glossterm
           linkend="pop">POP3</glossterm>, local
           <systemitem><filename>mbox</filename></systemitem> and
           <systemitem><filename>mh</filename></systemitem> files, and
           even NNTP messages (newsgroups), which aren't technically
           email.
         </para>
    </listitem>
    <listitem>
      <para>
        Lets you enhance your security with encryption.
      </para>
    </listitem>
     </itemizedlist>
    </para>
    <para>
      However, <application>Evolution</application> has some important
      differences.  First, it's built to handle very large amounts of
      mail without slowing down or crashing.  Both the <link
      linkend="usage-mail-organize-filters">filtering</link> and <link
      linkend="usage-mail-organize-search">searching</link> functions
      were built for speed and efficiency on gargantuan volumes of
      mail. There's also the <application>Evolution</application>
      <link linkend="usage-mail-organize-vFolders">Virtual
      Folder</link>, an advanced organizational feature not found in
      mainstream mail clients.  If you get a lot of mail, or if you keep
      every message you get in case you need to refer to it later,
      you'll find this feature especially useful.
    </para>
  </abstract>

  <sect1 id="usage-mail-getnsend-read">
      <title>Reading Mail</title>
      <para>
       You can start reading email by clicking
       <guibutton>Inbox</guibutton> in the shortcut bar. The first
       time you use <application>Evolution</application>, it will
       start with the <interface>Inbox</interface> open and show you a
       message from Ximian welcoming you to the application.
      </para>

      <para>
        Your <application>Evolution</application>
        <guilabel>Inbox</guilabel> will look something like the one in
        <xref linkend="usage-mail-intro-fig">.
        If you find the <interface>view pane</interface> too small, you can resize
        the pane, enlarge the whole window, or double-click on the
        message in the <interface>message list</interface> to have it
        open in a new window.  To change the sizes of a pane, just click
        and hold on the divider between the two panes.  Then you can drag
        up and down to select the size of the panes.  Just like with
        folders, you can right-click on messages in the message list and
        get a menu of possible actions.
     </para>

 <!-- ==============Figure=================================== -->

      <figure id="usage-mail-intro-fig">
          <title>Evolution Mail</title>
          <screenshot>
            <screeninfo>Inbox</screeninfo>
            <graphic fileref="fig/mail-inbox.png" srccredit="Kevin Breit">
        </graphic>
        </screenshot>
      </figure>
<!-- ==============End of Figure============================== -->

    <para>
      <inlinegraphic fileref="fig/full-1.png"></inlinegraphic>
      <guilabel>Email Viewer</guilabel>
    </para>
    
    <para>
      This is where your email is displayed.
    </para>

    <para>
      <inlinegraphic fileref="fig/full-2.png"></inlinegraphic>
      <guilabel>Email List</guilabel>
    </para>
    
    <para>
      The <guilabel>Email List</guilabel> displays all the emails that you
      have.  This includes all your read, unread, and email that is flagged 
      to be deleted.
    </para>
    
    <para>
      Most of the mail-related actions you'll want to perform are
      listed in the <guimenu>Message</guimenu> menu in the menu
      bar.  The most frequently used ones, like
      <guimenuitem>Reply</guimenuitem> and
      <guimenuitem>Forward</guimenuitem>, also appear as buttons in
      the toolbar. Almost all of them are also located in the
      right-click menu and as keyboard shortcuts, which tend to be
      faster once you get the hang of them.  You can choose
      whichever way you like best; the idea is that the software
      should work the way you want, rather than making you work the
      way the it does.
      
      <tip id="view-headers">
    <title>Take a look at the headers</title>
    <para>
      To look at the entire source of your email message, including
      all the header information, select
      <menuchoice><guimenu>View</guimenu><guimenuitem>Source</guimenuitem></menuchoice>
    </para>
      </tip>

    </para>
    
    <sect2 id="usage-mail-listorder">
      <title>Sorting the message list</title>
      <para>
    <application>Evolution</application> helps you work by letting you sort
    your email.  To sort by sender, subject, or date, click
    on the bars with those labels at the top of the message
    list. The direction of the arrow next to the label indicates
    the direction of the sort, and if you click again, you'll
    sort them in reverse order. For example, click once on
    <guilabel>Date</guilabel> to sort messages by date from
    oldest to newest.  Click again, and
    <application>Evolution</application> sorts the list from
    newest to oldest. You can also right-click on the message
    header bars to get a set of sorting options, and add or
    remove columns from the message list.  You can find detailed
    instructions on how to customize your message display
    columns in <xref linkend="usage-mail-organize-columns">.
      </para>
      <para>
    You can also choose a threaded message view. Select
    <menuchoice> 
      <guimenu>View</guimenu>
          <guimenuitem>Threaded</guimenuitem> 
    </menuchoice> 
    to turn the threaded view on or off.  When you select this option,
    <application>Evolution</application> groups the replies to a
    message with the original, so you can follow the thread of a
    conversation from one message to the next.
      </para>
    </sect2>
    
    <sect2 id="usage-mail-getnsend-delete">
        <title>Deleting Mail</title>
        <para>
          Once you've read your mail, you may want to get rid of
          it. 
    To delete a message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Click the message to select it
        </para>
      </listitem>
      <listitem>
        <para>
          Press delete button or right click and click on 
          <guilabel>Delete</guilabel>.
        </para>
        <note>
          <title>Deleted but still here?</title>
          <para>
        When you do this, your message is marked to be deleted.  Your
        email is not gone until you have expunged it.
          </para>
        </note>
      </listitem>
      <listitem>
        <para>
          Click
          <menuchoice>
        <guimenu>Actions</guimenu>
        <guimenuitem>Expunge</guimenuitem>
          </menuchoice>
          or press
          <keycombo action="simul">
        <keycap>Ctrl</keycap>
        <keycap>E</keycap>
          </keycombo>
        </para>
      </listitem>
    </orderedlist>
      </para>
      <note>
    <title>Trash is Actually a Virtual Folder?</title>
    <para>
      Your trash bin is actually a Virtual Folder that searches for all mails that
      are queued to be deleted.
    </para>
      </note>
    </sect2>
    <sect2 id="usage-mail-getnsend-undelete">
      <title>Undeleting Messages</title>
      <para>
    To undelete a message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Click a message marked for deletion to select it
        </para>
      </listitem>
      <listitem>
        <para>
          Click
          <menuchoice>
        <guimenu>Actions</guimenu>
        <guimenuitem>Undelete</guimenuitem>
          </menuchoice>
        </para>
        <note>
          <title>What does Undelete actually do?</title>
          <para>
        Undelete doesn't bring back messages that have been expunged.
        Undelete simply unmarks messages for expunging.
          </para>
        </note>
      </listitem>
    </orderedlist>
      </para>
    </sect2>
  </sect1>

  <sect1 id="usage-mail-getnsend-get">
    <title>Checking Mail</title>
    <para>
      Now that you've had a look around the <interface>Inbox</interface>, it's
      time to check for new mail.  Click <guibutton>Get Mail</guibutton> in the
      toolbar to check your mail.  If it's the first time you've done so, the
      <interface>mail setup assistance</interface> will ask you for the
      information it needs to check your email.
    </para>
    <para>
      The assistant will give you several dialog boxes where you configure:
      <itemizedlist>
    <listitem>
      <para>
        your personal information
      </para>
    </listitem>
    <listitem>
      <para>
        your outgoing email server information
      </para>
    </listitem>
    <listitem>
      <para>
        your mail account identity name
      </para>
    </listitem>
      </itemizedlist>
    </para>
    <para>
      To check your email, press the <guibutton>Check Mail</guibutton> button.
      If this is your first time checking mail, or you don't have
      <application>Evolution</application> setup to store your password, you'll
      be prompted for the password.  Enter your password and your email will be
      downloaded.
    </para>
    <note id="badmailsettings">
      <title>Can't Check Mail?</title>
      <para>
    If you get an error message instead of mail, you probably need to check
    your network settings.  To learn how to do that,
     have a look at <xref linkend="config-prefs-mail-network">, or
     ask your system administrator.
       </para>
     </note>

       <sect2 id="usage-mail-getnsend-get-news">
      <title>Using Evolution for News </title>
    <para>
      Newsgroups are so similar to email that there's no reason not
      to read them side by side.  If you want to do that, add a
      news source to your configuration (see <xref
      linkend="config-prefs-network-news">). The news server will
      appear as a remote server, and will look quite similar to an
      IMAP folder.  When you click <guibutton>Get Mail</guibutton>,
      <application>Evolution</application> will also check for news
      messages.
    </para>
    </sect2>

       <sect2 id="usage-mail-getnsend-get-attach">
     <title>Attachments and HTML Mail</title>
     <para>
       If someone sends you an <glossterm>attachment</glossterm>, a
       file attached to an email,
       <application>Evolution</application> will display the file
       at the bottom of the message to which it's attached.  Text,
       HTML, and most images will be displayed within the message
       itself.  For other files,
       <application>Evolution</application> will show an icon at
       the end of the message. 
     </para>
     <para>
       To Save an Attachment to Disk:
       <orderedlist numeration="arabic">
     <listitem>
       <para>
         Open up the desired email
       </para>
     </listitem>
     <listitem>
       <para>
         Click on the down arrow at the bottom of the email for the desired
         attachment.
       </para>
     </listitem>
     <listitem>
       <para>
         Select <guibutton>Save to Disk</guibutton>.
       </para>
     </listitem>
     <listitem>
       <para>
         Choose the directory and filename you wish.
       </para>
     </listitem>
     <listitem>
       <para>
         Click <guibutton>OK</guibutton>
       </para>
     </listitem>
       </orderedlist>
      </para>
      <tip>
    <para>
      To automatically view an attachment inline, press the arrow button next
      to the attachment.
    </para>
      </tip>
      <para>
    To Open an Attachment in a Program:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Open up the desired email
        </para>
      </listitem>
      <listitem>
        <para>
          Click the down arrow at the bottom of the email for the desired
          attachment.
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>Open in Program</guibutton> where program is the
          program that is assigned to open that file type.
        </para>
      </listitem>
    </orderedlist>
      </para>
    
      
      <!-- Right-click on the icon to get a
      list of options which will vary depending on the type of
      attachment. You will have the option to display most files
      as part of the message, export them to a different
      application (images to Eye of GNOME, spreadsheets to
      Gnumeric, and so forth), or save them to disk.
    </para>
      -->
        <para>
           <application>Evolution</application> can also display
           HTML-formatted mail, complete with graphics.  Graphics don't load
           automatically by default, becuase they can be large and take a long
           time to download.  They can also be used by spammers to help track
           who reads their email.  So having them not load automatically helps
           protect your privacy.
    <!-- I say the privacy thing because I saw an internal email which
           stated that gallop polls show people are concerned about online
           security and that we'd be best marketing Evolution as more secure -->
      </para>
    </sect2>
  </sect1>

    <sect1 id="usage-mail-getnsend-send">
      <title>Writing and Sending Mail</title>
      <para>
         You can start writing a new email message by selecting
         <menuchoice> <guimenu>File</guimenu>
         <guisubmenu>New</guisubmenu> <guimenuitem>
         Mail Message</guimenuitem></menuchoice>, or by pressing the
         <guibutton>Compose</guibutton> button in the Inbox toolbar.
         When you do so, the <interface>New Message</interface> window
         will open, as shown in <xref
         linkend="usage-mail-newmsg-fig">.
      </para>

<!--   ==============Figure=================================== -->
      <figure id="usage-mail-newmsg-fig">
        <title>New Message Window</title>
        <screenshot>
          <screeninfo>Evolution Main Window</screeninfo>
          <graphic fileref="fig/newmsg-pic" format="png" srccredit="Kevin Breit">
        </graphic>
        </screenshot>
      </figure>
<!-- ==============End of Figure=================================== -->

 <!-- Check the alignment of the following paragraph in the PS and
 HTML output: it's indented for no good reason 
      Kevin Breit: I dont see a problem with the HTML.
    -->
      <para>
      Enter an address in the <guilabel>To:</guilabel> field.  If you wish
      enter a  subject in the <guilabel>Subject:</guilabel> and a message in
      the big empty box at the bottom of the window.  Once you have revised
      your message, press <guibutton>Send</guibutton>.
    </para>

      <sect2 id="usage-mail-getnsend-send-delay">
        <title>Saving Messages for Later</title>
        <para>
           <application>Evolution</application> will send mail immediately unless you tell it to
           do otherwise by selecting <menuchoice>
           <guimenu>File</guimenu> <guimenuitem>Send
           Later</guimenuitem></menuchoice>.  This will add your
           messages to the <guilabel>Outbox</guilabel> queue.  Then,
           when you press <guibutton>Send</guibutton> in another
           message, or <guibutton>Get Mail</guibutton> in the main
           mail window, all your unsent messages will go out at once.
           You might want to use "Send Later" becuase it gives
           you a chance to change your mind about a message before you send it.
        </para>
        <para>
           To learn more about how you can specify message queue and
           filter behavior, see <xref linkend="config-prefs-mail">.
        </para>

      <para>
    You can also choose to save messages as drafts or as text
    files.  Choose
    <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Save</guimenuitem>
          </menuchoice>
    or <guimenuitem>Save As</guimenuitem> to save your message
    as a text file. If you prefer to keep your message in a
    folder (the <guilabel>Drafts</guilabel> folder would be the
    obvious place), you can select <menuchoice>
          <guimenu>File</guimenu> <guimenuitem>Save In
        Folder</guimenuitem> </menuchoice>.
      </para>
    </sect2>

    <sect2 id="usage-mail-getnsend-send-compose">
      <title>Advanced Mail Composition</title>
      <para>
    <application>Evolution</application> is meant to not only handle large
    amounts of incoming mail, but helps you manage all the tasks of having
    an email account.
    In the next few sections, you'll see how 
    <application>Evolution</application> handles additional features, 
    including large recipient lists, attachments, and forwarding.
      </para>
      <sect3 id="usage-mail-getnsend-send-attach">
        <title>Attachments</title>
        <para>
      To attach a file to your email:
      <orderedlist numeration="arabic">
        <listitem>
          <para>
        Push the attach button in the composer toolbar
          </para>
        </listitem>
        <listitem>
          <para>
        Select the file you want to attach
          </para>
        </listitem>
        <listitem>
          <para>
        Press <guibutton>OK</guibutton>
          </para>
        </listitem>
      </orderedlist>
    </para>
    <para>
      You can drag a file from your desktop into the composer window to
      attach it as well.
        </para>
        <para>
            To hide the display of files you've attached to the
            message, select <menuchoice>
            <guimenu>View</guimenu> <guimenuitem>Hide
            Attachments</guimenuitem> </menuchoice>; to show them
            again, choose <guimenuitem>Show Attachments</guimenuitem>.
        </para>
        <para>
            When you send the message, a copy of the attached file
            will go with it.  Be aware that big attachments can take a
            long time to download.
        </para>
        <para>
            When receiving a message that has an attached image,
            <application>Evolution</application> gives you the choice
            whether to view it or not.  You can choose to have it
            always shown, load images only if the sender is in your
            addressbook, or never load images.
        </para>
      </sect3>

      <sect3 id="usage-mail-getnsend-send-to-types">
    <title>Types of Recipients</title>
        <para>
      <application>Evolution</application>, like most email
      programs recognizes three types of addressee: primary
            recipients, secondary recipients, and hidden ("blind")
            recipients.
         </para>
         <para>
            The simplest way to direct a message is to put the email
            address or addresses in the <guilabel>To:</guilabel>
            field, which denotes primary recipients.  To send mail to
            more than one or two people, you can use the the
            <guilabel>Cc:</guilabel> field.
          </para>
          <para>
            Hearkening back to the dark ages when people used
            typewriters and there were no copy machines, "Cc" stands
            for "Carbon Copy."  Use it whenever you want to share a
            message you've written to someone else.
            <example id="ex-mail-cc">
              <title>Using the Cc: field</title>
              <para>
                 When Susan sends an email to a client, she puts her
                 co-worker, Tim, in the in the
                 <guilabel>Cc:</guilabel> field, so that he know
                 what's going on.  The client can see that Tim also
                 received the message, and knows that he can talk to
                 Tim about the message as well.
              </para>
            </example>
          </para>
          <para>

            <example id="ex-mail-bcc">
              <title>Using the Bcc: field</title>
              <para>
                 Tim is sending an email announcement to all of his
                 company's clients, some of whom are in competition
                 with each other, and all of whom value their
                 privacy. He needs to use the
                 <guilabel>Bcc:</guilabel> field here.  If he puts
                 every address from his address book's "Clients"
                 category into the <guilabel>To:</guilabel> or
                 <guilabel>Cc:</guilabel> fields, he'll make the
                 company's <emphasis>entire</emphasis> client list
                 public. But putting his "Clients" addressbook
                 into the Bcc: section, that will cause them to be hidden
                 from the competition.  It seems insignificant, but it can
                 make a huge difference in some situations.
             </para>
            </example>
          </para>
        </sect3>

        <sect3 id="usage-mail-getnsend-send-to">
        <title>Choosing Recipients Quickly</title>
        <para>
      If you have created address cards in the contact manager,
          you can also enter nicknames or other portions of address
          data, and <application>Evolution</application> will transparently
          complete
          the address for you. <!-- (INSERT description of UI for this
          feature, once it is decided upon). --> If you enter a name
          or nickname that can go with more than one card, Evolution
          will open a dialog box to ask you which person you meant.
          <!-- (NOT YET) Also, <application>Evolution</application>
          will add a domain to any unqualified addresses.  By default,
          this is your domain, but you can choose which one mail
          preferences dialog. -->
          </para>
          <para>
            Alternately, you can click on the
            <guibutton>To:</guibutton>, <guibutton>Cc:</guibutton>, or
            <guibutton>Bcc:</guibutton> buttons to get a list &mdash;
            potentially a very long one &mdash; of the email addresses
            in your contact manager.  Select addresses and click on
            the arrows to move them into the appropriate address
            columns.
          </para>
          <para>
            For more information about using email together with the
            contact manager and the calendar, see <xref
            linkend="usage-contact-automate"> and <xref
            linkend="usage-calendar-apts">.
          </para>
        </sect3>
      </sect2>

      <sect2 id="usage-mail-getnsend-send-reply">
        <title>Replying to Messages</title>
        <para>
           To reply to a message, press the
           <guibutton>Reply:</guibutton> button while it is selected,
           or choose <guimenuitem>Reply to Sender:</guimenuitem> from
           the message's right-click menu.  That will open the
           <interface>message composer</interface>.  The
           <guilabel>To:</guilabel> and <guilabel>Subject:</guilabel>
           fields will already be filled, although you can alter them
           if you wish.  In addition, the full text of the old message
           is inserted into the new message, either grey (for
           HTML display) or with the &gt; character before each line
           (in plain text mode), to indicate that it's part of the
           previous message.  People often intersperse their message
           with the quoted material as shown in <xref
           linkend="usage-mail-getnsend-reply-fig">.

<!-- note that this figure should have a reply message ready to send,
with quoted materials and the relevant replies interspersed-->
<!-- I want to wait for the formatting bugs to be fixed first -->
 <!-- ==============Figure=================================== -->
       <figure id="usage-mail-getnsend-reply-fig">
         <title>Reply Message Window</title>
         <screenshot>
          <screeninfo>Evolution Main Window</screeninfo>
          <graphic fileref="fig/replymsg" format="png" srccredit="Aaron Weber">
        </graphic>
        </screenshot>
      </figure>
<!-- ==============End of Figure=================================== -->
        </para>
        <para>
          If you're reading a message with several recipients, you may
           wish to use <guibutton>Reply to All</guibutton> instead of
           <guibutton>Reply</guibutton>.  If there are large numbers
           of people in the <guilabel>Cc:</guilabel> or
           <guilabel>To:</guilabel> fields, this can save substantial
           amounts of time.
          <example>
            <title>Using the Reply to All feature</title>
            <para>
              Susan sends an email to a client and sends copies to Tim
              and to an internal company mailing list of co-workers.
              If Tim wants to make a comment for all of them to read,
              he uses <guibutton>Reply to All</guibutton>, but if he
              just wants to tell Susan that he agrees with her, he
              uses <guibutton>Reply</guibutton>.  Note that his reply
              will not reach anyone that Susan put on her
              <guilabel>Bcc</guilabel> list, since that list is not
              shared with anyone.
            </para>
          </example>
        </para>
        <para>
          You may want to reply to a whole mailing list.  For this, you would
          use the <guibutton>Reply to List</guibutton> instead of the standard
          <guibutton>Reply</guibutton> or <guibutton>Reply to All</guibutton>.
          <note>
            <title>What is a Mailing List?</title>
            <para>
              Mailing Lists are one of the most popular ways in which group
              collaboration on the Internet works.  They allow people to send one
              message to one server.  The server then knows who is subscribed to the
              mailing list, and sends a copy of your email to all the people on the
              list.  
              For example, evolution-hackers@ximian.com allows the
              <application>Evolution</application> programmers to converse
              publically about their latest developments so that everyone can
              stay up to date.
            </para>
            <para>
              There are two different types of mailing lists.  The first is a
              general submission list.  That means that anyone can write to the
              list.  The second is a managed list.  The managed lists have
              someone running them.  They can do as little as limit who
              subscribes to the list or as much as moderate which emails get on
              the list.
            </para>
          </note>
        </para>
      </sect2>

      <sect2 id="usage-mail-getnsend-send-find">
        <title>Searching and Replacing with the Composer</title>
        <para>
           You maybe familiar with search and replace features,
           and if you come from a Linux or Unix background, you
           probably know what <guimenuitem>Find Regex</guimenuitem>
           does.  If you aren't among the lucky who already know,
           here's a quick rundown of an important section of the
           <guimenu>Edit</guimenu> menu.
        </para>
        <para>
           <variablelist>
            <varlistentry>
              <term><guimenuitem>Find</guimenuitem></term>
              <listitem><para> Enter a word or phrase, and
              <application>Evolution</application> will find it
              in your message.
              </para></listitem>
            </varlistentry>

            <varlistentry>
              <term><guimenuitem>Find Regex</guimenuitem></term>
              <listitem>
                <para>
                  Find a regex, also called a
                  <glossterm linkend="regular-expression">regular
                  expression</glossterm>, in your composer window.
               </para>
             </listitem>
            </varlistentry>

            <varlistentry>
              <term><guimenuitem>Find Again</guimenuitem></term>
              <listitem><para>
                   Select this item to repeat the last search you performed.
              </para></listitem>
            </varlistentry>

            <varlistentry>
               <term><guimenuitem>Replace</guimenuitem></term>
               <listitem><para>
                 Find a word or phrase, and replace it with
                 something else.
               </para></listitem>
            </varlistentry>

          </variablelist>
        </para>

        <para>
            For all of these menu items, you can choose whether or not
            to <guilabel>Search Backwards</guilabel> in the document
            from the point where your cursor is.  For all but the
            regular expression search (which doesn't need it), you are
            offered a check box to determine whether the search is to
            be <guilabel>Case Sensitive</guilabel> when it determines
            a match.
        </para>
      </sect2>

      <sect2 id="usage-mail-getnsend-send-html">
        <title>Embellish your email with HTML</title>
        <para>
            Normally, you can't set text styles or insert pictures in
            emails, which is why you've probably seen people use far
            too many exclamation points for emphasis, or use
            <glossterm linkend="emoticon">emoticons</glossterm> to
            convey their feelings.  However, most newer email programs
            can display images and text styles as well as basic
            alignment and paragraph formatting. They do this with
            <glossterm linkend="html">HTML</glossterm>, just like web
            pages do.
        </para>
        <note>
          <title>HTML Mail is not a Default Setting</title>
          <para>
            Some people do not have HTML-capable mail clients, or
            prefer not to receive HTML-enhanced mail because it is
            slower to download and display.  <emphasis>Some</emphasis>
            people refer to HTML mail as "the root of all evil" and
            get very angry if you send them HTML mail, which is why
            <application>Evolution</application> sends plain text
            unless you explicitly ask for HTML.  To send HTML mail,
            you will need to select <menuchoice>
            <guimenu>Format</guimenu> <guimenuitem>
            HTML</guimenuitem></menuchoice>.  Alternately, you can set
            your default mail format preferences in the mail
            configuration dialog.  See <xref
            linkend="config-prefs-mail-other"> for more information.
          </para>
        </note>
        <para>
           HTML formatting tools are located in the toolbar just above
           the space where you'll actually compose the message, and
           they also appear in the <guimenu>Insert</guimenu> and
           <guimenu>Format</guimenu> menus.
          </para>
          <para>
            The icons in the toolbar are explained in <glossterm
            linkend="tooltip">tool-tips</glossterm>, which appear when
            you hold your mouse over the buttons.  The buttons fall
            into four categories:
            <variablelist>
             <varlistentry>
             <term>Headers and lists</term>
              <listitem>
                <para>
                  At the left edge of the toolbar, you can choose
                  <guilabel>Normal</guilabel> for a default text style
                  or <guilabel>Header 1</guilabel> through
                  <guilabel>Header 6</guilabel> for varying sizes of
                  header from large (1) to tiny (6). Other styles
                  include <guilabel>preformat</guilabel>, to use the HTML
                  tag for preformatted blocks of text, and three types
                  of <guilabel>List Item</guilabel> for the highly
                  organized.
                </para>
              </listitem>
           </varlistentry>
      <varlistentry>
        <term>Text style</term>
        <listitem>
          <para>
        Use these buttons to determine the way your letters
        look.  If you have text selected, the style will
        apply to the selected text.  If you do not have text
        selected, the style will apply to whatever you type
        next.  The buttons are:
        <itemizedlist mark="none">
          <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem>
          <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem>
          <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem>
          <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem>
        </itemizedlist>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
              <term>Alignment</term>
        <listitem>
          <para>
        Located next to the text style buttons, these three
        paragraph icons should be familiar to users of most
        word processing software.  The leftmost button will
        make your text aligned to the left, the center
        button, centered, and the right hand button,
        aligned on the right side.
          </para>
        </listitem>
      </varlistentry>

            <varlistentry>
              <term>Indentation rules</term>
              <listitem>
                <para>
                  The button with the arrow pointing left will reduce
                  a paragraph's indentation, and the right arrow will
                  increase its indentation.
               </para>
            </listitem>
          </varlistentry>

            <varlistentry>
              <term>Color Selection</term>
              <listitem>
                <para>
                  At the far right is the color section tool.  The
                  colored box displays the current text color; to
                  choose a new one, click the arrow button just to the
                  right. If you have text selected, the color will
                  apply to the selected text.  If you do not have text
                  selected, the color will apply to whatever you type
                  next.
               </para>
            </listitem>
          </varlistentry>


          </variablelist>
        </para>
        <para>
    The <guimenu>Insert</guimenu> gives you three opinions which let you
           spruce up your email to make it more interesting:
    <variablelist>
      <varlistentry>
        <term><guimenuitem>Insert Link</guimenuitem></term>
        <listitem>
          <para>
        Lets you link some text to a website.  Use this tool to put hyperlinks in your HTML
                  messages.  If you don't want special link text, you can just enter the address
                  directly, and <application>Evolution</application>
                  will recognize it as a link.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guimenuitem>Insert Image</guimenuitem></term>
        <listitem>
          <para>
        Lets you put an image alongside text.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guimenuitem>Insert Rule</guimenuitem></term>
        <listitem>
          <para>
        Inserts a horizontal line into the text to help divide two
        sections.
          </para>
        </listitem>
      </varlistentry>
      </variablelist>
    To add a hyperlink to your HTML message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Select the text you want to link from
        </para>
      </listitem>
      <listitem>
        <para>
          Right click on text and select
          <guimenuitem>Link</guimenuitem>
        </para>
      </listitem>
      <listitem>
        <para>
          Enter the address you wish to link to in the
          <guilabel>URL</guilabel> field.
        </para>
      </listitem>
      <listitem>
        <para>
          Press <guibutton>OK</guibutton>.
        </para>
      </listitem>
    </orderedlist>
      </para>
      <para>
    To add an image to your HTML message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Click
          <menuchoice>
        <guimenu>Insert</guimenu>
        <guimenuitem>Image</guimenuitem>
          </menuchoice>
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>Browse</guibutton>
        </para>
      </listitem>
      <listitem>
        <para>
          Select the image you want
        </para>
      </listitem>
      <listitem>
        <para>
          Press <guibutton>OK</guibutton>
        </para>
      </listitem>
      <listitem>
        <para>
          Press <guibutton>Insert</guibutton>
        </para>
      </listitem>
    </orderedlist>

      </para>
      <note>
    <title>A Technical note on HTML Tags</title>
    <para>
      The composer is a <acronym>WYSIWYG</acronym>
      (What You See Is What You Get)
      editor for HTML. That means that if you enter HTML
      directly into the composer&mdash; say, 
      <markup role="html">&lt;B&gt;Bold Text&lt;/B&gt</markup>, the
      the composer will assume you meant exactly that string
      of characters, and not "make this text bold," as an HTML
      composition tool or text editor would.
    </para>
        </note>
      </sect2>

      <sect2 id="usage-mail-getnsend-fwd">
        <title>Forwarding Mail</title>
        <para>
          The post office forwards your mail for you when you change
          addresses, and you can forward a letter if it comes to you by mistake.
          The email <guilabel>Forward</guilabel> button
          works in much the same way.  It's particularly useful if you
          have received a message and you think someone else would
          like to see it.  You can forward a message as an attachment
          to a new message (this is the default) or
          you can send it <glossterm linkend="inline">inline</glossterm> as a quoted
          portion of the message you are sending.  Attachment
          forwarding is best if you want to send the full, unaltered
          message on to someone else.  Inline forwarding is best if
          you want to send portions of a message, or if you have a
          large number of comments on different sections of the
          message you are forwarding.  Remember to note from whom the
          message came, and where, if at all, you have removed or
          altered content.
        </para>
        <para>
          To forward a message you are reading, press
          <guibutton>Forward</guibutton> on the toolbar, or select
          <menuchoice> <guimenu>Message</guimenu>
          <guimenuitem>Forward</guimenuitem> </menuchoice>.  If you
          prefer to forward the message <glossterm linkend="inline">inline</glossterm>
          instead of attached, select <menuchoice>
          <guimenu>Message</guimenu> <guimenuitem>Forward
          Inline</guimenuitem> </menuchoice> from the menu.  Choose an
          addressee as you would when sending a new message; the
          subject will already be entered, but you can alter it.
          Enter your comments on the message in the
          <interface>composition frame</interface>, and press
          <guibutton>Send</guibutton>.
        </para>
      </sect2>

      <sect2 id="usage-mail-getnsend-ettiquette">
        <title>Seven Tips for Email Courtesy</title>
        <para>

          <itemizedlist>

            <listitem>
              <para>
                 Don't send spam or forward chain mail.  If you must,
                 watch out for hoaxes and urban legends, and make sure
                 the message doesn't have multiple layers of
                 greater-than signs, (&gt;) indicating multiple layers
                 of careless in-line forwarding.
              </para>
            </listitem>

            <listitem>
              <para>
                Always begin and close with a salutation. Say "please"
                and "thank you," just like you do in real life. You
                can keep your pleasantries short, but be pleasant!
              </para>
            </listitem>

            <listitem>
              <para>
                ALL CAPS MEANS YOU'RE SHOUTING! Don't write a whole
                message in capital letters.  It hurts people's ears.
              </para>
            </listitem>

            <listitem>
              <para>
               Check your spelling and use complete sentences.
              </para>
            </listitem>

            <listitem>
              <para>
                Don't send nasty emails (flames).  If you get one,
                don't write back.
              </para>
            </listitem>
      
      <listitem>
        <para>
          When you reply or forward, include just enough of
          the previous message to provide context: not too
          much, not too little.
        </para>
      </listitem>

      <listitem>
        <para>
          Don't send <glossterm linkend="spam">spam</glossterm>.
        </para>
      </listitem>
    </itemizedlist>
      </para>
      <para> Happy mailing! </para>
    </sect2>
  </sect1>


    <sect1 id="usage-mail-subscriptions">
      <title>Subscription Management</title>
      <para>
         <application>Evolution</application> lets you handle your
         IMAP and newsgroup subscriptions with the same tool: the
         subscriptions manager.

      <orderedlist numeration="arabic">
    <listitem>
      <para>
        Click on the folder you wish to subscribe to in the
        <guilabel>Store</guilabel> section.
      </para>
    </listitem>
    <listitem>
      <para>
        Click the <guibutton>Subscribe</guibutton> to add it to the
        subscribed list.
      </para>
    </listitem>
    <listitem>
      <para>
        Close the window.
      </para>
    </listitem>

      </orderedlist>
    </para>

  </sect1>

  
<sect1 id="encryption">
    <title>Encryption</title>
    <sect2 id="encryption-whatis">
      <title>What is Encryption?</title>
      <para>
    Encryption is an ancient method of changing readable text to unreadable
    text that dates back to Egyptian times.  Encryption takes the statement
    "Evolution" and turns it into something which cannot be read without help
    through decryption.
    <example>
      <title>Encryption Example</title>
      <para>
        Kevin sends his friend Rachel and email and chooses to encrypt it.
        The email has the following contents:
          Hi Rachel.
          Go banana!
          Kevin
        He tells <application>Evolution</application> to encrypt the
        message.  The computer encrypts the message which now looks like
        @#$23ui7yr87#@!48970fsd.  When the information gets to Rachel,
        she'll decrypt the message and it'll show up in plain text for her
        to read.
      </para>
    </example>
    Encryption can be used in email in two ways: to verify that the sender is
    the real sender, and to hide the message while in transmission.
    <application>Evolution</application> has the capability to do both.  
      </para>
    </sect2>
    <sect2 id="encryption-keygen">
      <title>Generating your PGP key</title>
      <para>
    First, you need to create a PGP key.  To do this, you'll need GPG
    installed.
      </para>
      <tip>
    <title>GPG Versions</title>
    <para>
      This manual covers version 1.0.6 of GPG.  If your version is different,
      this may not be entirely accurate.  You may find out your version number
      by typing in: <command>gpg --version</command>.
    </para>
      </tip>
      <para>
    You can start by typing in: <command>gpg --gen-key</command> at the
    console.  When you are asked about the algorythm to use, select 1.  The next question asks you about key length.
    The longer the key, more stronger it is.  However, the longer the key, the
    longer it takes to generate.  This is your choice.  However, 1024 bits
    (default) should be adequate.  The next question asks you if you want your
    key to expire.  Expiring keys make your key invalid after a certain amount
    of time, so old keys don't float around when they aren't used anymore.  This is the same concept
    as a coupon at a supermarket.  Next, you'll type in your real name, your
    email address, and a comment.  You should not forge this information, as
    it is used later to verify who you are.  Assuming that all your
    information is correct, press "O" to continue.  GPG now asks you for a
    passphrase.  This is a password which you will need to decrypt and encrypt
    messages.  This can be any length, with any characters in it.  It is case
    sensitive, which means that it does know the difference between capital
    letters and lower-case.  Now your key is generated.  It is recommend you
    surf the Internet, read your email, or write a letter in a word
    processor while your key is generated.
      </para>
      <para>
    Once this is completed, you'll be dropped back to the command line.
    Now you can view your key information by typing <command>gpg
      --list-keys</command>.  You should see something similar to this:
    <example id="gpg-list-keys">
      <title>GPG Listing Keys</title>
      <para>
        /home/bob/.gnupg/pubring.gpg
        ----------------------------
        pub 1024D/32j38dk2 2001-06-20 bob &lt;bob@bob.com&gt;
        sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]
      </para>
    </example>
    You'll now need to upload your public key to a keyserver, so that your
    friends can use your key.  You'll need to know the ID of your key, which
    is after the 1024D on the line beginning with pub.  For this example, it
    is 32j38dk2.  You now type in <command>gpg --send-keys --keyserver
      wwwkeys.pgp.net 32j38dk2</command>.  Substitute your key ID for 32j38dk2.
    You will be prompted to type in your password <!-- verify that you need to
    enter your password here --> and your key will be uploaded for your
    friends to download.
    <note id="why-keyserver">
      <title>Why Use a Keyserver?</title>
      <para>
        Keyservers store your public keys for you so that your friends can
        decrypt your messages.  If you choose not to use a keyserver, you
        can manually send your friends your public key.  It is much easier
        though to upload to a keyserver and then let your friends download
        your public key on their own wish. <!-- Bad wording -->
      </para>
    </note>
    <note id="pub-priv">
      <title>Public Key?  Private Key?  Whats the difference?</title>
      <para>
        GPG uses two types of keys: public and private.  The private should
        be given out to no one, ever.  Your private key allows your mail to
        be signed and encrypted and decrypted by anyone who has it.  The
        public key is what you give your friends so that they can decrypt
        your mails.
      </para>
    </note>
      </para>
    </sect2>
    <sect2 id="encrypt-getting-key">
      <title>Retrieving a Friends Key</title>
      <para>
    To encrypt a message to your friends, you'll need to use their public
    key in combination with your private key.
    <application>Evolution</application> does that transparently, but you
    still need to get their key off a keyserver.  To do that, type:
    <command>
      gpg --recv-keys --keyserver wwwkeys.pgp.net keyid
    </command>.  You will need to type in your password, and then their ID
    will automatically be added to your keyring.
      </para>
    </sect2>

    <sect2 id="encrypt-evo-integ">
      <title>Setting up Evolution's Encryption</title>
      <para>
    You'll need to open
    <menuchoice>
      <guimenu>Tools</guimenu>
      <guimenuitem>Mail Settings</guimenuitem>
    </menuchoice>
    Once there, select the account you'd like to associate the key to and click
    the <guibutton>Edit</guibutton> button.  In the
    <guilabel>Security</guilabel> tab is a section labeled <guilabel>Pretty
      Good Privacy</guilabel>.  Enter your key ID and click
    <guibutton>OK</guibutton>.  Your key is now integrated into your identity
    in <application>Evolution</application>.
      </para>
    </sect2>
    <sect2 id="encrypt-sending">
      <title>Sending Encrypted Messages</title>
      <para>
    You can either sign or encrypt a message.  When you sign a message, you verify
    that you were the one who sent it, and that no one is forging your
    identity.  Encrypting a message makes it impossible for someone with
    prying eyes to view it while it's in transmission.
      </para>
    </sect2>
    
    <sect2 id="sign-msg">
      <title>Signing a Message</title>
      <para>
    To sign a message, you simply click
    <menuchoice>
      <guimenu>Security</guimenu>
      <guimenuitem>PGP Sign</guimenuitem>
    </menuchoice>
    .  You will be prompted for your PGP password.  Once you enter it,
    click <guibutton>OK</guibutton> and your message will be signed.
      </para>
    </sect2>
      
      <sect2 id="encrypt-msg">
    <title>Encrypting a Message</title>
    <para>
      Encrypting a message is very similar to signing a message.  You simply
      click the menu item 
      <menuchoice>
        <guimenu>Security</guimenu>
        <guimenuitem>PGP Encrypt</guimenuitem>
      </menuchoice>
    </para>
      </sect2>
      <sect2 id="unencrypting">
    <title>Unencrypting a Recieved Message</title>
    <para>
      Sometimes, a friend will send you a message which is encrypted.  In order
      for you to read it, you need to unencrypt it.
    </para>
    <para>
      When you view the encrypted message, <application>Evolution</application>
      will prompt you for your PGP password.  You type in your PGP password and
      the message is then decrypted.
    </para>
      </sect2>
</sect1>
</chapter>