Pulled organizing stuff, made its own file.

2001-06-30  Kevin Breit  <battery841@mediaone.net>

	* C/usage-mail.sgml: Pulled organizing stuff, made its own file.

svn path=/trunk/; revision=10634

1 files changed, 848 insertions, 0 deletions

diff --git a/doc/C/usage-mail-org.sgml b/doc/C/usage-mail-org.sgml
new file mode 100644
index 0000000000..9a2a775740
--- /dev/null
+++ b/doc/C/usage-mail-org.sgml
@@ -0,0 +1,848 @@
+<chapter id="usage-mail-organize">
+    <title>Organizing and Managing your Email</title>
+    <para>
+      Even if you only get a few email messages a day, you probably
+      want to sort and organize them.  When you get a hundred a day
+      and you want to refer to a message you received six weeks ago,
+      you <emphasis>need</emphasis> to sort and organize them.
+      Fortunately, <application>Evolution</application> has the tools
+      to help you do it.
+    </para>
+
+    <sect1 id="usage-mail-organize-columns">
+      <title>Sorting Mail with Column Headers</title>
+      <para>
+         By default, the message list has columns with the following
+         headings: an envelope icon indicating whether you have read
+         or replied to a message (closed for unread, open for read,
+         and open with an arrow on it to indicate you've sent a
+         reply), an exclamation point indicating priority, and the
+         <guilabel>From</guilabel>, <guilabel>Subject</guilabel>, and
+         <guilabel>Date</guilabel> fields. You can change their order
+         and remove them by dragging and dropping them.  You can add
+         new ones with the <guimenuitem>Field Chooser</guimenuitem>
+         item in the right click menu for the column headings.
+      </para>
+      <para>
+	Right-click on one of the column headers to get a list of
+	options:
+	<variablelist>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Sort Ascending</guimenuitem></term>
+	    <listitem><para>
+		Sorts the messages top to bottom.
+	      </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Sort Descending</guimenuitem></term>
+	    <listitem><para>
+		Sorts the messages bottom to top.
+	      </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Group By this Field</guimenuitem></term>
+	    <listitem><para>
+		Groups messages instead of sorting them. (FIXME: Explain further) 
+	      </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Remove this
+		Column</guimenuitem></term> <listitem><para> Remove
+		this column from the display. You can also remove
+		columns by dragging the header off the list and
+		letting it drop.  </para></listitem>
+	  </varlistentry>
+	  
+	  <varlistentry>
+	    <term><guimenuitem>Field
+		Chooser</guimenuitem></term> <listitem><para> A list
+		of column headers; just drag and drop them into
+		place between two existing headers. A red arrow will
+		appear to show you where you're about to put the
+		column.  </para></listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect1>
+
+    <sect1 id="usage-mail-organize-folders">
+      <title>Getting Organized with Folders</title>
+      <para>
+	<application>Evolution</application> keeps mail, as well as
+	address cards and calendars, in folders.  You start out with a
+	few, like <guilabel>Inbox</guilabel>,
+	<guilabel>Outbox</guilabel>, and <guilabel>Drafts</guilabel>,
+	but you can create as many as you like.  Create new folders by
+	selecting <guisubmenu>New</guisubmenu> and then
+	<guimenuitem>Folder</guimenuitem> from the
+	<guimenu>File</guimenu> menu.
+	<application>Evolution</application> will as you for the name
+	and the type of the folder, and will provide you with a folder
+	tree so you can pick where it goes.
+      </para>
+      <para>
+        When you click <guibutton>OK</guibutton>, your new folder will
+	appear in the <interface>folder view</interface>.  You can
+	then put messages in it by dragging and dropping them, or by
+	using the <guibutton>Move</guibutton> button in the
+	toolbar. If you want to move several messages at once, click
+	on the ones you want to move while holding down the
+	<keycap>CTRL</keycap> key, or use <keycap>Shift</keycap> to
+	select a range of messages.  If you create a filter with the
+	<interface>filter assistant</interface>, you can have mail
+	moved to your folder automatically.
+      </para>
+  </sect1>    
+
+  <sect1 id="usage-mail-organize-search">
+      <title>Searching for Messages</title>
+      <para>
+	Most mail clients can search through your messages for you,
+	but <application>Evolution</application> does it faster. You
+	can search through just the message subjects, just the message
+	body, or both body and subject.
+      </para>
+      <para>
+	To start searching, enter a word or phrase in the text area
+	right below the toolbar, and choose a search type:
+	<variablelist>
+	  <varlistentry>
+	    <term><guilabel>Body or subject contains:</guilabel></term>
+	  <listitem>
+	      <para>
+	        This will search message subjects and the messages
+	        themselves for the word or phrase you've entered in
+	        the search field.
+   	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term> <guilabel>Body contains:</guilabel> </term>
+	    <listitem>
+	      <para>
+	        This will search only in message text, not the subject
+	        lines.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term><guilabel>Subject contains:</guilabel></term>
+	    <listitem>
+	      <para>
+	        This will show you messages where the search text is
+	        in the subject line.  It will not search in the
+	        message body.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term><guilabel>Body does not contain:</guilabel></term>
+	    <listitem>
+	      <para>
+	        This finds every email message that does not have the
+	        search text in the message body.  It will still show
+	        messages that have the search text in the subject
+	        line, if it is not also in the body.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term><guilabel>Subject does not contain:</guilabel></term>
+	    <listitem>
+	      <para>
+	        This finds every mail whose subject does not contain
+	        the search text.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	</variablelist>
+
+        When you've entered your search phrase, press
+        <keycap>Enter</keycap>.  <application>Evolution</application>
+        will show your search results in the message list.
+      </para>
+
+      <para>
+         If you think you'll want to return to a search again, you can
+         save it as a virtual folder by selecting <guilabel>Store
+         Search as Virtual Folder</guilabel>.
+      </para>
+
+      <para>
+         When you're done with the search, go back to seeing all your
+         messages by choosing <guimenuitem>Show All</guimenuitem> from
+         the <guilabel>Search</guilabel> drop-down box. If you're
+         sneaky, just enter a blank search: since every message has at
+         least one space in it, you'll see every message in the
+         folder.
+      </para>
+
+      <para>
+        If you'd like to perform a more complex search, open the
+        advanced search dialog by selecting
+        <guilabel>Advanced...</guilabel> from the
+        <guilabel>Search</guilabel> drop-down menu.  Then, create your
+        search criteria (each with the same options you saw in the
+        regular search bar), and decide whether you want to find
+        messages that match all of them, or messages that match even
+        one. Then, click <guibutton>Search</guibutton> to go and find
+        those messages.
+     </para>
+
+     <para>
+        You'll see a similar approach to sorting messages when you
+        create filters and virtual folders in the next few sections.
+     </para>
+
+    </sect1>
+
+    <sect1 id="usage-mail-organize-filters">
+      <title>Staying organized: Mail Filters in Evolution</title>
+      <para>
+	Filters work very much like the mail room in a large company.
+	Their purpose is to bundle, sort, and distribute mail to the
+	various folders.  
+        In addition, you can have multiple filters performing multiple
+        actions that may effect the same message in several ways.  For
+        example, your filters could put copies of one message into
+        multiple folders, or keep a copy and send one to another
+        person as well, and it can do that in under a second. Which is
+        to say, it's faster and more flexible than an actual person
+        with a pile of envelopes.
+      </para>
+      <para>
+        Most often, you'll want to have
+        <application>Evolution</application> put mail into different
+        folders, but you can have it do almost anything you like.
+        People who get lots of mail, or who often need to refer to old
+        messages, find filters especially helpful, but they can greatly benefit
+        anybody who gets more than a few messages a day.  To
+        create a filter, open the <interface>filter
+        assistant</interface> by selecting
+	<menuchoice>
+	  <guimenu>Settings</guimenu> 
+          <guimenuitem>Mail Filters</guimenuitem>
+        </menuchoice>.
+      </para>
+            
+       <figure id="usage-mail-filters-fig-assist">
+	 <title>The Filter Assistant</title>
+	 <screenshot>
+	  <screeninfo>The Filter Assistant</screeninfo>
+	  <graphic fileref="fig/filter-assist-fig" format="png" srccredit="Aaron Weber">
+	</graphic>
+	</screenshot>
+      </figure>
+
+      <para>
+        The <interface>filter assistant</interface> window contains a
+        list of your current filters, sorted by the order in which
+        they are used.  From the drop-down box at the top of the
+        window, choose <guilabel>Incoming</guilabel> to display
+        filters for incoming mail, and <guilabel>Outgoing</guilabel>
+        for those which sort only outgoing mail.
+      </para>
+      <para>
+         The <interface>filter assistant</interface> also has a set of
+         buttons:
+        <itemizedlist>
+
+           <listitem><para>
+            <guibutton>Add</guibutton> &mdash; Create a new filter.
+           </para></listitem>
+
+           <listitem><para>
+            <guibutton>Edit</guibutton> &mdash; Edit an existing filter.
+           </para></listitem>
+
+           <listitem><para>
+            <guibutton>Delete</guibutton> &mdash; Delete the selected filter.
+           </para></listitem>
+
+           <listitem><para> <guibutton>Up</guibutton> &mdash; Move the
+            selected filter up in the list so it gets applied first.
+           </para></listitem>
+
+           <listitem><para>
+            <guibutton>Down</guibutton> &mdash;  Move the selected filter down 
+             in the list, so it comes into play later.
+           </para></listitem>
+        </itemizedlist>
+
+        If you don't have any filters set up, the only one of those
+        buttons you can click is <guibutton>Add</guibutton>, which
+        will open a dialog to let you add a filter rule.  If you do
+        have filters, you can either add a new filter rule, or select
+        one from your list and click <guibutton>Edit</guibutton>.
+      </para>
+      <para>
+        The filter rule editor, shown in <xref
+        linkend="usage-mail-filters-fig-new">, is where you'll
+        actually create your filtering rule.
+
+       <figure id="usage-mail-filters-fig-new">
+	 <title>Creating a new Filter</title>
+	 <screenshot>
+	  <screeninfo>Creating a new Filter</screeninfo>
+	  <graphic fileref="fig/filter-new-fig" format="png" srccredit="Aaron Weber">
+	</graphic>
+	</screenshot>
+      </figure>
+      </para>
+      <para>
+        Enter a name for your filter in the <guilabel>Rule
+        Name</guilabel> field, and then begin choosing the criteria
+        you'd like to use as you sort your mail.  Choose how many
+        criteria you'd like by pressing <guibutton>Add
+        Criterion</guibutton> and <guibutton>Remove
+        Criterion</guibutton>.  If you have multiple criteria, you
+        should then decide whether to have the filter do its job only
+        <guilabel>if all criteria are met</guilabel>, or <guilabel>if
+        any criteria are met</guilabel>.
+     </para>
+
+     <para>
+        For each filter criterion, you must first select 
+        which of the following parts of the message you want the filter to 
+	examine:
+        <variablelist>
+	  <varlistentry>
+	    <term><guilabel>Sender</guilabel></term>
+	    <listitem><para>
+                The sender's address.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Recipients</guilabel></term>
+	    <listitem><para>
+               The recipients of the message.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Subject</guilabel></term>
+	    <listitem><para>
+                The subject line of the message.
+            </para></listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guilabel>Specific Header</guilabel></term>
+	    <listitem><para>
+              The filter can look at any header you
+	      want, even obscure or custom ones. Enter the header name
+	      in the first text box, and put your search text in the
+	      second one.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Message Body</guilabel></term>
+	    <listitem><para>
+                Search in the actual text of the message.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Expression</guilabel></term>
+	    <listitem>
+             <para>
+               For programmers only: match a message according to an
+               expression you write in the Scheme language, used to
+               define filters in Evolution.
+	     </para>
+           </listitem>
+	  </varlistentry>
+
+
+	  <varlistentry>
+	    <term><guilabel>Date Sent</guilabel></term>
+	    <listitem><para> Filter messages according to the date on
+	    which they were sent: First, choose the conditions you
+	    want a message to meet &mdash; <guilabel>before</guilabel>
+	    a given time, <guilabel>after</guilabel> it, and so forth.
+	    Then, choose the time. The filter will compare the
+	    message's time-stamp to the system clock when the filter
+	    is run, or to a specific time and date you choose from a
+	    calendar.  You can even have it look for messages within a
+	    range of time relative to the filter &mdash perhaps you're
+	    looking for messages less than two days old.
+          </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Date Recieved</guilabel></term>
+	    <listitem><para>
+                This works the same way as the <guilabel>Date Sent</guilabel> 
+                option, except that it compares the time you got the message 
+                with the dates you specify.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Priority</guilabel></term>
+	    <listitem><para>
+               Emails have a standard priority range from -3 (least
+               important) to 3 (most important). You can have filters set the
+               priority of messages you recieve, and then have other filters 
+               applied only to those messages which have a certain priority.
+            </para></listitem>
+           </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Regex Match</guilabel></term>
+	    <listitem>
+              <para>
+                If you know your way around a <glossterm
+  	        linkend="regular-expression">regex</glossterm>, or
+  	        regular expression, put your knowledge to use here.
+  	       </para>
+            </listitem>
+          </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Source</guilabel></term>
+	    <listitem>
+               <para>
+               Filter messages according the server you got them from.
+               You can enter a URL or choose one from the drop-down
+               list.  This ability is only relevant if you use more
+               than one mail source.
+             </para>
+            </listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+
+      <para>
+        Now, tell it what to do with those messages.  If you want more
+        actions, click <guibutton>Add Action</guibutton>; if you want
+        fewer, click <guibutton>Remove Action</guibutton>.  And choose
+        again:
+
+        <variablelist>
+	  <varlistentry>
+	    <term><guilabel>Copy to Folder</guilabel></term>
+	    <listitem><para>
+               If you select this item, <application>Evolution</application>
+               will put the messages into a folder you specify.  Click the 
+               <guibutton>&lt;click here to select a folder&gt;</guibutton> button
+               to select a folder. 
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Move to Folder</guilabel></term>
+	    <listitem><para>
+               If you select this item, <application>Evolution</application>
+               will put the messages into a folder you specify.  Click the 
+               <guibutton>&lt;click here to select a folder&gt;</guibutton> button
+               to select a folder. 
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Forward to Address</guilabel></term>
+	    <listitem><para>
+                Select this, enter an address, and the addressee will
+                get a copy of the message.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Delete</guilabel></term>
+	    <listitem><para>
+                Marks the message for deletion.  You can still get the message
+                back, at least until you <guimenuitem>Expunge</guimenuitem> your
+                mail yourself.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Stop Processing</guilabel></term>
+	    <listitem><para>
+              Select this if you want to tell all other filters to ignore 
+              this message, because whatever you've done with it so far
+              is plenty.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Assign Color</guilabel></term>
+	    <listitem><para>
+                Select this item, and <application>Evolution</application>
+                will mark the message with whatever color you please.
+            </para></listitem>
+	  </varlistentry>
+
+	  <varlistentry>
+	    <term><guilabel>Assign Score</guilabel></term>
+	    <listitem><para> If you know that all mail with
+	    "important" somewhere in the message body line is
+	    important, you can give it a high priority score. In a subsequent filter you can 
+            then arrange your messages by their priority score.
+	  </para></listitem>
+	  </varlistentry>
+
+	</variablelist>
+      </para>
+      <para>
+        You're done.  Click <guibutton>OK</guibutton> to use this
+        filter, or <guibutton>Cancel</guibutton> to close the window
+        without saving any changes.
+      </para>
+
+
+
+   <!-- FIXME: This needs to be in there.  But the feature is temporarily
+         disabled and I don't know how it will be reimplemented.
+
+	  <itemizedlist>
+	    <listitem>
+	       <para>
+		 <guilabel>When mail arrives:</guilabel> Select
+		 this option to have messages filtered as they
+		 arrive.
+	       </para>
+	     </listitem>
+	     <listitem>
+	       <para>
+		 <guilabel>When mail is sent:</guilabel> Select
+		 this option to filter your outgoing mail.  You
+		 can use this feature to keep your
+		 <interface>Outbox</interface> as organized as
+		 your <interface>Inbox</interface>.
+	     </para>
+	  </listitem>
+	</itemizedlist>
+      </para>
+
+    -->
+
+    <note>
+      <title>Notable Filter Features</title>
+      <para>
+	<itemizedlist>
+	  <listitem><para>
+	      Incoming email that your filters don't move goes into the Inbox; 
+	      outgoing mail that they don't move ends up in the Sent folder.
+	    </para>
+	  </listitem>
+	</itemizedlist>
+      </para>
+    </note>
+  </sect1>
+  <sect1 id="usage-mail-organize-filters-mailing-lists">
+    <title>Filtering by Mailing List</title>
+      <para>
+	  You can tell <application>Evolution</application> to filter by
+	  mailing list.  This means that <application>Evolution</application>
+	  will look at the mailing list address, and find out automatically
+	  what list this is.  If you are subscribed to mailing lists, you
+	  should use the <guibutton>Filter by List</guibutton> instead of by
+	  sender.
+	  <example>
+	    <title>Filter by List</title>
+	    <para>
+	      Kevin subscribes to bananas@ximian.com.  However, there is also
+	      a bananas@ximian.org address.  If he used a regular
+	      <guibutton>Filter by Sender</guibutton>, he would need to specify
+	      one for each address.  However, <guibutton>Filter by
+	      List</guibutton> will recognize that both of them are the same
+	      list.
+	    </para>
+	  </example>
+	</para>
+      </sect1>
+      
+      
+    <sect1 id="usage-mail-organize-vFolders">
+      <title>Getting Really Organized with Virtual Folders</title>
+      <para>
+	If filters aren't flexible enough for you, or you find
+	yourself performing the same search again and again, consider
+	a virtual folder. Virtual folders, or vFolders, are an
+	advanced way of viewing your email messages within
+	<application>Evolution</application>.  If you get a lot of
+	mail or often forget where you put messages, virtual folders can help
+	you stay on top of things.
+      </para>
+      <para>
+	A virtual folder is really a hybrid of all the other organizational
+	tools: it looks like a folder, it acts like a search, and you
+	set it up like a filter.  In other words, while a conventional
+	folder actually contains messages, a virtual folder is a view of
+	messages that may be in several different folders.  The
+	messages it contains are determined on the fly using a set of
+	criteria you choose in advance.
+      </para>
+
+      <para>
+	As messages that meet the virtual folder criteria arrive or are
+	deleted, <application>Evolution</application> will
+	automatically place them in and remove them from the
+	virtual folder contents list.  When you delete a message, it gets
+	erased from the folder in which it actually exists, as well as
+	any virtual folders which display it.
+      </para>
+
+      <para>
+	Imagine a business trying to keep track of mail from hundreds
+	of vendors and clients, or a university with overlapping and
+	changing groups of faculty, staff, administrators and
+	students.  The more mail you need to organize, the less you
+	can afford the sort of confusion that stems from an
+	organizational system that's not flexible enough.  Virtual folders
+	make for better organization because they can accept
+	overlapping groups in a way that regular folders and filing
+	systems can't.
+      </para>
+
+      <example id="usage-mail-organize-vFolders-ex">
+	<title>Using Folders, Searches, and Virtual Folders</title>
+	<para>
+	   To organize my mail box, I set up a virtual folder for
+	   emails from my friend and co-worker Anna.  I have another
+	   one for messages that have "ximian.com" in the address and
+	   "Evolution" in the subject line, so I can keep a record of
+	   what people from work send me about
+	   <application>Evolution</application>.  If Anna sends me a
+	   message about anything other than Evolution, it only shows
+	   up in the "Anna" folder. When Anna sends me mail about the
+	   user interface for <application>Evolution</application>, I
+	   can see that message both in the "Anna" virtual folder and
+	   in the "Internal Evolution Discussion" virtual folder.
+	</para>
+      </example>
+
+	<!--  (INSERT SCREENSHOT HERE: virtual folders in action) -->
+
+      <para>
+	 To create a virtual folder, select <menuchoice>
+	 <guimenu>Settings</guimenu> <guimenuitem>Virtual Folder
+	 Editor</guimenuitem> </menuchoice>.  This will bring up a
+	 dialog box that looks suspiciously like the filter window
+	 (for more information on filters, see <xref
+	 linkend="usage-mail-organize-filters">), and which
+	 presents you with a list of virtual folders you have previously
+	 created. If you have created any virtual folders, they are listed
+	 here, and you can select, edit or remove them if you wish.
+	 If you have not created any, there will be only one available
+	 option: click <guibutton>Add</guibutton> to add a new
+	 Virtual Folder.
+      </para>
+      <para>
+	 You can enter a name for your virtual folder in the
+	 <guilabel>Name</guilabel>.  Then, tell
+	 <application>Evolution</application> what messages to look
+	 for.  This process is exactly like filter creation: decide
+	 between <guilabel>Match all parts</guilabel> and
+	 <guilabel>Match any part</guilabel>, then choose what part of
+	 the message to look in, what sort of matching to perform, and
+	 specify exactly what it is that you want to find, be it a
+	 line of text, a score, a regular expression, or a particular date or
+	 range of dates.
+       </para>
+       <para>
+         The second part, however, is slightly different.  In the
+         section of the window labelled <guilabel>Virtual Folder Sources
+         </guilabel> is a list of folders in which
+         <application>Evolution</application> will search for the
+         contents of your vFolder.  Click <guibutton>Add</guibutton>
+         to add a folder, or <guibutton>Remove</guibutton> to remove
+         one.  That way, you can have your vFolder search in
+         newsgroups, or just in one of your mailboxes, or just in a
+         select few folders you've already screened with filters.
+       </para>
+       <para>
+        The vFolder creation window is shown in <xref
+	linkend="usage-mail-vfolder-fig-createrule">
+
+       <figure id="usage-mail-vfolder-fig-createrule">
+	 <title>Selecting a vFolder Rule</title>
+	 <screenshot>
+	  <screeninfo>Creating a vFolder Rule</screeninfo>
+	  <graphic fileref="fig/vfolder-createrule-fig" format="png" srccredit="Aaron Weber">
+	</graphic>
+	</screenshot>
+      </figure>
+      </para>
+    </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.  To start using it, choose
+         <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Manage
+         Subscriptions</guimenuitem> </menuchoice>.
+      </para>
+      <para>
+         If you have configured any IMAP (mail) or NNTP (news)
+         servers, you will see them listed in the left half of the
+         subscription management window.  Click on a server to select
+         it, and you will see the folders or newsgroups available to
+         you.  You can then select individual folders and subscribe to
+         them, or remove yourself from the subscription list.
+      </para>
+      <para>
+        Once you have subscribed to a folder or newsgroup, your system
+        will check for new messages whenever you press the
+        <guibutton>Get Mail</guibutton> button.
+      </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 orders an <application>Evolution</application> t-shirt from
+	    Ximian, Inc. over the internet.  He puts in his credit card number
+	    which is 1234-567-8901.  For security, his computer encrypts the
+	    credit card number so it can be safely transmitted over the internet.
+	    The number now is @#$23ui7yr87#@!48970fsd, which holds no intentional
+	    resemblance to the inital number.  When the information gets to
+	    Ximian, Inc. it'll be decrypted into the inital number.
+	  </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
+	first question, 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 active.  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.  This help creates randomness in the key.
+      </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.
+      </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
+	  Goog 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, 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 tranmission.
+      </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>