diff options
author | Aaron Weber <aaron@ximian.com> | 2002-11-05 06:41:05 +0800 |
---|---|---|
committer | Aaron Weber <aaron@src.gnome.org> | 2002-11-05 06:41:05 +0800 |
commit | fab377c503df250439b84aba95db023786d33ee1 (patch) | |
tree | 4fe93ea07618e0a1cc908e49a55df29dca565439 /help/C | |
parent | 877e911cdf220fa6dde24df147b9e8843c42fae9 (diff) | |
download | gsoc2013-evolution-fab377c503df250439b84aba95db023786d33ee1.tar.gz gsoc2013-evolution-fab377c503df250439b84aba95db023786d33ee1.tar.zst gsoc2013-evolution-fab377c503df250439b84aba95db023786d33ee1.zip |
All sgml files replaced with xml files. XML files validated. Two new XML
2002-11-04 Aaron Weber <aaron@ximian.com>
* C/*.sgml: All sgml files replaced with xml files. XML files
validated. Two new XML files added: apx-fdl.xml and legal.xml
* C/evolution-C.omf: Altered to fit the GDP template. This may now
work with the GNOME 2.0 DTD, although I could be wrong.
* sgmldocs.make: removed and replaced with xmldocs.make. This will
break all translations until they are also ported to XML. I will
probably begin doing that tomorrow, since it's just markup and not
language stuff.
* C/Makefile.am: added two files to the list. Does this
Makefile get included in another, somewhere, or is it just
detected?
svn path=/trunk/; revision=18538
Diffstat (limited to 'help/C')
-rw-r--r-- | help/C/Makefile.am | 40 | ||||
-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.xml | 667 | ||||
-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.omf | 18 | ||||
-rw-r--r-- | help/C/evolution.xml (renamed from help/C/evolution.sgml) | 73 | ||||
-rw-r--r-- | help/C/legal.xml | 75 | ||||
-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.xml | 39 |
21 files changed, 3135 insertions, 2359 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 — by - default, today — 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 — <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 — 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 — <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 — 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 > 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, (>) 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 <you@your-address.com>
- 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 > 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, (>) 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 <you@your-address.com> + 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— <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> |