All sgml files replaced with xml files. XML files validated. Two new XML

2002-11-04  Aaron Weber  <aaron@ximian.com>

	* C/*.sgml: All sgml files replaced with xml files. XML files
	validated. Two new XML files added: apx-fdl.xml and legal.xml

	* C/evolution-C.omf: Altered to fit the GDP template. This may now
	work with the GNOME 2.0 DTD, although I could be wrong.

	* sgmldocs.make: removed and replaced with xmldocs.make. This will
	break all translations until they are also ported to XML. I will
	probably begin doing that tomorrow, since it's just markup and not
	language stuff.

	* C/Makefile.am: added two files to the list. Does this
	Makefile get included in another, somewhere, or is it just
	detected?

svn path=/trunk/; revision=18538

24 files changed, 3246 insertions, 2503 deletions

diff --git a/help/C/Makefile.am b/help/C/Makefile.am
index 8b75954a13..dcd4722512 100644
--- a/help/C/Makefile.am
+++ b/help/C/Makefile.am
@@ -29,26 +29,28 @@ figs = \
 	figures/small_desktop.png		\
 	figures/summary.png			\
 	figures/vfolder-createrule-fig.png
-
+figdir = figures
 docname = evolution
 lang = C
 omffile = evolution-C.omf
-sgml_ents =	\
-	apx-authors.sgml	\
-	apx-bugs.sgml		\
-	apx-gloss.sgml		\
-	config-prefs.sgml	\
-	config-sync.sgml	\
-	menuref.sgml		\
-	preface.sgml		\
-	usage-calendar.sgml	\
-	usage-contact.sgml	\
-	usage-exec-summary.sgml	\
-	usage-exchange.sgml	\
-	usage-mail-org.sgml	\
-	usage-mail.sgml		\
-	usage-mainwindow.sgml	\
-	usage-print.sgml	\
-	usage-sync.sgml
-include $(top_srcdir)/help/sgmldocs.make
+entities =	\
+	apx-authors.xml	\
+	apx-bugs.xml		\
+	apx-gloss.xml		\
+	config-prefs.xml	\
+	config-sync.xml	\
+	menuref.xml		\
+	preface.xml		\
+	usage-calendar.xml	\
+	usage-contact.xml	\
+	usage-exec-summary.xml	\
+	usage-exchange.xml	\
+	usage-mail-org.xml	\
+	usage-mail.xml		\
+	usage-mainwindow.xml	\
+	usage-print.xml		\
+	usage-sync.xml		\
+	legal.xml		\
+	apx-fdl.xml		\
+include $(top_srcdir)/help/xmldocs.make
 dist-hook: app-dist-hook
diff --git a/help/C/apx-authors.sgml b/help/C/apx-authors.xml
index 0b0944b97d..0b0944b97d 100644
--- a/help/C/apx-authors.sgml
+++ b/help/C/apx-authors.xml
diff --git a/help/C/apx-bugs.sgml b/help/C/apx-bugs.xml
index 686305fbce..686305fbce 100644
--- a/help/C/apx-bugs.sgml
+++ b/help/C/apx-bugs.xml
diff --git a/help/C/apx-fdl.xml b/help/C/apx-fdl.xml
new file mode 100644
index 0000000000..4af2a495fa
--- /dev/null
+++ b/help/C/apx-fdl.xml
@@ -0,0 +1,667 @@
+<!--  
+     The GNU Free Documentation License 1.1 in DocBook
+     Markup by Eric Baudais <baudais@okstate.edu>
+     Maintained by the GNOME Documentation Project
+     http://developer.gnome.org/projects/gdp
+     Version: 1.0.1
+     Last Modified: Nov 16, 2000
+-->
+
+<appendix id="apx-fdl">
+  <appendixinfo>
+    <releaseinfo>
+      Version 1.1, March 2000
+    </releaseinfo>
+    <copyright>
+      <year>2000</year><holder>Free Software Foundation, Inc.</holder>
+    </copyright>
+    <legalnotice id="fdl-legalnotice">
+      <para>
+	<address>Free Software Foundation, Inc. <street>59 Temple Place, 
+        Suite 330</street>, <city>Boston</city>, <state>MA</state>  
+        <postcode>02111-1307</postcode>  <country>USA</country></address> 
+	Everyone is permitted to copy and distribute verbatim copies of this 
+        license document, but changing it is not allowed.
+      </para>
+    </legalnotice>
+  </appendixinfo>
+  <title>GNU Free Documentation License</title>
+
+  <sect1 id="fdl-preamble">
+    <title>0. PREAMBLE</title>
+    <para>
+      The purpose of this License is to make a manual, textbook, or
+      other written document <quote>free</quote> in the sense of
+      freedom: to assure everyone the effective freedom to copy and
+      redistribute it, with or without modifying it, either
+      commercially or noncommercially. Secondarily, this License
+      preserves for the author and publisher a way to get credit for
+      their work, while not being considered responsible for
+      modifications made by others.
+    </para>
+    
+    <para>
+      This License is a kind of <quote>copyleft</quote>, which means
+      that derivative works of the document must themselves be free in
+      the same sense. It complements the GNU General Public License,
+      which is a copyleft license designed for free software.
+    </para>
+    
+    <para>
+      We have designed this License in order to use it for manuals for
+      free software, because free software needs free documentation: a
+      free program should come with manuals providing the same
+      freedoms that the software does. But this License is not limited
+      to software manuals; it can be used for any textual work,
+      regardless of subject matter or whether it is published as a
+      printed book. We recommend this License principally for works
+      whose purpose is instruction or reference.
+    </para>
+  </sect1>
+  <sect1 id="fdl-section1">
+    <title>1. APPLICABILITY AND DEFINITIONS</title>
+    <para id="fdl-document">
+      This License applies to any manual or other work that contains a
+      notice placed by the copyright holder saying it can be
+      distributed under the terms of this License. The
+      <quote>Document</quote>, below, refers to any such manual or
+      work. Any member of the public is a licensee, and is addressed
+      as <quote>you</quote>.
+    </para>
+    
+    <para id="fdl-modified">
+      A <quote>Modified Version</quote> of the Document means any work
+      containing the Document or a portion of it, either copied
+      verbatim, or with modifications and/or translated into another
+      language.
+    </para>
+	
+    <para id="fdl-secondary">
+      A <quote>Secondary Section</quote> is a named appendix or a
+      front-matter section of the <link
+      linkend="fdl-document">Document</link> that deals exclusively
+      with the relationship of the publishers or authors of the
+      Document to the Document's overall subject (or to related
+      matters) and contains nothing that could fall directly within
+      that overall subject. (For example, if the Document is in part a
+      textbook of mathematics, a Secondary Section may not explain any
+      mathematics.)  The relationship could be a matter of historical
+      connection with the subject or with related matters, or of
+      legal, commercial, philosophical, ethical or political position
+      regarding them.
+    </para>
+
+    <para id="fdl-invariant">
+      The <quote>Invariant Sections</quote> are certain <link
+      linkend="fdl-secondary"> Secondary Sections</link> whose titles
+      are designated, as being those of Invariant Sections, in the
+      notice that says that the <link
+      linkend="fdl-document">Document</link> is released under this
+      License.
+    </para>
+    
+    <para id="fdl-cover-texts">
+      The <quote>Cover Texts</quote> are certain short passages of
+      text that are listed, as Front-Cover Texts or Back-Cover Texts,
+      in the notice that says that the <link
+      linkend="fdl-document">Document</link> is released under this
+      License.
+    </para>
+	
+    <para id="fdl-transparent">
+      A <quote>Transparent</quote> copy of the <link
+      linkend="fdl-document"> Document</link> means a machine-readable
+      copy, represented in a format whose specification is available
+      to the general public, whose contents can be viewed and edited
+      directly and straightforwardly with generic text editors or (for
+      images composed of pixels) generic paint programs or (for
+      drawings) some widely available drawing editor, and that is
+      suitable for input to text formatters or for automatic
+      translation to a variety of formats suitable for input to text
+      formatters. A copy made in an otherwise Transparent file format
+      whose markup has been designed to thwart or discourage
+      subsequent modification by readers is not Transparent.  A copy
+      that is not <quote>Transparent</quote> is called
+      <quote>Opaque</quote>.
+    </para>
+    
+    <para>
+      Examples of suitable formats for Transparent copies include
+      plain ASCII without markup, Texinfo input format, LaTeX input
+      format, SGML or XML using a publicly available DTD, and
+      standard-conforming simple HTML designed for human
+      modification. Opaque formats include PostScript, PDF,
+      proprietary formats that can be read and edited only by
+      proprietary word processors, SGML or XML for which the DTD
+      and/or processing tools are not generally available, and the
+      machine-generated HTML produced by some word processors for
+      output purposes only.
+    </para>
+    
+    <para id="fdl-title-page">
+      The <quote>Title Page</quote> means, for a printed book, the
+      title page itself, plus such following pages as are needed to
+      hold, legibly, the material this License requires to appear in
+      the title page. For works in formats which do not have any title
+      page as such, <quote>Title Page</quote> means the text near the
+      most prominent appearance of the work's title, preceding the
+      beginning of the body of the text.
+    </para>
+  </sect1>
+    
+  <sect1 id="fdl-section2">
+    <title>2. VERBATIM COPYING</title>
+    <para>
+      You may copy and distribute the <link
+      linkend="fdl-document">Document</link> in any medium, either
+      commercially or noncommercially, provided that this License, the
+      copyright notices, and the license notice saying this License
+      applies to the Document are reproduced in all copies, and that
+      you add no other conditions whatsoever to those of this
+      License. You may not use technical measures to obstruct or
+      control the reading or further copying of the copies you make or
+      distribute. However, you may accept compensation in exchange for
+      copies. If you distribute a large enough number of copies you
+      must also follow the conditions in <link
+      linkend="fdl-section3">section 3</link>.
+    </para>
+    
+    <para>
+      You may also lend copies, under the same conditions stated
+      above, and you may publicly display copies.
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section3">
+    <title>3. COPYING IN QUANTITY</title>
+    <para>
+      If you publish printed copies of the <link
+      linkend="fdl-document">Document</link> numbering more than 100,
+      and the Document's license notice requires <link
+      linkend="fdl-cover-texts">Cover Texts</link>, you must enclose
+      the copies in covers that carry, clearly and legibly, all these
+      Cover Texts: Front-Cover Texts on the front cover, and
+      Back-Cover Texts on the back cover. Both covers must also
+      clearly and legibly identify you as the publisher of these
+      copies. The front cover must present the full title with all
+      words of the title equally prominent and visible. You may add
+      other material on the covers in addition. Copying with changes
+      limited to the covers, as long as they preserve the title of the
+      <link linkend="fdl-document">Document</link> and satisfy these
+      conditions, can be treated as verbatim copying in other
+      respects.
+    </para>
+    
+    <para>
+      If the required texts for either cover are too voluminous to fit
+      legibly, you should put the first ones listed (as many as fit
+      reasonably) on the actual cover, and continue the rest onto
+      adjacent pages.
+    </para>
+    
+    <para>
+      If you publish or distribute <link
+      linkend="fdl-transparent">Opaque</link> copies of the <link
+      linkend="fdl-document">Document</link> numbering more than 100,
+      you must either include a machine-readable <link
+      linkend="fdl-transparent">Transparent</link> copy along with
+      each Opaque copy, or state in or with each Opaque copy a
+      publicly-accessible computer-network location containing a
+      complete Transparent copy of the Document, free of added
+      material, which the general network-using public has access to
+      download anonymously at no charge using public-standard network
+      protocols. If you use the latter option, you must take
+      reasonably prudent steps, when you begin distribution of Opaque
+      copies in quantity, to ensure that this Transparent copy will
+      remain thus accessible at the stated location until at least one
+      year after the last time you distribute an Opaque copy (directly
+      or through your agents or retailers) of that edition to the
+      public.
+    </para>
+    
+    <para>
+      It is requested, but not required, that you contact the authors
+      of the <link linkend="fdl-document">Document</link> well before
+      redistributing any large number of copies, to give them a chance
+      to provide you with an updated version of the Document.
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section4">
+    <title>4. MODIFICATIONS</title>
+    <para>
+      You may copy and distribute a <link
+      linkend="fdl-modified">Modified Version</link> of the <link
+      linkend="fdl-document">Document</link> under the conditions of
+      sections <link linkend="fdl-section2">2</link> and <link
+      linkend="fdl-section3">3</link> above, provided that you release
+      the Modified Version under precisely this License, with the
+      Modified Version filling the role of the Document, thus
+      licensing distribution and modification of the Modified Version
+      to whoever possesses a copy of it. In addition, you must do
+      these things in the Modified Version:
+    </para>
+    
+    <itemizedlist mark="opencircle">
+      <listitem>
+	<formalpara>
+	  <title>A</title>
+	  <para>
+	    Use in the <link linkend="fdl-title-page">Title
+	    Page</link> (and on the covers, if any) a title distinct
+	    from that of the <link
+	    linkend="fdl-document">Document</link>, and from those of
+	    previous versions (which should, if there were any, be
+	    listed in the History section of the Document). You may
+	    use the same title as a previous version if the original
+	    publisher of that version gives permission.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>B</title>
+	  <para>
+	    List on the <link linkend="fdl-title-page">Title
+	    Page</link>, as authors, one or more persons or entities
+	    responsible for authorship of the modifications in the
+	    <link linkend="fdl-modified">Modified Version</link>,
+	    together with at least five of the principal authors of
+	    the <link linkend="fdl-document">Document</link> (all of
+	    its principal authors, if it has less than five).
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>C</title>
+	  <para>
+	    State on the <link linkend="fdl-title-page">Title
+	    Page</link> the name of the publisher of the <link
+	    linkend="fdl-modified">Modified Version</link>, as the
+	    publisher.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>D</title>
+	  <para>
+	    Preserve all the copyright notices of the <link
+	    linkend="fdl-document">Document</link>.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>E</title>
+	  <para>
+	    Add an appropriate copyright notice for your modifications
+	    adjacent to the other copyright notices.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>F</title>
+	  <para>
+	    Include, immediately after the copyright notices, a
+	    license notice giving the public permission to use the
+	    <link linkend="fdl-modified">Modified Version</link> under
+	    the terms of this License, in the form shown in the
+	    Addendum below.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>G</title>
+	  <para>
+	    Preserve in that license notice the full lists of <link
+	    linkend="fdl-invariant"> Invariant Sections</link> and
+	    required <link linkend="fdl-cover-texts">Cover
+	    Texts</link> given in the <link
+	    linkend="fdl-document">Document's</link> license notice.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>H</title>
+	  <para>
+	    Include an unaltered copy of this License.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>I</title>
+	  <para>
+	    Preserve the section entitled <quote>History</quote>, and
+	    its title, and add to it an item stating at least the
+	    title, year, new authors, and publisher of the <link
+	    linkend="fdl-modified">Modified Version </link>as given on
+	    the <link linkend="fdl-title-page">Title Page</link>.  If
+	    there is no section entitled <quote>History</quote> in the
+	    <link linkend="fdl-document">Document</link>, create one
+	    stating the title, year, authors, and publisher of the
+	    Document as given on its Title Page, then add an item
+	    describing the Modified Version as stated in the previous
+	    sentence.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>J</title>
+	  <para>
+	    Preserve the network location, if any, given in the <link
+	    linkend="fdl-document">Document</link> for public access
+	    to a <link linkend="fdl-transparent">Transparent</link>
+	    copy of the Document, and likewise the network locations
+	    given in the Document for previous versions it was based
+	    on. These may be placed in the <quote>History</quote>
+	    section.  You may omit a network location for a work that
+	    was published at least four years before the Document
+	    itself, or if the original publisher of the version it
+	    refers to gives permission.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>K</title>
+	  <para>
+	    In any section entitled <quote>Acknowledgements</quote> or
+	    <quote>Dedications</quote>, preserve the section's title,
+	    and preserve in the section all the substance and tone of
+	    each of the contributor acknowledgements and/or
+	    dedications given therein.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>L</title>
+	  <para>
+	    Preserve all the <link linkend="fdl-invariant">Invariant
+	    Sections</link> of the <link
+	    linkend="fdl-document">Document</link>, unaltered in their
+	    text and in their titles.  Section numbers or the
+	    equivalent are not considered part of the section titles.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>M</title>
+	  <para>
+	    Delete any section entitled
+	    <quote>Endorsements</quote>. Such a section may not be
+	    included in the <link linkend="fdl-modified">Modified
+	    Version</link>.
+	  </para>
+	</formalpara>
+      </listitem>
+      
+      <listitem>
+	<formalpara>
+	  <title>N</title>
+	  <para>
+	    Do not retitle any existing section as
+	    <quote>Endorsements</quote> or to conflict in title with
+	    any <link linkend="fdl-invariant">Invariant
+	    Section</link>.
+	  </para>
+	</formalpara>
+      </listitem>
+    </itemizedlist>
+    
+    <para>
+      If the <link linkend="fdl-modified">Modified Version</link>
+      includes new front-matter sections or appendices that qualify as
+      <link linkend="fdl-secondary">Secondary Sections</link> and
+      contain no material copied from the Document, you may at your
+      option designate some or all of these sections as invariant. To
+      do this, add their titles to the list of <link
+      linkend="fdl-invariant">Invariant Sections</link> in the
+      Modified Version's license notice.  These titles must be
+      distinct from any other section titles.
+    </para>
+    
+    <para>
+      You may add a section entitled <quote>Endorsements</quote>,
+      provided it contains nothing but endorsements of your <link
+      linkend="fdl-modified">Modified Version</link> by various
+      parties--for example, statements of peer review or that the text
+      has been approved by an organization as the authoritative
+      definition of a standard.
+    </para>
+    
+    <para>
+      You may add a passage of up to five words as a <link
+      linkend="fdl-cover-texts">Front-Cover Text</link>, and a passage
+      of up to 25 words as a <link
+      linkend="fdl-cover-texts">Back-Cover Text</link>, to the end of
+      the list of <link linkend="fdl-cover-texts">Cover Texts</link>
+      in the <link linkend="fdl-modified">Modified Version</link>.
+      Only one passage of Front-Cover Text and one of Back-Cover Text
+      may be added by (or through arrangements made by) any one
+      entity. If the <link linkend="fdl-document">Document</link>
+      already includes a cover text for the same cover, previously
+      added by you or by arrangement made by the same entity you are
+      acting on behalf of, you may not add another; but you may
+      replace the old one, on explicit permission from the previous
+      publisher that added the old one.
+    </para>
+    
+    <para>
+      The author(s) and publisher(s) of the <link
+      linkend="fdl-document">Document</link> do not by this License
+      give permission to use their names for publicity for or to
+      assert or imply endorsement of any <link
+      linkend="fdl-modified">Modified Version </link>.
+    </para>
+  </sect1>
+    
+  <sect1 id="fdl-section5">
+    <title>5. COMBINING DOCUMENTS</title>
+    <para>
+      You may combine the <link linkend="fdl-document">Document</link>
+      with other documents released under this License, under the
+      terms defined in <link linkend="fdl-section4">section 4</link>
+      above for modified versions, provided that you include in the
+      combination all of the <link linkend="fdl-invariant">Invariant
+      Sections</link> of all of the original documents, unmodified,
+      and list them all as Invariant Sections of your combined work in
+      its license notice.
+    </para>
+    
+    <para>
+      The combined work need only contain one copy of this License,
+      and multiple identical <link linkend="fdl-invariant">Invariant
+      Sections</link> may be replaced with a single copy. If there are
+      multiple Invariant Sections with the same name but different
+      contents, make the title of each such section unique by adding
+      at the end of it, in parentheses, the name of the original
+      author or publisher of that section if known, or else a unique
+      number. Make the same adjustment to the section titles in the
+      list of Invariant Sections in the license notice of the combined
+      work.
+    </para>
+    
+    <para>
+      In the combination, you must combine any sections entitled
+      <quote>History</quote> in the various original documents,
+      forming one section entitled <quote>History</quote>; likewise
+      combine any sections entitled <quote>Acknowledgements</quote>,
+      and any sections entitled <quote>Dedications</quote>.  You must
+      delete all sections entitled <quote>Endorsements.</quote>
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section6">
+    <title>6. COLLECTIONS OF DOCUMENTS</title>
+    <para>
+      You may make a collection consisting of the <link
+      linkend="fdl-document">Document</link> and other documents
+      released under this License, and replace the individual copies
+      of this License in the various documents with a single copy that
+      is included in the collection, provided that you follow the
+      rules of this License for verbatim copying of each of the
+      documents in all other respects.
+    </para>
+    
+    <para>
+      You may extract a single document from such a collection, and
+      dispbibute it individually under this License, provided you
+      insert a copy of this License into the extracted document, and
+      follow this License in all other respects regarding verbatim
+      copying of that document.
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section7">
+    <title>7. AGGREGATION WITH INDEPENDENT WORKS</title>
+    <para>
+      A compilation of the <link
+      linkend="fdl-document">Document</link> or its derivatives with
+      other separate and independent documents or works, in or on a
+      volume of a storage or distribution medium, does not as a whole
+      count as a <link linkend="fdl-modified">Modified Version</link>
+      of the Document, provided no compilation copyright is claimed
+      for the compilation.  Such a compilation is called an
+      <quote>aggregate</quote>, and this License does not apply to the
+      other self-contained works thus compiled with the Document , on
+      account of their being thus compiled, if they are not themselves
+      derivative works of the Document.  If the <link
+      linkend="fdl-cover-texts">Cover Text</link> requirement of <link
+      linkend="fdl-section3">section 3</link> is applicable to these
+      copies of the Document, then if the Document is less than one
+      quarter of the entire aggregate, the Document's Cover Texts may
+      be placed on covers that surround only the Document within the
+      aggregate. Otherwise they must appear on covers around the whole
+      aggregate.
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section8">
+    <title>8. TRANSLATION</title>
+    <para>
+      Translation is considered a kind of modification, so you may
+      distribute translations of the <link
+      linkend="fdl-document">Document</link> under the terms of <link
+      linkend="fdl-section4">section 4</link>. Replacing <link
+      linkend="fdl-invariant"> Invariant Sections</link> with
+      translations requires special permission from their copyright
+      holders, but you may include translations of some or all
+      Invariant Sections in addition to the original versions of these
+      Invariant Sections. You may include a translation of this
+      License provided that you also include the original English
+      version of this License. In case of a disagreement between the
+      translation and the original English version of this License,
+      the original English version will prevail.
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section9">
+    <title>9. TERMINATION</title>
+    <para>
+      You may not copy, modify, sublicense, or distribute the <link
+      linkend="fdl-document">Document</link> except as expressly
+      provided for under this License. Any other attempt to copy,
+      modify, sublicense or distribute the Document is void, and will
+      automatically terminate your rights under this License. However,
+      parties who have received copies, or rights, from you under this
+      License will not have their licenses terminated so long as such
+      parties remain in full compliance.
+    </para>
+    </sect1>
+    
+  <sect1 id="fdl-section10">
+    <title>10. FUTURE REVISIONS OF THIS LICENSE</title>
+    <para>
+      The <ulink type="http"
+      url="http://www.gnu.org/fsf/fsf.html">Free Software
+      Foundation</ulink> may publish new, revised versions of the GNU
+      Free Documentation License from time to time. Such new versions
+      will be similar in spirit to the present version, but may differ
+      in detail to address new problems or concerns. See <ulink
+      type="http"
+      url="http://www.gnu.org/copyleft">http://www.gnu.org/copyleft/</ulink>.
+    </para>
+    
+    <para>
+      Each version of the License is given a distinguishing version
+      number. If the <link linkend="fdl-document">Document</link>
+      specifies that a particular numbered version of this License
+      <quote>or any later version</quote> applies to it, you have the
+      option of following the terms and conditions either of that
+      specified version or of any later version that has been
+      published (not as a draft) by the Free Software Foundation. If
+      the Document does not specify a version number of this License,
+      you may choose any version ever published (not as a draft) by
+      the Free Software Foundation.
+    </para>
+  </sect1>
+
+  <sect1 id="fdl-using">
+    <title>Addendum</title>
+    <para>
+      To use this License in a document you have written, include a copy of
+      the License in the document and put the following copyright and
+      license notices just after the title page:
+    </para>
+    
+    <blockquote>
+      <para>
+	Copyright YEAR YOUR NAME.
+      </para>
+      <para>
+	Permission is granted to copy, distribute and/or modify this
+	document under the terms of the GNU Free Documentation
+	License, Version 1.1 or any later version published by the
+	Free Software Foundation; with the <link
+	linkend="fdl-invariant">Invariant Sections</link> being LIST
+	THEIR TITLES, with the <link
+	linkend="fdl-cover-texts">Front-Cover Texts</link> being LIST,
+	and with the <link linkend="fdl-cover-texts">Back-Cover
+	Texts</link> being LIST.  A copy of the license is included in
+	the section entitled <quote>GNU Free Documentation
+	License</quote>.
+      </para>
+    </blockquote>
+      
+    <para>
+      If you have no <link linkend="fdl-invariant">Invariant
+      Sections</link>, write <quote>with no Invariant Sections</quote>
+      instead of saying which ones are invariant.  If you have no
+      <link linkend="fdl-cover-texts">Front-Cover Texts</link>, write
+      <quote>no Front-Cover Texts</quote> instead of
+      <quote>Front-Cover Texts being LIST</quote>; likewise for <link
+      linkend="fdl-cover-texts">Back-Cover Texts</link>.
+    </para>
+    
+    <para>
+      If your document contains nontrivial examples of program code,
+      we recommend releasing these examples in parallel under your
+      choice of free software license, such as the <ulink type="http"
+      url="http://www.gnu.org/copyleft/gpl.html"> GNU General Public
+      License</ulink>, to permit their use in free software.
+    </para>
+  </sect1>
+</appendix>  
+
+
diff --git a/help/C/apx-gloss.sgml b/help/C/apx-gloss.xml
index 40fa9a0ce9..e3b945e488 100644
--- a/help/C/apx-gloss.sgml
+++ b/help/C/apx-gloss.xml
@@ -405,7 +405,7 @@
    </glossdef>
   </glossentry> 
 
-  <glossentry id="SMTP">
+  <glossentry id="smtp">
    <glossterm>SMTP:</glossterm>
    <glossdef>
     <para>
diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.xml
index 67f1029bd3..08252a59b8 100644
--- a/help/C/config-prefs.sgml
+++ b/help/C/config-prefs.xml
@@ -29,7 +29,7 @@
 	<title>Changing Mail Settings</title>
 	<screenshot>
 	  <screeninfo>Changing Mail Settings</screeninfo>
-	  <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="png" srccredit="Aaron Weber">
+	  <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="PNG" srccredit="Aaron Weber"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
@@ -47,7 +47,7 @@
              accounts: the servers to which you connect, the way you
              download mail, your password authentication mode, and so
              forth. This is the most complex item in the list, and is
-             covered in <xref linkend="config-prefs-mail-identity">.
+             covered in <xref linkend="config-prefs-mail-identity"/>.
           </para>
 	</listitem>
       </varlistentry>
@@ -72,7 +72,7 @@
              These are overall mail reading preferences: display
              settings, notification options, security, and so
              forth. These are covered in <xref
-             linkend="config-prefs-mail-display">.
+             linkend="config-prefs-mail-display"/>.
           </para>
 	</listitem>
       </varlistentry>
@@ -86,7 +86,7 @@
              feature here is the ability to substitute graphical
              smiley-faces for "emoticons" such as :) that many people
              use in email. This tool is covered in <xref
-             linkend="config-prefs-mail-composer">.
+             linkend="config-prefs-mail-composer"/>.
           </para>
 	</listitem>
       </varlistentry>
@@ -351,7 +351,7 @@ smtp.omniport.com:143
               specific directory where your server stores mail for
               you.  Typical values are "mail" and "Mail."  For more
               information about how to use IMAP mail, see <xref
-              linkend="usage-mail-subscriptions">.</para>
+              linkend="usage-mail-subscriptions"/>.</para>
 	  </listitem>
 
 	  <listitem>
@@ -410,7 +410,7 @@ smtp.omniport.com:143
               this account. Enter your PGP Key ID and decide how
               frequently to encrypt and sign your messages. You can
               learn more about PGP and encryption in <xref
-              linkend="encryption">.
+              linkend="encryption"/>.
             </para>
 	  </listitem>
 	  </varlistentry>
@@ -432,7 +432,7 @@ smtp.omniport.com:143
         <application>Ximian Evolution</application> to handle inline
         images in HTML mail that you get. There is a detailed
         discussion of the issues surrounding these options in <xref
-        linkend="usage-mail-getnsend-get-attach-html">.
+        linkend="usage-mail-getnsend-get-attach-html"/>.
      </para>
      <para>
        To hange the font which <application>Ximian
@@ -586,14 +586,14 @@ smtp.omniport.com:143
           The calendar configuration tool has two tabs
           <guilabel>General</guilabel> and
           <guilabel>Display</guilabel>, and is illustrated in <xref
-          linkend="config-prefs-cal-fig">.
+          linkend="config-prefs-cal-fig"/>.
 
       <!-- ==============Figure===================== -->
       <figure id="config-prefs-cal-fig">
 	<title>Calendar Preferences Dialog</title>
 	<screenshot>
 	  <screeninfo>Calendar Configuration</screeninfo>
-	  <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="png" srccredit="Aaron Weber">
+	  <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="PNG" srccredit="Aaron Weber"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
diff --git a/help/C/config-sync.sgml b/help/C/config-sync.xml
index 95b0e71603..95b0e71603 100644
--- a/help/C/config-sync.sgml
+++ b/help/C/config-sync.xml
diff --git a/help/C/evolution-C.omf b/help/C/evolution-C.omf
index 44aae32de7..23dc3fdb86 100644
--- a/help/C/evolution-C.omf
+++ b/help/C/evolution-C.omf
@@ -1,16 +1,24 @@
 <?xml version="1.0" standalone="no"?>
 <omf>
   <resource>
-   <creator>
-     Ximian, Inc.
-   </creator>
+    <creator>
+      Ximian, Inc.
+    </creator>
     <title>
       Evolution Manual
     </title>
     <date>2002</date>
     <subject category="GNOME|Applications"/>
-    <format mime="text/html"/>
-    <identifier url="index.html"/>
+    <description>
+	A user's guide to Ximian Evolution which explains how to use
+	its mail, calendar, addressbook, and task list features.
+    </description>
+    <type>
+	manual
+    </type>
+    <format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.1.2//EN"//>
+    <identifier url="/"/>
     <language code="C"/>
+    <rights type="GNU FDL" license.version="1.1" license="http://www.gnu.org/licenses/fdl.html" holder="Ximian, Inc."/>
   </resource>
 </omf>
diff --git a/help/C/evolution.sgml b/help/C/evolution.xml
index 88a75bd6c0..80975cb2ba 100644
--- a/help/C/evolution.sgml
+++ b/help/C/evolution.xml
@@ -1,22 +1,26 @@
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN"[
-
-<!ENTITY PREFACE SYSTEM "preface.sgml">
-<!ENTITY USAGE-MAINWINDOW SYSTEM "usage-mainwindow.sgml">
-<!ENTITY USAGE-EXEC-SUMMARY SYSTEM "usage-exec-summary.sgml">
-<!ENTITY USAGE-MAIL SYSTEM "usage-mail.sgml">
-<!ENTITY USAGE-MAIL-ORG SYSTEM "usage-mail-org.sgml">
-<!ENTITY USAGE-CONTACT SYSTEM "usage-contact.sgml">
-<!ENTITY USAGE-CALENDAR SYSTEM "usage-calendar.sgml">
-<!ENTITY USAGE-EXCHANGE SYSTEM "usage-exchange.sgml">
-<!ENTITY USAGE-SYNC SYSTEM "usage-sync.sgml">
-<!ENTITY USAGE-PRINT SYSTEM "usage-print.sgml">
-<!ENTITY CONFIG-PREFS SYSTEM "config-prefs.sgml">
-<!ENTITY CONFIG-SYNC SYSTEM "config-sync.sgml">
-<!ENTITY MENUREF SYSTEM "menuref.sgml">
-<!ENTITY APX-GLOSS SYSTEM "apx-gloss.sgml">
-<!ENTITY APX-COMMON-TASKS SYSTEM "apx-common-tasks.sgml">
-<!ENTITY APX-BUGS SYSTEM "apx-bugs.sgml">
-<!ENTITY APX-AUTHORS SYSTEM "apx-authors.sgml">
+<?xml version='1.0'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+  
+<!ENTITY LEGAL SYSTEM "legal.xml">
+<!ENTITY GFDL SYSTEM "apx-fdl.xml">
+<!ENTITY PREFACE SYSTEM "preface.xml">
+<!ENTITY USAGE-MAINWINDOW SYSTEM "usage-mainwindow.xml">
+<!ENTITY USAGE-EXEC-SUMMARY SYSTEM "usage-exec-summary.xml">
+<!ENTITY USAGE-MAIL SYSTEM "usage-mail.xml">
+<!ENTITY USAGE-MAIL-ORG SYSTEM "usage-mail-org.xml">
+<!ENTITY USAGE-CONTACT SYSTEM "usage-contact.xml">
+<!ENTITY USAGE-CALENDAR SYSTEM "usage-calendar.xml">
+<!ENTITY USAGE-EXCHANGE SYSTEM "usage-exchange.xml">
+<!ENTITY USAGE-SYNC SYSTEM "usage-sync.xml">
+<!ENTITY USAGE-PRINT SYSTEM "usage-print.xml">
+<!ENTITY CONFIG-PREFS SYSTEM "config-prefs.xml">
+<!ENTITY CONFIG-SYNC SYSTEM "config-sync.xml">
+<!ENTITY MENUREF SYSTEM "menuref.xml">
+<!ENTITY APX-GLOSS SYSTEM "apx-gloss.xml">
+<!ENTITY APX-COMMON-TASKS SYSTEM "apx-common-tasks.xml">
+<!ENTITY APX-BUGS SYSTEM "apx-bugs.xml">
+<!ENTITY APX-AUTHORS SYSTEM "apx-authors.xml">
 
 ]>
 
@@ -38,38 +42,15 @@ entity names correspond.  APX is for appendix.  -->
       <holder>Ximian, Inc.</holder>
     </copyright>
     
-    <legalnotice id="legalnotice">
- 
-     <para>
-         Permission is granted to copy, distribute and/or modify this
-         document under the terms of the <ulink type="help"
-         url="gnome-help:fdl"><citetitle>GNU Free Documentation
-         License</citetitle></ulink>, Version 1.1 or any later version
-         published by the Free Software Foundation with no Invariant
-         Sections, no Front-Cover Texts, and no Back-Cover Texts. You
-         may obtain a copy of the <citetitle>GNU Free Documentation
-         License</citetitle> from the Free Software Foundation by
-         visiting <ulink type="http" url="http://www.fsf.org">their
-         Web site</ulink> or by writing to: Free Software Foundation,
-         Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
-         USA.
-       </para>
-       <para>
-         Many of the names used by companies to distinguish their
-         products and services are claimed as trademarks. Where those
-         names appear in any GNOME documentation, and those trademarks
-         are made aware to the members of the GNOME Documentation
-         Project, the names have been printed in caps or initial caps.
-       </para>
-    </legalnotice>
-
    <releaseinfo>
-      This is version 1.2 of the Ximian Evolution manual. It describes
-      version 1.2 of the Ximian Evolution groupware suite.
+      This is version 1.4 of the Ximian Evolution manual. It describes
+      version 1.4 of the Ximian Evolution groupware suite.
    </releaseinfo>
 
   </bookinfo>
 
+
+  &LEGAL;
   &PREFACE;
   
   <part id="usage">
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000000..50d758006b
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,75 @@
+  <legalnotice id="legalnotice">
+	<para>
+	  Permission is granted to copy, distribute and/or modify this
+	  document under the terms of the GNU Free Documentation
+	  License (GFDL), Version 1.1 or any later version published
+	  by the Free Software Foundation with no Invariant Sections,
+	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
+	  a copy of the GFDL in <xref linkend="apx-fdl"/> or in the
+	  file COPYING-DOCS distributed with this manual.
+         </para>
+         <para> This manual is part of a collection of GNOME manuals
+          distributed under the GFDL.  If you want to distribute this
+          manual separately from the collection, you can do so by
+          adding a copy of the license to the manual, as described in
+          section 6 of the license.
+	</para>
+
+	<para>
+	  Many of the names used by companies to distinguish their
+	  products and services are claimed as trademarks. Where those
+	  names appear in any GNOME documentation, and the members of
+	  the GNOME Documentation Project are made aware of those
+	  trademarks, then the names are in capital letters or initial
+	  capital letters.
+	</para>
+
+	<para>
+	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+	  WITH THE FURTHER UNDERSTANDING THAT:
+
+	  <orderedlist>
+		<listitem>
+		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
+                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+                    EXCEPT UNDER THIS DISCLAIMER; AND
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+                       THE POSSIBILITY OF SUCH DAMAGES.
+		  </para>
+		</listitem>
+	  </orderedlist>
+	</para>
+  </legalnotice>
+
diff --git a/help/C/menuref.sgml b/help/C/menuref.xml
index bb1eccf994..bb1eccf994 100644
--- a/help/C/menuref.sgml
+++ b/help/C/menuref.xml
diff --git a/help/C/preface.sgml b/help/C/preface.xml
index c69e058917..c7ac8ef870 100644
--- a/help/C/preface.sgml
+++ b/help/C/preface.xml
@@ -37,7 +37,7 @@
             in</userinput></member> <member><computeroutput>Text
             output from a computer</computeroutput></member>
 	  <member><glossterm linkend="apx-gloss">Words</glossterm>
-            that are defined in the <xref linkend="apx-gloss">.</member>
+            that are defined in the <xref linkend="apx-gloss"/>.</member>
 	  </simplelist>
 </para>
 <para>
@@ -116,7 +116,7 @@ Lastly, we'll have warnings, in cases where you should be careful:
                   </guimenuitem>
 		</menuchoice>. Detailed help for the preferences
 		dialogs has been added to <xref
-		linkend="config-prefs">.
+		linkend="config-prefs"/>.
               </para>
 	    </listitem>
 	  </varlistentry>
diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.xml
index 93e4aa4d3b..dd60c54b20 100644
--- a/help/C/usage-calendar.sgml
+++ b/help/C/usage-calendar.xml
@@ -71,7 +71,7 @@
       appointments, set alarms, and determine appointment
       recurrence. If you have installed the Ximian Connector for
       Microsoft Exchange, you can also read <xref
-      linkend="full-advantage"> to learn about how to take full
+      linkend="full-advantage"/> to learn about how to take full
       advantage of the collaborative group scheduling functions
       available on the Microsoft Exchange Server.
     </para>
@@ -101,8 +101,8 @@
       </tip>
 
       <para>
-        Your appointment must have a starting and ending date &mdash; by
-        default, today &mdash; but you can choose whether to give it
+        Your appointment must have a starting and ending date (by
+        default, today) but you can choose whether to give it
         starting and ending times or to mark it as an <guilabel>All
         day event</guilabel>. An <guilabel>All day event</guilabel>
         appears at the top of a day's appointment list, in the grey header under the date, rather than inside
@@ -225,7 +225,7 @@
 	<application>Evolution</application> can handle free/busy
 	scheduling Using the Ximian Connector on a Microsoft Exchange
 	2000 server. For more information about Ximian Connector, see
-	<xref linkend="usage-exchange">.
+	<xref linkend="usage-exchange"/>.
       </para>
       <para>
 	To set your appointment to be free or busy, simply click the
@@ -518,15 +518,15 @@
 	<screenshot>
 	  <screeninfo>Appointment Scheduling Window</screeninfo>
 	  <mediaobject><imageobject>
-	      <imagedata  format="png" fileref="figures/schedule"
-	  srccredit="Kevin Breit">
+	      <imagedata  format="PNG" fileref="figures/schedule"
+	  srccredit="Kevin Breit"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
       <para>
 	<inlinemediaobject>
 	  <imageobject>
-	    <imagedata fileref="figures/full-1" format="png">
+	    <imagedata fileref="figures/full-1" format="PNG"/>
 	  </imageobject>
 	</inlinemediaobject>
 	<guilabel>Invitee List</guilabel>
@@ -539,7 +539,7 @@
       <para>
 	<inlinemediaobject>
 	  <imageobject>
-	    <imagedata fileref="figures/full-2" format="png">
+	    <imagedata fileref="figures/full-2" format="PNG"/>
 	  </imageobject>
 	</inlinemediaobject>
 	<guilabel>Schedule Grid</guilabel>
@@ -553,7 +553,7 @@
       <para>
 	<inlinemediaobject>
 	  <imageobject>
-	    <imagedata fileref="figures/full-3" format="png">
+	    <imagedata fileref="figures/full-3" format="PNG"/>
 	  </imageobject>
 	</inlinemediaobject>
 	<guilabel>Meeting Scheduler</guilabel>
@@ -590,7 +590,7 @@
         </para>
 
         <para>
-         Read <xref linkend="full-advantage"> to learn about how to
+         Read <xref linkend="full-advantage"/> to learn about how to
 	 use this feature with the Ximian Connector for Microsoft
 	 Exchange.
        </para>
diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.xml
index ff94b3393e..3131118803 100644
--- a/help/C/usage-contact.sgml
+++ b/help/C/usage-contact.xml
@@ -10,7 +10,7 @@
         any amount of contact information, share addresses over a
         network, and several ways to save time with everyday tasks. To
         learn about configuring the addressbook, see <xref
-        linkend="config-prefs-contact">. You can import contacts from
+        linkend="config-prefs-contact"/>. You can import contacts from
         other contact management tools with the Import tool by
         selecting
         <menuchoice><guimenu>File</guimenu><guimenuitem>Import</guimenuitem></menuchoice>,
@@ -89,8 +89,8 @@
       <screenshot>
 	<screeninfo>Evolution Contact Editor</screeninfo>
 	<mediaobject><imageobject><imagedata
-	fileref="figures/contact-editor" format="png" srccredit="Aaron
-	Weber">
+	fileref="figures/contact-editor" format="PNG" srccredit="Aaron
+	Weber"/>
 	</imageobject></mediaobject>
       </screenshot>
     </figure>
@@ -204,7 +204,7 @@
       The last item in the <guilabel>General</guilabel> tab is the
        <guilabel>Categories</guilabel> organization tool; for
        information on that, read <xref
-       linkend="usage-contact-organize">.
+       linkend="usage-contact-organize"/>.
      </para>
      <para>
        The <guilabel>Details</guilabel> tab is much simpler:
@@ -317,7 +317,7 @@
        does, however, allow each card to fall under several
        categories, and allow you to create your own categories.  To
        learn about categories, read <xref
-       linkend="usage-contact-organize-group-category">.
+       linkend="usage-contact-organize-group-category"/>.
     </para>
 
 <!-- UNIMPLEMENTED FEATURE
@@ -349,7 +349,7 @@
 	   The simplest way to group address cards is to use folders.
 	   By default, cards start in the
 	   <guilabel>Contacts</guilabel> folder.  If you've read <xref
-	   linkend="usage-mainwindow"> then you already know that you
+	   linkend="usage-mainwindow"/> then you already know that you
 	   can create a new folder by selecting 
            <menuchoice>
            <guimenu>File</guimenu>
@@ -360,7 +360,7 @@
 	   like with mail, cards must be in a card folder, and no card
 	   can be in two places at once.  If you want more
 	   flexibility, try <xref
-	   linkend="usage-contact-organize-group-category">.
+	   linkend="usage-contact-organize-group-category"/>.
 	 </para>
 	<para>
           To put a card into a folder, just drag it there from the
@@ -446,7 +446,7 @@
                  Unless it is a very small list, it is recommended
                  that you leave the addresses hidden.  This is the
                  same thing as using the "Bcc:" feature discussed in
-                 <xref linkend="usage-mail-getnsend-send-to-types">.
+                 <xref linkend="usage-mail-getnsend-send-to-types"/>.
               </para>
 	    </listitem>
 	    
@@ -488,7 +488,7 @@
 
     <para>
        To learn how to add a remote directory to your available
-       contact folders, see <xref linkend="config-prefs-contact">.
+       contact folders, see <xref linkend="config-prefs-contact"/>.
        Once you have a LDAP connection, the network contacts folder or
        folders will appear inside the <guilabel>External
        Directories</guilabel> folder in the folder bar.  It will work
@@ -546,7 +546,7 @@
 	Card</guimenuitem> from the menu that appears.
       <application> Evolution</application> can also add cards from a
       hand-held device during HotSync operation.  For more
-      information about that, see <xref linkend="usage-sync">.
+      information about that, see <xref linkend="usage-sync"/>.
     </para>
   </sect1>
   
diff --git a/help/C/usage-exchange.sgml b/help/C/usage-exchange.xml
index 2a7ef31ba7..5fab9d0cc7 100644
--- a/help/C/usage-exchange.sgml
+++ b/help/C/usage-exchange.xml
@@ -335,7 +335,7 @@ There are, however, some features which are not available:
 	  server, click the <guibutton>Add</guibutton> button in the
 	  accounts list. The account creation assistant will guide you
 	  through the process, which is also described in <xref
-	  linkend="usage-mainwindow-starting">. If you're not sure
+	  linkend="usage-mainwindow-starting"/>. If you're not sure
 	  about any of the information you need, just ask your system
 	  administrator.
         </para>
@@ -474,7 +474,7 @@ There are, however, some features which are not available:
 	<screenshot>
 	  <screeninfo>Creating an Exchange Account, Step One: Identity</screeninfo>
 	  <mediaobject><imageobject>
-	      <imagedata  format="png" fileref="figures/exchange-identity" srccredit="Aaron Weber">
+	      <imagedata  format="PNG" fileref="figures/exchange-identity" srccredit="Aaron Weber"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
@@ -484,7 +484,7 @@ There are, however, some features which are not available:
 	<screenshot>
 	  <screeninfo>Creating an Exchange Account, Step Two: Receiving Mail</screeninfo>
 	  <mediaobject><imageobject>
-	      <imagedata  format="png" fileref="figures/exchange-receive" srccredit="Aaron Weber">
+	      <imagedata  format="PNG" fileref="figures/exchange-receive" srccredit="Aaron Weber"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
@@ -494,7 +494,7 @@ There are, however, some features which are not available:
 	<screenshot>
 	  <screeninfo>Creating an Exchange Account, Step Three: Mail Options</screeninfo>
 	  <mediaobject><imageobject>
-	      <imagedata  format="png" fileref="figures/exchange-receive-options" srccredit="Aaron Weber">
+	      <imagedata  format="PNG" fileref="figures/exchange-receive-options" srccredit="Aaron Weber"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
@@ -684,7 +684,7 @@ There are, however, some features which are not available:
 	<screenshot>
 	  <screeninfo>Using the Free/Busy Feature</screeninfo>
 	  <mediaobject><imageobject>
-	      <imagedata  format="png" fileref="figures/schedule" srccredit="Aaron Weber">
+	      <imagedata  format="PNG" fileref="figures/schedule" srccredit="Aaron Weber"/>
 	    </imageobject></mediaobject>
 	</screenshot>
       </figure>
diff --git a/help/C/usage-exec-summary.sgml b/help/C/usage-exec-summary.xml
index 564c1c6617..564c1c6617 100644
--- a/help/C/usage-exec-summary.sgml
+++ b/help/C/usage-exec-summary.xml
diff --git a/help/C/usage-mail-org.sgml b/help/C/usage-mail-org.xml
index d03edf6267..bb21abcf17 100644
--- a/help/C/usage-mail-org.sgml
+++ b/help/C/usage-mail-org.xml
@@ -548,13 +548,13 @@
 	
 		<listitem><para> Date sent - 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>
+		    want a message to meet -- <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
+		    range of time relative to the filter -- perhaps you're
 		    looking for messages less than two days old.
 		  </para></listitem>
 		
@@ -926,7 +926,7 @@
     </note>
 
 
-    <example id="usage-mail-organize-vFolders-ex">
+    <example id="usage-mail-organize-vfolders-ex">
       <title>Using Folders, Searches, and vFolders</title>
       <para>
 	To organize his mailbox, Jim sets up a virtual volder for emails from
@@ -1008,13 +1008,13 @@
 		
 		<listitem><para> Date sent - Search messages according to the date on
 		    which they were sent: First, choose the conditions you
-		    want a message to meet &mdash; <guilabel>before</guilabel>
+		    want a message to meet -- <guilabel>before</guilabel>
 		    a given time, <guilabel>after</guilabel> it, and so forth.
 		    Then, choose the time. The vFolder 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
+		    range of time relative to the filter -- perhaps you're
 		    looking for messages less than two days old.
 		  </para></listitem>
 		
@@ -1118,7 +1118,7 @@
 	    <mediaobject>
 	      <imageobject>
 		<imagedata fileref="figures/vfolder-createrule-fig" format="PNG"
-			   srccredit="Aaron Weber">
+			   srccredit="Aaron Weber"/>
 	      </imageobject>
 	    </mediaobject>
 	  </screenshot>
diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.xml
index 4ce62894c5..50c2245c84 100644
--- a/help/C/usage-mail.sgml
+++ b/help/C/usage-mail.xml
@@ -1,2209 +1,2209 @@
-<chapter id="usage-mail">

-  <title>Using Evolution for Email</title>

-  <para>

-    This chapter, and <xref linkend="usage-mail-organize">, will

-      provide you with an in-depth guide to the capabilities of

-      Evolution as a mail client.  For information about how to set up

-      your mail account, see <xref linkend="config-prefs-mail">.

-  </para>

-  

-  <note>

-    <title>If you use IMAP Mail</title>

-    <para>

-      If you chose IMAP mail during the setup process, you must

-      subscribe to your mail folders before you can read mail in

-      them. Read <xref linkend="usage-mail-subscriptions"> to find out

-      how.

-    </para>

-  </note>

-  

-  

-  <sect1 id="usage-mail-getnsend-read">

-    <title>Reading Mail</title>    

-    <para>

-      Start the mail client by clicking on the

-      <guibutton>Inbox</guibutton> icon in the shortcut bar, or by

-      selecting a mail folder in the folder bar.  To read a message,

-      select it in the message list; if you'd like to see it in its

-      own window, double-click on it or press

-      <keycombo action="simul">

-	<keycap>Ctrl</keycap>

-	<keycap>O</keycap>

-      </keycombo>.

-    </para>

-

-      <tip id="spaceandbs">

-	<title>Reading Mail with the Keyboard</title>

-	<para>

-	  You can click the spacebar to page down while you're reading

-	  an email, and press backspace to page up in an email.  This

-	  may help to make reading your email faster.

-	</para>

-      </tip>

-

-    <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>

-

-      <tip id="view-headers">

-	<title>Email Headers</title>

-	<para>

-	  To look at the complete headers for email messages, select

-	  <menuchoice><guimenu>View</guimenu><guisubmenu>Message

-	  Display</guisubmenu><guimenuitem>Show Full

-	  Headers</guimenuitem></menuchoice>. To see absolutely every

-	  bit, choose

-	  <menuchoice><guimenu>View</guimenu><guisubmenu>Message

-	  Display</guisubmenu><guimenuitem>Show Email Source

-	  </guimenuitem></menuchoice>.

-       </para>

-      </tip>

-

-      <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>

-      <figure>

-        <title>Threaded Mail View</title>

-	<screenshot>

-	  <screeninfo>Threaded Mail View</screeninfo>

-	  <mediaobject><imageobject>

-	      <imagedata  format="png" fileref="figures/mail-threaded" srccredit="Aaron Weber">

-	    </imageobject></mediaobject>

-	</screenshot>

-      </figure>

-

-    </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 on the message and

-	      choose <guilabel>Delete</guilabel>.

-	    </para>

-	    <note>

-	      <title>Why do I still see deleted mail?</title>

-	      <para>

-		When you press <guibutton>Delete</guibutton> or click

-		the trash button, your mail isn't actually deleted,

-		but is marked for deletion.  Your email is not gone

-		until you have expunged it. When you "Expunge" a

-		folder, you remove all the mail that you have marked

-		for deletion.

-	      </para>

-              <para>

-                 If you don't like this behavior, select

-                 <menuchoice><guimenu>View</guimenu><guimenuitem>Hide

-                 Deleted Messages</guimenuitem></menuchoice>. Then,

-                 you will only see deleted messages when you look in

-                 your <guilabel>Trash</guilabel> folder.

-              </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 vFolder?</title>

-	<para>

-	  Both local and IMAP Trash folders are actually vFolders that

-          display all messages you have marked for later deletion.

-          For more information about vFolders, see <xref

-          linkend="usage-mail-organize-vfolders">.  Since emptying

-          your trash expunges the messages in your Trash folder,

-          choosing <menuchoice> <guimenu>Actions</guimenu>

-          <guimenuitem>Empty Trash</guimenuitem> </menuchoice> is the

-          same as expunging deleted mail from <emphasis>all</emphasis>

-          your folders.

-	</para>

-        <para>

-           This is not, however, true for the Trash folder on Exchange

-           servers, which behaves just the same as it would in

-           Outlook. That is to say, the Trash folder on an Exchange

-           server is a normal folder with actual messages in it.

-        </para>

-      </note>

-    </sect2>

-    <sect2 id="usage-mail-getnsend-undelete">

-      <title>Undeleting Messages</title>

-      <para>

-	To undelete a message:

-	<orderedlist numeration="arabic">

-	  <listitem>

-	    <para>

-	      Select a message you have marked for deletion.

-	    </para>

-	  </listitem>

-	  <listitem>

-	    <para>

-	      Press <keycombo

-	      action="simul"><keycap>Ctrl</keycap><keycap>U</keycap>

-	      </keycombo>

-	      or choose

-	      <menuchoice>

-		<guimenu>Edit</guimenu>

-		<guimenuitem>Undelete</guimenuitem>

-	      </menuchoice>

-

-	    </para>

-	    <note>

-	      <title>What does Undelete actually do?</title>

-	      <para>

-                If you have marked a message for deletion, undeleting

-		it will unmark it, and the message will be removed

-		from the Trash folder. However, it can't bring back

-		messages that have been expunged.

-	      </para>

-	    </note>

-	  </listitem>

-	</orderedlist>

-      </para>

-    </sect2>

-  </sect1>

-

-  <sect1 id="usage-mail-getnsend-get">

-    <title>Checking for New 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 you haven't entered any mail settings yet, the

-      <interface>setup assistant</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

-      haven't asked <application>Evolution</application> 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">, or ask your

-	system administrator.

-       </para>

-     </note>

-

-

-

-          <tip>

-            <title>Sharing Mailboxes with Other Mail Programs</title>

-            <para>

-              If you want to use <application>Evolution</application>

-              and another email client, such as

-              <application>Mutt</application>, at the same time,

-              here's how:

-              <orderedlist numeration="arabic">

-                <listitem>

-                   <para>

-                      Download your mail in the other application as

-                      you would normally.

-                   </para>

-                  </listitem>

-                <listitem>

-                   <para>

-                      In <application>Evolution</application>

-                      <menuchoice><guimenu>Tools</guimenu><guimenuitem>Mail

-                      Settings</guimenuitem></menuchoice>, and pick the account

-                      you'd like to use to share mail. You may want to

-                      create a new account just for this source of

-                      mail.

-                   </para>

-               </listitem>                     

-               <listitem>

-                   <para>

-                      Under the <guilabel>Receiving Mail</guilabel>

-                      tab, select the type of mail file that your

-                      other mail application uses, and then enter the

-                      full path to that file.

-                   </para>

-                  </listitem>

-                <listitem>

-                   <para>

-                      Click the <guibutton>OK</guibutton> button.

-                   </para>

-                  </listitem>

-                </orderedlist>

-               </para>

-            </tip>

-

-

-<!-- NOT FOR 1.0

-       <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>Working with Attachments and HTML Mail</title>

-	 <para>

-	   If someone sends you an <glossterm linkend="attachment">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,

-	   including HTML formatting and embedded images, will appear

-	   as part of the message, rather than at the end of the

-	   message as an attachment.

-     </para>

-

-     <sect3 id="usage-mail-getnsend-get-attach-actions">

-     <title>Saving or Opening Attachments</title>

-     <para>

-        If you get an attachment with an email message,

-        <application>Ximian Evolution</application> can help you save

-        it or open it with the appropriate applications.

-     </para>

-     <para>

-       To save an attachment to disk:

-       <orderedlist numeration="arabic">

-	 <listitem>

-	   <para>

-	     Click the downward pointing arrow on the attachment icon

-	     and select <guimenuitem>Save to Disk</guimenuitem>.

-	   </para>

-	 </listitem>

-	 <listitem>

-	   <para>

-	     Choose a location and name for the file.

-	   </para>

-	 </listitem>

-	 <listitem>

-	   <para>

-	     Click <guibutton>OK</guibutton>.

-	   </para>

-	 </listitem>

-       </orderedlist>

-      </para>

-

-      <para>

-	To Open an Attachment in a Program:

-	<orderedlist numeration="arabic">

-	  <listitem>

-	    <para>

-	      Open the mail message with the attachment you want to read.

-	    </para>

-	  </listitem>

-	  <listitem>

-	    <para>

-	      Click the arrow next the attachment icon.

-	    </para>

-	  </listitem>

-	  <listitem>

-	    <para>

-	      Select the program you'd like to use. It will start up

-	      and open the document.

-	    </para>

-	  </listitem>

-	</orderedlist>

-      </para>

-      <para>

-      </para>

-      </sect3>

-

-      <sect3 id="usage-mail-getnsend-get-attach-html">

-      <title>Inline Images in HTML Mail</title>

-      <para>

-         When someone sends you HTML mail that includes an image in

-         the body of the message (for example, the welcome message in your

-         Inbox when you first start <application>Ximian

-         Evolution</application>) <application>Evolution</application>

-         will display the image inside the message.  You can create

-         messages like this by using the

-         <menuchoice><guimenu>Insert</guimenu><guimenuitem>Image</guimenuitem></menuchoice>

-         tool in the message composer.

-      </para>

-

-      <para>

-         If the image isn't included in the message, but is, instead,

-         a link to an image, <application>Evolution</application> can 

-         download the image from the Internet for you.  However,

-         <application>Evolution</application> will not display the

-         image unless you ask it to. This is because remotely hosted

-         images can be slow to load and display, and can even be used

-         by spammers to track who reads their email.  Having images

-         not load automatically helps protect your privacy.

-      </para>

-      <para>

-	 If you want the images to load for one message, select 

-	 <menuchoice>

-	   <guimenu>View</guimenu>

-	   <guisubmenu>Message Display</guisubmenu>

-	   <guimenuitem>Load Images</guimenuitem>

-         </menuchoice>.  

-

-         If you want <application>Ximian Evolution</application> to

-         load remotely hosted images more often, go to the

-         <guilabel>Display</guilabel> tab of the

-         <menuchoice>

-	   <guimenu>Tools</guimenu>

-	   <guimenuitem>Mail Settings</guimenuitem>

-         </menuchoice> dialog.

-      </para>

-      <note id="http-proxy">

-	<title>Loading Images from the Net through an HTTP Proxy</title>

-        <para>

-           If you use an HTTP proxy,

-           <application>Evolution</application> must be able to find

-           it through the <systemitem>gnome-vfs</systemitem> subsystem

-           before it can load images from the Internet.  This is also

-           the case if you wish to access weather and news information

-           through the Summary tool. You can tell the GNOME Virtual

-           File System about your HTTP proxy in one of two ways:

-            <variablelist>

-	    <varlistentry>

-	      <term>Configure it with Nautilus</term>

-	      <listitem>

-		<para>

-                 <orderedlist numeration="arabic">

-		    <listitem>

-		      <para>

-			Open a Nautilus window

-	               </para>

-		    </listitem>

-      		    <listitem>

-		      <para>

-	                 Select <menuchoice>

-			  <guimenu>Preferences</guimenu>

-			  <guimenuitem>Edit Preferences</guimenuitem>

-			</menuchoice>.

-	               </para>

-		    </listitem>

-      		    <listitem>

-		      <para>

-			Go to the <guilabel>Navigation</guilabel> tab.

-	               </para>

-		    </listitem>

-      		    <listitem>

-		      <para>

-			Click the <guilabel>Use HTTP Proxy</guilabel>

-			checkbox and enter the location of your HTTP

-			proxy in the <guilabel>Location</guilabel> field.

-	               </para>

-		    </listitem>

-		  </orderedlist>

-                </para>

-	      </listitem>

-	    </varlistentry>

-	    <varlistentry>

-	      <term>Configure it with the gconftool command</term>

-	      <listitem>

-	      <para>

-                 <orderedlist numeration="arabic">

-		    <listitem>

-		      <para>

-                        Open a terminal.

-                      </para>

-		    </listitem>

-		    <listitem>

-		      <para>

-                        Enter the command 

-                        <command>

-                        gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE"

-                        </command>

-                      </para>

-		    </listitem>

-		    <listitem>

-		      <para>

-                        Enter the command 

-                        <command>

-      gconftool --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url"

-                        </command>

-                      </para>

-		    </listitem>

-		    <listitem>

-		      <para>

-                        Enter the command 

-                        <command>

-                        gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080"

-                        </command>                  

-                      </para>

-		    </listitem>

-		  </orderedlist>

-                </para>

-		<para>

-                  For more information about the gconftool command,

-                  read the gconftool man page.

-                </para>

-	      </listitem>

-	    </varlistentry>

-	  </variablelist>

-         </para>

-      </note>

-     </sect3>

-    </sect2>

-  </sect1>

-

-    <sect1 id="usage-mail-getnsend-send">

-      <title>Composing New Email Messages</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>

-          <mediaobject><imageobject><imagedata fileref="figures/newmsg" format="png" srccredit="Aaron Weber">

-        </imageobject></mediaobject>

-        </screenshot>

-      </figure>

-<!-- ==============End of Figure=================================== -->

-

-      <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 box at the bottom of the window.

-      Once you have written your message, press

-      <guibutton>Send</guibutton>.

-    </para>

-

-      <sect2 id="usage-mail-getnsend-send-delay">

-        <title>Sending Composed Messages 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.  The

-           "Send Later" feature is particularly useful if you use a

-           modem to connect to the Internet and pay per-minute

-           charges: you can remain offline until you need to send

-           mail, then connect and send all your mail at once.  Mail in

-           the outbox is sent when you click

-           <guibutton>Send/Receive</guibutton> in the main window.

-        </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. Your options are:

-       <itemizedlist>

-        <listitem><para>

-          Choose

-	  <menuchoice>

-	   <guimenu>File</guimenu>

-	    <guimenuitem>Save Draft</guimenuitem>

-          </menuchoice>

-          to store your messages in the drafts folder for later

-          revision.

-       </para></listitem>

-

-       <listitem><para>

-         If you'd like to have the message sent later, you

-         can choose <guimenuitem>Send Later</guimenuitem>. That way,

-         the message will be added to the queue, and you can send a 

-         batch of messages all at once.

-        </para></listitem>

-        

-        <listitem><para> 

-         If you prefer to save your message as a text file,

-         choose <guimenuitem>Save As</guimenuitem> and then choose a

-         file name.

-           </para>

-	  </listitem>

-	</itemizedlist>

-      </para>

-    </sect2>

-

-  <sect2 id="usage-mail-getnsend-offline">

-            <title>Working Offline</title>

-            <para>

-              Offline mode is a tool designed for use with a dialup

-              connection or for laptop users who do not have a network

-              connection at all times. It allows you to cache messages

-              for reference while you are not connected to the

-              network, and to compose messages and leave them in your

-              Outbox to be sent the next time you connect to the network.

-             </para>

-            <para>

-	      Select

-	      <menuchoice><guimenu>File</guimenu><guimenuitem>Work

-	      Offline</guimenuitem></menuchoice> to have

-	      <application>Ximian Evolution</application> disconnect

-	      from the Internet while you work. When you want to

-	      reconnect, choose

-	      <menuchoice><guimenu>File</guimenu><guimenuitem>Work

-	      Online</guimenuitem></menuchoice>.  Alternativly, you

-	      can click the connection button at the bottom left side

-	      of the window.

-            </para>

-            <para>

-               If you use POP mail, all your messages will be

-               available to you, because they are stored locally. If

-               you use IMAP or Exchange mail, messages are stored

-               remotely, so availability is a little different.

-            </para>

-            <para>

-               Messages that you have read are cached and stored

-               locally; all read messages will be available to you

-               even if you are offline. Unread messages will be

-               downloaded and saved for offline use if they are in a

-               folder that you have marked as an Offline Folder. To

-               mark a folder for offline use, select

-               <menuchoice><guimenu>Settings</guimenu>

-               <guimenuitem>Preferences</guimenuitem></menuchoice> and

-               then click the <guilabel>Folders</guilabel> icon. In

-               the <guilabel>Offline Folders</guilabel> tab, click the

-               check-box next to the folders that you would like to

-               use while you are offline. Then, when you select

-               <guimenuitem>Go Offline</guimenuitem>, Evolution will

-               fetch their contents and store them for later

-               reference.

-          </para>

-       </sect2>

-    <sect2 id="usage-mail-getnsend-send-compose">

-      <title>More About Mail Composition</title>

-      <para>

-        In the next few sections, you'll see how

-	<application>Evolution</application> handles advanced email

-	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>

-       </sect3>

-

-      <sect3 id="usage-mail-getnsend-send-to-types">

-	<title>Specifying Recipients for Email</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

-            <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.

-          </para>

-          <para>

-            <guilabel>Bcc:</guilabel> is a little more complex.  You

-            use it like <guilabel>Cc:</guilabel>, but people on the

-            <guilabel>Bcc:</guilabel> list are hidden from the other

-            recipients of the message. Use it to send mail to large

-            groups of people, especially if they don't know each other

-            or if privacy is a concern.  If your <guilabel>Bcc:</guilabel> field is absent, click

-	    <menuchoice>

-	      <guimenu>View</guimenu>

-	      <guimenuitem>Bcc Field</guimenuitem>

-	    </menuchoice>.

-		

-          </para>

-

-         <para>

-           If you frequently write email to the same groups of people,

-           you can create address lists in the Contact Manager, and

-           then send them mail as though they had a single address.

-           To learn how to do that, read <xref

-           linkend="usage-contact-organize-group-list">.

-        </para>

-

-	<tip id="reply-to-per-mail">

-	  <title>Setting Reply-to On a Per-Mail Basis</title>

-	  <para>

-	    <application>Evolution</application> has the ability to

-	    let you specify the Reply-To in an email. Using this, you

-	    can setup a special Reply-To for an email.  To do this:

-	    <orderedlist numeration="arabic">

-	      <listitem>

-                <para>

-		  Open a composer window

-			 </para>

-			 </listitem>

-			 <listitem>

-			 <para>

-			 Open the Reply-To field by selecting

-			 <menuchoice>

-			 <guimenu>View</guimenu>

-			 <guimenuitem>Reply To</guimenuitem>

-			 </menuchoice>

-			 </para>

-			 </listitem>

-			 <listitem>

-			 <para>

-			 Enter the address you wish to have be the

-			 Reply-To address in the new Reply-To field.

-			 </para>

-			 </listitem>

-			 </orderedlist>			 

-	  </para>

-	</tip>

-        </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 offer a

-          drop down list of possible address completions from your

-          address book.  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. 

-

-<!-- 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. NOTE: Bug filed on this: it's not available now,

-          but may be in the future. 

--->

-

-          </para>

-

-          <para>

-            Alternately, you can click on the

-            <guibutton>To:</guibutton>, <guibutton>Cc:</guibutton>, or

-            <guibutton>Bcc:</guibutton> buttons to get a list --

-            potentially a very long one -- 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="contact-automation-basic"> and <xref

-            linkend="usage-calendar-apts">.

-          </para>

-        </sect3>

-      </sect2>

-

-      <sect2 id="usage-mail-getnsend-send-reply">

-        <title>Replying to Email 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">.

-

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

-       <figure id="usage-mail-getnsend-reply-fig">

-         <title>Reply Message Window</title>

-         <screenshot>

-          <screeninfo>Evolution Main Window</screeninfo>

-          <mediaobject><imageobject><imagedata fileref="figures/replymsg" format="png" srccredit="Aaron Weber">

-        </imageobject></mediaobject>

-        </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>

-          If you're subscribed to a mailing list, and want your reply

-          to go just to the list, rather than to the sender, choose

-          <guibutton>Reply to List</guibutton> instead of

-          <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 tools for

-              group collaboration on the Internet. Here's how they work: 

-              <simplelist>

-                <member>

-                  Someone sends a message to a single address, like

-                  <email>evolution@ximian.com</email>.

-                </member>

-                <member>

-                  That address belongs to a program that distributes

-                  the message to a list of recipients.

-                </member>

-             </simplelist>

-               The mail management program lets individuals subscribe

-               to or unsubscribe from the list at will, without

-               requiring the message writers to remember the addresses

-               of every recipient.

-            </para>

-            <para>

-              Mailing list servers can also let network administrators

-              control mail flow, list membership, and even moderate

-              the content of mailing lists.

-            </para>

-          </note>

-        </para>

-      </sect2>

-

-      <sect2 id="usage-mail-getnsend-send-find">

-        <title>Searching and Replacing with the Composer</title>

-        <para>

-           You are probably familiar with search and replace features

-           in any sort of text-editing software, and if you come from

-           a Linux or Unix background, you may know what

-           <guimenuitem>Find Regex</guimenuitem> does.  If you aren't

-           among the lucky who already know, here's a quick rundown of

-           the automated text searching features that the message

-           composer makes available to you.

-        </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>Enhance your email with HTML</title>

-        <para>

-            Normally, you can't set text styles or insert pictures in

-            emails, which is why email is often regarded as

-            uncommunicative and cold, and why people often resort to

-            using far too many exclamation points 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. Because some people may

-            prefer not to get HTML mail,

-            <application>Evolution</application> sends plain text

-            unless you explicitly ask for HTML.  

-           </para>

-	 </note>

-

-	 <para> You can change the format of an email message between

-            plain text and HTML by choosing <menuchoice>

-            <guimenu>Format</guimenu> <guimenuitem>

-            HTML</guimenuitem></menuchoice>.

-	  </para>

-	  <para>

-            To send all your mail as HTML by default, set your mail

-            format preferences in the mail configuration dialog.  See

-            <xref linkend="config-prefs-mail-composer"> for more

-            information.

-      </para>

-      <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 bullet points for the highly

-                  organized.

-                </para>

-	      <tip>

-		<title>Using Bullets to Make Your Email More

-		Attractive</title>

-		<para>

-		  Often times, people use asterisks instead of real bullets.

-		  Not only do asterisks look nicer, but

-		  <application>Evolution</application> will word wrap for you,

-		  which makes your text looks nicer.

-		</para>

-	      </tip>

-	    </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.  You can select a background color or image by

-                  right-clicking on the message background and

-                  selecting <guilabel>Page</guilabel>.

-               </para>

-            </listitem>

-          </varlistentry>

-          </variablelist>

-        </para>

-        <para>

-	The <guimenu>Insert</guimenu> gives you opinions which let you

-           spruce up your email to make it more interesting:

-	<variablelist>

-	  <varlistentry>

-	    <term><guimenuitem>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.  To add a link:

-		<orderedlist numeration="arabic">

-		  <listitem>

-		    <para>

-		      Select the text you wish to link from.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Right click on the text and click on <guibutton>Link</guibutton>.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Put the URL you want to use in the <guilabel>URL</guilabel> field.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Click <guibutton>OK</guibutton>.

-		    </para>

-		  </listitem>

-		</orderedlist>

-	      </para>

-	      <note>

-		<para>

-		  If you're typing a webpage address to be automatically formatted, keep in mind that a space terminates the link.

-		</para>

-	      </note>

-	    </listitem>

-	  </varlistentry>

-	  <varlistentry>

-	    <term><guimenuitem>Image:</guimenuitem></term>

-	    <listitem>

-	      <para>

-		Lets you put an image alongside text.

-	      </para>

-	      <para>

-		To insert an image into your email:

-		<orderedlist numeration="arabic">

-		  <listitem>

-		    <para>

-		      Open a new email by clicking <guibutton>New Message</guibutton>

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Make sure that you have the

-		      <menuchoice>

-			<guimenu>Format</guimenu>

-			<guimenuitem>HTML</guimenuitem>

-		      </menuchoice>

-                      selector checked.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Click the <guibutton>Insert Image</guibutton> button in the toolbar, or select		   

-		         <menuchoice>

-			<guimenu>Insert</guimenu>

-			<guimenuitem>Image</guimenuitem>

-		      </menuchoice>.

-		      </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Choose your image by clicking the <guibutton>Browse</guibutton> button.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Press <guibutton>Insert</guibutton> to insert the image.

-		    </para>

-		  </listitem>

-		</orderedlist>

-	      </para>

-	    </listitem>

-	  </varlistentry>

-	  <varlistentry>

-	    <term><guimenuitem>Rule:</guimenuitem></term>

-	    <listitem>

-	      <para>

-		Inserts a horizontal line into the text to help divide two

-		sections.

-	      </para>

-	      <para>

-		To insert a rule:

-		<orderedlist numeration="arabic">

-		  <listitem>

-		    <para>

-		      Open a new email by clicking <guibutton>New Message</guibutton>

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Make sure that you have the

-		      <menuchoice>

-			<guimenu>Format</guimenu>

-			<guimenuitem>HTML</guimenuitem>

-		      </menuchoice>

-                      selector checked.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Click the <guibutton>Rule</guibutton> button in the <guilabel>Toolbar</guilabel>.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Select the type of rule. You can use a plain

-		      line, a 3D line, or a yellow line with flowers.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Choose the size of the line, as a percentage of the width of the email window.

-		    </para>

-		  </listitem>

-

-		  <listitem>

-		    <para>

-		      Choose the alignment and style.  For the plain

-		      line, you can choose the thickness of the line,

-		      and whether it will be shaded, or solid.  For the

-		      other types, you can only choose alignment.

-		    </para>

-		  </listitem>

-

-		  <listitem>

-		    <para>

-		      Click <guibutton>Insert</guibutton> to insert the rule.

-		    </para>

-		  </listitem>

-		</orderedlist>

-	      </para>

-	    </listitem>

-	  </varlistentry>

-	  <varlistentry>

-	    <term>Table:</term>

-	    <listitem>

-	      <para>

-		Inserts a table into the text to help divide two

-		sections.

-	      </para>

-	      <para>

-		To insert a rule:

-		<orderedlist numeration="arabic">

-		  <listitem>

-		    <para>

-		      Open a new email by clicking <guibutton>New Message</guibutton>

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Make sure that you have the

-		      <menuchoice>

-			<guimenu>Format</guimenu>

-			<guimenuitem>HTML</guimenuitem>

-		      </menuchoice>

-                      selector checked.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Click the <guibutton>Table</guibutton> button in the <guilabel>Toolbar</guilabel>.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Select the <guibutton>Template</guibutton> you wish to use.  Each template has a slightly different feel and layout.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      If you so desire, you may change the other options such as: number of rows, columns, spacing of each cell, and more.

-		    </para>

-		  </listitem>

-		  <listitem>

-		    <para>

-		      Click the <guibutton>Insert</guibutton> button.

-		    </para>

-		  </listitem>

-		</orderedlist>

-	      </para>

-	    </listitem>

-	  </varlistentry>

-	</variablelist>

-	To add a hyperlink to your HTML message:

-	<orderedlist numeration="arabic">

-	  <listitem>

-	    <para>

-	      Select the text you want to display as a link.

-	    </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>

-	     Select

-	      <menuchoice>

-		<guimenu>Insert</guimenu>

-		<guimenuitem>Image</guimenuitem>

-	      </menuchoice>.

-	    </para>

-	  </listitem>

-	  <listitem>

-	    <para>

-	      Click <guibutton>Browse</guibutton> to select the image

-	      you want to include in your email.

-	    </para>

-	  </listitem>

-

-	  <listitem>

-	    <para>

-	    Along the right side of the window, choose the alignment,

-	    border, and other attributes of the image. If you change

-	    the size attributes, the image will be shrunk or stretched

-	    to fit the size you have chosen.

-	    </para>

-	  </listitem>

-

-	  <listitem>

-	    <para>

-	     If you would like to make the image a clickable link,

-	     enter a URL in the <guilabel>Link</guilabel> tab of the

-	     window.

-	    </para>

-	  </listitem>

-

-	  <listitem>

-	    <para>

-	      When you are finished, press

-	      <guibutton>Insert</guibutton> to include the image in

-	      your message.

-	    </para>

-	  </listitem>

-	</orderedlist>

-      </para>

-      <para>

-        You can insert an image into the background of your message by

-        right-clicking on the message background and selecting

-        <guimenuitem>Page</guimenuitem>. From that dialog, you may

-        also select background color and set other general options

-        about the html message you are composing.

-     </para>

-      <sect3 id="html-templates">

-	<title>HTML Templates</title>

-	<para>

-          <application>Evolution</application> not only allows you to

-	  decorate your email with HTML text and graphics, but

-	  provides you with prebuilt templates for you to use when

-	  making these improvements.  You can use these to emphasize a

-	  point or frame an image in an attractive manner.

-        </para>

-	<para>

-	  To include a template into your HTML based email:

-	  <orderedlist numeration="arabic">

-	    <listitem>

-	      <para>

-		Create a new email by clicking <guibutton>New Message</guibutton>.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Make sure that the

-		<menuchoice>

-		  <guimenu>

-		    Format

-		  </guimenu>

-		  <guimenuitem>

-		    HTML

-		  </guimenuitem>

-		</menuchoice>

-		selector is checked.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Click the <guibutton>HTML Template</guibutton> button in the 

-		<guilabel>Toolbar</guilabel> or select 		

-		<menuchoice>

-		  <guimenu>

-		  Insert

-		  </guimenu>

-		  <guimenuitem>

-		    HTML Template

-		  </guimenuitem>

-		</menuchoice>

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Select the template type in the

-		<guilabel>Template</guilabel> selection box. Your

-		options are <guilabel>Note</guilabel> and

-		<guilabel>Image Frame</guilabel>.  

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Set the size and alignment of the HTML template.

-	      </para>

-	    </listitem>

-

-	    <listitem>

-	      <para>

-		Click <guibutton>Insert</guibutton> to insert it where the 

-		cursor is.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Click on the text in the template, and enter the text

-		you want to use.

-              </para>

-	      <para>

-		If you have selected an image frame template,

-		right-click on the image and select

-		<guimenuitem>Image</guimenuitem> to select the image

-		you want to place in the frame.

-	      </para>

-	    </listitem>

-	  </orderedlist>

-	</para>

-      </sect3>

-      <sect3 id="composer-tables">

-	<title>Tables in Email</title>

-	<para>

-	  <application>Evolution</application> allows you to put

-	  tables in your HTML email to help organize your thoughts.

-	  These tables are a simplified version of what you might find

-	  in a spreadsheet program like

-	  <application>Gnumeric</application>.

-	</para>

-	<para>

-	  To include a table in your email:

-	  <orderedlist numeration="arabic">

-	    <listitem>

-	      <para>

-		Create a new email by clicking <guibutton>New Message</guibutton>.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Make sure you have the

-		<menuchoice>

-		  <guimenu>

-		    Format

-		  </guimenu>

-		  <guimenuitem>

-		    HTML

-		  </guimenuitem>

-		</menuchoice>

-		selector checked.

-	      </para>

-	    </listitem>

-

-	    <listitem>

-	      <para>

-	      Select

-		<menuchoice>

-		  <guimenu>

-		    Insert

-		  </guimenu>

-		  <guimenuitem>

-		    Table

-		  </guimenuitem>

-		</menuchoice>

-		or click the <guiicon>Table</guiicon> button in the

-		toolbar.

-	      </para>

-	    </listitem>

-

-	    <listitem>

-	      <para>

-		Select the template, or style, you want to use for the

-		table.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Set the number of rows and columns you want.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Click the <guibutton>Insert</guibutton> button.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Click in a cell and type to insert text into the table.

-	      </para>

-	    </listitem>

-	  </orderedlist>

-	</para>

-	<para>

-	  You can also edit a table after creation.  Just right-click

-	  on it and select <guimenuitem>Table</guimenuitem> to open

-	  the table editing window again. Or, you can select items

-	  from the <guimenu>Table Delete</guimenu> and <guimenu>Table

-	  Insert</guimenu> menus.

-	  </para>

-	

-	<para>

-	  <tip id="table-tip">

-	  <title>Deleting an Entire Table</title>

-	  <para>

-	    You can delete an entire table by right-clicking on

-            a table or other HTML object in a message, and selecting

-	  <menuchoice>

-	    <guimenu>Table Delete</guimenu>

-	    <guimenuitem>Table</guimenuitem> </menuchoice>.  In an

-	    HMTL message, your signature, templates, and image

-	    inclusions all have tables around them, and you can remove

-	    them completely and quickly with this shortcut.

-	  </para>

-         </tip>

-        </para>

-

-      </sect3>

-    </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>

-                WRITING IN CAPITAL LETTERS 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. By

-               default, <application>Evolution</application> will put

-               a red line beneath words it doesn't recognize, as you

-               type them.

-              </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 spam.

-	    </para>

-	  </listitem>

-	</itemizedlist>

-      </para>

-    </sect2>

-    <sect2 id="fancy-mail">

-      <title>Making Your Email More Fancy</title>

-      <para>

-	<application>Evolution</application> can do a lot with email

-	by utilizing the HTML features.  Making an email functional

-	and visually attractive can be challenging.  The following

-	section provides tips to make your mail functional, while

-	being more visually attractive than ever.

-      </para>

-      <sect3 id="sections-bolded-title">

-	<title>Sections Outlined in Bold</title>

-	<para>

-	  Indented sections are a great way to categorize and group

-	  your thoughts together.  Below is an example of indented

-	  text with headings to help separate your thoughts into the

-	  proper sections:

-	  <figure>

-	    <title>Indented Text with Headlines</title>

-	    <screenshot>

-	      <screeninfo></screeninfo>

-	      <graphic  format="png" fileref="figures/outline" srccredit="Kevin Breit">

-	    </screenshot>

-	  </figure>

-	</para>

-	<para>

-	  This message is not only more attractive, but more

-	  informative.  Each section is broken down into subsctions.

-	  The title for each section is in bold text, with the

-	  following content indented.

-	</para>

-	<para>

-	You may want to increase the size of your section headlings

-	instead of merely putting them in bold.  Header size 4 is

-	often the best choice, since it is not too large.  You can

-	change your text to size 4 by selecting it and pressing

-	Ctrl+4.  You can set your text to the normal text size by

-	hitting Ctrl+0.

-	</para>

-      </sect3>

-      <sect3 id="bulleted-lists">

-	<title>Bulleted Lists</title>

-	<para>

-	  Select the <guimenuitem>Bulleted List</guimenuitem> option

-	  from the text style drop-down box to begin making a bulleted

-	  list. <application>Evolution</application> will handle the

-	  word wrap and indentation for you.  If you prefer to send

-	  the message in plain text, you can still write it up in

-	  HTML, and <application>Evolution</application> will convert

-	  to a well-formed plain-text bulleted list, using asterisks

-	  instead of HTML bullets.

-	</para>

-      </sect3>

-      <sect3 id="inline-images">

-	<title>Images In Your Email</title>

-	<para>

-	  Images can help people to understand your point.  You can

-	  even use a HTML Picture Frame Template in

-	  <application>Evolution</application>, which looks very

-	  attractive and sets your image off from the rest of your

-	  message with a border and caption.

-	</para>

-	<para>

-	  If you do choose to use images, try to keep them narrow.  If

-	  your images are wider than 400 pixels, the image may not fit

-	  in the whole email window, making it hard for your reader to

-	  read the email and view the image.  Consider using a smaller

-	  version ("thumbnail") of your image, and offering a link to

-	  the larger version your readers can view in a web browser if

-	  they want.

-	  <figure>

-	    <title>Images in an email</title>

-	    <screenshot>

-	      <screeninfo></screeninfo>

-	      <graphic  format="png" fileref="figures/small_desktop" srccredit="Kevin Breit">

-	    </screenshot>

-	  </figure>

-	</para>

-      </sect3>

-      <sect3 id="color-suggestions">

-	<title>Coloring Your Text</title>

-	<para>

-	  Colors can help bring words or sentences out for emphasis.  You

-	  should choose your colors carefully though, as the wrong color

-	  can be distracting.  Some good colors to use would be:

-	  <itemizedlist>

-	    <listitem>

-	      <para>

-		Light brown

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Dull purple

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Dark red

-	      </para>

-	    </listitem>

-	  </itemizedlist>

-	  <!-- Include a screenshot -->

-	  Notice how these colors are similar saturation <!-- Confirm I am using the right word -->

-	</para>

-	<para>

-	  Happy mailing!

-	</para>

-      </sect3>

-    </sect2>

-  </sect1>

-  <sect1 id="rsvp-stuff">

-    <title>RSVPs in Mail</title>

-    <para>

-      If you create an event in the calendar component, you can then

-      send invitations to the attendee list through the

-      <application>Ximian Evolution</application> email tool.  The

-      invitation card is sent as an attachment in iCal format.

-    </para>

-    <para>

-      If you click on the attachment button and click the

-      <guibutton>View Inline</guibutton>, <application>Ximian

-      Evolution</application> will show you information about the

-      meeting, and let you respond to the meeting in several ways.

-      Select the response that you would like, and then click the

-      <guibutton>OK</guibutton> button.

-   </para>

-   <para>

-  Your options are:

-      <variablelist>

-	<varlistentry>

-	  <term>Accept:</term>

-	  <listitem>

-	    <para>

-	  Select this entry if you will attend the meeting.  When you

-	  click the <guibutton>OK</guibutton> button, the meeting will

-	  be entered into your calendar.

-	    </para>

-	  </listitem>

-	</varlistentry>

-

-	<varlistentry>

-	  <term>Tentatively Accept:</term>

-	  <listitem>

-	    <para>

-	  Select this entry if you will probably attend the meeting.

-	  When you click the <guibutton>OK</guibutton> button, the

-	  meeting will be entered into your calendar, but marked as

-	  tentative.

-	    </para>

-	  </listitem>

-	</varlistentry>

-

-	<varlistentry>

-	  <term>Decline:</term>

-	  <listitem>

-	    <para>

-	  Select this item if you will be unable to attend the

-	  meeting. The meeting will not be entered into your calendar

-	  when you click the <guibutton>OK</guibutton>, although your

-	  response will be sent to the meeting host if you have

-	  checked the <guilabel>RSVP</guilabel> box.

-	    </para>

-	  </listitem>

-	</varlistentry>

-

-	<varlistentry>

-	  <term>RSVP:</term>

-	  <listitem>

-	    <para>

-	     Check this box if you would like your response sent to

-	     the meeting organizers.

-	    </para>

-	  </listitem>

-	</varlistentry>

-     </variablelist>

-    </para>

-  </sect1>

-

-  <sect1 id="usage-mail-subscriptions">

-    <title>Subscription Management</title>

-    <para>

-      Since IMAP folders exist on the server, and opening them or

-      checking them takes time, you need fine-grained control over the

-      way that you use IMAP folders.  That's why

-      <application>Evolution</application> has an IMAP subscriptions

-      manager.  If you prefer to have every mail folder displayed, you

-      can select that option as well. However, if you'd like to choose

-      specific items in your mailbox, and exclude others, you can use

-      the subscription management tool to do that.

-    </para>

-    <para>

-    Here's how:

-      <orderedlist numeration="arabic">

-	

-	<listitem>

-	  <para>

-	   Select

-	   <menuchoice><guimenu>Tools</guimenu><guimenuitem>Subscribe

-	   to Folders</guimenuitem></menuchoice>.

-	  </para>

-	</listitem>

-

-	<listitem>

-	  <para>

-	    If you have accounts on multiple IMAP servers, select the

-	    server where you'd like to manage your

-	    subscriptions. <application>Evolution</application> will

-	    display a list of available files and folders.

-	  </para>

-	</listitem>

-

-	<listitem>

-	  <para>

-            Select a file or folder by clicking on it.  You will want

-            to select at least the <guilabel>INBOX</guilabel>

-            folder. Depending upon the way your IMAP server is

-            configured, the list of available files may include

-            non-mail folders. If it does, you can ignore them.

-	  </para>

-	</listitem>

-

-	<listitem>

-	  <para>

-	    Click the <guibutton>Subscribe</guibutton> to add it to

-	    the subscribed list.

-	  </para>

-	</listitem>

-	<listitem>

-	  <para>

-	    When you have subscribed to the folders you want, 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 keeping information safe

-	from prying eyes. <application>Evolution</application> helps

-	you you protect your privacy by using

-	<application>gpg</application>, an implementation of strong

-	<glossterm linkend="public-key-encryption">Public Key

-	Encryption.</glossterm>

-      </para>

-

-	<note id="pub-priv">

-	  <title>Public Key?  Private Key?  What is the difference?</title>

-	  <para>

-	    GPG uses two keys: public and private.  You can give your

-	    public key to anyone you want to receive

-	    encrypted messages, or put it on a public key server so

-	    that people can look it up before contacting you.

-	    <emphasis>Never give your private key to anyone,

-	    ever</emphasis>.  Your private key lets you decrypt any

-	    message encrypted with your public key.

-	  </para>

- 	</note>

-

-      <para>

-        Using encryption takes a bit of forethought.  When you send a

-        message that is encrypted, you must encrypt it using your

-        intended recipient's public key.  To <emphasis>get</emphasis>

-        an encrypted message, you must make sure that the sender has

-        your public key in advance. For signing messages, it's

-        reversed: you encrypt the signature with your private key, so

-        only your public key can unlock it. When you send it, the

-        recipient gets your public key and unlocks the signature,

-        verifying your identity.

-      </para>

-

-      <para>

-	You can use encryption in two different ways:

-        <simplelist>

-          <member>

-             Encrypt the entire message, so that nobody but the recipient can read it.

-          </member>

-          <member>

-            Attach an encrypted signature to a plain text message, so

-            that the recipient can read the message without decrypting

-            it, and only needs decryption to verify the sender's

-            identity. 

-           </member>

-         </simplelist>

-      </para>

-

-	<example> 

-         <title>Sending an Encrypted Messagee</title>

-	  <para>

-	    Kevin wants to send an encrypted message to his friend

-	    Rachel.  He looks up her public key on a general key

-	    server, and then tells

-	    <application>Evolution</application> to encrypt the

-	    message.  The message now reads "@#$23ui7yr87#@!48970fsd."

-	    When the information gets to Rachel, she decrypts it using

-	    her private key, and it appears as plain text for her to

-	    read.

-	  </para>

-	</example>

-      <tip id="always-sign">

-	<title>Always Sign</title>

-	<para>

-	  You can set <application>Evolution</application> to always sign your email messages:

-	  <orderedlist numeration="arabic">

-	    <listitem>

-	      <para>

-		Open your account preferences.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Open the <guilabel>Security</guilabel> tab.

-	      </para>

-	    </listitem>

-	    <listitem>

-	      <para>

-		Click the <guibutton>Always sign outgoing messages when using this account</guibutton> button.

-	      </para>

-	    </listitem>

-	  </orderedlist>

-	</para>

-      </tip>

-    </sect2>

-

-

-

-    <sect2 id="encryption-keygen">

-      <title>Making Encryption Keys</title>

-      <para>

-        Before you can get or send encrypted mail, you need to

-	generate your public and private keys with GPG. Here's how:

-      </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>

-        <orderedlist numeration="arabic">

-	  <listitem>

-      	   <para>

-            Open a terminal and type <command>gpg --gen-key</command>.

-	  </para>

-         </listitem>

-

-	  <listitem>

-      	   <para> 

-             Choose the default algorythm, "DSA and ElGamal."

-	  </para>

-         </listitem>

-

-	  <listitem>

-      	   <para>

-            Choose a key length. The default, 1024 bits, should be

-            long enough.

-	  </para>

-         </listitem>

-

-	  <listitem>

-      	   <para>

-             Decide if you want your key to expire automatically, and if so, when.

-	  </para>

-         </listitem>

-

-

-	  <listitem>

-      	   <para>

-            Enter your name, email address, and any additional

-            personal information you think is appropriate. Do not

-            falsify this information, because it will be needed to

-            verify your identity later on.

-	  </para>

-         </listitem>

-

-	  <listitem>

-      	   <para>

-             Next, enter your passphrase. It does not have to be the

-             same as your email password or your login password. In

-             fact, it probably shouldn't. Don't forget it. If you lose

-             it, your keys will be useless and you will be unable to

-             decrypt messages sent to you with those keys.

-	  </para>

-         </listitem>

-

-	  <listitem>

-      	   <para>

-             Now, GPG will generate your keys.  This may take awhile,

-             so feel free to do something else while it's

-             happening. In fact, using your computer for something

-             else actually helps to generate better keys, because it

-             increases the randomness in the key generation seeds.

-	  </para>

-         </listitem>

-	</orderedlist>

-      </para>

-      <para>

-	Once the keys are generated, you can view your key information

-        by typing <command>gpg --list-keys</command>.  You should see

-        something similar to this:

-        <programlisting>

-	    /home/you/.gnupg/pubring.gpg

-	    ----------------------------

-	    pub 1024D/32j38dk2 2001-06-20 you &lt;you@your-address.com&gt;

-	    sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]

-	</programlisting>

-      </para>

-      <para>

-         GPG will create one list, or keyring, for your public keys

-         and one for your private keys. All the public keys you know

-         are stored in the file

-         <filename>~/.gnupg/pubring.gpg</filename>. If you want to

-         give other people your key, send them that file.

-      </para>

-      <para>

-          If you wish, you can upload your keys to a keyserver. Here's

-          how:

-        <orderedlist>

-	  <listitem>

-	    <para>

-              Check your public key ID with <command>gpg

---list-keys</command>. It will be the string after 1024D on the line

-beginning with "pub." In this example, it's 32j38dk2.

-            </para>

-	  </listitem>

-	  <listitem>

-	    <para>

-	     Enter the command <command>gpg --send-keys --keyserver

-wwwkeys.pgp.net 32j38dk2</command>.  Substitute your key ID for

-32j38dk2. You will need your password to do this.

-             </para>

-           </listitem>

-    </orderedlist>

-

-	<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 people public

-	    key, include it in your signature file, or put it on your

-	    own web page. However, it's easier to publish them once,

-	    and then let people download them from the keyserver when

-	    they want.

-	  </para>

-          <para>

-             If you don't have a key you need to unlock or encrypt a

-             message, you can have your encryption tool set to look it

-             up automatically. If it can't find the key, then you'll

-             get an error message.

-          </para>

-	</note>

-

-      </para>

-    </sect2>

-

-    <sect2 id="encrypt-getting-key">

-      <title>Getting and Using Public Keys</title>

-      <para>

-	To encrypt a message to your someone else you'll need to use

-	their public key in combination with your private key.

-	<application>Evolution</application> does that for you, but

-	you still need to get their key and add it to your keyring.

-     </para>

-     <para>

-        To get public keys from a public key server, enter the

-        command:

-	<command>

-	  gpg --recv-keys --keyserver wwwkeys.pgp.net keyid

-	</command>, substituting "keyid" for your recipient's ID.  You

-	will need to type in your password, and then their ID will

-	automatically be added to your keyring. When you send mail to

-	them, <application>Evolution</application> will allow you to

-	encrypt your messages.

-      </para>

-      <para>

-        If someone sends you their public key directly, save it as a

-        plain text file and enter the command <command>gpg

-        filename</command>. This will add it 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>Settings</guimenuitem>

-	</menuchoice>

-	and select the <guilabel>Mail Accounts</guilabel> button, then

-	select the account you want to use securely, and click the

-	<guibutton>Edit</guibutton> button. Then, select the

-	<guilabel>Security</guilabel> tab in the account dialog.   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>

-      <note>

-	<title>What is my Key ID again?</title>

-	<para>

-	  <application>Evolution</application> requires that you know your key ID.  If you don't remember it, you can find it by typing <command>gpg --list-keys</command> in a console window.  Your key ID will be an eight character string with random numbers and letters.

-	</para>

-      </note>

-    </sect2>

-

-    <sect2 id="encrypt-sending">

-      <title>Sending Encrypted Messages</title>

-      <para>

-	As you know, you can use encryption to hide the entire

-	message, or just to verify your signature. Once you've

-	generated your public and private keys, and have the public

-	keys of the people to whom you want to send mail, here's what

-	to do:

-      </para>

-    </sect2>

-    

-    <sect2 id="sign-msg">

-      <title>Signing a Message</title>

-      <para>

-	To sign a message, choose:

-	<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.

-	  Just choose the menu item

-	  <menuchoice>

-	    <guimenu>Security</guimenu>

-	    <guimenuitem>PGP Encrypt</guimenuitem>

-	  </menuchoice>

-	</para>

-      </sect2>

-      <sect2 id="unencrypting">

-	<title>Unencrypting a Received Message</title>

-	<para>

-	  If you get an encrypted message, you will need to decrypt it

-	  before you read it. Remember, the sender has to have your

-	  public key before they can send you an encrypted message.

-	</para>

-	<para>

-	  When you view the message,

-	  <application>Evolution</application> will ask you for your

-	  PGP password.  Enter it, and the message will be displayed

-	  properly.  

-       </para>

-    </sect2>

-  </sect1>

-</chapter>

+<chapter id="usage-mail">
+  <title>Using Evolution for Email</title>
+  <para>
+    This chapter, and <xref linkend="usage-mail-organize"/>, will
+      provide you with an in-depth guide to the capabilities of
+      Evolution as a mail client.  For information about how to set up
+      your mail account, see <xref linkend="config-prefs-mail"/>.
+  </para>
+  
+  <note>
+    <title>If you use IMAP Mail</title>
+    <para>
+      If you chose IMAP mail during the setup process, you must
+      subscribe to your mail folders before you can read mail in
+      them. Read <xref linkend="usage-mail-subscriptions"/> to find out
+      how.
+    </para>
+  </note>
+  
+  
+  <sect1 id="usage-mail-getnsend-read">
+    <title>Reading Mail</title>    
+    <para>
+      Start the mail client by clicking on the
+      <guibutton>Inbox</guibutton> icon in the shortcut bar, or by
+      selecting a mail folder in the folder bar.  To read a message,
+      select it in the message list; if you'd like to see it in its
+      own window, double-click on it or press
+      <keycombo action="simul">
+	<keycap>Ctrl</keycap>
+	<keycap>O</keycap>
+      </keycombo>.
+    </para>
+
+      <tip id="spaceandbs">
+	<title>Reading Mail with the Keyboard</title>
+	<para>
+	  You can click the spacebar to page down while you're reading
+	  an email, and press backspace to page up in an email.  This
+	  may help to make reading your email faster.
+	</para>
+      </tip>
+
+    <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>
+
+      <tip id="view-headers">
+	<title>Email Headers</title>
+	<para>
+	  To look at the complete headers for email messages, select
+	  <menuchoice><guimenu>View</guimenu><guisubmenu>Message
+	  Display</guisubmenu><guimenuitem>Show Full
+	  Headers</guimenuitem></menuchoice>. To see absolutely every
+	  bit, choose
+	  <menuchoice><guimenu>View</guimenu><guisubmenu>Message
+	  Display</guisubmenu><guimenuitem>Show Email Source
+	  </guimenuitem></menuchoice>.
+       </para>
+      </tip>
+
+      <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>
+      <figure>
+        <title>Threaded Mail View</title>
+	<screenshot>
+	  <screeninfo>Threaded Mail View</screeninfo>
+	  <mediaobject><imageobject>
+	      <imagedata  format="PNG" fileref="figures/mail-threaded" srccredit="Aaron Weber"/>
+	    </imageobject></mediaobject>
+	</screenshot>
+      </figure>
+
+    </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 on the message and
+	      choose <guilabel>Delete</guilabel>.
+	    </para>
+	    <note>
+	      <title>Why do I still see deleted mail?</title>
+	      <para>
+		When you press <guibutton>Delete</guibutton> or click
+		the trash button, your mail isn't actually deleted,
+		but is marked for deletion.  Your email is not gone
+		until you have expunged it. When you "Expunge" a
+		folder, you remove all the mail that you have marked
+		for deletion.
+	      </para>
+              <para>
+                 If you don't like this behavior, select
+                 <menuchoice><guimenu>View</guimenu><guimenuitem>Hide
+                 Deleted Messages</guimenuitem></menuchoice>. Then,
+                 you will only see deleted messages when you look in
+                 your <guilabel>Trash</guilabel> folder.
+              </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 vFolder?</title>
+	<para>
+	  Both local and IMAP Trash folders are actually vFolders that
+          display all messages you have marked for later deletion.
+          For more information about vFolders, see <xref
+          linkend="usage-mail-organize-vfolders"/>.  Since emptying
+          your trash expunges the messages in your Trash folder,
+          choosing <menuchoice> <guimenu>Actions</guimenu>
+          <guimenuitem>Empty Trash</guimenuitem> </menuchoice> is the
+          same as expunging deleted mail from <emphasis>all</emphasis>
+          your folders.
+	</para>
+        <para>
+           This is not, however, true for the Trash folder on Exchange
+           servers, which behaves just the same as it would in
+           Outlook. That is to say, the Trash folder on an Exchange
+           server is a normal folder with actual messages in it.
+        </para>
+      </note>
+    </sect2>
+    <sect2 id="usage-mail-getnsend-undelete">
+      <title>Undeleting Messages</title>
+      <para>
+	To undelete a message:
+	<orderedlist numeration="arabic">
+	  <listitem>
+	    <para>
+	      Select a message you have marked for deletion.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Press <keycombo
+	      action="simul"><keycap>Ctrl</keycap><keycap>U</keycap>
+	      </keycombo>
+	      or choose
+	      <menuchoice>
+		<guimenu>Edit</guimenu>
+		<guimenuitem>Undelete</guimenuitem>
+	      </menuchoice>
+
+	    </para>
+	    <note>
+	      <title>What does Undelete actually do?</title>
+	      <para>
+                If you have marked a message for deletion, undeleting
+		it will unmark it, and the message will be removed
+		from the Trash folder. However, it can't bring back
+		messages that have been expunged.
+	      </para>
+	    </note>
+	  </listitem>
+	</orderedlist>
+      </para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="usage-mail-getnsend-get">
+    <title>Checking for New 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 you haven't entered any mail settings yet, the
+      <interface>setup assistant</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
+      haven't asked <application>Evolution</application> 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"/>, or ask your
+	system administrator.
+       </para>
+     </note>
+
+
+
+          <tip>
+            <title>Sharing Mailboxes with Other Mail Programs</title>
+            <para>
+              If you want to use <application>Evolution</application>
+              and another email client, such as
+              <application>Mutt</application>, at the same time,
+              here's how:
+              <orderedlist numeration="arabic">
+                <listitem>
+                   <para>
+                      Download your mail in the other application as
+                      you would normally.
+                   </para>
+                  </listitem>
+                <listitem>
+                   <para>
+                      In <application>Evolution</application>
+                      <menuchoice><guimenu>Tools</guimenu><guimenuitem>Mail
+                      Settings</guimenuitem></menuchoice>, and pick the account
+                      you'd like to use to share mail. You may want to
+                      create a new account just for this source of
+                      mail.
+                   </para>
+               </listitem>                     
+               <listitem>
+                   <para>
+                      Under the <guilabel>Receiving Mail</guilabel>
+                      tab, select the type of mail file that your
+                      other mail application uses, and then enter the
+                      full path to that file.
+                   </para>
+                  </listitem>
+                <listitem>
+                   <para>
+                      Click the <guibutton>OK</guibutton> button.
+                   </para>
+                  </listitem>
+                </orderedlist>
+               </para>
+            </tip>
+
+
+<!-- NOT FOR 1.0
+       <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>Working with Attachments and HTML Mail</title>
+	 <para>
+	   If someone sends you an <glossterm linkend="attachment">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,
+	   including HTML formatting and embedded images, will appear
+	   as part of the message, rather than at the end of the
+	   message as an attachment.
+     </para>
+
+     <sect3 id="usage-mail-getnsend-get-attach-actions">
+     <title>Saving or Opening Attachments</title>
+     <para>
+        If you get an attachment with an email message,
+        <application>Ximian Evolution</application> can help you save
+        it or open it with the appropriate applications.
+     </para>
+     <para>
+       To save an attachment to disk:
+       <orderedlist numeration="arabic">
+	 <listitem>
+	   <para>
+	     Click the downward pointing arrow on the attachment icon
+	     and select <guimenuitem>Save to Disk</guimenuitem>.
+	   </para>
+	 </listitem>
+	 <listitem>
+	   <para>
+	     Choose a location and name for the file.
+	   </para>
+	 </listitem>
+	 <listitem>
+	   <para>
+	     Click <guibutton>OK</guibutton>.
+	   </para>
+	 </listitem>
+       </orderedlist>
+      </para>
+
+      <para>
+	To Open an Attachment in a Program:
+	<orderedlist numeration="arabic">
+	  <listitem>
+	    <para>
+	      Open the mail message with the attachment you want to read.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click the arrow next the attachment icon.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Select the program you'd like to use. It will start up
+	      and open the document.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+      <para>
+      </para>
+      </sect3>
+
+      <sect3 id="usage-mail-getnsend-get-attach-html">
+      <title>Inline Images in HTML Mail</title>
+      <para>
+         When someone sends you HTML mail that includes an image in
+         the body of the message (for example, the welcome message in your
+         Inbox when you first start <application>Ximian
+         Evolution</application>) <application>Evolution</application>
+         will display the image inside the message.  You can create
+         messages like this by using the
+         <menuchoice><guimenu>Insert</guimenu><guimenuitem>Image</guimenuitem></menuchoice>
+         tool in the message composer.
+      </para>
+
+      <para>
+         If the image isn't included in the message, but is, instead,
+         a link to an image, <application>Evolution</application> can 
+         download the image from the Internet for you.  However,
+         <application>Evolution</application> will not display the
+         image unless you ask it to. This is because remotely hosted
+         images can be slow to load and display, and can even be used
+         by spammers to track who reads their email.  Having images
+         not load automatically helps protect your privacy.
+      </para>
+      <para>
+	 If you want the images to load for one message, select 
+	 <menuchoice>
+	   <guimenu>View</guimenu>
+	   <guisubmenu>Message Display</guisubmenu>
+	   <guimenuitem>Load Images</guimenuitem>
+         </menuchoice>.  
+
+         If you want <application>Ximian Evolution</application> to
+         load remotely hosted images more often, go to the
+         <guilabel>Display</guilabel> tab of the
+         <menuchoice>
+	   <guimenu>Tools</guimenu>
+	   <guimenuitem>Mail Settings</guimenuitem>
+         </menuchoice> dialog.
+      </para>
+      <note id="http-proxy">
+	<title>Loading Images from the Net through an HTTP Proxy</title>
+        <para>
+           If you use an HTTP proxy,
+           <application>Evolution</application> must be able to find
+           it through the <systemitem>gnome-vfs</systemitem> subsystem
+           before it can load images from the Internet.  This is also
+           the case if you wish to access weather and news information
+           through the Summary tool. You can tell the GNOME Virtual
+           File System about your HTTP proxy in one of two ways:
+            <variablelist>
+	    <varlistentry>
+	      <term>Configure it with Nautilus</term>
+	      <listitem>
+		<para>
+                 <orderedlist numeration="arabic">
+		    <listitem>
+		      <para>
+			Open a Nautilus window
+	               </para>
+		    </listitem>
+      		    <listitem>
+		      <para>
+	                 Select <menuchoice>
+			  <guimenu>Preferences</guimenu>
+			  <guimenuitem>Edit Preferences</guimenuitem>
+			</menuchoice>.
+	               </para>
+		    </listitem>
+      		    <listitem>
+		      <para>
+			Go to the <guilabel>Navigation</guilabel> tab.
+	               </para>
+		    </listitem>
+      		    <listitem>
+		      <para>
+			Click the <guilabel>Use HTTP Proxy</guilabel>
+			checkbox and enter the location of your HTTP
+			proxy in the <guilabel>Location</guilabel> field.
+	               </para>
+		    </listitem>
+		  </orderedlist>
+                </para>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Configure it with the gconftool command</term>
+	      <listitem>
+	      <para>
+                 <orderedlist numeration="arabic">
+		    <listitem>
+		      <para>
+                        Open a terminal.
+                      </para>
+		    </listitem>
+		    <listitem>
+		      <para>
+                        Enter the command 
+                        <command>
+                        gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE"
+                        </command>
+                      </para>
+		    </listitem>
+		    <listitem>
+		      <para>
+                        Enter the command 
+                        <command>
+      gconftool --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url"
+                        </command>
+                      </para>
+		    </listitem>
+		    <listitem>
+		      <para>
+                        Enter the command 
+                        <command>
+                        gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080"
+                        </command>                  
+                      </para>
+		    </listitem>
+		  </orderedlist>
+                </para>
+		<para>
+                  For more information about the gconftool command,
+                  read the gconftool man page.
+                </para>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+         </para>
+      </note>
+     </sect3>
+    </sect2>
+  </sect1>
+
+    <sect1 id="usage-mail-getnsend-send">
+      <title>Composing New Email Messages</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>
+          <mediaobject><imageobject><imagedata fileref="figures/newmsg" format="PNG" srccredit="Aaron Weber"/>
+        </imageobject></mediaobject>
+        </screenshot>
+      </figure>
+<!-- ==============End of Figure=================================== -->
+
+      <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 box at the bottom of the window.
+      Once you have written your message, press
+      <guibutton>Send</guibutton>.
+    </para>
+
+      <sect2 id="usage-mail-getnsend-send-delay">
+        <title>Sending Composed Messages 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.  The
+           "Send Later" feature is particularly useful if you use a
+           modem to connect to the Internet and pay per-minute
+           charges: you can remain offline until you need to send
+           mail, then connect and send all your mail at once.  Mail in
+           the outbox is sent when you click
+           <guibutton>Send/Receive</guibutton> in the main window.
+        </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. Your options are:
+       <itemizedlist>
+        <listitem><para>
+          Choose
+	  <menuchoice>
+	   <guimenu>File</guimenu>
+	    <guimenuitem>Save Draft</guimenuitem>
+          </menuchoice>
+          to store your messages in the drafts folder for later
+          revision.
+       </para></listitem>
+
+       <listitem><para>
+         If you'd like to have the message sent later, you
+         can choose <guimenuitem>Send Later</guimenuitem>. That way,
+         the message will be added to the queue, and you can send a 
+         batch of messages all at once.
+        </para></listitem>
+        
+        <listitem><para> 
+         If you prefer to save your message as a text file,
+         choose <guimenuitem>Save As</guimenuitem> and then choose a
+         file name.
+           </para>
+	  </listitem>
+	</itemizedlist>
+      </para>
+    </sect2>
+
+  <sect2 id="usage-mail-getnsend-offline">
+            <title>Working Offline</title>
+            <para>
+              Offline mode is a tool designed for use with a dialup
+              connection or for laptop users who do not have a network
+              connection at all times. It allows you to cache messages
+              for reference while you are not connected to the
+              network, and to compose messages and leave them in your
+              Outbox to be sent the next time you connect to the network.
+             </para>
+            <para>
+	      Select
+	      <menuchoice><guimenu>File</guimenu><guimenuitem>Work
+	      Offline</guimenuitem></menuchoice> to have
+	      <application>Ximian Evolution</application> disconnect
+	      from the Internet while you work. When you want to
+	      reconnect, choose
+	      <menuchoice><guimenu>File</guimenu><guimenuitem>Work
+	      Online</guimenuitem></menuchoice>.  Alternativly, you
+	      can click the connection button at the bottom left side
+	      of the window.
+            </para>
+            <para>
+               If you use POP mail, all your messages will be
+               available to you, because they are stored locally. If
+               you use IMAP or Exchange mail, messages are stored
+               remotely, so availability is a little different.
+            </para>
+            <para>
+               Messages that you have read are cached and stored
+               locally; all read messages will be available to you
+               even if you are offline. Unread messages will be
+               downloaded and saved for offline use if they are in a
+               folder that you have marked as an Offline Folder. To
+               mark a folder for offline use, select
+               <menuchoice><guimenu>Settings</guimenu>
+               <guimenuitem>Preferences</guimenuitem></menuchoice> and
+               then click the <guilabel>Folders</guilabel> icon. In
+               the <guilabel>Offline Folders</guilabel> tab, click the
+               check-box next to the folders that you would like to
+               use while you are offline. Then, when you select
+               <guimenuitem>Go Offline</guimenuitem>, Evolution will
+               fetch their contents and store them for later
+               reference.
+          </para>
+       </sect2>
+    <sect2 id="usage-mail-getnsend-send-compose">
+      <title>More About Mail Composition</title>
+      <para>
+        In the next few sections, you'll see how
+	<application>Evolution</application> handles advanced email
+	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>
+       </sect3>
+
+      <sect3 id="usage-mail-getnsend-send-to-types">
+	<title>Specifying Recipients for Email</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
+            <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.
+          </para>
+          <para>
+            <guilabel>Bcc:</guilabel> is a little more complex.  You
+            use it like <guilabel>Cc:</guilabel>, but people on the
+            <guilabel>Bcc:</guilabel> list are hidden from the other
+            recipients of the message. Use it to send mail to large
+            groups of people, especially if they don't know each other
+            or if privacy is a concern.  If your <guilabel>Bcc:</guilabel> field is absent, click
+	    <menuchoice>
+	      <guimenu>View</guimenu>
+	      <guimenuitem>Bcc Field</guimenuitem>
+	    </menuchoice>.
+		
+          </para>
+
+         <para>
+           If you frequently write email to the same groups of people,
+           you can create address lists in the Contact Manager, and
+           then send them mail as though they had a single address.
+           To learn how to do that, read <xref
+           linkend="usage-contact-organize-group-list"/>.
+        </para>
+
+	<tip id="reply-to-per-mail">
+	  <title>Setting Reply-to On a Per-Mail Basis</title>
+	  <para>
+	    <application>Evolution</application> has the ability to
+	    let you specify the Reply-To in an email. Using this, you
+	    can setup a special Reply-To for an email.  To do this:
+	    <orderedlist numeration="arabic">
+	      <listitem>
+                <para>
+		  Open a composer window
+			 </para>
+			 </listitem>
+			 <listitem>
+			 <para>
+			 Open the Reply-To field by selecting
+			 <menuchoice>
+			 <guimenu>View</guimenu>
+			 <guimenuitem>Reply To</guimenuitem>
+			 </menuchoice>
+			 </para>
+			 </listitem>
+			 <listitem>
+			 <para>
+			 Enter the address you wish to have be the
+			 Reply-To address in the new Reply-To field.
+			 </para>
+			 </listitem>
+			 </orderedlist>			 
+	  </para>
+	</tip>
+        </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 offer a
+          drop down list of possible address completions from your
+          address book.  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. 
+
+<!-- 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. NOTE: Bug filed on this: it's not available now,
+          but may be in the future. 
+-->
+
+          </para>
+
+          <para>
+            Alternately, you can click on the
+            <guibutton>To:</guibutton>, <guibutton>Cc:</guibutton>, or
+            <guibutton>Bcc:</guibutton> buttons to get a list --
+            potentially a very long one -- 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="contact-automation-basic"/> and <xref
+            linkend="usage-calendar-apts"/>.
+          </para>
+        </sect3>
+      </sect2>
+
+      <sect2 id="usage-mail-getnsend-send-reply">
+        <title>Replying to Email 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"/>.
+
+ <!-- ==============Figure=================================== -->
+       <figure id="usage-mail-getnsend-reply-fig">
+         <title>Reply Message Window</title>
+         <screenshot>
+          <screeninfo>Evolution Main Window</screeninfo>
+          <mediaobject><imageobject><imagedata fileref="figures/replymsg" format="PNG" srccredit="Aaron Weber"/>
+        </imageobject></mediaobject>
+        </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>
+          If you're subscribed to a mailing list, and want your reply
+          to go just to the list, rather than to the sender, choose
+          <guibutton>Reply to List</guibutton> instead of
+          <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 tools for
+              group collaboration on the Internet. Here's how they work: 
+              <simplelist>
+                <member>
+                  Someone sends a message to a single address, like
+                  <email>evolution@ximian.com</email>.
+                </member>
+                <member>
+                  That address belongs to a program that distributes
+                  the message to a list of recipients.
+                </member>
+             </simplelist>
+               The mail management program lets individuals subscribe
+               to or unsubscribe from the list at will, without
+               requiring the message writers to remember the addresses
+               of every recipient.
+            </para>
+            <para>
+              Mailing list servers can also let network administrators
+              control mail flow, list membership, and even moderate
+              the content of mailing lists.
+            </para>
+          </note>
+        </para>
+      </sect2>
+
+      <sect2 id="usage-mail-getnsend-send-find">
+        <title>Searching and Replacing with the Composer</title>
+        <para>
+           You are probably familiar with search and replace features
+           in any sort of text-editing software, and if you come from
+           a Linux or Unix background, you may know what
+           <guimenuitem>Find Regex</guimenuitem> does.  If you aren't
+           among the lucky who already know, here's a quick rundown of
+           the automated text searching features that the message
+           composer makes available to you.
+        </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>Enhance your email with HTML</title>
+        <para>
+            Normally, you can't set text styles or insert pictures in
+            emails, which is why email is often regarded as
+            uncommunicative and cold, and why people often resort to
+            using far too many exclamation points 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. Because some people may
+            prefer not to get HTML mail,
+            <application>Evolution</application> sends plain text
+            unless you explicitly ask for HTML.  
+           </para>
+	 </note>
+
+	 <para> You can change the format of an email message between
+            plain text and HTML by choosing <menuchoice>
+            <guimenu>Format</guimenu> <guimenuitem>
+            HTML</guimenuitem></menuchoice>.
+	  </para>
+	  <para>
+            To send all your mail as HTML by default, set your mail
+            format preferences in the mail configuration dialog.  See
+            <xref linkend="config-prefs-mail-composer"/> for more
+            information.
+      </para>
+      <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 bullet points for the highly
+                  organized.
+                </para>
+	      <tip>
+		<title>Using Bullets to Make Your Email More
+		Attractive</title>
+		<para>
+		  Often times, people use asterisks instead of real bullets.
+		  Not only do asterisks look nicer, but
+		  <application>Evolution</application> will word wrap for you,
+		  which makes your text looks nicer.
+		</para>
+	      </tip>
+	    </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.  You can select a background color or image by
+                  right-clicking on the message background and
+                  selecting <guilabel>Page</guilabel>.
+               </para>
+            </listitem>
+          </varlistentry>
+          </variablelist>
+        </para>
+        <para>
+	The <guimenu>Insert</guimenu> gives you opinions which let you
+           spruce up your email to make it more interesting:
+	<variablelist>
+	  <varlistentry>
+	    <term><guimenuitem>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.  To add a link:
+		<orderedlist numeration="arabic">
+		  <listitem>
+		    <para>
+		      Select the text you wish to link from.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Right click on the text and click on <guibutton>Link</guibutton>.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Put the URL you want to use in the <guilabel>URL</guilabel> field.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Click <guibutton>OK</guibutton>.
+		    </para>
+		  </listitem>
+		</orderedlist>
+	      </para>
+	      <note>
+		<para>
+		  If you're typing a webpage address to be automatically formatted, keep in mind that a space terminates the link.
+		</para>
+	      </note>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term><guimenuitem>Image:</guimenuitem></term>
+	    <listitem>
+	      <para>
+		Lets you put an image alongside text.
+	      </para>
+	      <para>
+		To insert an image into your email:
+		<orderedlist numeration="arabic">
+		  <listitem>
+		    <para>
+		      Open a new email by clicking <guibutton>New Message</guibutton>
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Make sure that you have the
+		      <menuchoice>
+			<guimenu>Format</guimenu>
+			<guimenuitem>HTML</guimenuitem>
+		      </menuchoice>
+                      selector checked.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Click the <guibutton>Insert Image</guibutton> button in the toolbar, or select		   
+		         <menuchoice>
+			<guimenu>Insert</guimenu>
+			<guimenuitem>Image</guimenuitem>
+		      </menuchoice>.
+		      </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Choose your image by clicking the <guibutton>Browse</guibutton> button.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Press <guibutton>Insert</guibutton> to insert the image.
+		    </para>
+		  </listitem>
+		</orderedlist>
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term><guimenuitem>Rule:</guimenuitem></term>
+	    <listitem>
+	      <para>
+		Inserts a horizontal line into the text to help divide two
+		sections.
+	      </para>
+	      <para>
+		To insert a rule:
+		<orderedlist numeration="arabic">
+		  <listitem>
+		    <para>
+		      Open a new email by clicking <guibutton>New Message</guibutton>
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Make sure that you have the
+		      <menuchoice>
+			<guimenu>Format</guimenu>
+			<guimenuitem>HTML</guimenuitem>
+		      </menuchoice>
+                      selector checked.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Click the <guibutton>Rule</guibutton> button in the <guilabel>Toolbar</guilabel>.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Select the type of rule. You can use a plain
+		      line, a 3D line, or a yellow line with flowers.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Choose the size of the line, as a percentage of the width of the email window.
+		    </para>
+		  </listitem>
+
+		  <listitem>
+		    <para>
+		      Choose the alignment and style.  For the plain
+		      line, you can choose the thickness of the line,
+		      and whether it will be shaded, or solid.  For the
+		      other types, you can only choose alignment.
+		    </para>
+		  </listitem>
+
+		  <listitem>
+		    <para>
+		      Click <guibutton>Insert</guibutton> to insert the rule.
+		    </para>
+		  </listitem>
+		</orderedlist>
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>Table:</term>
+	    <listitem>
+	      <para>
+		Inserts a table into the text to help divide two
+		sections.
+	      </para>
+	      <para>
+		To insert a rule:
+		<orderedlist numeration="arabic">
+		  <listitem>
+		    <para>
+		      Open a new email by clicking <guibutton>New Message</guibutton>
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Make sure that you have the
+		      <menuchoice>
+			<guimenu>Format</guimenu>
+			<guimenuitem>HTML</guimenuitem>
+		      </menuchoice>
+                      selector checked.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Click the <guibutton>Table</guibutton> button in the <guilabel>Toolbar</guilabel>.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Select the <guibutton>Template</guibutton> you wish to use.  Each template has a slightly different feel and layout.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      If you so desire, you may change the other options such as: number of rows, columns, spacing of each cell, and more.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Click the <guibutton>Insert</guibutton> button.
+		    </para>
+		  </listitem>
+		</orderedlist>
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	</variablelist>
+	To add a hyperlink to your HTML message:
+	<orderedlist numeration="arabic">
+	  <listitem>
+	    <para>
+	      Select the text you want to display as a link.
+	    </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>
+	     Select
+	      <menuchoice>
+		<guimenu>Insert</guimenu>
+		<guimenuitem>Image</guimenuitem>
+	      </menuchoice>.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click <guibutton>Browse</guibutton> to select the image
+	      you want to include in your email.
+	    </para>
+	  </listitem>
+
+	  <listitem>
+	    <para>
+	    Along the right side of the window, choose the alignment,
+	    border, and other attributes of the image. If you change
+	    the size attributes, the image will be shrunk or stretched
+	    to fit the size you have chosen.
+	    </para>
+	  </listitem>
+
+	  <listitem>
+	    <para>
+	     If you would like to make the image a clickable link,
+	     enter a URL in the <guilabel>Link</guilabel> tab of the
+	     window.
+	    </para>
+	  </listitem>
+
+	  <listitem>
+	    <para>
+	      When you are finished, press
+	      <guibutton>Insert</guibutton> to include the image in
+	      your message.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+      <para>
+        You can insert an image into the background of your message by
+        right-clicking on the message background and selecting
+        <guimenuitem>Page</guimenuitem>. From that dialog, you may
+        also select background color and set other general options
+        about the html message you are composing.
+     </para>
+      <sect3 id="html-templates">
+	<title>HTML Templates</title>
+	<para>
+          <application>Evolution</application> not only allows you to
+	  decorate your email with HTML text and graphics, but
+	  provides you with prebuilt templates for you to use when
+	  making these improvements.  You can use these to emphasize a
+	  point or frame an image in an attractive manner.
+        </para>
+	<para>
+	  To include a template into your HTML based email:
+	  <orderedlist numeration="arabic">
+	    <listitem>
+	      <para>
+		Create a new email by clicking <guibutton>New Message</guibutton>.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Make sure that the
+		<menuchoice>
+		  <guimenu>
+		    Format
+		  </guimenu>
+		  <guimenuitem>
+		    HTML
+		  </guimenuitem>
+		</menuchoice>
+		selector is checked.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Click the <guibutton>HTML Template</guibutton> button in the 
+		<guilabel>Toolbar</guilabel> or select 		
+		<menuchoice>
+		  <guimenu>
+		  Insert
+		  </guimenu>
+		  <guimenuitem>
+		    HTML Template
+		  </guimenuitem>
+		</menuchoice>
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Select the template type in the
+		<guilabel>Template</guilabel> selection box. Your
+		options are <guilabel>Note</guilabel> and
+		<guilabel>Image Frame</guilabel>.  
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Set the size and alignment of the HTML template.
+	      </para>
+	    </listitem>
+
+	    <listitem>
+	      <para>
+		Click <guibutton>Insert</guibutton> to insert it where the 
+		cursor is.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Click on the text in the template, and enter the text
+		you want to use.
+              </para>
+	      <para>
+		If you have selected an image frame template,
+		right-click on the image and select
+		<guimenuitem>Image</guimenuitem> to select the image
+		you want to place in the frame.
+	      </para>
+	    </listitem>
+	  </orderedlist>
+	</para>
+      </sect3>
+      <sect3 id="composer-tables">
+	<title>Tables in Email</title>
+	<para>
+	  <application>Evolution</application> allows you to put
+	  tables in your HTML email to help organize your thoughts.
+	  These tables are a simplified version of what you might find
+	  in a spreadsheet program like
+	  <application>Gnumeric</application>.
+	</para>
+	<para>
+	  To include a table in your email:
+	  <orderedlist numeration="arabic">
+	    <listitem>
+	      <para>
+		Create a new email by clicking <guibutton>New Message</guibutton>.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Make sure you have the
+		<menuchoice>
+		  <guimenu>
+		    Format
+		  </guimenu>
+		  <guimenuitem>
+		    HTML
+		  </guimenuitem>
+		</menuchoice>
+		selector checked.
+	      </para>
+	    </listitem>
+
+	    <listitem>
+	      <para>
+	      Select
+		<menuchoice>
+		  <guimenu>
+		    Insert
+		  </guimenu>
+		  <guimenuitem>
+		    Table
+		  </guimenuitem>
+		</menuchoice>
+		or click the <guiicon>Table</guiicon> button in the
+		toolbar.
+	      </para>
+	    </listitem>
+
+	    <listitem>
+	      <para>
+		Select the template, or style, you want to use for the
+		table.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Set the number of rows and columns you want.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Click the <guibutton>Insert</guibutton> button.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Click in a cell and type to insert text into the table.
+	      </para>
+	    </listitem>
+	  </orderedlist>
+	</para>
+	<para>
+	  You can also edit a table after creation.  Just right-click
+	  on it and select <guimenuitem>Table</guimenuitem> to open
+	  the table editing window again. Or, you can select items
+	  from the <guimenu>Table Delete</guimenu> and <guimenu>Table
+	  Insert</guimenu> menus.
+	  </para>
+	
+	<para>
+	  <tip id="table-tip">
+	  <title>Deleting an Entire Table</title>
+	  <para>
+	    You can delete an entire table by right-clicking on
+            a table or other HTML object in a message, and selecting
+	  <menuchoice>
+	    <guimenu>Table Delete</guimenu>
+	    <guimenuitem>Table</guimenuitem> </menuchoice>.  In an
+	    HMTL message, your signature, templates, and image
+	    inclusions all have tables around them, and you can remove
+	    them completely and quickly with this shortcut.
+	  </para>
+         </tip>
+        </para>
+
+      </sect3>
+    </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>
+                WRITING IN CAPITAL LETTERS 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. By
+               default, <application>Evolution</application> will put
+               a red line beneath words it doesn't recognize, as you
+               type them.
+              </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 spam.
+	    </para>
+	  </listitem>
+	</itemizedlist>
+      </para>
+    </sect2>
+    <sect2 id="fancy-mail">
+      <title>Making Your Email More Fancy</title>
+      <para>
+	<application>Evolution</application> can do a lot with email
+	by utilizing the HTML features.  Making an email functional
+	and visually attractive can be challenging.  The following
+	section provides tips to make your mail functional, while
+	being more visually attractive than ever.
+      </para>
+      <sect3 id="sections-bolded-title">
+	<title>Sections Outlined in Bold</title>
+	<para>
+	  Indented sections are a great way to categorize and group
+	  your thoughts together.  Below is an example of indented
+	  text with headings to help separate your thoughts into the
+	  proper sections:
+	  <figure>
+	    <title>Indented Text with Headlines</title>
+	    <screenshot>
+	      <screeninfo></screeninfo>
+	      <graphic  format="PNG" fileref="figures/outline" srccredit="Kevin Breit"/>
+	    </screenshot>
+	  </figure>
+	</para>
+	<para>
+	  This message is not only more attractive, but more
+	  informative.  Each section is broken down into subsctions.
+	  The title for each section is in bold text, with the
+	  following content indented.
+	</para>
+	<para>
+	You may want to increase the size of your section headlings
+	instead of merely putting them in bold.  Header size 4 is
+	often the best choice, since it is not too large.  You can
+	change your text to size 4 by selecting it and pressing
+	Ctrl+4.  You can set your text to the normal text size by
+	hitting Ctrl+0.
+	</para>
+      </sect3>
+      <sect3 id="bulleted-lists">
+	<title>Bulleted Lists</title>
+	<para>
+	  Select the <guimenuitem>Bulleted List</guimenuitem> option
+	  from the text style drop-down box to begin making a bulleted
+	  list. <application>Evolution</application> will handle the
+	  word wrap and indentation for you.  If you prefer to send
+	  the message in plain text, you can still write it up in
+	  HTML, and <application>Evolution</application> will convert
+	  to a well-formed plain-text bulleted list, using asterisks
+	  instead of HTML bullets.
+	</para>
+      </sect3>
+      <sect3 id="inline-images">
+	<title>Images In Your Email</title>
+	<para>
+	  Images can help people to understand your point.  You can
+	  even use a HTML Picture Frame Template in
+	  <application>Evolution</application>, which looks very
+	  attractive and sets your image off from the rest of your
+	  message with a border and caption.
+	</para>
+	<para>
+	  If you do choose to use images, try to keep them narrow.  If
+	  your images are wider than 400 pixels, the image may not fit
+	  in the whole email window, making it hard for your reader to
+	  read the email and view the image.  Consider using a smaller
+	  version ("thumbnail") of your image, and offering a link to
+	  the larger version your readers can view in a web browser if
+	  they want.
+	  <figure>
+	    <title>Images in an email</title>
+	    <screenshot>
+	      <screeninfo></screeninfo>
+	      <graphic  format="PNG" fileref="figures/small_desktop" srccredit="Kevin Breit"/>
+	    </screenshot>
+	  </figure>
+	</para>
+      </sect3>
+      <sect3 id="color-suggestions">
+	<title>Coloring Your Text</title>
+	<para>
+	  Colors can help bring words or sentences out for emphasis.  You
+	  should choose your colors carefully though, as the wrong color
+	  can be distracting.  Some good colors to use would be:
+	  <itemizedlist>
+	    <listitem>
+	      <para>
+		Light brown
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Dull purple
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Dark red
+	      </para>
+	    </listitem>
+	  </itemizedlist>
+	  <!-- Include a screenshot -->
+	  Notice how these colors are similar saturation <!-- Confirm I am using the right word -->
+	</para>
+	<para>
+	  Happy mailing!
+	</para>
+      </sect3>
+    </sect2>
+  </sect1>
+  <sect1 id="rsvp-stuff">
+    <title>RSVPs in Mail</title>
+    <para>
+      If you create an event in the calendar component, you can then
+      send invitations to the attendee list through the
+      <application>Ximian Evolution</application> email tool.  The
+      invitation card is sent as an attachment in iCal format.
+    </para>
+    <para>
+      If you click on the attachment button and click the
+      <guibutton>View Inline</guibutton>, <application>Ximian
+      Evolution</application> will show you information about the
+      meeting, and let you respond to the meeting in several ways.
+      Select the response that you would like, and then click the
+      <guibutton>OK</guibutton> button.
+   </para>
+   <para>
+  Your options are:
+      <variablelist>
+	<varlistentry>
+	  <term>Accept:</term>
+	  <listitem>
+	    <para>
+	  Select this entry if you will attend the meeting.  When you
+	  click the <guibutton>OK</guibutton> button, the meeting will
+	  be entered into your calendar.
+	    </para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term>Tentatively Accept:</term>
+	  <listitem>
+	    <para>
+	  Select this entry if you will probably attend the meeting.
+	  When you click the <guibutton>OK</guibutton> button, the
+	  meeting will be entered into your calendar, but marked as
+	  tentative.
+	    </para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term>Decline:</term>
+	  <listitem>
+	    <para>
+	  Select this item if you will be unable to attend the
+	  meeting. The meeting will not be entered into your calendar
+	  when you click the <guibutton>OK</guibutton>, although your
+	  response will be sent to the meeting host if you have
+	  checked the <guilabel>RSVP</guilabel> box.
+	    </para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term>RSVP:</term>
+	  <listitem>
+	    <para>
+	     Check this box if you would like your response sent to
+	     the meeting organizers.
+	    </para>
+	  </listitem>
+	</varlistentry>
+     </variablelist>
+    </para>
+  </sect1>
+
+  <sect1 id="usage-mail-subscriptions">
+    <title>Subscription Management</title>
+    <para>
+      Since IMAP folders exist on the server, and opening them or
+      checking them takes time, you need fine-grained control over the
+      way that you use IMAP folders.  That's why
+      <application>Evolution</application> has an IMAP subscriptions
+      manager.  If you prefer to have every mail folder displayed, you
+      can select that option as well. However, if you'd like to choose
+      specific items in your mailbox, and exclude others, you can use
+      the subscription management tool to do that.
+    </para>
+    <para>
+    Here's how:
+      <orderedlist numeration="arabic">
+	
+	<listitem>
+	  <para>
+	   Select
+	   <menuchoice><guimenu>Tools</guimenu><guimenuitem>Subscribe
+	   to Folders</guimenuitem></menuchoice>.
+	  </para>
+	</listitem>
+
+	<listitem>
+	  <para>
+	    If you have accounts on multiple IMAP servers, select the
+	    server where you'd like to manage your
+	    subscriptions. <application>Evolution</application> will
+	    display a list of available files and folders.
+	  </para>
+	</listitem>
+
+	<listitem>
+	  <para>
+            Select a file or folder by clicking on it.  You will want
+            to select at least the <guilabel>INBOX</guilabel>
+            folder. Depending upon the way your IMAP server is
+            configured, the list of available files may include
+            non-mail folders. If it does, you can ignore them.
+	  </para>
+	</listitem>
+
+	<listitem>
+	  <para>
+	    Click the <guibutton>Subscribe</guibutton> to add it to
+	    the subscribed list.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    When you have subscribed to the folders you want, 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 keeping information safe
+	from prying eyes. <application>Evolution</application> helps
+	you you protect your privacy by using
+	<application>gpg</application>, an implementation of strong
+	<glossterm linkend="public-key-encryption">Public Key
+	Encryption.</glossterm>
+      </para>
+
+	<note id="pub-priv">
+	  <title>Public Key?  Private Key?  What is the difference?</title>
+	  <para>
+	    GPG uses two keys: public and private.  You can give your
+	    public key to anyone you want to receive
+	    encrypted messages, or put it on a public key server so
+	    that people can look it up before contacting you.
+	    <emphasis>Never give your private key to anyone,
+	    ever</emphasis>.  Your private key lets you decrypt any
+	    message encrypted with your public key.
+	  </para>
+ 	</note>
+
+      <para>
+        Using encryption takes a bit of forethought.  When you send a
+        message that is encrypted, you must encrypt it using your
+        intended recipient's public key.  To <emphasis>get</emphasis>
+        an encrypted message, you must make sure that the sender has
+        your public key in advance. For signing messages, it's
+        reversed: you encrypt the signature with your private key, so
+        only your public key can unlock it. When you send it, the
+        recipient gets your public key and unlocks the signature,
+        verifying your identity.
+      </para>
+
+      <para>
+	You can use encryption in two different ways:
+        <simplelist>
+          <member>
+             Encrypt the entire message, so that nobody but the recipient can read it.
+          </member>
+          <member>
+            Attach an encrypted signature to a plain text message, so
+            that the recipient can read the message without decrypting
+            it, and only needs decryption to verify the sender's
+            identity. 
+           </member>
+         </simplelist>
+      </para>
+
+	<example> 
+         <title>Sending an Encrypted Messagee</title>
+	  <para>
+	    Kevin wants to send an encrypted message to his friend
+	    Rachel.  He looks up her public key on a general key
+	    server, and then tells
+	    <application>Evolution</application> to encrypt the
+	    message.  The message now reads "@#$23ui7yr87#@!48970fsd."
+	    When the information gets to Rachel, she decrypts it using
+	    her private key, and it appears as plain text for her to
+	    read.
+	  </para>
+	</example>
+      <tip id="always-sign">
+	<title>Always Sign</title>
+	<para>
+	  You can set <application>Evolution</application> to always sign your email messages:
+	  <orderedlist numeration="arabic">
+	    <listitem>
+	      <para>
+		Open your account preferences.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Open the <guilabel>Security</guilabel> tab.
+	      </para>
+	    </listitem>
+	    <listitem>
+	      <para>
+		Click the <guibutton>Always sign outgoing messages when using this account</guibutton> button.
+	      </para>
+	    </listitem>
+	  </orderedlist>
+	</para>
+      </tip>
+    </sect2>
+
+
+
+    <sect2 id="encryption-keygen">
+      <title>Making Encryption Keys</title>
+      <para>
+        Before you can get or send encrypted mail, you need to
+	generate your public and private keys with GPG. Here's how:
+      </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>
+        <orderedlist numeration="arabic">
+	  <listitem>
+      	   <para>
+            Open a terminal and type <command>gpg --gen-key</command>.
+	  </para>
+         </listitem>
+
+	  <listitem>
+      	   <para> 
+             Choose the default algorythm, "DSA and ElGamal."
+	  </para>
+         </listitem>
+
+	  <listitem>
+      	   <para>
+            Choose a key length. The default, 1024 bits, should be
+            long enough.
+	  </para>
+         </listitem>
+
+	  <listitem>
+      	   <para>
+             Decide if you want your key to expire automatically, and if so, when.
+	  </para>
+         </listitem>
+
+
+	  <listitem>
+      	   <para>
+            Enter your name, email address, and any additional
+            personal information you think is appropriate. Do not
+            falsify this information, because it will be needed to
+            verify your identity later on.
+	  </para>
+         </listitem>
+
+	  <listitem>
+      	   <para>
+             Next, enter your passphrase. It does not have to be the
+             same as your email password or your login password. In
+             fact, it probably shouldn't. Don't forget it. If you lose
+             it, your keys will be useless and you will be unable to
+             decrypt messages sent to you with those keys.
+	  </para>
+         </listitem>
+
+	  <listitem>
+      	   <para>
+             Now, GPG will generate your keys.  This may take awhile,
+             so feel free to do something else while it's
+             happening. In fact, using your computer for something
+             else actually helps to generate better keys, because it
+             increases the randomness in the key generation seeds.
+	  </para>
+         </listitem>
+	</orderedlist>
+      </para>
+      <para>
+	Once the keys are generated, you can view your key information
+        by typing <command>gpg --list-keys</command>.  You should see
+        something similar to this:
+        <programlisting>
+	    /home/you/.gnupg/pubring.gpg
+	    ----------------------------
+	    pub 1024D/32j38dk2 2001-06-20 you &lt;you@your-address.com&gt;
+	    sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]
+	</programlisting>
+      </para>
+      <para>
+         GPG will create one list, or keyring, for your public keys
+         and one for your private keys. All the public keys you know
+         are stored in the file
+         <filename>~/.gnupg/pubring.gpg</filename>. If you want to
+         give other people your key, send them that file.
+      </para>
+      <para>
+          If you wish, you can upload your keys to a keyserver. Here's
+          how:
+        <orderedlist>
+	  <listitem>
+	    <para>
+              Check your public key ID with <command>gpg
+--list-keys</command>. It will be the string after 1024D on the line
+beginning with "pub." In this example, it's 32j38dk2.
+            </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	     Enter the command <command>gpg --send-keys --keyserver
+wwwkeys.pgp.net 32j38dk2</command>.  Substitute your key ID for
+32j38dk2. You will need your password to do this.
+             </para>
+           </listitem>
+    </orderedlist>
+
+	<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 people public
+	    key, include it in your signature file, or put it on your
+	    own web page. However, it's easier to publish them once,
+	    and then let people download them from the keyserver when
+	    they want.
+	  </para>
+          <para>
+             If you don't have a key you need to unlock or encrypt a
+             message, you can have your encryption tool set to look it
+             up automatically. If it can't find the key, then you'll
+             get an error message.
+          </para>
+	</note>
+
+      </para>
+    </sect2>
+
+    <sect2 id="encrypt-getting-key">
+      <title>Getting and Using Public Keys</title>
+      <para>
+	To encrypt a message to your someone else you'll need to use
+	their public key in combination with your private key.
+	<application>Evolution</application> does that for you, but
+	you still need to get their key and add it to your keyring.
+     </para>
+     <para>
+        To get public keys from a public key server, enter the
+        command:
+	<command>
+	  gpg --recv-keys --keyserver wwwkeys.pgp.net keyid
+	</command>, substituting "keyid" for your recipient's ID.  You
+	will need to type in your password, and then their ID will
+	automatically be added to your keyring. When you send mail to
+	them, <application>Evolution</application> will allow you to
+	encrypt your messages.
+      </para>
+      <para>
+        If someone sends you their public key directly, save it as a
+        plain text file and enter the command <command>gpg
+        filename</command>. This will add it 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>Settings</guimenuitem>
+	</menuchoice>
+	and select the <guilabel>Mail Accounts</guilabel> button, then
+	select the account you want to use securely, and click the
+	<guibutton>Edit</guibutton> button. Then, select the
+	<guilabel>Security</guilabel> tab in the account dialog.   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>
+      <note>
+	<title>What is my Key ID again?</title>
+	<para>
+	  <application>Evolution</application> requires that you know your key ID.  If you don't remember it, you can find it by typing <command>gpg --list-keys</command> in a console window.  Your key ID will be an eight character string with random numbers and letters.
+	</para>
+      </note>
+    </sect2>
+
+    <sect2 id="encrypt-sending">
+      <title>Sending Encrypted Messages</title>
+      <para>
+	As you know, you can use encryption to hide the entire
+	message, or just to verify your signature. Once you've
+	generated your public and private keys, and have the public
+	keys of the people to whom you want to send mail, here's what
+	to do:
+      </para>
+    </sect2>
+    
+    <sect2 id="sign-msg">
+      <title>Signing a Message</title>
+      <para>
+	To sign a message, choose:
+	<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.
+	  Just choose the menu item
+	  <menuchoice>
+	    <guimenu>Security</guimenu>
+	    <guimenuitem>PGP Encrypt</guimenuitem>
+	  </menuchoice>
+	</para>
+      </sect2>
+      <sect2 id="unencrypting">
+	<title>Unencrypting a Received Message</title>
+	<para>
+	  If you get an encrypted message, you will need to decrypt it
+	  before you read it. Remember, the sender has to have your
+	  public key before they can send you an encrypted message.
+	</para>
+	<para>
+	  When you view the message,
+	  <application>Evolution</application> will ask you for your
+	  PGP password.  Enter it, and the message will be displayed
+	  properly.  
+       </para>
+    </sect2>
+  </sect1>
+</chapter>
diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.xml
index 41942e798e..58a5e1f17e 100644
--- a/help/C/usage-mainwindow.sgml
+++ b/help/C/usage-mainwindow.xml
@@ -49,7 +49,7 @@
       makes displays faster and more efficient, so searches are faster
       and memory usage is lower.  People who get lots of mail will
       appreciate advanced features like <link
-      linkend="usage-mail-organize-vFolders"><trademark>VFolders</trademark></link>,
+      linkend="usage-mail-organize-vfolders"><trademark>VFolders</trademark></link>,
       which let you save searches as though they were ordinary mail
       folders.
     </para>
@@ -319,7 +319,7 @@
         </guimenuitem></menuchoice>, click the <guibutton>Mail
         Accounts</guibutton> button. Then, select the account you want
         to change and click <guibutton>Edit</guibutton>. See <xref
-        linkend="config-prefs-mail"> for details.
+        linkend="config-prefs-mail"/> for details.
       </para>
         <variablelist>
 	 <varlistentry>
@@ -424,7 +424,7 @@
               specific directory where your server stores mail for
               you.  Typical values are "mail" and "Mail."  For more
               information about how to use IMAP mail, see <xref
-              linkend="usage-mail-subscriptions">.</para>
+              linkend="usage-mail-subscriptions"/>.</para>
 	  </listitem>
 
 	  <listitem>
@@ -451,7 +451,7 @@
 		    If you prefer, you can choose to subscribe to
 		    individual mail folders one at a time. For more
 		    information about how to use IMAP mail, see <xref
-		    linkend="usage-mail-subscriptions">.
+		    linkend="usage-mail-subscriptions"/>.
                </para>
              </note>
 
@@ -796,14 +796,18 @@ the workaround described in the note below.
       <title>The Ximian Evolution Main Window</title>
       <screenshot>
 	<screeninfo>Inbox</screeninfo>
-	<mediaobject><imageobject><imagedata
-	fileref="figures/mainwindow-pic" format="png" srccredit="Kevin
-	Breit"> </imageobject></mediaobject>
+	  <mediaobject>
+             <imageobject>
+                 <imagedata fileref="figures/mainwindow-pic" format="PNG" srccredit="Kevin Breit"/> 
+             </imageobject>
+          </mediaobject>
       </screenshot>
     </figure>
     
     <para>
-      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-1" format="png"></imageobject></inlinemediaobject>
+      <inlinemediaobject>
+        <imageobject>
+          <imagedata  fileref="figures/full-1" format="PNG"/></imageobject></inlinemediaobject>
       <guilabel>Menubar</guilabel>
     </para>
     
@@ -813,7 +817,7 @@ the workaround described in the note below.
     </para>
 
     <para>
-      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-2" format="png"></imageobject></inlinemediaobject>
+      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-2" format="PNG"/></imageobject></inlinemediaobject>
       <guilabel>Toolbar</guilabel>
     </para>
 
@@ -823,7 +827,7 @@ the workaround described in the note below.
     </para>
     
     <para>
-      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-3" format="png"></imageobject></inlinemediaobject>
+      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-3" format="PNG"/></imageobject></inlinemediaobject>
       <guilabel>Shortcut Bar</guilabel>
     </para>
     
@@ -833,7 +837,7 @@ the workaround described in the note below.
     </para>
     
     <para>
-      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-4" format="png"></imageobject></inlinemediaobject>
+      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-4" format="PNG"/></imageobject></inlinemediaobject>
       <guilabel>Status Bar</guilabel>
     </para>
     
@@ -845,7 +849,7 @@ the workaround described in the note below.
     </para>
     
     <para>
-      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-5" format="png"></imageobject></inlinemediaobject>
+      <inlinemediaobject><imageobject><imagedata  fileref="figures/full-5" format="PNG"/></imageobject></inlinemediaobject>
       <guilabel>Search Tool</guilabel>
     </para>
     
@@ -953,7 +957,7 @@ the workaround described in the note below.
       directories, and <glossterm linkend="imap">IMAP</glossterm> mail
       folders to which you subscribe.  Lastly, there are
       <guilabel>vFolders</guilabel>, or virtual folders, discussed in
-      <xref linkend="usage-mail-organize-vfolders">,
+      <xref linkend="usage-mail-organize-vfolders"/>,
     </para>
     <para>
        
@@ -1220,37 +1224,37 @@ the workaround described in the note below.
 	<title>The Evolution Summary</title>
 
 <screenshot>
-<graphic  format="png" fileref="figures/summary" srccredit="Kevin Breit">
+<graphic  format="PNG" fileref="figures/summary" srccredit="Kevin Breit"/>
 </screenshot>
 </figure>
       </para>
 
 <para>
-<inlinemediaobject><imageobject><imagedata fileref="figures/full-1" format="png"></imageobject></inlinemediaobject> <guilabel>Weather Summary</guilabel>
+<inlinemediaobject><imageobject><imagedata fileref="figures/full-1" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Weather Summary</guilabel>
 </para>
 <para>
 Shows you the latest weather updates from hundreds of cities around the world.
 </para>
 <para>
-<inlinemediaobject><imageobject><imagedata fileref="figures/full-2" format="png"></imageobject></inlinemediaobject> <guilabel>News Feeds</guilabel>
+<inlinemediaobject><imageobject><imagedata fileref="figures/full-2" format="PNG"/></imageobject></inlinemediaobject> <guilabel>News Feeds</guilabel>
 </para>
 <para>
 Displays up to the minute news from your favorite websites.
 </para>
 <para>
-<inlinemediaobject><imageobject><imagedata fileref="figures/full-3" format="png"></imageobject></inlinemediaobject> <guilabel>Mail Summary</guilabel>
+<inlinemediaobject><imageobject><imagedata fileref="figures/full-3" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Mail Summary</guilabel>
 </para>
 <para>
 Shows you how many email messages you have in your selected folders, waiting to be read.
 </para>
 <para>
-<inlinemediaobject><imageobject><imagedata fileref="figures/full-4" format="png"></imageobject></inlinemediaobject> <guilabel>Calendar Summary</guilabel>
+<inlinemediaobject><imageobject><imagedata fileref="figures/full-4" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Calendar Summary</guilabel>
 </para>
 <para>
 Shows you your calendar.
 </para>
 <para>
-<inlinemediaobject><imageobject><imagedata fileref="figures/full-5" format="png"></imageobject></inlinemediaobject> <guilabel>Tasks</guilabel>
+<inlinemediaobject><imageobject><imagedata fileref="figures/full-5" format="PNG"/></imageobject></inlinemediaobject> <guilabel>Tasks</guilabel>
 </para>
 <para>
 Shows your pending tasks
@@ -1311,7 +1315,7 @@ Shows your pending tasks
         <link linkend="usage-mail-organize-search">searching</link>
         functions were built for speed and efficiency on large volumes
         of mail. There's also the <application>Ximian Evolution</application>
-        <link linkend="usage-mail-organize-vFolders">vFolder</link>,
+        <link linkend="usage-mail-organize-vfolders">vFolder</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
@@ -1326,7 +1330,7 @@ Shows your pending tasks
           <title>Ximian Evolution Mail</title>
           <screenshot>
             <screeninfo>Inbox</screeninfo>
-            <mediaobject><imageobject><imagedata  fileref="figures/mail-inbox" format="png" srccredit="Kevin Breit">
+            <mediaobject><imageobject><imagedata  fileref="figures/mail-inbox" format="PNG" srccredit="Kevin Breit"/>
         </imageobject></mediaobject>
         </screenshot>
       </figure>
@@ -1334,7 +1338,7 @@ Shows your pending tasks
 </para>
       <para>
         <inlinemediaobject><imageobject><imagedata  fileref="figures/full-1"
-        format="png"></imageobject></inlinemediaobject> <guilabel>Email
+        format="PNG"/></imageobject></inlinemediaobject> <guilabel>Email
         Viewer</guilabel>
       </para>
     
@@ -1344,7 +1348,7 @@ Shows your pending tasks
 
       <para>
         <inlinemediaobject><imageobject><imagedata  fileref="figures/full-2"
-        format="png"></imageobject></inlinemediaobject> <guilabel>Message List</guilabel>
+        format="PNG"/></imageobject></inlinemediaobject> <guilabel>Message List</guilabel>
       </para>
     
       <para>
@@ -1383,7 +1387,7 @@ Shows your pending tasks
 
        <para>
          For an in-depth guide to the email capabilities of Ximian
-         Evolution, read <xref linkend="usage-mail">.
+         Evolution, read <xref linkend="usage-mail"/>.
       </para>
     </sect2>
     <sect2 id="basics-calendar">
@@ -1403,7 +1407,7 @@ Shows your pending tasks
       <title>Ximian Evolution Calendar View</title>
       <screenshot>
 	<screeninfo>Ximian Evolution Contact Manager Window</screeninfo>
-	<mediaobject><imageobject><imagedata  fileref="figures/calendar" format="png" srccredit="Aaron Weber">
+	<mediaobject><imageobject><imagedata  fileref="figures/calendar" format="PNG" srccredit="Aaron Weber"/>
 	</imageobject></mediaobject>
       </screenshot>
     </figure>
@@ -1413,7 +1417,7 @@ Shows your pending tasks
 
       <para>
         <inlinemediaobject><imageobject><imagedata  fileref="figures/full-1"
-        format="png"></imageobject></inlinemediaobject> <guilabel>Appointment
+        format="PNG"/></imageobject></inlinemediaobject> <guilabel>Appointment
         List</guilabel>
       </para>
   
@@ -1424,7 +1428,7 @@ Shows your pending tasks
       </para>
 
       <para>
-	<inlinemediaobject><imageobject><imagedata  fileref="figures/full-2" format="png"></imageobject></inlinemediaobject>
+	<inlinemediaobject><imageobject><imagedata  fileref="figures/full-2" format="PNG"/></imageobject></inlinemediaobject>
 	<guilabel>Task List</guilabel>
       </para>
 
@@ -1437,7 +1441,7 @@ Shows your pending tasks
       </para>
 
       <para>
-	<inlinemediaobject><imageobject><imagedata  fileref="figures/full-3" format="png"></imageobject></inlinemediaobject>
+	<inlinemediaobject><imageobject><imagedata  fileref="figures/full-3" format="PNG"/></imageobject></inlinemediaobject>
 	<guilabel>Calendar Window</guilabel>
       </para>
 
@@ -1449,7 +1453,7 @@ Shows your pending tasks
 
       <para>
           For more information about the calendar
-          read <xref linkend="usage-calendar">.
+          read <xref linkend="usage-calendar"/>.
       </para>
 
     </sect2>
@@ -1475,7 +1479,7 @@ Shows your pending tasks
         To open your address book, click on
         <guibutton>Contacts</guibutton> in the shortcut bar, or select
         one of your contacts folders from the folder bar.  <xref
-        linkend="usage-contact-fig"> shows the address book in all its
+        linkend="usage-contact-fig"/> shows the address book in all its
         organizational glory.  By default, the address book shows all
         your cards in alphabetical order, in a <glossterm
         linkend="minicard">minicard</glossterm> view.  You can select
@@ -1490,14 +1494,14 @@ Shows your pending tasks
 	<title>Ximian Evolution Contact Interface</title>
 	<screenshot>
 	  <screeninfo>Ximian Evolution Contact List Window</screeninfo>
-	  <mediaobject><imageobject><imagedata  fileref="figures/contact" format="png" srccredit="Kevin Breit">
+	  <mediaobject><imageobject><imagedata  fileref="figures/contact" format="PNG" srccredit="Kevin Breit"/>
   	  </imageobject></mediaobject>
 	</screenshot>
       </figure>
      </para>
       <para>
         <inlinemediaobject><imageobject><imagedata  fileref="figures/full-1"
-        format="png"></imageobject></inlinemediaobject> <guilabel>Contact
+        format="PNG"/></imageobject></inlinemediaobject> <guilabel>Contact
         List</guilabel>
       </para>
       <para>
@@ -1505,7 +1509,7 @@ Shows your pending tasks
       </para>
       <para>
           For detailed instructions on how to use the address book,
-          read <xref linkend="usage-contact">.
+          read <xref linkend="usage-contact"/>.
       </para>
     </sect2>
   </sect1>
diff --git a/help/C/usage-print.sgml b/help/C/usage-print.xml
index c36a53fe2a..a9c124e9a0 100644
--- a/help/C/usage-print.sgml
+++ b/help/C/usage-print.xml
@@ -45,7 +45,7 @@
 	  <title>Print Preview</title>
 	  <screenshot>
 	    <screeninfo>Print Preview</screeninfo>
-	    <mediaobject><imageobject><imagedata fileref="figures/print-preview" format="png" srccredit="Aaron Weber">
+	    <mediaobject><imageobject><imagedata fileref="figures/print-preview" format="PNG" srccredit="Aaron Weber"/>
 	</imageobject></mediaobject>
 	</screenshot>
       </figure>
@@ -57,8 +57,8 @@
     <title>File or Printer?</title>
     <para>
        The printer selection window, shown in <xref
-       linkend="print-dest">, lets you choose the format for
-       printing&mdash; <guilabel>Generic Postscript</guilabel>,
+       linkend="print-dest"/>, lets you choose the format for
+       printing-- <guilabel>Generic Postscript</guilabel>,
        whether to write to a PDF file, and whether to print to a file
        or to an actual printer in Generic Postscript.  If you choose a
        printer, you'll be asked for the printer command (probably
@@ -85,7 +85,7 @@
 	  <title>Choosing a Printer</title>
 	  <screenshot>
 	    <screeninfo>Choosing a Printer</screeninfo>
-	    <mediaobject><imageobject><imagedata fileref="figures/print-dest" format="png" srccredit="Aaron Weber">
+	    <mediaobject><imageobject><imagedata fileref="figures/print-dest" format="PNG" srccredit="Aaron Weber"/>
 	</imageobject></mediaobject>
 	</screenshot>
       </figure>
diff --git a/help/C/usage-sync.xml b/help/C/usage-sync.xml
new file mode 100644
index 0000000000..45e18e5e82
--- /dev/null
+++ b/help/C/usage-sync.xml
@@ -0,0 +1,39 @@
+    <chapter id="usage-sync">
+      <title>Synchronizing Evolution with Hand-Held Devices</title>
+      <para>
+        This chapter is very short.  It describes how to synchronize
+        the data on your Palm-OS device with the data you store in
+        <application>Ximian Evolution</application>.  If you need
+        information on how to set up handheld synchronization, consult
+        <xref linkend="config-sync"/>.
+      </para>
+
+      <sect1 id="hotsync">
+        <title>Using HotSync</title>
+        <para>
+          Put your hand-held device in its cradle and press the
+          HotSync button.
+        </para>
+
+<tip id="sync-tip">
+<title>Palm OS v. 4.0 with Passwords</title>
+<para>
+If you use Palm OS v. 4.0 and have password protection turned on for
+your handheld device, you may encounter trouble synchronizing.  If
+this happens, try turning off password protection on your handheld,
+synchronize it with your desktop computer, and then re-enable password
+protection on your handheld.
+</para>
+</tip>
+        <para>
+	 If you have followed the set up instructions properly, your
+	 Palm-OS device will synchronize data with <application>Ximian
+	 Evolution</application>.
+        </para>
+
+         <para>
+            That's it.
+         </para>
+
+       </sect1>
+    </chapter>
diff --git a/help/ChangeLog b/help/ChangeLog
index c1f9da8698..095f29fe99 100644
--- a/help/ChangeLog
+++ b/help/ChangeLog
@@ -1,3 +1,18 @@
+2002-11-04  Aaron Weber  <aaron@ximian.com>
+
+	* C/*.sgml: All sgml files replaced with xml files. XML files
+	validated. Two new XML files-- apx-fdl.xml and legal.xml
+
+	* C/evolution-C.omf: Altered to fit the GDP template. This may now
+	work with the GNOME 2.0 DTD, although I could be wrong.
+
+	* sgmldocs.make: removed and replaced with xmldocs.make. This will
+	break all translations until they are also ported to XML. I will
+	probably begin doing that tomorrow, since it's just markup and not
+	language stuff.
+
+	* C/Makefile.am: added two files
+
 2002-10-22  Aaron Weber  <aaron@ximian.com>
 
 	* C/usage-mail.sgml: Edit-->Undelete, not Actions-->Undelete
diff --git a/help/sgmldocs.make b/help/sgmldocs.make
deleted file mode 100644
index 2bd7c5dc1e..0000000000
--- a/help/sgmldocs.make
+++ /dev/null
@@ -1,144 +0,0 @@
-# To use this template:
-#     1) Define: figs, docname, lang, omffile, sgml_ents although figs, 
-#        omffile, and sgml_ents may be empty in your Makefile.am which 
-#        will "include" this one 
-#     2) Figures must go under figures/ and be in PNG format
-#     3) You should only have one document per directory 
-#
-#        Note that this makefile forces the directory name under
-#        $prefix/share/gnome/help/ to be the same as the SGML filename
-#        of the document.  This is required by GNOME. eg:
-#        $prefix/share/gnome/help/fish_applet/C/fish_applet.sgml
-#                                 ^^^^^^^^^^^   ^^^^^^^^^^^
-# Definitions:
-#   figs         A list of screenshots which will be included in EXTRA_DIST
-#                Note that these should reside in figures/ and should be .png
-#                files, or you will have to make modifications below.
-#   docname      This is the name of the SGML file: <docname>.sgml
-#   lang         This is the document locale
-#   omffile      This is the name of the OMF file.  Convention is to name
-#                it <docname>-<locale>.omf.
-#   sgml_ents    This is a list of SGML entities which must be installed 
-#                with the main SGML file and included in EXTRA_DIST. 
-# eg:
-#   figs = \
-#          figures/fig1.png            \
-#          figures/fig2.png
-#   docname = scrollkeeper-manual
-#   lang = C
-#   omffile=scrollkeeper-manual-C.omf
-#   sgml_ents = fdl.sgml
-#   include $(top_srcdir)/help/sgmldocs.make
-#   dist-hook: app-dist-hook
-#
-
-docdir = $(datadir)/gnome/help/$(docname)/$(lang)
-
-doc_DATA = index.html
-
-sgml_files = $(sgml_ents) $(docname).sgml
-
-omf_dir=$(top_srcdir)/omf-install
-
-EXTRA_DIST = $(sgml_files) $(doc_DATA) $(omffile) $(figs)
-
-CLEANFILES = omf_timestamp
-
-all: index.html omf
-
-omf: omf_timestamp
-
-omf_timestamp: $(omffile)
-	-for file in $(srcdir)/$(omffile); do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  scrollkeeper-preinstall $(docdir)/index.html $$file $(omf_dir)/$$basefile; \
-	done
-	touch omf_timestamp
-
-index.html: $(docname)/index.html
-	-cp $(docname)/index.html .
-
-$(docname).sgml: $(sgml_ents)
-	-ourdir=`pwd`;  \
-        cd $(srcdir);   \
-        cp $(sgml_ents) $$ourdir
-
-
-# The weird srcdir trick is because the db2html from the Cygnus RPMs
-# cannot handle relative filenames
-$(docname)/index.html: $(srcdir)/$(docname).sgml
-	-srcdir=`cd $(srcdir) && pwd`;			\
-	if test "$(HAVE_JW)" = 'yes' ; then 		\
-		jw -c /etc/sgml/catalog $$srcdir/$(docname).sgml -o $$srcdir/$(docname); \
-	else 						\
-		db2html $$srcdir/$(docname).sgml; 	\
-	 fi
-
-app-dist-hook: index.html
-	-$(mkinstalldirs) $(distdir)/$(docname)/stylesheet-images
-	-$(mkinstalldirs) $(distdir)/figures
-	-cp $(srcdir)/$(docname)/*.html $(distdir)/$(docname)
-	-for file in $(srcdir)/$(docname)/*.css; do \
-	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
-	  cp $$file $(distdir)/$(docname)/$$basefile ; \
-	done
-	-for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \
-	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
-	  cp $$file $(distdir)/$(docname)/stylesheet-images/$$basefile ; \
-	done
-	-if [ -f topic.dat ]; then \
-		cp $(srcdir)/topic.dat $(distdir); \
-	 fi
-
-install-data-am: index.html omf
-	-$(mkinstalldirs) $(DESTDIR)$(docdir)/stylesheet-images
-	-$(mkinstalldirs) $(DESTDIR)$(docdir)/figures
-	-$(mkinstalldirs) $(DESTDIR)$(docdir)/sgml
-
-	-for file in $(sgml_files); do \
-         $(INSTALL_DATA) $(srcdir)/$$file $(DESTDIR)$(docdir)/sgml ; \
-        done
-
-	-for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$$basefile; \
-	done
-	-for file in $(srcdir)/figures/*.png; do \
-	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
-	  $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/figures/$$basefile; \
-	done
-	-for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \
-	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
-	  $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/stylesheet-images/$$basefile; \
-	done
-	-if [ -f $(srcdir)/topic.dat ]; then \
-		$(INSTALL_DATA) $(srcdir)/topic.dat $(DESTDIR)$(docdir); \
-	 fi
-
-$(docname).ps: $(srcdir)/$(docname).sgml
-	-srcdir=`cd $(srcdir) && pwd`; \
-	db2ps $$srcdir/$(docname).sgml
-
-$(docname).rtf: $(srcdir)/$(docname).sgml
-	-srcdir=`cd $(srcdir) && pwd`; \
-	db2ps $$srcdir/$(docname).sgml
-
-uninstall-local:
-	-for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \
-	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
-	  rm -f $(docdir)/stylesheet-images/$$basefile; \
-	done
-	-for file in $(srcdir)/figures/*.png; do \
-	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
-	  rm -f $(docdir)/figures/$$basefile; \
-	done
-	-for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  rm -f $(DESTDIR)$(docdir)/$$basefile; \
-	done
-	-for file in $(sgml_files); do \
-	  rm -f $(DESTDIR)$(docdir)/$$file; \
-	done
-	-rmdir $(DESTDIR)$(docdir)/stylesheet-images
-	-rmdir $(DESTDIR)$(docdir)/figures
-	-rmdir $(DESTDIR)$(docdir)
diff --git a/help/xmldocs.make b/help/xmldocs.make
new file mode 100644
index 0000000000..5d58b28b78
--- /dev/null
+++ b/help/xmldocs.make
@@ -0,0 +1,96 @@
+#
+# No modifications of this Makefile should be necessary.
+#
+# To use this template:
+#     1) Define: figdir, docname, lang, omffile, and entities in
+#        your Makefile.am file for each document directory,
+#        although figdir, omffile, and entities may be empty
+#     2) Make sure the Makefile in (1) also includes 
+#	 "include $(top_srcdir)/xmldocs.make" and
+#	 "dist-hook: app-dist-hook".
+#     3) Optionally define 'entities' to hold xml entities which
+#        you would also like installed
+#     4) Figures must go under $(figdir)/ and be in PNG format
+#     5) You should only have one document per directory 
+#     6) Note that the figure directory, $(figdir)/, should not have its
+#        own Makefile since this Makefile installs those figures.
+#
+# example Makefile.am:
+#   figdir = figures
+#   docname = scrollkeeper-manual
+#   lang = C
+#   omffile=scrollkeeper-manual-C.omf
+#   entities = fdl.xml
+#   include $(top_srcdir)/xmldocs.make
+#   dist-hook: app-dist-hook
+#
+# About this file:
+#	This file was taken from scrollkeeper_example2, a package illustrating
+#	how to install documentation and OMF files for use with ScrollKeeper 
+#	0.3.x and 0.4.x.  For more information, see:
+#		http://scrollkeeper.sourceforge.net/
+#	Version: 0.1.2 (last updated: March 20, 2002)
+#
+
+
+# ************* Begin of section some packagers may need to modify  **************
+# This variable (docdir) specifies where the documents should be installed.
+# This default value should work for most packages.
+# docdir = $(datadir)/@PACKAGE@/doc/$(docname)/$(lang)
+docdir = $(datadir)/gnome/help/$(docname)/$(lang)
+
+# **************  You should not have to edit below this line  *******************
+xml_files = $(entities) $(docname).xml
+
+EXTRA_DIST = $(xml_files) $(omffile)
+CLEANFILES = omf_timestamp
+
+# If the following file is in a subdir (like help/) you need to add that to the path
+include $(top_srcdir)/omf.make
+
+all: omf
+
+$(docname).xml: $(entities)
+	-ourdir=`pwd`;  \
+	cd $(srcdir);   \
+	cp $(entities) $$ourdir
+
+app-dist-hook:
+	if test "$(figdir)"; then \
+	  $(mkinstalldirs) $(distdir)/$(figdir); \
+	  for file in $(srcdir)/$(figdir)/*.png; do \
+	    basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	    $(INSTALL_DATA) $$file $(distdir)/$(figdir)/$$basefile; \
+	  done \
+	fi
+
+install-data-local: omf
+	$(mkinstalldirs) $(DESTDIR)$(docdir)
+	for file in $(xml_files); do \
+	  cp $(srcdir)/$$file $(DESTDIR)$(docdir); \
+	done
+	if test "$(figdir)"; then \
+	  $(mkinstalldirs) $(DESTDIR)$(docdir)/$(figdir); \
+	  for file in $(srcdir)/$(figdir)/*.png; do \
+	    basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	    $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$(figdir)/$$basefile; \
+	  done \
+	fi
+
+install-data-hook: install-data-hook-omf
+
+uninstall-local: uninstall-local-doc uninstall-local-omf
+
+uninstall-local-doc:
+	-if test "$(figdir)"; then \
+	  for file in $(srcdir)/$(figdir)/*.png; do \
+	    basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	    rm -f $(docdir)/$(figdir)/$$basefile; \
+	  done; \
+	  rmdir $(DESTDIR)$(docdir)/$(figdir); \
+	fi
+	-for file in $(xml_files); do \
+	  rm -f $(DESTDIR)$(docdir)/$$file; \
+	done
+	-rmdir $(DESTDIR)$(docdir)
+