aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--help/C/Makefile.am40
-rw-r--r--help/C/apx-authors.xml (renamed from help/C/apx-authors.sgml)0
-rw-r--r--help/C/apx-bugs.xml (renamed from help/C/apx-bugs.sgml)0
-rw-r--r--help/C/apx-fdl.xml667
-rw-r--r--help/C/apx-gloss.xml (renamed from help/C/apx-gloss.sgml)2
-rw-r--r--help/C/config-prefs.xml (renamed from help/C/config-prefs.sgml)18
-rw-r--r--help/C/config-sync.xml (renamed from help/C/config-sync.sgml)0
-rw-r--r--help/C/evolution-C.omf18
-rw-r--r--help/C/evolution.xml (renamed from help/C/evolution.sgml)73
-rw-r--r--help/C/legal.xml75
-rw-r--r--help/C/menuref.xml (renamed from help/C/menuref.sgml)0
-rw-r--r--help/C/preface.xml (renamed from help/C/preface.sgml)4
-rw-r--r--help/C/usage-calendar.xml (renamed from help/C/usage-calendar.sgml)20
-rw-r--r--help/C/usage-contact.xml (renamed from help/C/usage-contact.sgml)20
-rw-r--r--help/C/usage-exchange.xml (renamed from help/C/usage-exchange.sgml)10
-rw-r--r--help/C/usage-exec-summary.xml (renamed from help/C/usage-exec-summary.sgml)0
-rw-r--r--help/C/usage-mail-org.xml (renamed from help/C/usage-mail-org.sgml)12
-rw-r--r--help/C/usage-mail.xml (renamed from help/C/usage-mail.sgml)4418
-rw-r--r--help/C/usage-mainwindow.xml (renamed from help/C/usage-mainwindow.sgml)70
-rw-r--r--help/C/usage-print.xml (renamed from help/C/usage-print.sgml)8
-rw-r--r--help/C/usage-sync.xml39
-rw-r--r--help/ChangeLog15
-rw-r--r--help/sgmldocs.make144
-rw-r--r--help/xmldocs.make96
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)
+