From fab377c503df250439b84aba95db023786d33ee1 Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Mon, 4 Nov 2002 22:41:05 +0000 Subject: All sgml files replaced with xml files. XML files validated. Two new XML 2002-11-04 Aaron Weber * 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 --- help/C/Makefile.am | 40 +- help/C/apx-authors.sgml | 72 -- help/C/apx-authors.xml | 72 ++ help/C/apx-bugs.sgml | 30 - help/C/apx-bugs.xml | 30 + help/C/apx-fdl.xml | 667 ++++++++++++ help/C/apx-gloss.sgml | 480 --------- help/C/apx-gloss.xml | 480 +++++++++ help/C/config-prefs.sgml | 908 ----------------- help/C/config-prefs.xml | 908 +++++++++++++++++ help/C/config-sync.sgml | 138 --- help/C/config-sync.xml | 138 +++ help/C/evolution-C.omf | 18 +- help/C/evolution.sgml | 126 --- help/C/evolution.xml | 107 ++ help/C/legal.xml | 75 ++ help/C/menuref.sgml | 421 -------- help/C/menuref.xml | 421 ++++++++ help/C/preface.sgml | 362 ------- help/C/preface.xml | 362 +++++++ help/C/usage-calendar.sgml | 757 -------------- help/C/usage-calendar.xml | 757 ++++++++++++++ help/C/usage-contact.sgml | 571 ----------- help/C/usage-contact.xml | 571 +++++++++++ help/C/usage-exchange.sgml | 748 -------------- help/C/usage-exchange.xml | 748 ++++++++++++++ help/C/usage-exec-summary.sgml | 323 ------ help/C/usage-exec-summary.xml | 323 ++++++ help/C/usage-mail-org.sgml | 1129 -------------------- help/C/usage-mail-org.xml | 1129 ++++++++++++++++++++ help/C/usage-mail.sgml | 2209 ---------------------------------------- help/C/usage-mail.xml | 2209 ++++++++++++++++++++++++++++++++++++++++ help/C/usage-mainwindow.sgml | 1512 --------------------------- help/C/usage-mainwindow.xml | 1516 +++++++++++++++++++++++++++ help/C/usage-print.sgml | 115 --- help/C/usage-print.xml | 115 +++ help/C/usage-sync.xml | 39 + help/ChangeLog | 15 + help/sgmldocs.make | 144 --- help/xmldocs.make | 96 ++ 40 files changed, 10812 insertions(+), 10069 deletions(-) delete mode 100644 help/C/apx-authors.sgml create mode 100644 help/C/apx-authors.xml delete mode 100644 help/C/apx-bugs.sgml create mode 100644 help/C/apx-bugs.xml create mode 100644 help/C/apx-fdl.xml delete mode 100644 help/C/apx-gloss.sgml create mode 100644 help/C/apx-gloss.xml delete mode 100644 help/C/config-prefs.sgml create mode 100644 help/C/config-prefs.xml delete mode 100644 help/C/config-sync.sgml create mode 100644 help/C/config-sync.xml delete mode 100644 help/C/evolution.sgml create mode 100644 help/C/evolution.xml create mode 100644 help/C/legal.xml delete mode 100644 help/C/menuref.sgml create mode 100644 help/C/menuref.xml delete mode 100644 help/C/preface.sgml create mode 100644 help/C/preface.xml delete mode 100644 help/C/usage-calendar.sgml create mode 100644 help/C/usage-calendar.xml delete mode 100644 help/C/usage-contact.sgml create mode 100644 help/C/usage-contact.xml delete mode 100644 help/C/usage-exchange.sgml create mode 100644 help/C/usage-exchange.xml delete mode 100644 help/C/usage-exec-summary.sgml create mode 100644 help/C/usage-exec-summary.xml delete mode 100644 help/C/usage-mail-org.sgml create mode 100644 help/C/usage-mail-org.xml delete mode 100644 help/C/usage-mail.sgml create mode 100644 help/C/usage-mail.xml delete mode 100644 help/C/usage-mainwindow.sgml create mode 100644 help/C/usage-mainwindow.xml delete mode 100644 help/C/usage-print.sgml create mode 100644 help/C/usage-print.xml create mode 100644 help/C/usage-sync.xml delete mode 100644 help/sgmldocs.make create mode 100644 help/xmldocs.make (limited to 'help') 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.sgml deleted file mode 100644 index 0b0944b97d..0000000000 --- a/help/C/apx-authors.sgml +++ /dev/null @@ -1,72 +0,0 @@ - - Authors - - Evolution was written by the Ximian - Evolution team and numerous other dedicated GNOME programmers. - You can see their names by selecting - Help About - from any Evolution window. - - - The Evolution code owes a great debt - to the GNOME-pim and - GNOME-Calendar applications, and to - KHTMLW. The developers of - Evolution acknowledge the efforts - and contributions of all who worked on those projects. - - - - Ximian would like to thank everyone who helped out with the bug - tracking process, particularly Miles Lane, and also the staff of - El Pelon Taqueria, on Peterborough St. in Boston, for - sustenance. - - - - For more information please visit the - Evolution Web page. Please send all comments, - suggestions, and bug reports to the Ximian bug tracking - database. Instructions for submitting bug reports can be - found on-line at the same location. You can also use the GNOME - bug report tool, bug-buddy, to submit your - defect reports. - - - This manual was written by Aaron Weber - (aaron@ximian.com), Kevin Breit - (mrproper@ximian.com) Duncan Mak - (duncan@ximian.com) and Ettore Perazzoli - (ettore@ximian.com) with the help of the - application programmers and the GNOME Documentation Project. - Please file comments and suggestions for this manual as bugs in - the Ximian bug tracking system. If you contributed to this - project but do not see your name here, please contact Aaron - Weber (aaron@ximian.com) and he'll list you. - - - Partial list of Translators: - - - Daniel Persson for .se - - - - Hector Garcia Alvarez for .es - - - - Kjartan Maraas for .no - - - - - - - - - - diff --git a/help/C/apx-authors.xml b/help/C/apx-authors.xml new file mode 100644 index 0000000000..0b0944b97d --- /dev/null +++ b/help/C/apx-authors.xml @@ -0,0 +1,72 @@ + + Authors + + Evolution was written by the Ximian + Evolution team and numerous other dedicated GNOME programmers. + You can see their names by selecting + Help About + from any Evolution window. + + + The Evolution code owes a great debt + to the GNOME-pim and + GNOME-Calendar applications, and to + KHTMLW. The developers of + Evolution acknowledge the efforts + and contributions of all who worked on those projects. + + + + Ximian would like to thank everyone who helped out with the bug + tracking process, particularly Miles Lane, and also the staff of + El Pelon Taqueria, on Peterborough St. in Boston, for + sustenance. + + + + For more information please visit the + Evolution Web page. Please send all comments, + suggestions, and bug reports to the Ximian bug tracking + database. Instructions for submitting bug reports can be + found on-line at the same location. You can also use the GNOME + bug report tool, bug-buddy, to submit your + defect reports. + + + This manual was written by Aaron Weber + (aaron@ximian.com), Kevin Breit + (mrproper@ximian.com) Duncan Mak + (duncan@ximian.com) and Ettore Perazzoli + (ettore@ximian.com) with the help of the + application programmers and the GNOME Documentation Project. + Please file comments and suggestions for this manual as bugs in + the Ximian bug tracking system. If you contributed to this + project but do not see your name here, please contact Aaron + Weber (aaron@ximian.com) and he'll list you. + + + Partial list of Translators: + + + Daniel Persson for .se + + + + Hector Garcia Alvarez for .es + + + + Kjartan Maraas for .no + + + + + + + + + + diff --git a/help/C/apx-bugs.sgml b/help/C/apx-bugs.sgml deleted file mode 100644 index 686305fbce..0000000000 --- a/help/C/apx-bugs.sgml +++ /dev/null @@ -1,30 +0,0 @@ - - - Known bugs and limitations - - - Ximian Evolution bug tracking is done at the Ximian bug tracking - System. You may use that, or the GNOME Bug - Report Tool (known as bug-buddy - at the command line) if you find bugs or would like to request new - features. - - - If you need additional help with Ximian Evolution, please visit - the Ximian support site at ximian.com/support. - - - - - - A complete list of feature requests and other issues with - Evolution is available online in the Ximian bug tracking system. - You can learn more about the Ximian Evolution development process - at developer.ximian.com. - - - - diff --git a/help/C/apx-bugs.xml b/help/C/apx-bugs.xml new file mode 100644 index 0000000000..686305fbce --- /dev/null +++ b/help/C/apx-bugs.xml @@ -0,0 +1,30 @@ + + + Known bugs and limitations + + + Ximian Evolution bug tracking is done at the Ximian bug tracking + System. You may use that, or the GNOME Bug + Report Tool (known as bug-buddy + at the command line) if you find bugs or would like to request new + features. + + + If you need additional help with Ximian Evolution, please visit + the Ximian support site at ximian.com/support. + + + + + + A complete list of feature requests and other issues with + Evolution is available online in the Ximian bug tracking system. + You can learn more about the Ximian Evolution development process + at developer.ximian.com. + + + + 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 @@ + + + + + + Version 1.1, March 2000 + + + 2000Free Software Foundation, Inc. + + + +
Free Software Foundation, Inc. 59 Temple Place, + Suite 330, Boston, MA + 02111-1307 USA
+ Everyone is permitted to copy and distribute verbatim copies of this + license document, but changing it is not allowed. + + + + GNU Free Documentation License + + + 0. PREAMBLE + + The purpose of this License is to make a manual, textbook, or + other written document free 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. + + + + This License is a kind of copyleft, 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. + + + + 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. + + + + 1. APPLICABILITY AND DEFINITIONS + + 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 + Document, below, refers to any such manual or + work. Any member of the public is a licensee, and is addressed + as you. + + + + A Modified Version 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. + + + + A Secondary Section is a named appendix or a + front-matter section of the Document 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. + + + + The Invariant Sections are certain Secondary Sections whose titles + are designated, as being those of Invariant Sections, in the + notice that says that the Document is released under this + License. + + + + The Cover Texts are certain short passages of + text that are listed, as Front-Cover Texts or Back-Cover Texts, + in the notice that says that the Document is released under this + License. + + + + A Transparent copy of the Document 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 Transparent is called + Opaque. + + + + 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. + + + + The Title Page 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, Title Page means the text near the + most prominent appearance of the work's title, preceding the + beginning of the body of the text. + + + + + 2. VERBATIM COPYING + + You may copy and distribute the Document 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 section 3. + + + + You may also lend copies, under the same conditions stated + above, and you may publicly display copies. + + + + + 3. COPYING IN QUANTITY + + If you publish printed copies of the Document numbering more than 100, + and the Document's license notice requires Cover Texts, 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 + Document and satisfy these + conditions, can be treated as verbatim copying in other + respects. + + + + 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. + + + + If you publish or distribute Opaque copies of the Document numbering more than 100, + you must either include a machine-readable Transparent 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. + + + + It is requested, but not required, that you contact the authors + of the Document well before + redistributing any large number of copies, to give them a chance + to provide you with an updated version of the Document. + + + + + 4. MODIFICATIONS + + You may copy and distribute a Modified Version of the Document under the conditions of + sections 2 and 3 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: + + + + + + A + + Use in the Title + Page (and on the covers, if any) a title distinct + from that of the Document, 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. + + + + + + + B + + List on the Title + Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the + Modified Version, + together with at least five of the principal authors of + the Document (all of + its principal authors, if it has less than five). + + + + + + + C + + State on the Title + Page the name of the publisher of the Modified Version, as the + publisher. + + + + + + + D + + Preserve all the copyright notices of the Document. + + + + + + + E + + Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. + + + + + + + F + + Include, immediately after the copyright notices, a + license notice giving the public permission to use the + Modified Version under + the terms of this License, in the form shown in the + Addendum below. + + + + + + + G + + Preserve in that license notice the full lists of Invariant Sections and + required Cover + Texts given in the Document's license notice. + + + + + + + H + + Include an unaltered copy of this License. + + + + + + + I + + Preserve the section entitled History, and + its title, and add to it an item stating at least the + title, year, new authors, and publisher of the Modified Version as given on + the Title Page. If + there is no section entitled History in the + Document, 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. + + + + + + + J + + Preserve the network location, if any, given in the Document for public access + to a Transparent + 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 History + 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. + + + + + + + K + + In any section entitled Acknowledgements or + Dedications, 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. + + + + + + + L + + Preserve all the Invariant + Sections of the Document, unaltered in their + text and in their titles. Section numbers or the + equivalent are not considered part of the section titles. + + + + + + + M + + Delete any section entitled + Endorsements. Such a section may not be + included in the Modified + Version. + + + + + + + N + + Do not retitle any existing section as + Endorsements or to conflict in title with + any Invariant + Section. + + + + + + + If the Modified Version + includes new front-matter sections or appendices that qualify as + Secondary Sections 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 Invariant Sections in the + Modified Version's license notice. These titles must be + distinct from any other section titles. + + + + You may add a section entitled Endorsements, + provided it contains nothing but endorsements of your Modified Version 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. + + + + You may add a passage of up to five words as a Front-Cover Text, and a passage + of up to 25 words as a Back-Cover Text, to the end of + the list of Cover Texts + in the Modified Version. + 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 Document + 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. + + + + The author(s) and publisher(s) of the Document do not by this License + give permission to use their names for publicity for or to + assert or imply endorsement of any Modified Version . + + + + + 5. COMBINING DOCUMENTS + + You may combine the Document + with other documents released under this License, under the + terms defined in section 4 + above for modified versions, provided that you include in the + combination all of the Invariant + Sections of all of the original documents, unmodified, + and list them all as Invariant Sections of your combined work in + its license notice. + + + + The combined work need only contain one copy of this License, + and multiple identical Invariant + Sections 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. + + + + In the combination, you must combine any sections entitled + History in the various original documents, + forming one section entitled History; likewise + combine any sections entitled Acknowledgements, + and any sections entitled Dedications. You must + delete all sections entitled Endorsements. + + + + + 6. COLLECTIONS OF DOCUMENTS + + You may make a collection consisting of the Document 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. + + + + 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. + + + + + 7. AGGREGATION WITH INDEPENDENT WORKS + + A compilation of the Document 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 Modified Version + of the Document, provided no compilation copyright is claimed + for the compilation. Such a compilation is called an + aggregate, 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 Cover Text requirement of section 3 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. + + + + + 8. TRANSLATION + + Translation is considered a kind of modification, so you may + distribute translations of the Document under the terms of section 4. Replacing Invariant Sections 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. + + + + + 9. TERMINATION + + You may not copy, modify, sublicense, or distribute the Document 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. + + + + + 10. FUTURE REVISIONS OF THIS LICENSE + + The Free Software + Foundation 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 http://www.gnu.org/copyleft/. + + + + Each version of the License is given a distinguishing version + number. If the Document + specifies that a particular numbered version of this License + or any later version 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. + + + + + Addendum + + 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: + + +
+ + Copyright YEAR YOUR NAME. + + + 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 Invariant Sections being LIST + THEIR TITLES, with the Front-Cover Texts being LIST, + and with the Back-Cover + Texts being LIST. A copy of the license is included in + the section entitled GNU Free Documentation + License. + +
+ + + If you have no Invariant + Sections, write with no Invariant Sections + instead of saying which ones are invariant. If you have no + Front-Cover Texts, write + no Front-Cover Texts instead of + Front-Cover Texts being LIST; likewise for Back-Cover Texts. + + + + 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 GNU General Public + License, to permit their use in free software. + + + + + diff --git a/help/C/apx-gloss.sgml b/help/C/apx-gloss.sgml deleted file mode 100644 index 40fa9a0ce9..0000000000 --- a/help/C/apx-gloss.sgml +++ /dev/null @@ -1,480 +0,0 @@ - - - Glossary - - - Assistant: - - - See druid - - - - - - Attachment: - - - Any file sent along with an email. Attachments may be embedded in - a message or appended to it. - - - - - - Automatic Indexing: - - - Pre-fetching procedure that allows - Evolution to refer to data quickly. - It enables faster searches and decreases memory usage for - data displays. - - - - - - Bcc (Blind Carbon Copy): - - - A way of addressing a message. Bcc is used to send a group of - people an e-mail, while hiding their names and addresses from each - other. - - - - - - Cc (Carbon Copy): - - - Carbon-copies are used to send a 3rd party a copy of the e-mail, - so they an keep up to date on a conversation, without being in the - To: list. - - - - - - Conduit: - - - A small application which controls - the transfer of data between a handheld device and a desktop - computer. - - - - - - - Druid: - - - A tool which guides a user through a series of steps, usually to - configure or set up a program. Equivalent to "Assistant" and - "Wizard." - - - - - - Evolution: - - - Evolution is the GNOME - groupware application. - - - - - - Execute: - - - To run a program. Any file that can be run is called an - executable. Evolution can download - executable attachments, but before they can be run, the files must - be marked as executable with a shell or file manager. This - security precaution prevents the automatic or accidental execution - of malicious programs. For more information on executables and file - permissions, see the documentation for your file manager or shell. - - - - - - Expunge: - - - When messages are marked for deletion, they remain till they are expunged. - When a message is expunged, it is permanently deleted, as long as it was - marked for deletion. - - - - - - File Tree: - - - A way of describing a group of files on a computer. With the - perversity typical of computer (and especially Unix and Linux) - nomenclature, the top of the tree is called the root directory, - and denoted by /. - The rest of the "branches" spread downwards from the root. Don't - confuse the root directory with the root - account, or root's home directory, normally - /root. - - - - - - Filter: - - - Within Evolution, a filter is a method - of sorting mail automatically when it's downloaded. You can create filters to perform - one or more actions on a message that meets any (or all) of a wide - range of criteria. - - - - - - Forward: - - - If you get a message intended for someone else, you can use - message forwarding to send it on to the right person. - - - - - - Groupware: - - - Groupware is a term describing an application which helps groups - of people work together. Typically, a groupware application will - have several productivity features built into one program, - including: email, calendar, and addressbook tools. - - - - - - HTML: - - - Hyper-text Markup Language (HTML) is a language - for describing page layout in electronic documents like web pages, - help files, and email messages. HTML can be used in email and - news posts to insert images and apply text treatments. - - - - - - Hot Key: - - - Hot-keys are keyboard combinations used to do actions on a - computer instead of using the mouse. - Hot-keys can speed up computer usage. - - - - - - iCal: - - - iCal is the program which - Evolution uses to manage the calendar - section. - - - - - - IMAP: - - - Depending upon whom you ask, IMAP stands for the Internet Mail - Access Protocol, or the Interim Mail Access Protocol. It allows access to email which is typically (although - not always) stored remotely on a server rather than on a local - hard disk. Often contrasted with POP:. - This will not be on the test. - - - - - - - Inline: - - - Displayed as part of a message or other document, rather than - attached as a separate file. Contrast with Attachment:. - - - - - - LDAP: - - - LDAP, the Lightweight Directory Access Protocol, allows a client - to search through a large database of addresses, phone numbers, - and people stored on a server. - - - - - - Mail Client: - - - A mail client is the application with which a person reads and - sends e-mail. Its counterparts are the various types of mail - servers, which handle user authentication and direct messages from - sender to recipient. - - - - - - - Minicard: - - - A format for the display of contact data. Similar in appearance - to a small business card. - - - - - - Nautilus: - - - Nautilus is the next generation file - manager for GNOME. - - - - - - POP: - - - POP, the Post Office Protocol, is a mechanism for email - transport. In contrast to IMAP, it is used only to get mail from - a server and store it locally on your hard disk. - - - - - - Protocol: - - - An agreed-upon method of communication, especially one for - sending particular types of information between computer systems. - Examples include POP (Post Office Protocol), for email, and HTTP - (HypterText Transfer Protocol), for web pages. - - - - - - Postscript: - - - A standard document publishing format. Many printers read raw - Postscript, making Postscript quite versatile. - - - - - - Public Key Encryption: - - - A strong encryption method that uses a set of two "keys," one of - which is made public, and one of which is kept private. Data - encrypted using the public key can only be decrypted using the - private key. The longer the keys, the more difficult it is to - break the encryption. - - - - - - - - Regular Expression: - - - A regular expression, or "regex", is a way of describing a - string of text using metacharacters or wild-card symbols. For - example, the statement fly.*so[au]p means - "any phrase beginning with 'fly' and ending in 'soup' or - 'soap'". If you searched for that expression, you'd find both - "fly in my soup" and "fly in my soap." There's not room here to - go into depth, but if you want, have a look at the documentation - for the grep command by opening a command - line and typing in man grep. - - - - - - Script: - - - A program written in an interpreted (rather than compiled) - language. Often used as a synonym for "macro," to denote a series - of pre-recorded commands or actions within an application. Often - times, accomplish repetitive and tedious tasks, to save the - user time. - - - - - - Search Base: - - - LDAP can break contact lists into many groups. The Search - Base tells LDAP the top group to use. How much of the Search - Base that is searched is set by the Search Scope option. - - - - - - Search Scope: - - - Search Scope states how much of the Search Base to search. - - - - - - Sendmail: - - - As its name implies, sendmail is a - program which sends mail. Evolution - can use it instead of SMTP:; some people - prefer it because it offers more flexibility, but is more - difficult to set up. - - - - - - - Shortcut Bar: - - - A portion of Evolution which offers - users fast access to the most frequently used portions of the - application. - - - - - - Signature: - - - In email terms, a signature is a piece of text placed at the end - of every email sent, similar to a hand-written signature at the bottom - of a written letter. A signature can be anything from a favorite - quotation to a link to a web page; courtesy dictates that it be - fewer than four lines long. - - - - - - SMTP: - - - This is the most common way of transporting mail messages from - the client's computer (you) to the server. SMTP stands for - Simple Mail Transfer Protocol. - - - - - - Tool-Tip: - - - A small box of explanatory text which appears when the mouse - pointer is held motionless over a button or other interface - element. - - - - - - Virus: - - - A program which inserts itself into other files or programs and - which, when executed, spreads to more programs and other - computers. A virus can cause substantial damage by clogging - networks or disk drives, deleting files, or opening security - holes. - - - - - - vCard: - - - A file format for the exchange of contact information. When you - get an address card attached to an email, it's probably in vCard - format. Not to be confused with vFolder:. - - - - - - vFolder: - - - An email organization tool. vFolders allows you to create a folder - that contains the results of a complex search. vFolder contents are - are updated dynamically. - - - - - - - - - - - - - - - - - - - diff --git a/help/C/apx-gloss.xml b/help/C/apx-gloss.xml new file mode 100644 index 0000000000..e3b945e488 --- /dev/null +++ b/help/C/apx-gloss.xml @@ -0,0 +1,480 @@ + + + Glossary + + + Assistant: + + + See druid + + + + + + Attachment: + + + Any file sent along with an email. Attachments may be embedded in + a message or appended to it. + + + + + + Automatic Indexing: + + + Pre-fetching procedure that allows + Evolution to refer to data quickly. + It enables faster searches and decreases memory usage for + data displays. + + + + + + Bcc (Blind Carbon Copy): + + + A way of addressing a message. Bcc is used to send a group of + people an e-mail, while hiding their names and addresses from each + other. + + + + + + Cc (Carbon Copy): + + + Carbon-copies are used to send a 3rd party a copy of the e-mail, + so they an keep up to date on a conversation, without being in the + To: list. + + + + + + Conduit: + + + A small application which controls + the transfer of data between a handheld device and a desktop + computer. + + + + + + + Druid: + + + A tool which guides a user through a series of steps, usually to + configure or set up a program. Equivalent to "Assistant" and + "Wizard." + + + + + + Evolution: + + + Evolution is the GNOME + groupware application. + + + + + + Execute: + + + To run a program. Any file that can be run is called an + executable. Evolution can download + executable attachments, but before they can be run, the files must + be marked as executable with a shell or file manager. This + security precaution prevents the automatic or accidental execution + of malicious programs. For more information on executables and file + permissions, see the documentation for your file manager or shell. + + + + + + Expunge: + + + When messages are marked for deletion, they remain till they are expunged. + When a message is expunged, it is permanently deleted, as long as it was + marked for deletion. + + + + + + File Tree: + + + A way of describing a group of files on a computer. With the + perversity typical of computer (and especially Unix and Linux) + nomenclature, the top of the tree is called the root directory, + and denoted by /. + The rest of the "branches" spread downwards from the root. Don't + confuse the root directory with the root + account, or root's home directory, normally + /root. + + + + + + Filter: + + + Within Evolution, a filter is a method + of sorting mail automatically when it's downloaded. You can create filters to perform + one or more actions on a message that meets any (or all) of a wide + range of criteria. + + + + + + Forward: + + + If you get a message intended for someone else, you can use + message forwarding to send it on to the right person. + + + + + + Groupware: + + + Groupware is a term describing an application which helps groups + of people work together. Typically, a groupware application will + have several productivity features built into one program, + including: email, calendar, and addressbook tools. + + + + + + HTML: + + + Hyper-text Markup Language (HTML) is a language + for describing page layout in electronic documents like web pages, + help files, and email messages. HTML can be used in email and + news posts to insert images and apply text treatments. + + + + + + Hot Key: + + + Hot-keys are keyboard combinations used to do actions on a + computer instead of using the mouse. + Hot-keys can speed up computer usage. + + + + + + iCal: + + + iCal is the program which + Evolution uses to manage the calendar + section. + + + + + + IMAP: + + + Depending upon whom you ask, IMAP stands for the Internet Mail + Access Protocol, or the Interim Mail Access Protocol. It allows access to email which is typically (although + not always) stored remotely on a server rather than on a local + hard disk. Often contrasted with POP:. + This will not be on the test. + + + + + + + Inline: + + + Displayed as part of a message or other document, rather than + attached as a separate file. Contrast with Attachment:. + + + + + + LDAP: + + + LDAP, the Lightweight Directory Access Protocol, allows a client + to search through a large database of addresses, phone numbers, + and people stored on a server. + + + + + + Mail Client: + + + A mail client is the application with which a person reads and + sends e-mail. Its counterparts are the various types of mail + servers, which handle user authentication and direct messages from + sender to recipient. + + + + + + + Minicard: + + + A format for the display of contact data. Similar in appearance + to a small business card. + + + + + + Nautilus: + + + Nautilus is the next generation file + manager for GNOME. + + + + + + POP: + + + POP, the Post Office Protocol, is a mechanism for email + transport. In contrast to IMAP, it is used only to get mail from + a server and store it locally on your hard disk. + + + + + + Protocol: + + + An agreed-upon method of communication, especially one for + sending particular types of information between computer systems. + Examples include POP (Post Office Protocol), for email, and HTTP + (HypterText Transfer Protocol), for web pages. + + + + + + Postscript: + + + A standard document publishing format. Many printers read raw + Postscript, making Postscript quite versatile. + + + + + + Public Key Encryption: + + + A strong encryption method that uses a set of two "keys," one of + which is made public, and one of which is kept private. Data + encrypted using the public key can only be decrypted using the + private key. The longer the keys, the more difficult it is to + break the encryption. + + + + + + + + Regular Expression: + + + A regular expression, or "regex", is a way of describing a + string of text using metacharacters or wild-card symbols. For + example, the statement fly.*so[au]p means + "any phrase beginning with 'fly' and ending in 'soup' or + 'soap'". If you searched for that expression, you'd find both + "fly in my soup" and "fly in my soap." There's not room here to + go into depth, but if you want, have a look at the documentation + for the grep command by opening a command + line and typing in man grep. + + + + + + Script: + + + A program written in an interpreted (rather than compiled) + language. Often used as a synonym for "macro," to denote a series + of pre-recorded commands or actions within an application. Often + times, accomplish repetitive and tedious tasks, to save the + user time. + + + + + + Search Base: + + + LDAP can break contact lists into many groups. The Search + Base tells LDAP the top group to use. How much of the Search + Base that is searched is set by the Search Scope option. + + + + + + Search Scope: + + + Search Scope states how much of the Search Base to search. + + + + + + Sendmail: + + + As its name implies, sendmail is a + program which sends mail. Evolution + can use it instead of SMTP:; some people + prefer it because it offers more flexibility, but is more + difficult to set up. + + + + + + + Shortcut Bar: + + + A portion of Evolution which offers + users fast access to the most frequently used portions of the + application. + + + + + + Signature: + + + In email terms, a signature is a piece of text placed at the end + of every email sent, similar to a hand-written signature at the bottom + of a written letter. A signature can be anything from a favorite + quotation to a link to a web page; courtesy dictates that it be + fewer than four lines long. + + + + + + SMTP: + + + This is the most common way of transporting mail messages from + the client's computer (you) to the server. SMTP stands for + Simple Mail Transfer Protocol. + + + + + + Tool-Tip: + + + A small box of explanatory text which appears when the mouse + pointer is held motionless over a button or other interface + element. + + + + + + Virus: + + + A program which inserts itself into other files or programs and + which, when executed, spreads to more programs and other + computers. A virus can cause substantial damage by clogging + networks or disk drives, deleting files, or opening security + holes. + + + + + + vCard: + + + A file format for the exchange of contact information. When you + get an address card attached to an email, it's probably in vCard + format. Not to be confused with vFolder:. + + + + + + vFolder: + + + An email organization tool. vFolders allows you to create a folder + that contains the results of a complex search. vFolder contents are + are updated dynamically. + + + + + + + + + + + + + + + + + + + diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.sgml deleted file mode 100644 index 67f1029bd3..0000000000 --- a/help/C/config-prefs.sgml +++ /dev/null @@ -1,908 +0,0 @@ - - - - Advanced Configuration - - Perhaps your mail server has changed names. Perhaps you've - grown tired of a certain layout for your appointments. - Whatever the reason, you want to change your - Evolution settings. This chapter - will tell you how to do just that. - - - Evolution 1.2 brings with it a redesigned comprehensive - settings window that you can open by choosing - Tools - Configure, no matter - where you are in Evolution. On the left half of the settings - window is a column, similar to the Evolution shortcut bar, - which lets you choose which portion of Evolution to - customize. The right half of the window is where you'll make - your actual changes. - - - - -
- Changing Mail Settings - - Changing Mail Settings - - - -
- - - - There are eight items you can customize. From top to bottom, they - are: - - - Mail Accounts - - - Here, add or change information about your email - 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 . - - - - - - Folder Settings - - - Here, you can choose the default folders for various - components of Evolution, the folders that will be cached - locally when you go to offline mode, and the folders that - Evolution will use when it is searching for - autocompletion information as you address a mail. - - - - - - Mail Preferences - - - These are overall mail reading preferences: display - settings, notification options, security, and so - forth. These are covered in . - - - - - - Composer Preferences - - - Settings for the way that you use the mail composer: - shortcuts, signatures, spelling, and so forth. One fun - 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 . - - - - - - Calendar and Tasks - - - Here, you can set the way the calendar behaves, including - your time zone and the length of your work-week. - - - - - - Directory Servers - - - If you want to use a shared directory server (LDAP - server), this is the place to set it up. - - - - - - Font Preferences - - - Choose the fonts that Evolution will use to display email - here. You can choose fonts for the mail composer by - selecting Edit - Properties from - within the composer window. - - - - - - Summary Preferences - - - Set the mail folders, news feeds, schedule summary - length, and weather locations to be displayed here. For - news feeds, enter the web address of any RDF file. - - - - - - - - - - Mail Settings - - The first few tools, with the exception of the folder tool, - cover mail tasks: - - - - Working with Mail Accounts - - Ximian Evolution allows you to - maintain multiple accounts, or identities. This is useful - want to keep personal and professional email separate, or if - you wear several hats at work. When you are writing an email - message, you can which account to use by selecting from the - drop-down list next to the From entry in - the message composer. - - - - Clicking Get Mail will refresh any - IMAP, mh, or - mbox listings - and check and download mail from all POP servers. In other - words, Get Mail gets your mail, no - matter how many sources you have, or what types they are. If - you don't want to check mail for a given account, select it - in the Accounts tab and click the - Disable button. - - - - To add a new account, simply click Add - to open the mail configuration assistant. To alter an - existing identity, select it in the - Preferences window, and then click - Edit to open the account editor - dialog. - - - - The account editor dialog has six sections: - - - - Identity: - - - Here, enter the name, - email address, and other identifying information for the - account. - - - - - Receiving Mail - - - Here, select the way you will be getting mail: you may - download mail from a server (POP), read and keep it on the - server (Microsoft Exchange or IMAP), or read it from files - that already exist on your desktop computer. If you use - a server, it may permit or require you to use a Secure - Socket Layer (SSL) connection. To turn SSL connections - on, just click the Use Secure Connection - (SSL) button. - - -Specifying Port Numbers - -Your system administrator may ask you to connect to a specific port on -a mail server. To specify which port you use, just type a colon and -the port number after the server name. For example, to connect to port -143 on the server smtp.omniport.com, you would enter -as - -smtp.omniport.com:143 - as the server name. - - - - - - - - Receiving Options - - - Here, decide whether you'd like to check for mail - automatically and how often, as well as other message - retrieval options. - - - - If you chose POP: - - - - - Checking for new mail: If you would - like Evolution - to check for new mail automatically, - check the box and select a frequency in - minutes. - - - - - - Message Storage: If you'd like to store - copies of your mail on the server, check - this option. - - - - - - Store Store status headers in - Elm/Pine/Mutt format: If you would like to - use the X-Status header format used by the - mail clients Elm, Pine, and Mutt, select - this option. This option is useful if you - plan to check your mail with those clients - from time to time. - - - - - - - - - If you chose Microsoft Exchange: - - - - - Checking for new mail: If you would like - Evolution to check for new mail - automatically, check the box and select a frequency in - minutes. - - - - - Exchange Server: If your active directory user name - is different from your Exchange mail user name, check this - box and enter your mail username here. - - - - - Create a Global Address List folder: If you would - like to have a seperate folder for the Active Directory's - Global Address List, leave this box checked. - - - - - Active Directory Server Name: In most organizations, - the Active Directory server will be different from - the Exchange mail server. If so, check the box and - enter the Active Directory server name here. - - - - - Limit number of Responses: Select a maximum number - of results for an address search. A maximum number of - results limits the load on your system and on your network. - - - - - - - - - If you chose IMAP: - - - - - - Checking for new mail: If you would like - Evolution to check for new mail - automatically, check the box and select a frequency in - minutes. - - - - - If you want Evolution - to check for new messages in all your - IMAP folders, make sure the Check for new - messages in all folders box is selected. - - - - Show only subscribed folders: Check this box if you - have more folders in your IMAP view than you want to - read. - - - - - Override server-supplied namespace: If you like, enter a - 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 . - - - - Apply filters to new messages in INBOX on this - server: If you'd like your filters to work on this account - as well as on locally downloaded mail, check this box. - - - - Store Store status headers in Elm/Pine/Mutt format: - If you would like to use the X-Status header format used - by the mail clients Elm, Pine, and Mutt, select this - option. This option is useful if you plan to check your - mail with those clients from time to time. - - - - - - - - - - - - - - - Sending Mail - - - In this section, you will choose and configure a method - for sending mail. You may choose SMTP, Microsoft Exchange (if - you have purchased the Ximian Connector for Microsoft - Exchange) or sendmail. - - - - - Special Folders - - - Here, you can decide where this account will store the - messages that it has sent, and the messages that you - save as drafts. - - - - - Security - - - In this section, you will set the security options for - 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 . - - - - - - - - - - Mail Display Options - - In this tab you can decide how you would like - Ximian Evolution to display your - mail: how to display citations, how long to wait before - marking a message as read, and so forth. - - - This is also where you can decide how you would like - Ximian Evolution to handle inline - images in HTML mail that you get. There is a detailed - discussion of the issues surrounding these options in . - - - To hange the font which Ximian - Evolution uses to display mail, do the - following: - - - - Open the Control Center by selecting - System - Settings from - the menu panel. - - - - - Select the HTML Viewer settings tool. - - - - Choose the font and font size you would like to use. - - - - - Alternately, open a terminal and run the - gtkhtml-properties-capplet command. This - will open the GNOME HTML Display Properties tool, and you can - select a font and other attributes of your HTML display, - including that in Ximian Evolution. - - - - - Message Composer Preferences - - There are three whole tabs of settings you can change for the - message composer. The General tab covers shortcuts and - assorted behavior, and the other two control signatures and - spell checking. In the General tab, you can set: - - - - - Shortcuts Type - - - Choose a keyboard shortcut scheme: do you prefer - keyboard shortcuts similar to those of Microsoft - Windows, XEmacs, or Emacs? - - - - - - Default Behavior - - - Choose how you will normally forward and reply - messages, what character set they will use, whether - they will be in HTML, and whether that HTML can - contain smiley face images. - - - - - - - Alerts - - - There are two optional alerts here: - - - Prompt when sending messages with an empty subject - - - The composer will warn you if you try to send a - message without a subject. - - - - - - Prompt when sending messages with only Bcc recipients defined - - - The composer will warn you if you try to send a - message that has only Bcc - recipients. This is important because some mail - servers will fail to honor blind carbon copy if you - do not have at least one recipient that is visible to - all readers. - - - - - - - - - - - - The signature editor is new for Evolution 1.2. It allows you - to create several different signatures in plain text or in - HTML, and to specify which of them will be added to emails - you create in the message composer. If you prefer to use an - alternate signature or none at all, you can select it from - the mail composer itself. - - - In the spell-checking tool, you can set spelling options, - including the language or languages you will use. Note that you - must install the gnome-spell package, available through Red - Carpet, for spell-checking to be available in - Evolution. Alternate dictionaries are aslo available through - Red Carpet and are detected automatically if you have installed - them. - - - - - - - - - Calendar and Task List Settings - - The calendar configuration tool has two tabs - General and - Display, and is illustrated in . - - -
- Calendar Preferences Dialog - - Calendar Configuration - - - -
- - - - - The General tab lets you set the - following: - - - Time zone - - - The city you're located in, to judge your time zone. - - - - - Time format - - You may choose between twelve-hour (AM/PM) and - twenty-four hour time formats here by clicking the - appropriate radio button. - - - - - Work Week - - - When does your work day start, and when does it end? - In the day and week views, - Evolution displays all the - hours in the range you select here, even if there are - no appointments for those times. Of course, you can - still schedule an appointment outside of these hours, - and if you do, the display will be extended to show - it. - - - - - First day of the week - - You can set weeks to start on Sunday or on Monday. - - - - Start of day - - - Says what time of the day your weekday starts. This - will show all times till the end of the day, - regardless of there is an appointment during the time - period. - - - - - End of day - - - Sets the time the day ends at. - - - - - - - Alerts - - - If you'd like to be warned before you delete any - appointment, or to have a reminder automatically - appear for each event, select the check boxes here. - - - - - - - - The Display section lets you choose how - your appointments and tasks will appear in your calendar. - - The display properties you can set are: - - - - Time divisions - - - Sets the increments shown on the daily view in the - calendar. You can set this to be anywhere from five - minutes to an hour, in five minute increments. - - - - - Show appointment end times in week and month views - - - If there is space, - Evolution will show the end - times in the week and month views for each - appointment. - - - - - Compress weekends in month view - - - If checked, your weekends will be shown in one box, - instead of one for each day in the month view. - - - - - - Show week numbers in date navigator - - - This will show the week numbers next to the respective - weeks in the calendar. - - - - - - Tasks due today - - - Configures what color to set your tasks that are due - today to. - - - - - Overdue tasks - - - Choose the color for overdue tasks. - - - - - - - - Managing the Addressbook - - Addressbook settings are limited to the usage and - configuration of directory servers (LDAP and - Exchange). Contact folders for the mailer's autocompletion - feature are set in the Folders tool above, and all other - addressbook controls are available in the addressbook window - itself. - - - - Adding Directory Servers - - To add a new LDAP server - to your available contact folders: - - - - Select - - Tools - Addressbook Sources - - from the menu. - - - - - Click the Add button on the right - side. - - - - - Enter the server information: - - - Account name - - - The name that you see on the screen. This could - be anything you wish. - - - - - Server name - - - Address of the server where the addressbook is located. - - - - - My server requires authentication - - - Select this if the server requires - Evolution to provide - a server in order to access the LDAP contacts. - - - - - Port - - - The internet port - Evolution connects to - in order to access the LDAP database. This is - normally 389. - - - - - Search base - - - The base entry to use for all your searches. - Contact your administrator for information about - the correct settings. - - - - - Search scope - - - How broad the search is in the directory. The - following options are available: - - - Base - - - Searches just the Search Base. Most of the time, - not very useful. - - - - - One - - - Searches the Search Base and one entry - below it. - - - - - Sub - - - Searches the Search Base and all entries - below it. - - - - - - - - - - - - - Click OK. - - - - - Click OK to permanenty make - changes or Apply to temporarily - set the changes. - - - - - - - - - - \ No newline at end of file diff --git a/help/C/config-prefs.xml b/help/C/config-prefs.xml new file mode 100644 index 0000000000..08252a59b8 --- /dev/null +++ b/help/C/config-prefs.xml @@ -0,0 +1,908 @@ + + + + Advanced Configuration + + Perhaps your mail server has changed names. Perhaps you've + grown tired of a certain layout for your appointments. + Whatever the reason, you want to change your + Evolution settings. This chapter + will tell you how to do just that. + + + Evolution 1.2 brings with it a redesigned comprehensive + settings window that you can open by choosing + Tools + Configure, no matter + where you are in Evolution. On the left half of the settings + window is a column, similar to the Evolution shortcut bar, + which lets you choose which portion of Evolution to + customize. The right half of the window is where you'll make + your actual changes. + + + + +
+ Changing Mail Settings + + Changing Mail Settings + + + +
+ + + + There are eight items you can customize. From top to bottom, they + are: + + + Mail Accounts + + + Here, add or change information about your email + 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 . + + + + + + Folder Settings + + + Here, you can choose the default folders for various + components of Evolution, the folders that will be cached + locally when you go to offline mode, and the folders that + Evolution will use when it is searching for + autocompletion information as you address a mail. + + + + + + Mail Preferences + + + These are overall mail reading preferences: display + settings, notification options, security, and so + forth. These are covered in . + + + + + + Composer Preferences + + + Settings for the way that you use the mail composer: + shortcuts, signatures, spelling, and so forth. One fun + 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 . + + + + + + Calendar and Tasks + + + Here, you can set the way the calendar behaves, including + your time zone and the length of your work-week. + + + + + + Directory Servers + + + If you want to use a shared directory server (LDAP + server), this is the place to set it up. + + + + + + Font Preferences + + + Choose the fonts that Evolution will use to display email + here. You can choose fonts for the mail composer by + selecting Edit + Properties from + within the composer window. + + + + + + Summary Preferences + + + Set the mail folders, news feeds, schedule summary + length, and weather locations to be displayed here. For + news feeds, enter the web address of any RDF file. + + + + + + + + + + Mail Settings + + The first few tools, with the exception of the folder tool, + cover mail tasks: + + + + Working with Mail Accounts + + Ximian Evolution allows you to + maintain multiple accounts, or identities. This is useful + want to keep personal and professional email separate, or if + you wear several hats at work. When you are writing an email + message, you can which account to use by selecting from the + drop-down list next to the From entry in + the message composer. + + + + Clicking Get Mail will refresh any + IMAP, mh, or + mbox listings + and check and download mail from all POP servers. In other + words, Get Mail gets your mail, no + matter how many sources you have, or what types they are. If + you don't want to check mail for a given account, select it + in the Accounts tab and click the + Disable button. + + + + To add a new account, simply click Add + to open the mail configuration assistant. To alter an + existing identity, select it in the + Preferences window, and then click + Edit to open the account editor + dialog. + + + + The account editor dialog has six sections: + + + + Identity: + + + Here, enter the name, + email address, and other identifying information for the + account. + + + + + Receiving Mail + + + Here, select the way you will be getting mail: you may + download mail from a server (POP), read and keep it on the + server (Microsoft Exchange or IMAP), or read it from files + that already exist on your desktop computer. If you use + a server, it may permit or require you to use a Secure + Socket Layer (SSL) connection. To turn SSL connections + on, just click the Use Secure Connection + (SSL) button. + + +Specifying Port Numbers + +Your system administrator may ask you to connect to a specific port on +a mail server. To specify which port you use, just type a colon and +the port number after the server name. For example, to connect to port +143 on the server smtp.omniport.com, you would enter +as + +smtp.omniport.com:143 + as the server name. + + + + + + + + Receiving Options + + + Here, decide whether you'd like to check for mail + automatically and how often, as well as other message + retrieval options. + + + + If you chose POP: + + + + + Checking for new mail: If you would + like Evolution + to check for new mail automatically, + check the box and select a frequency in + minutes. + + + + + + Message Storage: If you'd like to store + copies of your mail on the server, check + this option. + + + + + + Store Store status headers in + Elm/Pine/Mutt format: If you would like to + use the X-Status header format used by the + mail clients Elm, Pine, and Mutt, select + this option. This option is useful if you + plan to check your mail with those clients + from time to time. + + + + + + + + + If you chose Microsoft Exchange: + + + + + Checking for new mail: If you would like + Evolution to check for new mail + automatically, check the box and select a frequency in + minutes. + + + + + Exchange Server: If your active directory user name + is different from your Exchange mail user name, check this + box and enter your mail username here. + + + + + Create a Global Address List folder: If you would + like to have a seperate folder for the Active Directory's + Global Address List, leave this box checked. + + + + + Active Directory Server Name: In most organizations, + the Active Directory server will be different from + the Exchange mail server. If so, check the box and + enter the Active Directory server name here. + + + + + Limit number of Responses: Select a maximum number + of results for an address search. A maximum number of + results limits the load on your system and on your network. + + + + + + + + + If you chose IMAP: + + + + + + Checking for new mail: If you would like + Evolution to check for new mail + automatically, check the box and select a frequency in + minutes. + + + + + If you want Evolution + to check for new messages in all your + IMAP folders, make sure the Check for new + messages in all folders box is selected. + + + + Show only subscribed folders: Check this box if you + have more folders in your IMAP view than you want to + read. + + + + + Override server-supplied namespace: If you like, enter a + 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 . + + + + Apply filters to new messages in INBOX on this + server: If you'd like your filters to work on this account + as well as on locally downloaded mail, check this box. + + + + Store Store status headers in Elm/Pine/Mutt format: + If you would like to use the X-Status header format used + by the mail clients Elm, Pine, and Mutt, select this + option. This option is useful if you plan to check your + mail with those clients from time to time. + + + + + + + + + + + + + + + Sending Mail + + + In this section, you will choose and configure a method + for sending mail. You may choose SMTP, Microsoft Exchange (if + you have purchased the Ximian Connector for Microsoft + Exchange) or sendmail. + + + + + Special Folders + + + Here, you can decide where this account will store the + messages that it has sent, and the messages that you + save as drafts. + + + + + Security + + + In this section, you will set the security options for + 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 . + + + + + + + + + + Mail Display Options + + In this tab you can decide how you would like + Ximian Evolution to display your + mail: how to display citations, how long to wait before + marking a message as read, and so forth. + + + This is also where you can decide how you would like + Ximian Evolution to handle inline + images in HTML mail that you get. There is a detailed + discussion of the issues surrounding these options in . + + + To hange the font which Ximian + Evolution uses to display mail, do the + following: + + + + Open the Control Center by selecting + System + Settings from + the menu panel. + + + + + Select the HTML Viewer settings tool. + + + + Choose the font and font size you would like to use. + + + + + Alternately, open a terminal and run the + gtkhtml-properties-capplet command. This + will open the GNOME HTML Display Properties tool, and you can + select a font and other attributes of your HTML display, + including that in Ximian Evolution. + + + + + Message Composer Preferences + + There are three whole tabs of settings you can change for the + message composer. The General tab covers shortcuts and + assorted behavior, and the other two control signatures and + spell checking. In the General tab, you can set: + + + + + Shortcuts Type + + + Choose a keyboard shortcut scheme: do you prefer + keyboard shortcuts similar to those of Microsoft + Windows, XEmacs, or Emacs? + + + + + + Default Behavior + + + Choose how you will normally forward and reply + messages, what character set they will use, whether + they will be in HTML, and whether that HTML can + contain smiley face images. + + + + + + + Alerts + + + There are two optional alerts here: + + + Prompt when sending messages with an empty subject + + + The composer will warn you if you try to send a + message without a subject. + + + + + + Prompt when sending messages with only Bcc recipients defined + + + The composer will warn you if you try to send a + message that has only Bcc + recipients. This is important because some mail + servers will fail to honor blind carbon copy if you + do not have at least one recipient that is visible to + all readers. + + + + + + + + + + + + The signature editor is new for Evolution 1.2. It allows you + to create several different signatures in plain text or in + HTML, and to specify which of them will be added to emails + you create in the message composer. If you prefer to use an + alternate signature or none at all, you can select it from + the mail composer itself. + + + In the spell-checking tool, you can set spelling options, + including the language or languages you will use. Note that you + must install the gnome-spell package, available through Red + Carpet, for spell-checking to be available in + Evolution. Alternate dictionaries are aslo available through + Red Carpet and are detected automatically if you have installed + them. + + + + + + + + + Calendar and Task List Settings + + The calendar configuration tool has two tabs + General and + Display, and is illustrated in . + + +
+ Calendar Preferences Dialog + + Calendar Configuration + + + +
+ + + + + The General tab lets you set the + following: + + + Time zone + + + The city you're located in, to judge your time zone. + + + + + Time format + + You may choose between twelve-hour (AM/PM) and + twenty-four hour time formats here by clicking the + appropriate radio button. + + + + + Work Week + + + When does your work day start, and when does it end? + In the day and week views, + Evolution displays all the + hours in the range you select here, even if there are + no appointments for those times. Of course, you can + still schedule an appointment outside of these hours, + and if you do, the display will be extended to show + it. + + + + + First day of the week + + You can set weeks to start on Sunday or on Monday. + + + + Start of day + + + Says what time of the day your weekday starts. This + will show all times till the end of the day, + regardless of there is an appointment during the time + period. + + + + + End of day + + + Sets the time the day ends at. + + + + + + + Alerts + + + If you'd like to be warned before you delete any + appointment, or to have a reminder automatically + appear for each event, select the check boxes here. + + + + + + + + The Display section lets you choose how + your appointments and tasks will appear in your calendar. + + The display properties you can set are: + + + + Time divisions + + + Sets the increments shown on the daily view in the + calendar. You can set this to be anywhere from five + minutes to an hour, in five minute increments. + + + + + Show appointment end times in week and month views + + + If there is space, + Evolution will show the end + times in the week and month views for each + appointment. + + + + + Compress weekends in month view + + + If checked, your weekends will be shown in one box, + instead of one for each day in the month view. + + + + + + Show week numbers in date navigator + + + This will show the week numbers next to the respective + weeks in the calendar. + + + + + + Tasks due today + + + Configures what color to set your tasks that are due + today to. + + + + + Overdue tasks + + + Choose the color for overdue tasks. + + + + + + + + Managing the Addressbook + + Addressbook settings are limited to the usage and + configuration of directory servers (LDAP and + Exchange). Contact folders for the mailer's autocompletion + feature are set in the Folders tool above, and all other + addressbook controls are available in the addressbook window + itself. + + + + Adding Directory Servers + + To add a new LDAP server + to your available contact folders: + + + + Select + + Tools + Addressbook Sources + + from the menu. + + + + + Click the Add button on the right + side. + + + + + Enter the server information: + + + Account name + + + The name that you see on the screen. This could + be anything you wish. + + + + + Server name + + + Address of the server where the addressbook is located. + + + + + My server requires authentication + + + Select this if the server requires + Evolution to provide + a server in order to access the LDAP contacts. + + + + + Port + + + The internet port + Evolution connects to + in order to access the LDAP database. This is + normally 389. + + + + + Search base + + + The base entry to use for all your searches. + Contact your administrator for information about + the correct settings. + + + + + Search scope + + + How broad the search is in the directory. The + following options are available: + + + Base + + + Searches just the Search Base. Most of the time, + not very useful. + + + + + One + + + Searches the Search Base and one entry + below it. + + + + + Sub + + + Searches the Search Base and all entries + below it. + + + + + + + + + + + + + Click OK. + + + + + Click OK to permanenty make + changes or Apply to temporarily + set the changes. + + + + + + + + + + \ No newline at end of file diff --git a/help/C/config-sync.sgml b/help/C/config-sync.sgml deleted file mode 100644 index 95b0e71603..0000000000 --- a/help/C/config-sync.sgml +++ /dev/null @@ -1,138 +0,0 @@ - - Setting up your synchronization system - - Synchronization presents you with two issues you'll need to - address. - - - Your computer needs to recognize and access your handheld. - At this time, Ximian Evolution only - supports Palm-OS devices like the PalmPilot and the - Handspring Visor. - - - You should decide what sort of synchronization behavior you - want. - - - - - - If you haven't used a handheld device with your computer - before, you'll need to run the GNOME Control - Center by selecting - SystemSettings, - and make sure that Pilot Link is - properly configured. You will need to make sure that you have - read and write permissions on the device, which is normally - /dev/pilot. If that does not work, check /dev/ttyS0 if you have - a serial connection, or /dev/ttyUSB0 for a USB connection. You - can do this by becoming root and running the command: - chmod 777 /dev/ttyUSB0. - - - Once your computer and your Palm-OS device are talking happily - to each other, select the conduits you want under the - Pilot Conduits section of the Control - Center. You may use conduits to synchronize data with several - applications; the Ximian Evolution - conduits are labelled EAddress, for the - contacts in your addressbook, ECalendar, - for your calendar, and ETodo, for your - task list. - - - To enable a conduit, click the - Enable to enable it, and click - Settings to change what it will do when - activated. Your options may vary depending on the conduit, - but typically they will be: - - - - Disabled: - - - Do nothing. - - - - - - Synchronize: - - - Copy new data from the computer to the handheld, and - from the handheld to the computer. Remove items - that were on both systems but have been deleted on - one. - - - - - - Copy From Pilot: - - - If there is any new data on the the handheld device, - copy it to the computer. - - - - - - Copy To Pilot: - - - Copy new data from the computer to the handheld. - - - - - - Merge From Pilot: - - - Copy new data from the handheld to the computer, and - remove any information from the computer that has - been deleted on the handheld. - - - - - - Merge To Pilot: - - - Copy new data from the computer to the handheld, and - remove any information from the handheld that has - been deleted on the computer. - - - - - - - - Select the behavior you want for each conduit you choose to use. - If you're not sure, go ahead and stick with - Synchronize. Then, put your handheld on - its cradle and press the HotSync button. - - - - Data Loss Prevention - - It's always a good idea to make a backup. To do that, - make a copy of the evolution - directory inside your home directory. - - - - - - - - - diff --git a/help/C/config-sync.xml b/help/C/config-sync.xml new file mode 100644 index 0000000000..95b0e71603 --- /dev/null +++ b/help/C/config-sync.xml @@ -0,0 +1,138 @@ + + Setting up your synchronization system + + Synchronization presents you with two issues you'll need to + address. + + + Your computer needs to recognize and access your handheld. + At this time, Ximian Evolution only + supports Palm-OS devices like the PalmPilot and the + Handspring Visor. + + + You should decide what sort of synchronization behavior you + want. + + + + + + If you haven't used a handheld device with your computer + before, you'll need to run the GNOME Control + Center by selecting + SystemSettings, + and make sure that Pilot Link is + properly configured. You will need to make sure that you have + read and write permissions on the device, which is normally + /dev/pilot. If that does not work, check /dev/ttyS0 if you have + a serial connection, or /dev/ttyUSB0 for a USB connection. You + can do this by becoming root and running the command: + chmod 777 /dev/ttyUSB0. + + + Once your computer and your Palm-OS device are talking happily + to each other, select the conduits you want under the + Pilot Conduits section of the Control + Center. You may use conduits to synchronize data with several + applications; the Ximian Evolution + conduits are labelled EAddress, for the + contacts in your addressbook, ECalendar, + for your calendar, and ETodo, for your + task list. + + + To enable a conduit, click the + Enable to enable it, and click + Settings to change what it will do when + activated. Your options may vary depending on the conduit, + but typically they will be: + + + + Disabled: + + + Do nothing. + + + + + + Synchronize: + + + Copy new data from the computer to the handheld, and + from the handheld to the computer. Remove items + that were on both systems but have been deleted on + one. + + + + + + Copy From Pilot: + + + If there is any new data on the the handheld device, + copy it to the computer. + + + + + + Copy To Pilot: + + + Copy new data from the computer to the handheld. + + + + + + Merge From Pilot: + + + Copy new data from the handheld to the computer, and + remove any information from the computer that has + been deleted on the handheld. + + + + + + Merge To Pilot: + + + Copy new data from the computer to the handheld, and + remove any information from the handheld that has + been deleted on the computer. + + + + + + + + Select the behavior you want for each conduit you choose to use. + If you're not sure, go ahead and stick with + Synchronize. Then, put your handheld on + its cradle and press the HotSync button. + + + + Data Loss Prevention + + It's always a good idea to make a backup. To do that, + make a copy of the evolution + directory inside your home directory. + + + + + + + + + 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 @@ - - Ximian, Inc. - + + Ximian, Inc. + Evolution Manual 2002 - - + + A user's guide to Ximian Evolution which explains how to use + its mail, calendar, addressbook, and task list features. + + + manual + + + + diff --git a/help/C/evolution.sgml b/help/C/evolution.sgml deleted file mode 100644 index 88a75bd6c0..0000000000 --- a/help/C/evolution.sgml +++ /dev/null @@ -1,126 +0,0 @@ - - - - - - - - - - - - - - - - - - -]> - - - - - - - A User's Guide to Ximian Evolution - - AaronWeber - KevinBreit - EttorePerazzoli - DuncanMak - - - 2000-2002 - Ximian, Inc. - - - - - - 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 no Invariant - Sections, no Front-Cover Texts, and no Back-Cover Texts. You - may obtain a copy of the GNU Free Documentation - License from the Free Software Foundation by - visiting their - Web site or by writing to: Free Software Foundation, - Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, - USA. - - - 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. - - - - - This is version 1.2 of the Ximian Evolution manual. It describes - version 1.2 of the Ximian Evolution groupware suite. - - - - - &PREFACE; - - - Getting Started with Ximian Evolution - - - Part one of the Ximian Evolution manual - describes how to use Ximian Evolution for - email, contact management, and appointment and task - scheduling. You'll find as you go along that there's more - than one way to do things, and you can pick whichever method - you like best. - - - - &USAGE-MAINWINDOW; - &USAGE-EXEC-SUMMARY; - &USAGE-MAIL; - &USAGE-MAIL-ORG; - &USAGE-CONTACT; - &USAGE-CALENDAR; - &USAGE-EXCHANGE; - &USAGE-SYNC; - &USAGE-PRINT; - - - Configuring and Managing Ximian Evolution - - - Ximian Evolution is highly - configurable. Usually, when developers say that, they mean - that they didn't test it out thoroughly and have left it to - other programmers to "configure" themselves a working - system. In the case of Ximian - Evolution, "configurable" means that, while you - can expect the program to work perfectly well with the default - settings, it's also easy to alter its behavior in a wide - variety of ways, so that it fits your needs exactly. This - part of the book will describe that process, from the quickest - glimpse of the Setup Assistant to an in-depth guide to obscure - preferences settings. - - - - &CONFIG-PREFS; - &CONFIG-SYNC; - - - &MENUREF; - &APX-GLOSS; - &APX-BUGS; - &APX-AUTHORS; - - \ No newline at end of file diff --git a/help/C/evolution.xml b/help/C/evolution.xml new file mode 100644 index 0000000000..80975cb2ba --- /dev/null +++ b/help/C/evolution.xml @@ -0,0 +1,107 @@ + + + + + + + + + + + + + + + + + + + + + +]> + + + + + + + A User's Guide to Ximian Evolution + + AaronWeber + KevinBreit + EttorePerazzoli + DuncanMak + + + 2000-2002 + Ximian, Inc. + + + + This is version 1.4 of the Ximian Evolution manual. It describes + version 1.4 of the Ximian Evolution groupware suite. + + + + + + &LEGAL; + &PREFACE; + + + Getting Started with Ximian Evolution + + + Part one of the Ximian Evolution manual + describes how to use Ximian Evolution for + email, contact management, and appointment and task + scheduling. You'll find as you go along that there's more + than one way to do things, and you can pick whichever method + you like best. + + + + &USAGE-MAINWINDOW; + &USAGE-EXEC-SUMMARY; + &USAGE-MAIL; + &USAGE-MAIL-ORG; + &USAGE-CONTACT; + &USAGE-CALENDAR; + &USAGE-EXCHANGE; + &USAGE-SYNC; + &USAGE-PRINT; + + + Configuring and Managing Ximian Evolution + + + Ximian Evolution is highly + configurable. Usually, when developers say that, they mean + that they didn't test it out thoroughly and have left it to + other programmers to "configure" themselves a working + system. In the case of Ximian + Evolution, "configurable" means that, while you + can expect the program to work perfectly well with the default + settings, it's also easy to alter its behavior in a wide + variety of ways, so that it fits your needs exactly. This + part of the book will describe that process, from the quickest + glimpse of the Setup Assistant to an in-depth guide to obscure + preferences settings. + + + + &CONFIG-PREFS; + &CONFIG-SYNC; + + + &MENUREF; + &APX-GLOSS; + &APX-BUGS; + &APX-AUTHORS; + + \ No newline at end of file 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 @@ + + + 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 or in the + file COPYING-DOCS distributed with this manual. + + 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. + + + + 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. + + + + DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED + UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE + WITH THE FURTHER UNDERSTANDING THAT: + + + + 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 + + + + 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. + + + + + + diff --git a/help/C/menuref.sgml b/help/C/menuref.sgml deleted file mode 100644 index bb1eccf994..0000000000 --- a/help/C/menuref.sgml +++ /dev/null @@ -1,421 +0,0 @@ - - - - Quick Reference - - You might want to copy this section and tape it to the wall - next to your computer: it's a very short summary of most of - the things you'll want to do with - Ximian Evolution. - - - - -Custom Keyboard Shortcuts - - If you have set custom keyboard shortcuts for your desktop, (you can - do this the control center: select - SystemSettings - from your menu panel), they may interfere with Evolution keyboard - shortcuts. - - - For example, if you have chosen Emacs-style key bindings for your - desktop-wide text editor, the shortcut - - Ctrl - W - - will act as "Cut region" rather than as "Close Window" in the - message composer. - - - - - - - - Opening or Creating Anything - - - - - - New Item: - - - Press Ctrl - N to open a new item - for whatever part of Ximian - Evolution you're working on. In mail, - that means you'll create a new message. If you're - looking at your addressbook, Ctrl - N creates a new contact - card, and in the calendar, a new appointment. - - - - - - - Create a new folder: - - - FileNew - Folder or - - Ctrl - Shift - E - - - - - - - Create a new Shortcut in the Evolution Bar: - - - File - New - Evolution Bar Shortcut or - - Ctrl - Shift - S - - - - - - - Create a new email message: - - - Use - FileNewMail - Message or - - Ctrl - Shift - M - - - - - - - Create a new Appointment: - - - File - New - Appointment or - - Ctrl - Shift - A - - - - - - - - Enter a new Contact: - - - Double-click in any blank space in the contact - manager to create a new address card. You can also - use - File - New - Contact or - - Ctrl - Shift - C - - - - - - - Create a new Task: - - - File - New - Task or - - Ctrl - Shift - T - - - - - - - - - Mail Tasks - - Here are the most frequent email tasks, and shortcuts for - navigating your mailbox with the keyboard instead of the - mouse: - - - - - Send and Receive Mail: - - - Press F9, click the - Send/Receive button in the - toolbar, or choose - Actions - Send/Receive. - - - - - Navigating the Message List with the Keyboard: - - - Press ] or . to jump to the next unread - message. [ or , goes to the previous - unread message. Use the arrow keys to move up - and down along the list of all messages. - - - - - - Move the display up and down in the preview pane: - - - Press the space bar to go a page down. Press - Backspace to go a page up. - - - - - - Reply to a Message: - - - To reply to the sender of the message only: - click Reply in the - toolbar, or press - - Ctrl - R - - - - To reply to the sender and all the other visible - recipients of the message, click Reply to - All or select the message and press - - Shift - Ctrl - R - - - - - - - Forward a Message: - - - Select the message or messages you want to forward, - and click Forward in the - toolbar, or press - - Ctrl - F - - - - - - - Open a Message in a New Window: - - - Double-click the message you want to view, or select - it and press Return - - Ctrl - O - - - - - - - Create Filters and Virtual Folders: - - - Right-click on a message and select - Create Rule From - Message. You can also create filters and - virtual folders in the Tools menu. - - - - - - - Add Sender to Address Book: - - - Right-click on a message and select Add - Sender to Address Book. You can also - right-click on any email address to add it to your - address book. - - - - - - - - - - - Calendar - - - - - Create a new Appointment: - - - File - New - Appointment or - - Ctrl - Shift - A - - - - - - - Create a new Task: - - - File - New - Task or - - Ctrl - Shift - T - - - - - - - - - - - New Appointments Fast - - Click on any blank spot in the calendar and start - typing to create a new appointment entry. - - - - - - - - - - - Addressbook - - Here are shortcuts for the most frequent addressbook actions: - - - Edit a Contact: - - - You can edit a contact two ways: - - - - Click once on the person's address card and you can - edit the person's properties all in the same window. - - - - - Double-click on the contact's card and alter their details. - - - - - - - - - - - Deleting a Contact: - - - Right click on a contact and click Delete - or select a contact and press the Delete - on the toolbar. - - - - - - - - - Email a Contact: - - - Right click on a contact and select - Send message to contact. - - - - - - - - Creating a New Contact: - - - Double-click in any blank space in the contact - manager to create a new address card. You can also - use File - New - Contact or - - Ctrl - Shift - C - - - - - - - - \ No newline at end of file diff --git a/help/C/menuref.xml b/help/C/menuref.xml new file mode 100644 index 0000000000..bb1eccf994 --- /dev/null +++ b/help/C/menuref.xml @@ -0,0 +1,421 @@ + + + + Quick Reference + + You might want to copy this section and tape it to the wall + next to your computer: it's a very short summary of most of + the things you'll want to do with + Ximian Evolution. + + + + +Custom Keyboard Shortcuts + + If you have set custom keyboard shortcuts for your desktop, (you can + do this the control center: select + SystemSettings + from your menu panel), they may interfere with Evolution keyboard + shortcuts. + + + For example, if you have chosen Emacs-style key bindings for your + desktop-wide text editor, the shortcut + + Ctrl + W + + will act as "Cut region" rather than as "Close Window" in the + message composer. + + + + + + + + Opening or Creating Anything + + + + + + New Item: + + + Press Ctrl + N to open a new item + for whatever part of Ximian + Evolution you're working on. In mail, + that means you'll create a new message. If you're + looking at your addressbook, Ctrl + N creates a new contact + card, and in the calendar, a new appointment. + + + + + + + Create a new folder: + + + FileNew + Folder or + + Ctrl + Shift + E + + + + + + + Create a new Shortcut in the Evolution Bar: + + + File + New + Evolution Bar Shortcut or + + Ctrl + Shift + S + + + + + + + Create a new email message: + + + Use + FileNewMail + Message or + + Ctrl + Shift + M + + + + + + + Create a new Appointment: + + + File + New + Appointment or + + Ctrl + Shift + A + + + + + + + + Enter a new Contact: + + + Double-click in any blank space in the contact + manager to create a new address card. You can also + use + File + New + Contact or + + Ctrl + Shift + C + + + + + + + Create a new Task: + + + File + New + Task or + + Ctrl + Shift + T + + + + + + + + + Mail Tasks + + Here are the most frequent email tasks, and shortcuts for + navigating your mailbox with the keyboard instead of the + mouse: + + + + + Send and Receive Mail: + + + Press F9, click the + Send/Receive button in the + toolbar, or choose + Actions + Send/Receive. + + + + + Navigating the Message List with the Keyboard: + + + Press ] or . to jump to the next unread + message. [ or , goes to the previous + unread message. Use the arrow keys to move up + and down along the list of all messages. + + + + + + Move the display up and down in the preview pane: + + + Press the space bar to go a page down. Press + Backspace to go a page up. + + + + + + Reply to a Message: + + + To reply to the sender of the message only: + click Reply in the + toolbar, or press + + Ctrl + R + + + + To reply to the sender and all the other visible + recipients of the message, click Reply to + All or select the message and press + + Shift + Ctrl + R + + + + + + + Forward a Message: + + + Select the message or messages you want to forward, + and click Forward in the + toolbar, or press + + Ctrl + F + + + + + + + Open a Message in a New Window: + + + Double-click the message you want to view, or select + it and press Return + + Ctrl + O + + + + + + + Create Filters and Virtual Folders: + + + Right-click on a message and select + Create Rule From + Message. You can also create filters and + virtual folders in the Tools menu. + + + + + + + Add Sender to Address Book: + + + Right-click on a message and select Add + Sender to Address Book. You can also + right-click on any email address to add it to your + address book. + + + + + + + + + + + Calendar + + + + + Create a new Appointment: + + + File + New + Appointment or + + Ctrl + Shift + A + + + + + + + Create a new Task: + + + File + New + Task or + + Ctrl + Shift + T + + + + + + + + + + + New Appointments Fast + + Click on any blank spot in the calendar and start + typing to create a new appointment entry. + + + + + + + + + + + Addressbook + + Here are shortcuts for the most frequent addressbook actions: + + + Edit a Contact: + + + You can edit a contact two ways: + + + + Click once on the person's address card and you can + edit the person's properties all in the same window. + + + + + Double-click on the contact's card and alter their details. + + + + + + + + + + + Deleting a Contact: + + + Right click on a contact and click Delete + or select a contact and press the Delete + on the toolbar. + + + + + + + + + Email a Contact: + + + Right click on a contact and select + Send message to contact. + + + + + + + + Creating a New Contact: + + + Double-click in any blank space in the contact + manager to create a new address card. You can also + use File + New + Contact or + + Ctrl + Shift + C + + + + + + + + \ No newline at end of file diff --git a/help/C/preface.sgml b/help/C/preface.sgml deleted file mode 100644 index c69e058917..0000000000 --- a/help/C/preface.sgml +++ /dev/null @@ -1,362 +0,0 @@ - - Introduction - - Organization - - This book is divided into two parts, with several - appendices. The first part is a guided - tour, which will explain how to use - Evolution. If you are new to - Evolution or to groupware in - general, this section is for you. The second section, covering - configuration, is targeted at - more advanced users, but anyone who wants to change the way - Evolution looks or acts can benefit - from reading it. - - - - - Typographical conventions - - In this book, we'll mark some words with special typography: - - Applications - Commands you type at the command line - Labels for buttons and other portions of the graphical interface - - Menu selections look like this: - - Menu - Submenu - Menu Item - - - Buttons you can - click Anything you type - in Text - output from a computer - Words - that are defined in the . - - - -We'll provide assorted bits of additional information in tips set off from the rest of the book, as well. - - - Tip - - Tips and bits of extra information will look like - this. - - - - - -Examples are also set off from the rest of the text. They look like this: - - - Example Example - - This is what an example looks like. We'll provide - examples for some of the more complicated tasks you - might be performing. - - - - -Lastly, we'll have warnings, in cases where you should be careful: - - - Example Warning - - This is what a warning looks like. If there's a chance - you'll run into trouble, we'll warn you beforehand. - - - - - - - - Additional Help Sources - - You can find additional help in three places. For information - about command-line options, open a terminal window and type - man evolution or evolution - --help. For support, late-breaking news, and errata, - visit the Ximian support center at support.ximian.com. - - - - - What's New in Evolution 1.2 - - If you're already familiar with Ximian Evolution 1.0, our new - version has a lot to add. Here are some of the new and - changed features. Ximian Connector for Microsoft Exchange also - has new features, which are covered in "new-in-connector-one-two">. - - - Evolution Settings Interface - - - The preferences dialogs have been completely - overhauled. There is now a single configuration dialog - window for all components of the program, and you can - access it from anywhere. To change your preferences, - select - - - Tools - - - Preferences - - . Detailed help for the preferences - dialogs has been added to . - - - - - - - Mail Composer Autocomplete - - - Email addresses in the message composer can now work - with LDAP address books. Add your LDAP address book to - the list of folders searched for address completion in - the Folder Settings section of - the Settings dialog. - - - - - - Performance Improvements - - - Startup time has decreased, POP server interactions - are more efficient, and indexing of locally cached - mail is now faster. - - - - - - - Mail Composer HTML Improvements - - - Pasting into the mail composer from another message - or from a web page preserves the HTML formatting of - the source document. Multiple levels of reply - quotation in messages are clearer and use a vertical - blue line on the left side to indicate quotation. Text - "smileys" are now automatically converted to small - images displaying the appropriate emotion. You can - turn this option off in the - Composer section of the Settings - dialog. - - - - - - Signature Editor - - - There is now a signature editor, which can be used to - create plain text or HTML signatures. - click the the Signatures tab in - the Composer Settings section of the Evolution - Settings window. - - - - - - - Keyboard Navigation Overhaul - - - All unmodified letter keys have changed function-- the - N and P keys, for - example, no longer take you to the next you to the - next or previous message. Pressing a letter will now - take you to the nearest message whose data in the sort - column begins with that letter. That is, if you press - N and you are sorting your list by sender, you will - move to a message from Nadine. If you are sorting by - subject, you'll move to the message about - nectarines. This should also work in the folder list - for folder navigation. - - - This means that the old single letter shortcuts have - changed as well. The new shortcuts: - - - , (comma) and . - (period) are now the keyboard shortcuts for Next - and Previous unread messages. You can also use the - square brackets ] and - [. - - - ` (backtick) toggles - the message preview pane. - - - Shortcuts that use the Control key - have not changed. - - - - - - Added Functionality for the "New" Button - - - The New now has a menu next to - it. As in Evolution 1.0, you can click the button once - to get a new item for the Evolution tool you're - using. However, if you click the small arrow menu to - the right of the button, you will find a menu that - allows you to create new items for the rest of - Evolution: All day appointments, regular appointments, - tasks and meetings for the calendar; mail messages for - the mail tool; and contacts and contact lists for the - address book. - - - - - - Import Tool Now Imports Netscape Filters - - - You can now import your filters, as well as your email - messages, from the Netscape mail client. - - - - - - Folder Naming Internationalization - - - You can now use Unicode (UTF-8) characters in the - names for IMAP folders. - - - - - - Executive Summary now Reads IMAP - - - The Executive Summary tool in Evolution now displays - email messages in IMAP as well as local mail folders. - - - - - - Filters and vFolders Notice Moved or Missing Folders - - - vFolders and filters now notice if you move or delete - a folder that they use. - - - - - - vFolder "Original Location" Feature - - - vFolders can now display the actual folder location - for each message they contain. To do so, right click - on the column headers in the message list of any - vFolder, select Add a - Column, and drag the Original - Location item into position. - - - - - - New Criteria and Actions - - - There are many new filter criteria and actions, - including additional message flags such as Flag for - Followup. - - - - - - Folder Selection for Offline Mode - - - You may now select which network folders which will be - cached locally when you go into Offline mode. This - setting may be changed from the Folders section of the - Evolution Settings window. - - - - - - Resend (Bounce) Feature Added - - - This feature is often called "Bounce" or "Redirect." To - resend a message with all its headers instead of merely - forwarding it, select the message and choose - - - Actions - - - Forward - - - Resend - - . - - - - - - Digest-mode Display of Forwarded Messages - - - Messages that contain multiple forwarded messages are - now displayed as a digest rather than inline or as a - series of attachments. - - - - - - New Mail Notification - - - When new mail arrives, you may opt to have Evolution - beep or play a sound file that you specify. - - - - - - - - - diff --git a/help/C/preface.xml b/help/C/preface.xml new file mode 100644 index 0000000000..c7ac8ef870 --- /dev/null +++ b/help/C/preface.xml @@ -0,0 +1,362 @@ + + Introduction + + Organization + + This book is divided into two parts, with several + appendices. The first part is a guided + tour, which will explain how to use + Evolution. If you are new to + Evolution or to groupware in + general, this section is for you. The second section, covering + configuration, is targeted at + more advanced users, but anyone who wants to change the way + Evolution looks or acts can benefit + from reading it. + + + + + Typographical conventions + + In this book, we'll mark some words with special typography: + + Applications + Commands you type at the command line + Labels for buttons and other portions of the graphical interface + + Menu selections look like this: + + Menu + Submenu + Menu Item + + + Buttons you can + click Anything you type + in Text + output from a computer + Words + that are defined in the . + + + +We'll provide assorted bits of additional information in tips set off from the rest of the book, as well. + + + Tip + + Tips and bits of extra information will look like + this. + + + + + +Examples are also set off from the rest of the text. They look like this: + + + Example Example + + This is what an example looks like. We'll provide + examples for some of the more complicated tasks you + might be performing. + + + + +Lastly, we'll have warnings, in cases where you should be careful: + + + Example Warning + + This is what a warning looks like. If there's a chance + you'll run into trouble, we'll warn you beforehand. + + + + + + + + Additional Help Sources + + You can find additional help in three places. For information + about command-line options, open a terminal window and type + man evolution or evolution + --help. For support, late-breaking news, and errata, + visit the Ximian support center at support.ximian.com. + + + + + What's New in Evolution 1.2 + + If you're already familiar with Ximian Evolution 1.0, our new + version has a lot to add. Here are some of the new and + changed features. Ximian Connector for Microsoft Exchange also + has new features, which are covered in "new-in-connector-one-two">. + + + Evolution Settings Interface + + + The preferences dialogs have been completely + overhauled. There is now a single configuration dialog + window for all components of the program, and you can + access it from anywhere. To change your preferences, + select + + + Tools + + + Preferences + + . Detailed help for the preferences + dialogs has been added to . + + + + + + + Mail Composer Autocomplete + + + Email addresses in the message composer can now work + with LDAP address books. Add your LDAP address book to + the list of folders searched for address completion in + the Folder Settings section of + the Settings dialog. + + + + + + Performance Improvements + + + Startup time has decreased, POP server interactions + are more efficient, and indexing of locally cached + mail is now faster. + + + + + + + Mail Composer HTML Improvements + + + Pasting into the mail composer from another message + or from a web page preserves the HTML formatting of + the source document. Multiple levels of reply + quotation in messages are clearer and use a vertical + blue line on the left side to indicate quotation. Text + "smileys" are now automatically converted to small + images displaying the appropriate emotion. You can + turn this option off in the + Composer section of the Settings + dialog. + + + + + + Signature Editor + + + There is now a signature editor, which can be used to + create plain text or HTML signatures. + click the the Signatures tab in + the Composer Settings section of the Evolution + Settings window. + + + + + + + Keyboard Navigation Overhaul + + + All unmodified letter keys have changed function-- the + N and P keys, for + example, no longer take you to the next you to the + next or previous message. Pressing a letter will now + take you to the nearest message whose data in the sort + column begins with that letter. That is, if you press + N and you are sorting your list by sender, you will + move to a message from Nadine. If you are sorting by + subject, you'll move to the message about + nectarines. This should also work in the folder list + for folder navigation. + + + This means that the old single letter shortcuts have + changed as well. The new shortcuts: + + + , (comma) and . + (period) are now the keyboard shortcuts for Next + and Previous unread messages. You can also use the + square brackets ] and + [. + + + ` (backtick) toggles + the message preview pane. + + + Shortcuts that use the Control key + have not changed. + + + + + + Added Functionality for the "New" Button + + + The New now has a menu next to + it. As in Evolution 1.0, you can click the button once + to get a new item for the Evolution tool you're + using. However, if you click the small arrow menu to + the right of the button, you will find a menu that + allows you to create new items for the rest of + Evolution: All day appointments, regular appointments, + tasks and meetings for the calendar; mail messages for + the mail tool; and contacts and contact lists for the + address book. + + + + + + Import Tool Now Imports Netscape Filters + + + You can now import your filters, as well as your email + messages, from the Netscape mail client. + + + + + + Folder Naming Internationalization + + + You can now use Unicode (UTF-8) characters in the + names for IMAP folders. + + + + + + Executive Summary now Reads IMAP + + + The Executive Summary tool in Evolution now displays + email messages in IMAP as well as local mail folders. + + + + + + Filters and vFolders Notice Moved or Missing Folders + + + vFolders and filters now notice if you move or delete + a folder that they use. + + + + + + vFolder "Original Location" Feature + + + vFolders can now display the actual folder location + for each message they contain. To do so, right click + on the column headers in the message list of any + vFolder, select Add a + Column, and drag the Original + Location item into position. + + + + + + New Criteria and Actions + + + There are many new filter criteria and actions, + including additional message flags such as Flag for + Followup. + + + + + + Folder Selection for Offline Mode + + + You may now select which network folders which will be + cached locally when you go into Offline mode. This + setting may be changed from the Folders section of the + Evolution Settings window. + + + + + + Resend (Bounce) Feature Added + + + This feature is often called "Bounce" or "Redirect." To + resend a message with all its headers instead of merely + forwarding it, select the message and choose + + + Actions + + + Forward + + + Resend + + . + + + + + + Digest-mode Display of Forwarded Messages + + + Messages that contain multiple forwarded messages are + now displayed as a digest rather than inline or as a + series of attachments. + + + + + + New Mail Notification + + + When new mail arrives, you may opt to have Evolution + beep or play a sound file that you specify. + + + + + + + + + diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.sgml deleted file mode 100644 index 93e4aa4d3b..0000000000 --- a/help/C/usage-calendar.sgml +++ /dev/null @@ -1,757 +0,0 @@ - - - - Managing your Schedule - - - This chapter will show you how to use the Ximian Evolution - Calendar to manage your schedule alone or in conjunction with - peers. - - - - Ways of Looking at your Calendar - - The toolbar offers you four different views of your calendar: - - - - Day - - - - - Work Week - - - - - Week - - - - - Month - - - - - - Press the calendar-shaped buttons on the right side of the toolbar to - switch between views. - - - You can also select an arbitrary range of days in the small - calendar at the upper right. To do this, click and drag on the - days that you wish to view in your calendar. - - - The Prev and Next - buttons will move you forward and back in your calendar pages. - If you're looking at only one day, you'll see tomorrow's page, - or yesterday's. If you're looking at your calendar by week or - month, you'll move around by just that much. - To come back to today's listing, click the - Today button in the toolbar. - - - To visit a specific date's calendar entries, click - Go To and select the date in the dialog - box that appears. - - - - - Scheduling With the Evolution Calendar - - Of course, you'll want to use the calendar to do more than find - out what day it is. This section will tell you how to schedule - appointments, set alarms, and determine appointment - recurrence. If you have installed the Ximian Connector for - Microsoft Exchange, you can also read to learn about how to take full - advantage of the collaborative group scheduling functions - available on the Microsoft Exchange Server. - - - - Creating appointments - - To create a new appointment, select - - File - New - Appointment - - or click the New Appointment button on the left end - of the toolbar. The New Appointment - dialog will pop up with the menu bar, tool bar, and - window full of choices for you. - - - Shortcut - - If you don't need to enter more information than the date - and time of the appointment, you just click in any blank - space in the calendar and start typing. You can enter other - information later with the appointment editor. - - - - - 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 All - day event. An All day event - appears at the top of a day's appointment list, in the grey header under the date, rather than inside - it. That makes it easy to have appointments that overlap and fit - inside each other. For example, a conference might be an all - day appointment, and the meetings at the conference would be timed - appointments. Of course, appointments with specific starting and ending - times can also overlap. When they do they're displayed as - multiple columns in the day view of the calendar. - - - Evolution supports the use of - timezones. If you share calendar files with friends or - co-workers, it is quite possible you will need to configure - your timezone. To configure your timezone: - - - - Click - - Tools - Calendar Settings - - - - - - Click the Globe button in the - Time section, located in the - General tab. - - - - - Each red dot represents a major city. Click a dot and click OK to select your time zone. - - - - - - You can also configure timezone information specific to the - Start and End time in each appointment. To do that, simply - create a new appointment and click on a globe to customize the - timezone that the time exists in. For example, if you live in - New York but have a telephone meeting set for noon with - someone in California, you need to make sure that you're not - calling each other a few hours off. Setting time-zones on a - per-appointment basis helps avoid that potential confusion. - - - Multiple Simultaneous Appointments - - If you create calendar appointments that overlap, - Evolution will display them side - by side in your calendar. However, - Evolution cannot help you do - multiple things at once. - - - - You can have as many - Alarms, any time prior to the appointment - you've scheduled. You can have one alarm of each of the following types: - - - Display: - - - A window will pop up on your screen to remind you of - your appointment. - - - - - Audio: - - - Choose this to have your computer deliver a sound - alarm. - - - - - Program: - - - Select this if you would like to run a program as a - reminder. You can enter its name in the text field, - or find it with the Browse - button. - - - - - - - - - Reminders Without Evolution - - If you have stored reminders in a local calendar, they - will work from the moment you log in. However, for reminders - stored on an Exchange server, you must run Evolution at - least once after logging in. No matter where the reminders - are stored, you can quit Evolution and still be reminded of - an upcoming appointment. - - - - - Classification - only applies to calendars on a - network. Public is the default category, - and a public appointment can be viewed by anyone on the calendar - sharing network. Private denotes one - level of security, and Confidential an even - higher level. - - - Evolution can handle free/busy - scheduling Using the Ximian Connector on a Microsoft Exchange - 2000 server. For more information about Ximian Connector, see - . - - - To set your appointment to be free or busy, simply click the - box in the Show Time As section in the - Appointment Editor. - - - Evolution lets you categorize your - appointments, which can help if you lead a busy life. The bottom - section of the Appointment tab is where your - categorization is done. - - - - Adding a New Appointment Category - - You can add a new category to your category list by clicking on - Edit Master Category List and single-clicking - on Click here to add a category. - - - - - The purpose of categories is to let you view all appointments which have - similar activities. To do this, change Any field contains - to Has category and enter your category at right. - - - - Clicking on the Categories button opens up the category - list. To associate a category to an appointment, simply click the check box. - - - Once you've selected your categories, click OK to - assign these categories to the appointment. The categories you selected are now - listed in the text box to the right of the Categories... - button. - - - - The Recurrence tab lets you describe - repetition in appointments ranging from once every day up to once - every 100 years. You can then choose a time and date when the - appointment will stop recurring, and, under - Exceptions, pick individual days when the - appointment will not recur. Make your - selections from left to right, and you'll form a sentence: - "Every two weeks on Monday and Friday until January 3, 2003" - or "Every month on the first Friday for 12 occurrences." - - - - Once you're done with all those settings, click on the disk - icon in the toolbar to save and close the appointment editor window. - If you want, you can alter an appointment - summary in the calendar view by clicking on it and typing. You - can change other settings by right-clicking on the appointment then - choosing Edit this Appointment. - - - - Sending an RSVP with the Calendar - - Evolution can be used to schedule - group meetings and help you manage responses to meeting - requests. - - - When you create a meeting or group appointment, you can - specify the attendees in several categories, such as "chair" - or "required." When you save the appointment listing, each - attendee will be sent an email with the appointment - information and gives them the option to respond. - - - - Simple Announcements - - If you don't need to collect attendance information when - you're scheduling an event, and would rather just announce - it, select - ActionsForward - as iCalendar. That will open a - new email message with the event notification attached as - an announcement. Recipients will be able to add the event - to their calendars with one click, but won't automatically - send you email about whether they'll attend. - - - - - To schedule a meeting: - - - - Select - - Actions Schedule - Meeting . The - Scheduling and - Meeting tabs open. - - - - - If you have multiple Evolution identities, choose the - one you'll use by selecting an item in the - Sent By field. - - - - - Click the space labeled Click here to add an - attendee to enter the names and email - addresses of people you will invite, or click the - Invite Others to select them from - your addressbook. - - - - - Save the Appointment. - - - - An email is now sent out to all the recipients, inviting them to your event. - - - - Replying to a Meeting Request - - Meeting requests are sent as iCal attachments. To view or - respond to one, click on the attachment icon and view it - inline in the mail window. All the details are shown about - the event including time and dates. Then you can choose how - to reply to the invitation. Your choices are: - - - - Accept - - - - - Tentatively Accept - - - - - Decline - - - - Click OK and an email will be sent to - the organizer with your answer. The event will also be added - to your calendar if you accept. - - - - Note, however, that if you add a meeting to your calendar, - there are some limitations: only the organizer of a meeting - can add participants in a meeting. Your only options, as a - participant, are to accept the meeting, or decline it. - - - Once you have added the meeting to your calendar, you can make - changes to your copy-- change the description, mark yourself - the organizer, invite more people, and so forth-- but be aware - that if the original organizer sends out another update, your - changes may be overwritten. - - - There Can Be Only One - - A meeting can have only one organizer. You can designate - yourself the organizer of the meeting, but unless you - coordinate that action with the organizer you are replacing, - you could create confusion in the scheduling process. If you - want to invite additional people to a meeting without - changing the organizer, it's best to forward the first - organizer's message to the additional participants. - - - - - - Getting Responses to Meeting Requests - - Once you get a reply to your meeting invitation, you'll need - to view it inline in the email. Click the attachment and - select View Inline. At the bottom, you - can click OK to update your attendee - list. - - - - - - Scheduling Meetings and The Free/Busy View - - In addition to the standard meeting scheduling tools, you can - use the Free/Busy view to check whether people are available - in advance. At this time, the Free/Busy feature only works - with Microsoft Exchange servers. However, you can still use - iCal event invitations to coordinate schedules with other - people no matter what server you're using. - - - To access the free/busy view: - - - - Open or create an appointment in the - Calendar window. - - - - - Click - - Actions - Schedule Meeting - - - - - - Open the Scheduling tab. - - - - -
- Appointment Scheduling Window - - Appointment Scheduling Window - - - - -
- - - - - - - Invitee List - - - The Invitee List lists off the people who - have been invited to the respective appointment. It also - shows their RSVP status. - - - - - - - - Schedule Grid - - - The Schedule Grid shows the invitee's - published Free/Busy information. This is where you compare - people's schedules to find free time to schedule the - appointment. - - - - - - - - Meeting Scheduler - - - The Meeting Scheduler allows you to - schedule the meeting in the Free/Busy window. - - - Scheduling an Appointment - - To schedule an appointment, you'll first need people's - free/busy information. If you're using the Ximian Connector - for Microsoft Exchange, all of the information is already - available to you in the Global Address List. Otherwise, each - person will have to email you their schedule files and you - will have to incorporate them into your calendar. - - - Regardless of how you get the information, Ximian Evolution - will display it in the Scheduling tab. - The pending appointment time will appear in white with bold - black borders. Each attendee's free and busy times appear - color-coded next to their names in the attendee list. - - - Adjust the meeting time, either by dragging the meeting - borders or by using the Autopick - buttons to choose a time automatically, then click - Save and Close. Attendees on an - Exchange server will have the appointment updated - automatically; others will receive email notification of any - change in plans. - - - - Read to learn about how to - use this feature with the Ximian Connector for Microsoft - Exchange. - - - - - - - - The Task Pad - - The Task Pad, located in the lower right corner of the - calendar, lets you keep a list of tasks separate from your - calendar appointments. You can use the list - in a larger window by choosing the Tasks - button in the shortcut bar or in the folder tree. - - - To record a new task, click the Add - button in the toolbar. Evolution - will pop up a small window with five items in it: - - - - Summary: - - - The description you enter here will appear in the To Do - list itself. - - - - - - Due Date: - - - Decide when this item is - due. You can either type in a date and time, or select one from - the Calendar and time drop-down menus. - - - - - Start Date: - - - The date you intend to start working. - - - - - Description: - - - If you wish, you can keep a more detailed description of - the item here. For example, you can note that a task is - in progress, and display how close it is to completion. - - - - - Classification: - - - Sets who will see it if your calendar is shared. - - - - - - - There are more options in the Details tab such as priority and progress settings. - - - Once you've added a task to your to-do list, its summary - appears in the Summary section of task - list. To view or edit a detailed description of an item, - double-click on it, or right click on it and select Open. You can delete items by selecting - them and clicking on the Delete button. - - - The list of tasks is sorted in a similar way to the list of - email messages in Ximian Evolution - Mail. Click once on the message headers to change - the direction and type of sorting, or right-click to add or - remove columns from the display. - - - Folders for Your Tasks - - Like any other component in - Evolution, you can create a folder - to help organize your tasks. To do this: - - - - Open the Folders Bar. - - - - - Click Tasks. - - - - - Right click on Tasks. - - - - - Click Create New Folder. - - - - - Enter the folder name. - - - - - Click OK - - - - - - - - - Multiple Calendars - - Evolution permits you to have and - maintain multiple calendars. This is useful if you maintain - schedules for other people, if you are responsible for resource - or room allocation, or if you have multiple personalities. - - - - Keeping Multiple Calendars - - Lucy, the office manager for a small company, has one calendar - for her own schedule. She maintains one for the conference - room, to schedule meetings. Next to that, she maintains a - calendar that reflects when consultants are going to be on - site, and another that keeps track of when the Cubs are - playing. - - - - To create a new calendar, select - - File New - Folder - . - You'll need to tell the New Folder dialog that the new folder should be of the calendar type. You can place the calendar in any calendar folder and access it - from the folder view. - - - Each calendar folder can hold only one calendar. - - - diff --git a/help/C/usage-calendar.xml b/help/C/usage-calendar.xml new file mode 100644 index 0000000000..dd60c54b20 --- /dev/null +++ b/help/C/usage-calendar.xml @@ -0,0 +1,757 @@ + + + + Managing your Schedule + + + This chapter will show you how to use the Ximian Evolution + Calendar to manage your schedule alone or in conjunction with + peers. + + + + Ways of Looking at your Calendar + + The toolbar offers you four different views of your calendar: + + + + Day + + + + + Work Week + + + + + Week + + + + + Month + + + + + + Press the calendar-shaped buttons on the right side of the toolbar to + switch between views. + + + You can also select an arbitrary range of days in the small + calendar at the upper right. To do this, click and drag on the + days that you wish to view in your calendar. + + + The Prev and Next + buttons will move you forward and back in your calendar pages. + If you're looking at only one day, you'll see tomorrow's page, + or yesterday's. If you're looking at your calendar by week or + month, you'll move around by just that much. + To come back to today's listing, click the + Today button in the toolbar. + + + To visit a specific date's calendar entries, click + Go To and select the date in the dialog + box that appears. + + + + + Scheduling With the Evolution Calendar + + Of course, you'll want to use the calendar to do more than find + out what day it is. This section will tell you how to schedule + appointments, set alarms, and determine appointment + recurrence. If you have installed the Ximian Connector for + Microsoft Exchange, you can also read to learn about how to take full + advantage of the collaborative group scheduling functions + available on the Microsoft Exchange Server. + + + + Creating appointments + + To create a new appointment, select + + File + New + Appointment + + or click the New Appointment button on the left end + of the toolbar. The New Appointment + dialog will pop up with the menu bar, tool bar, and + window full of choices for you. + + + Shortcut + + If you don't need to enter more information than the date + and time of the appointment, you just click in any blank + space in the calendar and start typing. You can enter other + information later with the appointment editor. + + + + + 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 All + day event. An All day event + appears at the top of a day's appointment list, in the grey header under the date, rather than inside + it. That makes it easy to have appointments that overlap and fit + inside each other. For example, a conference might be an all + day appointment, and the meetings at the conference would be timed + appointments. Of course, appointments with specific starting and ending + times can also overlap. When they do they're displayed as + multiple columns in the day view of the calendar. + + + Evolution supports the use of + timezones. If you share calendar files with friends or + co-workers, it is quite possible you will need to configure + your timezone. To configure your timezone: + + + + Click + + Tools + Calendar Settings + + + + + + Click the Globe button in the + Time section, located in the + General tab. + + + + + Each red dot represents a major city. Click a dot and click OK to select your time zone. + + + + + + You can also configure timezone information specific to the + Start and End time in each appointment. To do that, simply + create a new appointment and click on a globe to customize the + timezone that the time exists in. For example, if you live in + New York but have a telephone meeting set for noon with + someone in California, you need to make sure that you're not + calling each other a few hours off. Setting time-zones on a + per-appointment basis helps avoid that potential confusion. + + + Multiple Simultaneous Appointments + + If you create calendar appointments that overlap, + Evolution will display them side + by side in your calendar. However, + Evolution cannot help you do + multiple things at once. + + + + You can have as many + Alarms, any time prior to the appointment + you've scheduled. You can have one alarm of each of the following types: + + + Display: + + + A window will pop up on your screen to remind you of + your appointment. + + + + + Audio: + + + Choose this to have your computer deliver a sound + alarm. + + + + + Program: + + + Select this if you would like to run a program as a + reminder. You can enter its name in the text field, + or find it with the Browse + button. + + + + + + + + + Reminders Without Evolution + + If you have stored reminders in a local calendar, they + will work from the moment you log in. However, for reminders + stored on an Exchange server, you must run Evolution at + least once after logging in. No matter where the reminders + are stored, you can quit Evolution and still be reminded of + an upcoming appointment. + + + + + Classification + only applies to calendars on a + network. Public is the default category, + and a public appointment can be viewed by anyone on the calendar + sharing network. Private denotes one + level of security, and Confidential an even + higher level. + + + Evolution can handle free/busy + scheduling Using the Ximian Connector on a Microsoft Exchange + 2000 server. For more information about Ximian Connector, see + . + + + To set your appointment to be free or busy, simply click the + box in the Show Time As section in the + Appointment Editor. + + + Evolution lets you categorize your + appointments, which can help if you lead a busy life. The bottom + section of the Appointment tab is where your + categorization is done. + + + + Adding a New Appointment Category + + You can add a new category to your category list by clicking on + Edit Master Category List and single-clicking + on Click here to add a category. + + + + + The purpose of categories is to let you view all appointments which have + similar activities. To do this, change Any field contains + to Has category and enter your category at right. + + + + Clicking on the Categories button opens up the category + list. To associate a category to an appointment, simply click the check box. + + + Once you've selected your categories, click OK to + assign these categories to the appointment. The categories you selected are now + listed in the text box to the right of the Categories... + button. + + + + The Recurrence tab lets you describe + repetition in appointments ranging from once every day up to once + every 100 years. You can then choose a time and date when the + appointment will stop recurring, and, under + Exceptions, pick individual days when the + appointment will not recur. Make your + selections from left to right, and you'll form a sentence: + "Every two weeks on Monday and Friday until January 3, 2003" + or "Every month on the first Friday for 12 occurrences." + + + + Once you're done with all those settings, click on the disk + icon in the toolbar to save and close the appointment editor window. + If you want, you can alter an appointment + summary in the calendar view by clicking on it and typing. You + can change other settings by right-clicking on the appointment then + choosing Edit this Appointment. + + + + Sending an RSVP with the Calendar + + Evolution can be used to schedule + group meetings and help you manage responses to meeting + requests. + + + When you create a meeting or group appointment, you can + specify the attendees in several categories, such as "chair" + or "required." When you save the appointment listing, each + attendee will be sent an email with the appointment + information and gives them the option to respond. + + + + Simple Announcements + + If you don't need to collect attendance information when + you're scheduling an event, and would rather just announce + it, select + ActionsForward + as iCalendar. That will open a + new email message with the event notification attached as + an announcement. Recipients will be able to add the event + to their calendars with one click, but won't automatically + send you email about whether they'll attend. + + + + + To schedule a meeting: + + + + Select + + Actions Schedule + Meeting . The + Scheduling and + Meeting tabs open. + + + + + If you have multiple Evolution identities, choose the + one you'll use by selecting an item in the + Sent By field. + + + + + Click the space labeled Click here to add an + attendee to enter the names and email + addresses of people you will invite, or click the + Invite Others to select them from + your addressbook. + + + + + Save the Appointment. + + + + An email is now sent out to all the recipients, inviting them to your event. + + + + Replying to a Meeting Request + + Meeting requests are sent as iCal attachments. To view or + respond to one, click on the attachment icon and view it + inline in the mail window. All the details are shown about + the event including time and dates. Then you can choose how + to reply to the invitation. Your choices are: + + + + Accept + + + + + Tentatively Accept + + + + + Decline + + + + Click OK and an email will be sent to + the organizer with your answer. The event will also be added + to your calendar if you accept. + + + + Note, however, that if you add a meeting to your calendar, + there are some limitations: only the organizer of a meeting + can add participants in a meeting. Your only options, as a + participant, are to accept the meeting, or decline it. + + + Once you have added the meeting to your calendar, you can make + changes to your copy-- change the description, mark yourself + the organizer, invite more people, and so forth-- but be aware + that if the original organizer sends out another update, your + changes may be overwritten. + + + There Can Be Only One + + A meeting can have only one organizer. You can designate + yourself the organizer of the meeting, but unless you + coordinate that action with the organizer you are replacing, + you could create confusion in the scheduling process. If you + want to invite additional people to a meeting without + changing the organizer, it's best to forward the first + organizer's message to the additional participants. + + + + + + Getting Responses to Meeting Requests + + Once you get a reply to your meeting invitation, you'll need + to view it inline in the email. Click the attachment and + select View Inline. At the bottom, you + can click OK to update your attendee + list. + + + + + + Scheduling Meetings and The Free/Busy View + + In addition to the standard meeting scheduling tools, you can + use the Free/Busy view to check whether people are available + in advance. At this time, the Free/Busy feature only works + with Microsoft Exchange servers. However, you can still use + iCal event invitations to coordinate schedules with other + people no matter what server you're using. + + + To access the free/busy view: + + + + Open or create an appointment in the + Calendar window. + + + + + Click + + Actions + Schedule Meeting + + + + + + Open the Scheduling tab. + + + + +
+ Appointment Scheduling Window + + Appointment Scheduling Window + + + + +
+ + + + + + + Invitee List + + + The Invitee List lists off the people who + have been invited to the respective appointment. It also + shows their RSVP status. + + + + + + + + Schedule Grid + + + The Schedule Grid shows the invitee's + published Free/Busy information. This is where you compare + people's schedules to find free time to schedule the + appointment. + + + + + + + + Meeting Scheduler + + + The Meeting Scheduler allows you to + schedule the meeting in the Free/Busy window. + + + Scheduling an Appointment + + To schedule an appointment, you'll first need people's + free/busy information. If you're using the Ximian Connector + for Microsoft Exchange, all of the information is already + available to you in the Global Address List. Otherwise, each + person will have to email you their schedule files and you + will have to incorporate them into your calendar. + + + Regardless of how you get the information, Ximian Evolution + will display it in the Scheduling tab. + The pending appointment time will appear in white with bold + black borders. Each attendee's free and busy times appear + color-coded next to their names in the attendee list. + + + Adjust the meeting time, either by dragging the meeting + borders or by using the Autopick + buttons to choose a time automatically, then click + Save and Close. Attendees on an + Exchange server will have the appointment updated + automatically; others will receive email notification of any + change in plans. + + + + Read to learn about how to + use this feature with the Ximian Connector for Microsoft + Exchange. + + + + + + + + The Task Pad + + The Task Pad, located in the lower right corner of the + calendar, lets you keep a list of tasks separate from your + calendar appointments. You can use the list + in a larger window by choosing the Tasks + button in the shortcut bar or in the folder tree. + + + To record a new task, click the Add + button in the toolbar. Evolution + will pop up a small window with five items in it: + + + + Summary: + + + The description you enter here will appear in the To Do + list itself. + + + + + + Due Date: + + + Decide when this item is + due. You can either type in a date and time, or select one from + the Calendar and time drop-down menus. + + + + + Start Date: + + + The date you intend to start working. + + + + + Description: + + + If you wish, you can keep a more detailed description of + the item here. For example, you can note that a task is + in progress, and display how close it is to completion. + + + + + Classification: + + + Sets who will see it if your calendar is shared. + + + + + + + There are more options in the Details tab such as priority and progress settings. + + + Once you've added a task to your to-do list, its summary + appears in the Summary section of task + list. To view or edit a detailed description of an item, + double-click on it, or right click on it and select Open. You can delete items by selecting + them and clicking on the Delete button. + + + The list of tasks is sorted in a similar way to the list of + email messages in Ximian Evolution + Mail. Click once on the message headers to change + the direction and type of sorting, or right-click to add or + remove columns from the display. + + + Folders for Your Tasks + + Like any other component in + Evolution, you can create a folder + to help organize your tasks. To do this: + + + + Open the Folders Bar. + + + + + Click Tasks. + + + + + Right click on Tasks. + + + + + Click Create New Folder. + + + + + Enter the folder name. + + + + + Click OK + + + + + + + + + Multiple Calendars + + Evolution permits you to have and + maintain multiple calendars. This is useful if you maintain + schedules for other people, if you are responsible for resource + or room allocation, or if you have multiple personalities. + + + + Keeping Multiple Calendars + + Lucy, the office manager for a small company, has one calendar + for her own schedule. She maintains one for the conference + room, to schedule meetings. Next to that, she maintains a + calendar that reflects when consultants are going to be on + site, and another that keeps track of when the Cubs are + playing. + + + + To create a new calendar, select + + File New + Folder + . + You'll need to tell the New Folder dialog that the new folder should be of the calendar type. You can place the calendar in any calendar folder and access it + from the folder view. + + + Each calendar folder can hold only one calendar. + + + diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.sgml deleted file mode 100644 index ff94b3393e..0000000000 --- a/help/C/usage-contact.sgml +++ /dev/null @@ -1,571 +0,0 @@ - - - - Working with Your Contacts - - This chapter will show you how to use the - Evolution addressbook to organize - 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 . You can import contacts from - other contact management tools with the Import tool by - selecting - FileImport, - or by mailing them to yourself as vCard attachments. - - - - The toolbar for the addressbook is quite simple. - - - Click New Contact to create a new card, or double-click - in a blank space in the contact list. - - - - Click New List to create a new card, or double-click - in a blank space in the contact list. - - - The printer icon sends one - or more of your cards to the printer. - - The stop sign icon stops loading - contact data from the network. This button is only - relevant if you are looking at contact information on a - network. - - - - - Your contact information fills the rest of the display. Move - through the cards alphabetically with the buttons and the - scrollbar to the right of the window. Of course, if you have - more than a few people listed, you'll want some way of finding - them more quickly, which is why there's a search feature. - - - - The Contact Editor - - To delete a contact: - - - - Click once on the contact. - - - - - Press the Delete button. - - - - - - If you want to add or change cards, you'll use the contact - editor. To change a card that already exists, double click on - it to open the contact editor window. If you want to create a new - card, clicking the New button in the - toolbar will open the same window, with blank entry boxes for - you to fill in. - - - - The contact editor window has two tabs, - General, for basic contact information, and - Details, for a more specific description of - the person. In addition, it contains a File - menu and a toolbar with three items: Save and - Close, Print, and - Delete. - - -
- Evolution Contact Editor - - Evolution Contact Editor - - - -
- - The General tab has seven sections, - each with an icon: a face, for name and company; a telephone - for phone numbers; an envelope for email address; a globe for - web page address; a house for postal address; a file folder - for contacts, and a briefcase for categories. - - - - - - Full Name - - - The Full Name field has two - major features: - - - - You can enter a name into the Full - Name field, but you can also click the - Full Name button to bring - up a small dialog box with a few text boxes - - - Title: - - Enter an honorific or select one from the menu. - - - - First: - - Enter the first, or given, name. - - - - Middle: - - Enter the middle name or initial, if any. - - - - Last: - - Enter the last name (surname). - - - - Suffix: - - Enter suffixes such as "Jr." or "III." - - - - - - - - - The Full Name field also - interacts with the File As - box to help you organize your contacts. - - - To see how it works, type a name in the - Full Name field. As an example, - we'll use the Ximian mascot, Rupert - T. Monkey. You'll notice that the - File As field also fills in, - but in reverse: Monkey, - Rupert. You can pick - Rupert Monkey from - the drop-down, or type in your own, such as - T. Rupert Monkey . - - - Filing Suggestion - - Don't enter something entirely different from the - actual name, since you might forget that you've filed - Rupert's information under "F" for "Fictitious Ximian - Employee." - - - - - - Multiple Values for Fields: - - - If you click on the downward pointing triangle buttons - next to the Primary Email field, - you can also choose Email 2 and - Email 3. Although the contact - editor will only display one of those at any given - time, Evolution will store - them all. Entries that have information in them have - a check mark next to them. The buttons next to the - telephone and postal address fields work in the same - way. - - - - - - - The last item in the General tab is the - Categories organization tool; for - information on that, read . - - - The Details tab is much simpler: - - - - The briefcase - Describes the person's professional life - - - - - The face - Describes the person's personal life - - - - - The globe - Miscellanious notes - - - - - - Contact Shortcuts - - You can add cards from within an email message or calendar - appointment. While looking at an email, right-click on - any email address or message, and choose - Create Card for this Address or - Create Card for this Sender - from the menu. - - - - - - - Searching for Contacts - - Evolution allows searching through contacts - quickly and easily. - - - To search through contacts: - - - - Select your search focus in the search bar. - - - - - Enter your query. - - - - - Press return to search. - - - - - - To perform a complex search through your contacts: - - - - Open - - Tools - Search for contacts - - - - - - Name the rule in the Rule Name field. - - - - - Setup your criteria information in the If section. - - - - - If you want to add more critera, click the Add - Criterion button. - - - - - Click Search. - - - - - - To show all your contacts, select Show All in the - Search Bar or search with an empty query. - - - - - - Organizing your Addressbook - - Organizing your addressbook is a lot like organizing your - mail. You can have folders and searches the same way you can - with mail, but the addressbook does not allow Virtual Folders. It - does, however, allow each card to fall under several - categories, and allow you to create your own categories. To - learn about categories, read . - - - - - - Groups of contacts - - Evolution offers two ways for you - to organize your cards. The first way is to use folders; - this works the same way mail folders do. For more - flexibility, you can also mark contacts as elements of - different categories. To better integrate with email tools, - you can also create lists of contacts that you can send mail - to as a single person. - - - - Grouping with Folders - - The simplest way to group address cards is to use folders. - By default, cards start in the - Contacts folder. If you've read then you already know that you - can create a new folder by selecting - - File - New - Folder - - and that you can put new folders anywhere you like. Just - 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 . - - - To put a card into a folder, just drag it there from the - folder view. Remember that contact cards can only go in - contact folders, just like mail can only go in mail folders, - and calendars in calendar folders. - - - - - Grouping with Categories - - The other way to group cards is to mark them as belonging - to different categories. - That means that you - can mark a card as being in several categories or no - category at all. For example, I put my friend Matthew's - card in the "Business" category, because he works with me, - the "Friends" category, because he's also my friend, and - the "Frequent" category, because I call him all the time - and can never remember his phone number. - - - To mark a card as belonging to a category, click the - Categories button at the lower - right. From the dialog box that appears, you can check as - many or as few categories as you like. - - - - - - - - Creating a List of Contacts - - To create a list of contacts: - - - - - Open the list creation dialog box by clicking the - New List button or selecting - - - File - - - New - - - Contact List - - . - - - - - - Enter a name for the list. - - - - - Enter names or email addresses of contacts, or just - drag contacts from the main window into the list. - - - - - - Choose whether you would like to hide the email - addresses when you send a message to the list. - 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 - . - - - - - - - When you are done, click OK. The - list will appear as a contact card, which you can use as - you would any other. That includes emailing the list to - another person, and, of course, sending email to the list. - - - To mail the list, open a new email and type the name you - chose for the list. Ximian Evolution will address the - message to the entire list when you send it. You can also - right-click on the list's address card in the Addressbook - and select Send Message to List. - - - Ximian Evolution cannot store contact lists on Exchange - servers. - - - - - - - - LDAP: Shared Addressbooks on a Network - - - The LDAP protocol was - created to let users share contact information over a network by - sharing access to a central address book. LDAP allows a company - to maintain a shared set of contact information for a company or - department. Many companies keep a common LDAP address book for - all their employees or for client contacts. - - - - To learn how to add a remote directory to your available - contact folders, see . - Once you have a LDAP connection, the network contacts folder or - folders will appear inside the External - Directories folder in the folder bar. It will work - exactly like a local folder of cards, with the following - exceptions: - - - - - Network folders are only available when you are - connected to the network. If you use a laptop or have a - modem connection, you may wish to copy or cache the - network directory. You do this by dragging and dropping - your desired contacts into the local contacts list. - - - - - - To prevent excess network traffic, - Evolution will not normally - load the contents of LDAP folders immediately upon - opening. You must click Display - All before LDAP folder cards will be loaded - from the network. You can change this behavior in the - Contact Preferences window. - - - - - You cannot add, delete, or alter cards on the LDAP - server. If you need to change information there, you - will need to speak to your system administrator - - - - - - Configuring Evolution to use LDAP - - For information about setting up - Evolution to use LDAP, please refer - to - - - - - - Send me a Card: Adding New Cards Quickly - - As noted before, when you get information about a person in - the mail or in a calendar entry, you can add it to an address - card. To do so, right click on any email address or email - message, and select Add Address - Card from the menu that appears. - Evolution can also add cards from a - hand-held device during HotSync operation. For more - information about that, see . - - - - - - - - diff --git a/help/C/usage-contact.xml b/help/C/usage-contact.xml new file mode 100644 index 0000000000..3131118803 --- /dev/null +++ b/help/C/usage-contact.xml @@ -0,0 +1,571 @@ + + + + Working with Your Contacts + + This chapter will show you how to use the + Evolution addressbook to organize + 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 . You can import contacts from + other contact management tools with the Import tool by + selecting + FileImport, + or by mailing them to yourself as vCard attachments. + + + + The toolbar for the addressbook is quite simple. + + + Click New Contact to create a new card, or double-click + in a blank space in the contact list. + + + + Click New List to create a new card, or double-click + in a blank space in the contact list. + + + The printer icon sends one + or more of your cards to the printer. + + The stop sign icon stops loading + contact data from the network. This button is only + relevant if you are looking at contact information on a + network. + + + + + Your contact information fills the rest of the display. Move + through the cards alphabetically with the buttons and the + scrollbar to the right of the window. Of course, if you have + more than a few people listed, you'll want some way of finding + them more quickly, which is why there's a search feature. + + + + The Contact Editor + + To delete a contact: + + + + Click once on the contact. + + + + + Press the Delete button. + + + + + + If you want to add or change cards, you'll use the contact + editor. To change a card that already exists, double click on + it to open the contact editor window. If you want to create a new + card, clicking the New button in the + toolbar will open the same window, with blank entry boxes for + you to fill in. + + + + The contact editor window has two tabs, + General, for basic contact information, and + Details, for a more specific description of + the person. In addition, it contains a File + menu and a toolbar with three items: Save and + Close, Print, and + Delete. + + +
+ Evolution Contact Editor + + Evolution Contact Editor + + + +
+ + The General tab has seven sections, + each with an icon: a face, for name and company; a telephone + for phone numbers; an envelope for email address; a globe for + web page address; a house for postal address; a file folder + for contacts, and a briefcase for categories. + + + + + + Full Name + + + The Full Name field has two + major features: + + + + You can enter a name into the Full + Name field, but you can also click the + Full Name button to bring + up a small dialog box with a few text boxes + + + Title: + + Enter an honorific or select one from the menu. + + + + First: + + Enter the first, or given, name. + + + + Middle: + + Enter the middle name or initial, if any. + + + + Last: + + Enter the last name (surname). + + + + Suffix: + + Enter suffixes such as "Jr." or "III." + + + + + + + + + The Full Name field also + interacts with the File As + box to help you organize your contacts. + + + To see how it works, type a name in the + Full Name field. As an example, + we'll use the Ximian mascot, Rupert + T. Monkey. You'll notice that the + File As field also fills in, + but in reverse: Monkey, + Rupert. You can pick + Rupert Monkey from + the drop-down, or type in your own, such as + T. Rupert Monkey . + + + Filing Suggestion + + Don't enter something entirely different from the + actual name, since you might forget that you've filed + Rupert's information under "F" for "Fictitious Ximian + Employee." + + + + + + Multiple Values for Fields: + + + If you click on the downward pointing triangle buttons + next to the Primary Email field, + you can also choose Email 2 and + Email 3. Although the contact + editor will only display one of those at any given + time, Evolution will store + them all. Entries that have information in them have + a check mark next to them. The buttons next to the + telephone and postal address fields work in the same + way. + + + + + + + The last item in the General tab is the + Categories organization tool; for + information on that, read . + + + The Details tab is much simpler: + + + + The briefcase - Describes the person's professional life + + + + + The face - Describes the person's personal life + + + + + The globe - Miscellanious notes + + + + + + Contact Shortcuts + + You can add cards from within an email message or calendar + appointment. While looking at an email, right-click on + any email address or message, and choose + Create Card for this Address or + Create Card for this Sender + from the menu. + + + + + + + Searching for Contacts + + Evolution allows searching through contacts + quickly and easily. + + + To search through contacts: + + + + Select your search focus in the search bar. + + + + + Enter your query. + + + + + Press return to search. + + + + + + To perform a complex search through your contacts: + + + + Open + + Tools + Search for contacts + + + + + + Name the rule in the Rule Name field. + + + + + Setup your criteria information in the If section. + + + + + If you want to add more critera, click the Add + Criterion button. + + + + + Click Search. + + + + + + To show all your contacts, select Show All in the + Search Bar or search with an empty query. + + + + + + Organizing your Addressbook + + Organizing your addressbook is a lot like organizing your + mail. You can have folders and searches the same way you can + with mail, but the addressbook does not allow Virtual Folders. It + does, however, allow each card to fall under several + categories, and allow you to create your own categories. To + learn about categories, read . + + + + + + Groups of contacts + + Evolution offers two ways for you + to organize your cards. The first way is to use folders; + this works the same way mail folders do. For more + flexibility, you can also mark contacts as elements of + different categories. To better integrate with email tools, + you can also create lists of contacts that you can send mail + to as a single person. + + + + Grouping with Folders + + The simplest way to group address cards is to use folders. + By default, cards start in the + Contacts folder. If you've read then you already know that you + can create a new folder by selecting + + File + New + Folder + + and that you can put new folders anywhere you like. Just + 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 . + + + To put a card into a folder, just drag it there from the + folder view. Remember that contact cards can only go in + contact folders, just like mail can only go in mail folders, + and calendars in calendar folders. + + + + + Grouping with Categories + + The other way to group cards is to mark them as belonging + to different categories. + That means that you + can mark a card as being in several categories or no + category at all. For example, I put my friend Matthew's + card in the "Business" category, because he works with me, + the "Friends" category, because he's also my friend, and + the "Frequent" category, because I call him all the time + and can never remember his phone number. + + + To mark a card as belonging to a category, click the + Categories button at the lower + right. From the dialog box that appears, you can check as + many or as few categories as you like. + + + + + + + + Creating a List of Contacts + + To create a list of contacts: + + + + + Open the list creation dialog box by clicking the + New List button or selecting + + + File + + + New + + + Contact List + + . + + + + + + Enter a name for the list. + + + + + Enter names or email addresses of contacts, or just + drag contacts from the main window into the list. + + + + + + Choose whether you would like to hide the email + addresses when you send a message to the list. + 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 + . + + + + + + + When you are done, click OK. The + list will appear as a contact card, which you can use as + you would any other. That includes emailing the list to + another person, and, of course, sending email to the list. + + + To mail the list, open a new email and type the name you + chose for the list. Ximian Evolution will address the + message to the entire list when you send it. You can also + right-click on the list's address card in the Addressbook + and select Send Message to List. + + + Ximian Evolution cannot store contact lists on Exchange + servers. + + + + + + + + LDAP: Shared Addressbooks on a Network + + + The LDAP protocol was + created to let users share contact information over a network by + sharing access to a central address book. LDAP allows a company + to maintain a shared set of contact information for a company or + department. Many companies keep a common LDAP address book for + all their employees or for client contacts. + + + + To learn how to add a remote directory to your available + contact folders, see . + Once you have a LDAP connection, the network contacts folder or + folders will appear inside the External + Directories folder in the folder bar. It will work + exactly like a local folder of cards, with the following + exceptions: + + + + + Network folders are only available when you are + connected to the network. If you use a laptop or have a + modem connection, you may wish to copy or cache the + network directory. You do this by dragging and dropping + your desired contacts into the local contacts list. + + + + + + To prevent excess network traffic, + Evolution will not normally + load the contents of LDAP folders immediately upon + opening. You must click Display + All before LDAP folder cards will be loaded + from the network. You can change this behavior in the + Contact Preferences window. + + + + + You cannot add, delete, or alter cards on the LDAP + server. If you need to change information there, you + will need to speak to your system administrator + + + + + + Configuring Evolution to use LDAP + + For information about setting up + Evolution to use LDAP, please refer + to + + + + + + Send me a Card: Adding New Cards Quickly + + As noted before, when you get information about a person in + the mail or in a calendar entry, you can add it to an address + card. To do so, right click on any email address or email + message, and select Add Address + Card from the menu that appears. + Evolution can also add cards from a + hand-held device during HotSync operation. For more + information about that, see . + + + + + + + + diff --git a/help/C/usage-exchange.sgml b/help/C/usage-exchange.sgml deleted file mode 100644 index 2a7ef31ba7..0000000000 --- a/help/C/usage-exchange.sgml +++ /dev/null @@ -1,748 +0,0 @@ - - The Ximian Connector for Microsoft Exchange - - The Ximian Connector for Microsoft Exchange allows Ximian - Evolution clients to access accounts on Microsoft Exchange 2000 - servers. It is available through Ximian Red Carpet in its own - channel, but cannot be used without a license file. The license - file may be purchased from the Ximian online store at store.ximian.com. Unlike the - regular Ximian Evolution client, the Ximian Connector for - Microsoft Exchange is proprietary software and source code is not - available. - - - - Requirements - - Ximian Connector works only with Exchange 2000, and requires - that Outlook Web Access be enabled. Each user will need a - valid Microsoft Exchange 2000 server account, including license. - - - - -What's New in Connector 1.2 - - Ximian Connector 1.2 has added some of the most frequently - requested features of Microsoft Exchange clients, including Public - Folder access and calendar delegation. - - - - - Preferences Dialogs - - - The preferences dialogs have been completely overhauled for - Evolution and Connector 1.2. Select - ToolsPreferences - from the main Evolution window to change your settings. - - - - - - Public Folders, Posting, and Delegation - - - Public folders, posting to folders, and delegation - functions have been added. You may now set permissions on - folders to which you have appropriate access, and view the - folders of other users who have granted you permission to - view them. - - - - - - Flag for Followup - - - Flag for Followup now works properly in both Outlook and - Evolution, even when set in one and read in the other. - - - - - - Improved vFolder Support - - - vFolders now function better with Exchange accounts. - - - - - - - Notes - - - The "Notes" and "Journal" folders in Exchange accounts are now readable, and you can drag items into them from other folders. Creating new Notes or Journal entries is not yet supported. - - - - - - Direct Booking - - - When creating a meeting request, resources such as rooms - and equipment can be checked and reserved without waiting - for a reply. - - - - - - - - Connector Features - - In addition to the features listed above, Ximian - Connector supports the following basic - Microsoft Exchange features: - - - - General - - - - Remote Exchange Information Store - - - Allows you to access mail, address book (including - Global Address List folder), and calendars, and task - folders on an Exchange - 2000 server from - Evolution. - - - - - - Palm synchronization - - - Supported for Contacts and Calendars on Exchange. - - - - - - - - Mail - - - - Viewing Mail in ExchangeFolder - - - - - - Sending Email via Exchange Protocols - - - You may use the Microsoft Exchange mail transport - protocol to send email. Make sure that the address - you have entered as your email address is exactly - the one that the Exchange server has on file. This - may be "yourname@exchange-server.ximian.com" rather - than "yourname@ximian.com.a" - - - - - - - - Calendar - - - - Meeting Request/Proposal - - - Allows Evolution users to - schedule meetings and view attendee availability for - other users (Evolution or - Outlook users) on - Exchange. - - - - - Adding iCalendar Meeting Requests to Calendar - - - If you receive an iCalendar meeting request and add it - to your calendar, it will be saved to your - Exchange calendar. - - - - - - - - Contacts - - - - Address Completion - - - Supported for your Exchange - Contacts folder. Not yet supported for the Global - Address List. - - - - - Adding vCards to Address Book - - - If you receive a vCard attachment and click - Save in Address Book, it will - be saved to your Exchangeaddress book. - - - - - New Address Book entries can be created on - Exchange from received email - messages with a single click - - - - - - - - - - - -There are, however, some features which are not available: - - - - Work Offline (disconnected mode). - - - - - "Recall Message" function. - - - - - Creation of an automatic "out-of-office" reply - messages. - - - - - - - Installing the Connector - - To install the Ximian Connector, run Ximian Red Carpet by - selecting SystemGet - Software. Subscribe to the Ximian - Connector for Microsoft Exchange channel, select the Ximian - Connector for Microsoft - Exchange2000, and click the - Install button. You can also install - the Connector by downloading the individual packages from - ftp.ximian.com if you wish. - - - Once you have installed the software, you will also need to - install a license file. The license file is the verification - that you have paid for a license to use the Ximian - Connector. You can get the license file from the the Ximian - online store at store.ximian.com. You - will need a browser with strong (128-bit or greater) encryption - to access the store. When you purchase a Ximian Connector - license, the store will mail you the license file with - instructions for installation. Once installed, the license file - unlocks the Ximian Connector functionality and you may connect - to an Exchangeserver. - - - - - Configuration - - Once you have installed the Connector, you need to set up access - for your Exchangeaccount on both the - Exchangeserver and within Evolution. - - - - Exchange Server Configuration - - Check with your system administrator to ensure that: - - - - You have a valid account on the Exchangeserver. - - - - You are permitted to access the account with - WebDAV. This is the default setting for the - Exchangeserver, so unless - your system administrator has specifically turned it - off, no changes should be necessary. - - - - - - The Ximian website knowledge base, at support.ximian.com, - has additional information about checking to make sure that - your Exchangeserver will accept - connections from Ximian Evolution. - - - - - Evolution Settings for Connecting to an <application>Exchange</application>Server - - - Once you know that your server is ready for you to connect, start - Ximian Evolution and select - - Tools - Mail Settings - - from any mail view. - - - Creating a New Exchange Account - - - - If you would like to create a new account for your Exchange - server, click the Add button in the - accounts list. The account creation assistant will guide you - through the process, which is also described in . If you're not sure - about any of the information you need, just ask your system - administrator. - - - - Identity - - Enter your name and email address. If you wish, - you may add your organization and the location of your - signature file. Only your name and email address are - required. - - - - - - Receiving Mail - - - In this step, you'll enter information about the way - you check mail: - - - - First, select Microsoft - Exchange as your server type. - - - - - Enter the name of your Exchange email server, and - the user name you would use to log in to a - Windows workstation in your organization. - - - - - If you wish, select the box labelled - Use secure connection - (SSL), to take advantage of a more - secure connection method. This may allow you to - connect to the server from outside your - firewall. - - - - - If you would like - Evolution to - remember your password, check the box labelled - Remember this password. - - - - - - - - - Receiving Mail, Step Two - - There are a few additional options in this step: - - - - Checking for New Mail: If you would like to - check for new mail automatically, click the - checkbox and enter an interval in minutes. - - - - - Exchange Server: If your Exchange mailbox name - is different from your Windows name, enter your - mailbox name here. - - - - - Override Outlook Web Access Path: In most cases, - the URL for web access is - "http://server.company.com/exchange." If your - system has a path that is not "exchange," check - the box and enter the custom path here. - - - - - - Active Directory: If you would like to use the - Global Address List (GAL), check the box - labelled Create a Global Address - List folder and enter the name - of the directory server. To avoid strain - on the server, the maximum number of - responses to any Active Directory query has - been set to 500. If you would like to - change that, you may do so here as well. - - - - - - - - - Sending Mail - - Select Microsoft Exchange as - your email sending method. There is nothing else to do - in this step. - - - - - Account Management - - Enter a name that you will use to remember this - account. "Exchange Account" is a good suggestion. Note - that you cannot have two accounts with the same name. - If you'd like to make this your default account for - sending email, check the Make this my default - account box. - - - - - You're done. Click Finish and - OK, then quit - Evolution and start it again. Now - you're ready to get to work on the Exchange server. - - -
- Creating an Exchange Account, Step One: Identity - - Creating an Exchange Account, Step One: Identity - - - - -
- -
- Creating an Exchange Account, Step Two: Receiving Mail - - Creating an Exchange Account, Step Two: Receiving Mail - - - - -
- -
- Creating an Exchange Account, Step Three: Mail Options - - Creating an Exchange Account, Step Three: Mail Options - - - - -
- - - - - - Changing an Existing Account to Work with Exchange - - If you have an existing email account, and want to convert it - to use for Exchange, select the account you want to convert - and click the Edit button. You'll want - to change settings in the following tabs of the account - dialog: - - - - Identity - - - If your email address will change because you are moving - to a new server, then change it in this tab. Otherwise, - move to the next tab. - - - - - Receiving Mail - - - Select Microsoft Exchange as your - server type. Enter your name of your server next to - Host, and the user name for your - account next to Username. If your - server supports SSL (Secure Socket Layer) encryption, it - you can check the Use SSL box to - take advantage of more secure data transfers. - - - - - Receiving Options - - - Here, tab, you'll find some additional settings: - - - Checking for New Mail - - - Select whether you would like to check for - mail automatically, and if so, how often. - - - - - Mailbox Name and Web Access Path - - - If your Exchange server requires you to use a - different mailbox name from the name you use to - log in, select the second check-box and enter - the mailbox name. Check with your system - administrator to be sure. - - - In most cases, the URL for web access is - "http://server.company.com/exchange." If your - system has a path that is not "exchange," check - the box and enter the custom path here. - - - - - Active Directory - - - If you would like to use the Global Address - List (GAL) maintained on your Exchange server, - click the tab labelled Receiving - Options and check the box labelled - Create a Global Address List - folder. The GAL is maintained by - your system administrator and you cannot add, - change, or remove items from it using Ximian - Evolution. However, you can use it to invite - people to meetings and to look up addresses and - other information. In many organizations, the - GAL is stored on a different server from email. - If this is the case, you should also specify - the directory server name here. - - - - - - - - - Sending Mail - - - If you will use your Exchange server to send as well as - receive mail, select Microsoft - Exchange as your server type, and enter the - server name as the Host. - - - - - - - Once you have made those changes, click the - OK button. - - - Then, quit Evolution and start it - up again. Changes to the Ximian Connector accounts - configuration are not active until you have restarted the - application. - - - - - - - Accessing the <application>Exchange</application>Server - - Like IMAP and LDAP data, information for - Exchangeaccounts is stored on the - server, not on your desktop computer. This means that you can - access it from multiple locations. It also means that your - Microsoft Exchangeaccount information - is in a seperate folder tree from the Local - tree in your folder bar. You'll see it below the local tree, - with the name you gave the account. If you have multiple - accounts, you will have multiple folder trees. - - - Click on any of the folder tree items to visit them; you may - have to enter your server password. You can now create contact - cards, send and receive email as you would normally. If there - are items in your local calendar or addressbook that you'd like - to add to your Exchangestores, you - can copy and paste them over, or just drag items from one folder - to another as you would with two local stores. - - - - Saving Attached Addresses and Appointments - - If you are using both an Exchange account and a local mail - account, you should be aware that whenever you save an email - address or appointment from an email message, it will be - saved in your Exchange contacts list or calendar, rather - than in your local account. The same is true of - synchronization with Palm-OS devices: tasks, appointments, - and addresses from your Palm-OS device will be synchronized - with those in the Exchange folders rather than local - folders. - - - - - The Global Address List Is Empty At First - - To avoid unnecessary strain on the server, the GAL will - appear empty until you have searched for something in it. - If you want to display all the cards in the list, click in - the search box and press Enter. This - enters a blank search: since every card contains a blank in - it, every card will appear. - - - - - Taking Full Advantage of the Exchange Server When Scheduling Appointments - - When you schedule a meeting with your calendar on the - Exchangeserver, you can check when - other local Exchange users are busy according to their - Exchangecalendars. To do so: - -
- Scheduling With Free/Busy Information - - Using the Free/Busy Feature - - - - -
- - - Reminders In Exchange - - Reminders for appointments in your Exchange calendar will - not work until you have run Evolution at least once after - logging in. This is different from locally stored reminders, - which will work from the moment you log in, regardless of - whether you have run Evolution in the session. - - - - - - Open a new appointment in the calendar. - - - - Choose Actions - Schedule Meeting - in the meeting editor window. - - - - Add attendees, either by entering their email - addresses into the list, or by clicking the - Invite Others button. If you choose - to so, it's best to use the Global Address List (GAL). - Choose the GAL from the drop-down list of address sources - at the top of the dialog box. - - - - - Choose Options and then - Update Free/Busy to check participant - schedules and, if possible, update the meeting in all - participants' calendars. - - - - - Using Autopick to Adjust Meeting Times - - If meeting attendees are not available during the times you - have scheduled a meeting, you can "nudge" the meeting forward - or backward to the nearest available time. To do so, just - click the arrows to the left or right of the - Autopick button. The autopick tool will - move the meeting to the nearest time during which all - attendees are available. If you aren't satisfied with those - results, you can drag the edges of the meeting time to the - hours that you want to select. - - - - - diff --git a/help/C/usage-exchange.xml b/help/C/usage-exchange.xml new file mode 100644 index 0000000000..5fab9d0cc7 --- /dev/null +++ b/help/C/usage-exchange.xml @@ -0,0 +1,748 @@ + + The Ximian Connector for Microsoft Exchange + + The Ximian Connector for Microsoft Exchange allows Ximian + Evolution clients to access accounts on Microsoft Exchange 2000 + servers. It is available through Ximian Red Carpet in its own + channel, but cannot be used without a license file. The license + file may be purchased from the Ximian online store at store.ximian.com. Unlike the + regular Ximian Evolution client, the Ximian Connector for + Microsoft Exchange is proprietary software and source code is not + available. + + + + Requirements + + Ximian Connector works only with Exchange 2000, and requires + that Outlook Web Access be enabled. Each user will need a + valid Microsoft Exchange 2000 server account, including license. + + + + +What's New in Connector 1.2 + + Ximian Connector 1.2 has added some of the most frequently + requested features of Microsoft Exchange clients, including Public + Folder access and calendar delegation. + + + + + Preferences Dialogs + + + The preferences dialogs have been completely overhauled for + Evolution and Connector 1.2. Select + ToolsPreferences + from the main Evolution window to change your settings. + + + + + + Public Folders, Posting, and Delegation + + + Public folders, posting to folders, and delegation + functions have been added. You may now set permissions on + folders to which you have appropriate access, and view the + folders of other users who have granted you permission to + view them. + + + + + + Flag for Followup + + + Flag for Followup now works properly in both Outlook and + Evolution, even when set in one and read in the other. + + + + + + Improved vFolder Support + + + vFolders now function better with Exchange accounts. + + + + + + + Notes + + + The "Notes" and "Journal" folders in Exchange accounts are now readable, and you can drag items into them from other folders. Creating new Notes or Journal entries is not yet supported. + + + + + + Direct Booking + + + When creating a meeting request, resources such as rooms + and equipment can be checked and reserved without waiting + for a reply. + + + + + + + + Connector Features + + In addition to the features listed above, Ximian + Connector supports the following basic + Microsoft Exchange features: + + + + General + + + + Remote Exchange Information Store + + + Allows you to access mail, address book (including + Global Address List folder), and calendars, and task + folders on an Exchange + 2000 server from + Evolution. + + + + + + Palm synchronization + + + Supported for Contacts and Calendars on Exchange. + + + + + + + + Mail + + + + Viewing Mail in ExchangeFolder + + + + + + Sending Email via Exchange Protocols + + + You may use the Microsoft Exchange mail transport + protocol to send email. Make sure that the address + you have entered as your email address is exactly + the one that the Exchange server has on file. This + may be "yourname@exchange-server.ximian.com" rather + than "yourname@ximian.com.a" + + + + + + + + Calendar + + + + Meeting Request/Proposal + + + Allows Evolution users to + schedule meetings and view attendee availability for + other users (Evolution or + Outlook users) on + Exchange. + + + + + Adding iCalendar Meeting Requests to Calendar + + + If you receive an iCalendar meeting request and add it + to your calendar, it will be saved to your + Exchange calendar. + + + + + + + + Contacts + + + + Address Completion + + + Supported for your Exchange + Contacts folder. Not yet supported for the Global + Address List. + + + + + Adding vCards to Address Book + + + If you receive a vCard attachment and click + Save in Address Book, it will + be saved to your Exchangeaddress book. + + + + + New Address Book entries can be created on + Exchange from received email + messages with a single click + + + + + + + + + + + +There are, however, some features which are not available: + + + + Work Offline (disconnected mode). + + + + + "Recall Message" function. + + + + + Creation of an automatic "out-of-office" reply + messages. + + + + + + + Installing the Connector + + To install the Ximian Connector, run Ximian Red Carpet by + selecting SystemGet + Software. Subscribe to the Ximian + Connector for Microsoft Exchange channel, select the Ximian + Connector for Microsoft + Exchange2000, and click the + Install button. You can also install + the Connector by downloading the individual packages from + ftp.ximian.com if you wish. + + + Once you have installed the software, you will also need to + install a license file. The license file is the verification + that you have paid for a license to use the Ximian + Connector. You can get the license file from the the Ximian + online store at store.ximian.com. You + will need a browser with strong (128-bit or greater) encryption + to access the store. When you purchase a Ximian Connector + license, the store will mail you the license file with + instructions for installation. Once installed, the license file + unlocks the Ximian Connector functionality and you may connect + to an Exchangeserver. + + + + + Configuration + + Once you have installed the Connector, you need to set up access + for your Exchangeaccount on both the + Exchangeserver and within Evolution. + + + + Exchange Server Configuration + + Check with your system administrator to ensure that: + + + + You have a valid account on the Exchangeserver. + + + + You are permitted to access the account with + WebDAV. This is the default setting for the + Exchangeserver, so unless + your system administrator has specifically turned it + off, no changes should be necessary. + + + + + + The Ximian website knowledge base, at support.ximian.com, + has additional information about checking to make sure that + your Exchangeserver will accept + connections from Ximian Evolution. + + + + + Evolution Settings for Connecting to an <application>Exchange</application>Server + + + Once you know that your server is ready for you to connect, start + Ximian Evolution and select + + Tools + Mail Settings + + from any mail view. + + + Creating a New Exchange Account + + + + If you would like to create a new account for your Exchange + server, click the Add button in the + accounts list. The account creation assistant will guide you + through the process, which is also described in . If you're not sure + about any of the information you need, just ask your system + administrator. + + + + Identity + + Enter your name and email address. If you wish, + you may add your organization and the location of your + signature file. Only your name and email address are + required. + + + + + + Receiving Mail + + + In this step, you'll enter information about the way + you check mail: + + + + First, select Microsoft + Exchange as your server type. + + + + + Enter the name of your Exchange email server, and + the user name you would use to log in to a + Windows workstation in your organization. + + + + + If you wish, select the box labelled + Use secure connection + (SSL), to take advantage of a more + secure connection method. This may allow you to + connect to the server from outside your + firewall. + + + + + If you would like + Evolution to + remember your password, check the box labelled + Remember this password. + + + + + + + + + Receiving Mail, Step Two + + There are a few additional options in this step: + + + + Checking for New Mail: If you would like to + check for new mail automatically, click the + checkbox and enter an interval in minutes. + + + + + Exchange Server: If your Exchange mailbox name + is different from your Windows name, enter your + mailbox name here. + + + + + Override Outlook Web Access Path: In most cases, + the URL for web access is + "http://server.company.com/exchange." If your + system has a path that is not "exchange," check + the box and enter the custom path here. + + + + + + Active Directory: If you would like to use the + Global Address List (GAL), check the box + labelled Create a Global Address + List folder and enter the name + of the directory server. To avoid strain + on the server, the maximum number of + responses to any Active Directory query has + been set to 500. If you would like to + change that, you may do so here as well. + + + + + + + + + Sending Mail + + Select Microsoft Exchange as + your email sending method. There is nothing else to do + in this step. + + + + + Account Management + + Enter a name that you will use to remember this + account. "Exchange Account" is a good suggestion. Note + that you cannot have two accounts with the same name. + If you'd like to make this your default account for + sending email, check the Make this my default + account box. + + + + + You're done. Click Finish and + OK, then quit + Evolution and start it again. Now + you're ready to get to work on the Exchange server. + + +
+ Creating an Exchange Account, Step One: Identity + + Creating an Exchange Account, Step One: Identity + + + + +
+ +
+ Creating an Exchange Account, Step Two: Receiving Mail + + Creating an Exchange Account, Step Two: Receiving Mail + + + + +
+ +
+ Creating an Exchange Account, Step Three: Mail Options + + Creating an Exchange Account, Step Three: Mail Options + + + + +
+ + + + + + Changing an Existing Account to Work with Exchange + + If you have an existing email account, and want to convert it + to use for Exchange, select the account you want to convert + and click the Edit button. You'll want + to change settings in the following tabs of the account + dialog: + + + + Identity + + + If your email address will change because you are moving + to a new server, then change it in this tab. Otherwise, + move to the next tab. + + + + + Receiving Mail + + + Select Microsoft Exchange as your + server type. Enter your name of your server next to + Host, and the user name for your + account next to Username. If your + server supports SSL (Secure Socket Layer) encryption, it + you can check the Use SSL box to + take advantage of more secure data transfers. + + + + + Receiving Options + + + Here, tab, you'll find some additional settings: + + + Checking for New Mail + + + Select whether you would like to check for + mail automatically, and if so, how often. + + + + + Mailbox Name and Web Access Path + + + If your Exchange server requires you to use a + different mailbox name from the name you use to + log in, select the second check-box and enter + the mailbox name. Check with your system + administrator to be sure. + + + In most cases, the URL for web access is + "http://server.company.com/exchange." If your + system has a path that is not "exchange," check + the box and enter the custom path here. + + + + + Active Directory + + + If you would like to use the Global Address + List (GAL) maintained on your Exchange server, + click the tab labelled Receiving + Options and check the box labelled + Create a Global Address List + folder. The GAL is maintained by + your system administrator and you cannot add, + change, or remove items from it using Ximian + Evolution. However, you can use it to invite + people to meetings and to look up addresses and + other information. In many organizations, the + GAL is stored on a different server from email. + If this is the case, you should also specify + the directory server name here. + + + + + + + + + Sending Mail + + + If you will use your Exchange server to send as well as + receive mail, select Microsoft + Exchange as your server type, and enter the + server name as the Host. + + + + + + + Once you have made those changes, click the + OK button. + + + Then, quit Evolution and start it + up again. Changes to the Ximian Connector accounts + configuration are not active until you have restarted the + application. + + + + + + + Accessing the <application>Exchange</application>Server + + Like IMAP and LDAP data, information for + Exchangeaccounts is stored on the + server, not on your desktop computer. This means that you can + access it from multiple locations. It also means that your + Microsoft Exchangeaccount information + is in a seperate folder tree from the Local + tree in your folder bar. You'll see it below the local tree, + with the name you gave the account. If you have multiple + accounts, you will have multiple folder trees. + + + Click on any of the folder tree items to visit them; you may + have to enter your server password. You can now create contact + cards, send and receive email as you would normally. If there + are items in your local calendar or addressbook that you'd like + to add to your Exchangestores, you + can copy and paste them over, or just drag items from one folder + to another as you would with two local stores. + + + + Saving Attached Addresses and Appointments + + If you are using both an Exchange account and a local mail + account, you should be aware that whenever you save an email + address or appointment from an email message, it will be + saved in your Exchange contacts list or calendar, rather + than in your local account. The same is true of + synchronization with Palm-OS devices: tasks, appointments, + and addresses from your Palm-OS device will be synchronized + with those in the Exchange folders rather than local + folders. + + + + + The Global Address List Is Empty At First + + To avoid unnecessary strain on the server, the GAL will + appear empty until you have searched for something in it. + If you want to display all the cards in the list, click in + the search box and press Enter. This + enters a blank search: since every card contains a blank in + it, every card will appear. + + + + + Taking Full Advantage of the Exchange Server When Scheduling Appointments + + When you schedule a meeting with your calendar on the + Exchangeserver, you can check when + other local Exchange users are busy according to their + Exchangecalendars. To do so: + +
+ Scheduling With Free/Busy Information + + Using the Free/Busy Feature + + + + +
+ + + Reminders In Exchange + + Reminders for appointments in your Exchange calendar will + not work until you have run Evolution at least once after + logging in. This is different from locally stored reminders, + which will work from the moment you log in, regardless of + whether you have run Evolution in the session. + + + + + + Open a new appointment in the calendar. + + + + Choose Actions + Schedule Meeting + in the meeting editor window. + + + + Add attendees, either by entering their email + addresses into the list, or by clicking the + Invite Others button. If you choose + to so, it's best to use the Global Address List (GAL). + Choose the GAL from the drop-down list of address sources + at the top of the dialog box. + + + + + Choose Options and then + Update Free/Busy to check participant + schedules and, if possible, update the meeting in all + participants' calendars. + + + + + Using Autopick to Adjust Meeting Times + + If meeting attendees are not available during the times you + have scheduled a meeting, you can "nudge" the meeting forward + or backward to the nearest available time. To do so, just + click the arrows to the left or right of the + Autopick button. The autopick tool will + move the meeting to the nearest time during which all + attendees are available. If you aren't satisfied with those + results, you can drag the edges of the meeting time to the + hours that you want to select. + + + + + diff --git a/help/C/usage-exec-summary.sgml b/help/C/usage-exec-summary.sgml deleted file mode 100644 index 564c1c6617..0000000000 --- a/help/C/usage-exec-summary.sgml +++ /dev/null @@ -1,323 +0,0 @@ - - - Getting Oriented with the Ximian Evolution Summary - - - Using the Summary - - The Ximian Evolution Summary can show you what you need to know - quickly. It will show you your tasks for that day, how many - emails are waiting for you, and much more. - - - To begin using your Summary, click on the Shortcut - Bar or Summary at the top of the - Folder Bar. By default, you will see: - - - - Weather Reports - - - - - News feeds from the Internet - - - - - Mail summary - - - - - Appointments - - - - - Tasks - - - - - - - Customizing the Summary's Modules - - Evolution's modules can be customized - to suit your needs. For example, you can choose which mail - boxes are summarized, and which news services appear. - - - - - Using the Summary through an HTTP Proxy - - If you use an HTTP proxy, Ximian - Evolution must be able to find it through the - gnome-vfs subsystem before it can - access news and weather from the Internet. This is also - the case if you wish to load remote images into HTML mail - message. You can tell the GNOME Virtual File System about - your HTTP proxy in one of three ways, from easiest to most - complicated: - - - Use the VFS Proxy Tool - - - - - - Run the command "gnome-vfs-proxy-capplet" or - select the GNOME VFS Proxy Configuration tool - from your Desktop Preferences menu in the menu - panel. - - - - - Enter the address or hostname of your proxy - server and click the OK - button. - - - - - - - - Configure it with Nautilus - - - - - - Open a Nautilus window - - - - - Select - Preferences - Edit Preferences - . - - - - - Go to the Navigation tab. - - - - - Click the Use HTTP Proxy - checkbox and enter the location of your HTTP - proxy in the Location field. - - - - - - - - Configure it with the gconftool command - - - - - - Open a terminal. - - - - - Enter the command - - gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE" - - - - - - Enter the command - - gconftool --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url" - - - - - - Enter the command - - gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080" - - - - - - - For more information about the gconftool command, - read the gconftool man page. - - - - - - - - - - Customizing the Weather Summary - - To add a city to be displayed in the weather: - - - - - Choose - - Tools - Configure and - select the Summary Preferences tool. - - - - - Click the Weather tab. - - - - - Select the city on the left hand column. - - - - - Click the Add button. - - - - - Metric or Imperial? - - Evolution supports both - Imperial and Metric measurement for weather - reports. Imperial units are sometimes called British - units, but are used almost exclusively in the United - States. Britain, and most of the rest of the world, use - metric units. - - - - - - Customizing Your News Feeds - - To customize your news feeds: - - - - Choose - - Tools - Configure and - select the Summary Preferences tool. Then, choose the - News tab. - - - - - In the left hand column, select the news feed to add to - your display. - - - - - Click the Add button. - - - - - Click OK. - - - - - - You can also add your own news feeds. Evolution will display - RDF format news feeds from the website of your choice. - - - - - Customizing Your Mail Summary - - To customize your mail summary: - - - - Choose - - Tools - Configure and - select the Summary Preferences tool. - - - - - Click the Mail tab. - - - - - Select the mail folder you want to see in the preview on the left. - - - - - Click Add. - - - - - - - Customizing Your Schedule Summary - - To customize your calendar summary: - - - - Choose - - Tools - Configure and - select the Summary Preferences tool. - - - - - Click the Schedule tab. - - - - - Choose whether you'd like appointments displayed for one - day, five days, a week, or a month. - - - - - Choose whether you'd like to display all tasks, or just - the tasks due today. - - - - - - - \ No newline at end of file diff --git a/help/C/usage-exec-summary.xml b/help/C/usage-exec-summary.xml new file mode 100644 index 0000000000..564c1c6617 --- /dev/null +++ b/help/C/usage-exec-summary.xml @@ -0,0 +1,323 @@ + + + Getting Oriented with the Ximian Evolution Summary + + + Using the Summary + + The Ximian Evolution Summary can show you what you need to know + quickly. It will show you your tasks for that day, how many + emails are waiting for you, and much more. + + + To begin using your Summary, click on the Shortcut + Bar or Summary at the top of the + Folder Bar. By default, you will see: + + + + Weather Reports + + + + + News feeds from the Internet + + + + + Mail summary + + + + + Appointments + + + + + Tasks + + + + + + + Customizing the Summary's Modules + + Evolution's modules can be customized + to suit your needs. For example, you can choose which mail + boxes are summarized, and which news services appear. + + + + + Using the Summary through an HTTP Proxy + + If you use an HTTP proxy, Ximian + Evolution must be able to find it through the + gnome-vfs subsystem before it can + access news and weather from the Internet. This is also + the case if you wish to load remote images into HTML mail + message. You can tell the GNOME Virtual File System about + your HTTP proxy in one of three ways, from easiest to most + complicated: + + + Use the VFS Proxy Tool + + + + + + Run the command "gnome-vfs-proxy-capplet" or + select the GNOME VFS Proxy Configuration tool + from your Desktop Preferences menu in the menu + panel. + + + + + Enter the address or hostname of your proxy + server and click the OK + button. + + + + + + + + Configure it with Nautilus + + + + + + Open a Nautilus window + + + + + Select + Preferences + Edit Preferences + . + + + + + Go to the Navigation tab. + + + + + Click the Use HTTP Proxy + checkbox and enter the location of your HTTP + proxy in the Location field. + + + + + + + + Configure it with the gconftool command + + + + + + Open a terminal. + + + + + Enter the command + + gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE" + + + + + + Enter the command + + gconftool --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url" + + + + + + Enter the command + + gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080" + + + + + + + For more information about the gconftool command, + read the gconftool man page. + + + + + + + + + + Customizing the Weather Summary + + To add a city to be displayed in the weather: + + + + + Choose + + Tools + Configure and + select the Summary Preferences tool. + + + + + Click the Weather tab. + + + + + Select the city on the left hand column. + + + + + Click the Add button. + + + + + Metric or Imperial? + + Evolution supports both + Imperial and Metric measurement for weather + reports. Imperial units are sometimes called British + units, but are used almost exclusively in the United + States. Britain, and most of the rest of the world, use + metric units. + + + + + + Customizing Your News Feeds + + To customize your news feeds: + + + + Choose + + Tools + Configure and + select the Summary Preferences tool. Then, choose the + News tab. + + + + + In the left hand column, select the news feed to add to + your display. + + + + + Click the Add button. + + + + + Click OK. + + + + + + You can also add your own news feeds. Evolution will display + RDF format news feeds from the website of your choice. + + + + + Customizing Your Mail Summary + + To customize your mail summary: + + + + Choose + + Tools + Configure and + select the Summary Preferences tool. + + + + + Click the Mail tab. + + + + + Select the mail folder you want to see in the preview on the left. + + + + + Click Add. + + + + + + + Customizing Your Schedule Summary + + To customize your calendar summary: + + + + Choose + + Tools + Configure and + select the Summary Preferences tool. + + + + + Click the Schedule tab. + + + + + Choose whether you'd like appointments displayed for one + day, five days, a week, or a month. + + + + + Choose whether you'd like to display all tasks, or just + the tasks due today. + + + + + + + \ No newline at end of file diff --git a/help/C/usage-mail-org.sgml b/help/C/usage-mail-org.sgml deleted file mode 100644 index d03edf6267..0000000000 --- a/help/C/usage-mail-org.sgml +++ /dev/null @@ -1,1129 +0,0 @@ - - Organizing and Managing your Email - - Even if you only get a few email messages a day, you probably - want to sort and organize them. When you get a hundred a day - and you want to refer to a message you received six weeks ago, - you need to sort and organize them. - Fortunately, Ximian Evolution has the tools - to help you do it. - - - - Importing Your Old Email and Settings - - Evolution allows you to import old - email and data so that you don't need to worry about losing your - old information. - - - Importing Email - - Ximian Evolution can import the - following types of files: - - - VCard (.vcf, gcrd): - - - The addressbook format used by the GNOME, KDE, and - many other contact management applications. You - should be able to export to VCard format from any - address book application. - - - - - - iCalendar (.ics): - - - A format for storing calendar files. iCalendar is used by - PalmOS based handhelds, Ximian - Evolution, and Microsoft - Outlook. - - - - - - Microsoft Outlook Express 4 (.mbx): - - - Email file format used by Microsoft Outlook Express - 4. For other versions of Microsoft Outlook and Outlook Express, see - the workaround described in the note below. - - - - - - MBox (mbox): - - - The email box format used by Mozilla, Netscape, - Ximian Evolution, Eudora, and many other email clients. - - - - - - - To import your old email: - - - - Click FileImport. - - - - - Click Next after reading the Welcome screen. - - - - - Select Import a single file. - - - - - Find the file that you wish to import into Evolution. - - - - - Click Import - - - - - - - Importing Preferences - - Evolution can import all your old - mail, contacts, and other information from other applications, - making your transition to Evolution - easy. - - - To import your old information: - - - - Click FileImport. - - - - - Click Next after reading the Welcome screen. - - - - - Select Import data and settings from older programs. - - - - - The left-most column shows the application which your - information will be imported from. You then select - checkboxes on each component to import different - properties of each application. - - - - - Click Next - - - - - Click Import - - - - - - - - Microsoft Outlook and Outlook Express Users - - Microsoft Outlook, and versions of Outlook Express after - version 4, use proprietary formats that Ximian - Evolution cannot read or import. For contacts, - you may have to email them to yourself and import them that - way. For email, there is a simpler workaround: - - - - - While using Windows, import the files into Mozilla Mail (or - another mailer, such as Netscape or Eudora, that uses the - standard mbox format). - - - - - - Copy the files to the system or partition you use for - Ximian Evolution. - - - - - - Use the Ximian Evolution import - tool to import the files. There's more information about - why this works, and how, at the Ximian support website. - - - - - - - - Netscape Users - - Before importing mail from Netscape, make sure you select - FileCompact All - Folders. If you don't, - Ximian Evolution will import and undelete - the messages in your Trash folders. - - - - - - - - - Sorting Mail with Column Headers - - By default, the message list has columns with the following - headings: an envelope icon indicating whether you have read - or replied to a message, an exclamation point indicating priority, and the - From, Subject, and - Date fields. You can change their order - and remove them by dragging and dropping them. - - To add columns: - - - - Right click on the column header - - - - - Click Add a Column - - - - - Click and drag a column you want into a space between - existing column headers. A red arrow will show you where - the column will be placed. - - - - - - Right-click on one of the column headers to get a list of - options: - - - Sort Ascending: - - Sorts the messages top to bottom. - - - - - Sort Descending: - - Sorts the messages bottom to top. - - - - - Group By this Field: - - Groups messages instead of sorting them. This makes each contact - with identical properties in the specified field to be placed in - its own group and physically separated from others. - - - - - Remove this - Column: - - - Remove this column from the display. You can also remove - columns by dragging the header off the list and - letting it drop. - - - - - - Field - Chooser: - When you choose this item, a list - of column headers will appear; just drag and drop them into - place between two existing headers. A red arrow will - appear to show you where you're about to put the - column. - - - - - - - - Getting Organized with Folders - - Ximian Evolution keeps mail, as well as - address cards and calendars, in folders. You start out with a - few mail folders, such as Inbox, - Outbox, and Drafts, - but you can create as many as you like. Create new folders by - selecting New and then - Folder from the - File menu. - Ximian Evolution will as you for the name - and the type of the folder, and will provide you with a folder - tree so you can pick where it goes. - - - When you click OK, your new folder will - appear in the folder view. You can - then put messages in it by dragging and dropping them, or by - using the Move button in the - toolbar. If you want to move several messages at once, click - on the ones you want to move while holding down the - Ctrl key, or use Shift to - select a range of messages. If you create a filter with the - filter assistant, you can have mail - filed automatically. - - - - Subfolders in IMAP - - The INBOX folder on most IMAP servers cannot contain both - subfolders and messages. When you create additional folders - on your IMAP mail server, branch them from the root of the - IMAP account's folder, tree, not from INBOX. If you create - subfolders in your INBOX folder, you will lose the ability - to read messages that exist in your INBOX until you move the - folders out of the way. - - - - - - - Searching for Messages - - Most mail clients can search through your messages for you, - but Ximian Evolution does it faster. You - can search through just the message subjects, just the message - body, or both body and subject. - - - To start searching, enter a word or phrase in the text area - right below the toolbar, and choose a search type: - - - Body or subject contains: - - - This will search message subjects and the messages - themselves for the word or phrase you've entered in - the search field. - - - - - Body contains: - - - This will search only in message text, not the subject - lines. - - - - - Subject contains: - - - This will show you messages where the search text is - in the subject line. It will not search in the - message body. - - - - - Body does not contain: - - - This finds every email message that does not have the - search text in the message body. It will still show - messages that have the search text in the subject - line, if it is not also in the body. - - - - - Subject does not contain: - - - This finds every mail whose subject does not contain - the search text. - - - - - - When you've entered your search phrase, press - Enter. Ximian Evolution - will show your search results in the message list. - - - - If you think you'll want to return to a search again, you can - save it as a virtual folder by selecting Store - Search as vFolder. - - - - When you're done with the search, go back to seeing all your - messages by choosing Show All from - the Search drop-down box. If you're - sneaky, just enter a blank search: since every message has at - least one space in it, you'll see every message in the - folder. - - - - If you'd like to perform a more complex search, open the - advanced search dialog by selecting - Advanced... from the - Search drop-down menu. Then, create your - search criteria (each with the same options you saw in the - regular search bar), and decide whether you want to find - messages that match all of them, or messages that match even - one. Then, click Search to go and find - those messages. - - - - You'll see a similar approach to sorting messages when you - create filters and vFolders in the next few sections. - - - - - - Create Rules to Automatically Organize Mail - - Filters work very much like the mail room in a large company. - Their purpose is to bundle, sort, and distribute mail to the - various folders. In addition, you can have multiple filters - performing multiple actions that may effect the same message - in several ways. For example, your filters could put copies - of one message into multiple folders, or keep a copy and send - one to another person as well, and it can do that quickly. Of - course, it's also faster and more flexible than an actual - person with a pile of envelopes. - - - - - Quick Filter Creation - - There is an easy shortcut for fast filter or vFolder - creation. Right-click on the message in the message - list, and select one of the items under the - Create Rule from Message - submenu. - - - - - Making New Filters - - To create a new filter: - - - - Click - - Tools - Filters - - - - - - Press the Add button. - - - - - Name your filter in the Rule name field. - For each filter criterion, you must first select - which of the following parts of the message you want the filter to - examine: - - - - Sender - The sender's address. - - - - - Recipients - The recipients of the message. - - - - Subject - The subject line of the message. - - - - Specific Header - The filter can look at any header you - want, even obscure or custom ones. Enter the header name - in the first text box, and put your search text in the - second one. - - - - Repeated Headers - - If a message uses a header more than once, Evolution will - pay attention only to the first instance, even if the - message defines the header differently the second - time. For example, if a message declares the Resent-From: - header as "engineering@rupertcorp.com" and then restates - it as "marketing@rupertcorp.com," Evolution will filter as - though the second declaration had not occurred. To filter - on messages that use headers multiple times, use a regular - expression. - - - - - - - Message Body - Search in the actual text of the message. - - - - - Expression - For programmers only: match a message according to an - expression you write in the Scheme language, used to - define filters in Ximian Evolution. - - - - - - What if Multiple Filters Match One Message? - - If you have several filters that match a single message, - they will all be applied to the message, in order, unless - one of the filters has the action Stop - Processing. If you use that action in a - filter, the messages that it affects will not be touched - by other filters. - - - - - - - - Date sent - Filter messages according to the date on - which they were sent: First, choose the conditions you - want a message to meet — before - a given time, after 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 - looking for messages less than two days old. - - - - Date Received - This works the same way as the Date Sent - option, except that it compares the time you got the message - with the dates you specify. - - - - Score - Emails have a standard priority range from -3 (least - important) to 3 (most important). You can have filters set the - priority of messages you receive, and then have other filters - applied only to those messages which have a certain priority. - - - - - Size (kb) - Sorts based on the size of the message in kilobytes. - - - - - - Status - Filters according to the status of a message, such as - 'New'. - - - - - - Attachments - Create a filter based on whether or not you - have an attachment in the email. - - - - - - Mailing List - Filter based on the mailing list it came from. - - - How Does Filtering on Mailing Lists Work? - - Filtering on mailing list actually looks for a - specific mailing-list header called the - X-BeenThere - header, used to identify mailing lists or other - redistributors of mail. - - - - - - - Regex Match - If you know your way around a - regex, or - regular expression, put your knowledge to use - here. - - - - - - Source Account - Filter messages according the server you got them from. - You can enter a URL or choose one from the drop-down - list. This ability is only relevant if you use more - than one mail source. - - - - - - - - Select the criterion for the condition. If you want multiple - criteria for this filter, press Add - criterion and repeat the previous step. - - - - - Select the actions for the filter in the Then - section. You can select any of the following options. - - - Move to Folder - If you select this item, Ximian Evolution - will put the messages into a folder you specify. Click the - <click here to select a folder> button - to select a folder. - - - - Copy to Folder - If you select this item, Ximian Evolution - will put the messages into a folder you specify. Click the - <click here to select a folder> button - to select a folder. - - - - Forward to Address - Select this, enter an address, and the addressee will - get a copy of the message. - - - - Delete - Marks the message for deletion. You can still get the message - back, at least until you Expunge your - mail yourself. - - - - Stop Processing - Select this if you want to tell all other filters to ignore - this message, because whatever you've done with it so far - is plenty. - - - - Assign Color - Select this item, and Ximian Evolution - will mark the message with whatever color you please. - - - - Assign Score - If you know that all mail with - "important" somewhere in the message body line is - important, you can give it a high priority score. In a subsequent filter you can - then arrange your messages by their priority score. - - - - - - - Set Status - If you want to add multiple actions for this filter, press - Add action and repeat the previous step. - - - - - Press OK. - - - - - - - When Are Filters Applied? - - If you move mail from your server into your local system - using POP mail, filters are applied to incoming mail every - time you check for mail. - - - If you store your mail on the mail server and check your - mail with IMAP, filters are applied to the INBOX when you - open it. In some cases, you will see a number of unread - messages in the INBOX, click the INBOX, and then have the - messages move elsewhere as they are filtered out. - - - If you use Ximian Connector to store your mail on an - Exchange server, filters are not applied until you open - your INBOX folder and select - ActionsApply - Filters or press - CtrlY - - - - Using a Filter to Avoid Spam - - A good deal of bulk mail is eventually tagged with the - Precedence: Bulk header at - one point or another. Not all of it is, of course, and - there are "good" messages (mailing lists you subscribe to, - for example) that are also considered "Bulk" mail. - However, if you filter out all the mail with that header, - you'll catch a lot of the mail you don't want to get. - - - - - To catch them and automatically mark them for deletion, do - the following: - - - - Select ToolsFilters. - - - - Click New. - - - - Set the first part of your search critera to look in a Specific header. - - - - Enter Precedence as the name of the header. - - - - Choose contains at the second drop-down box. - - - - Enter Bulk as the content to search for. - You're now working with all email that has the word "Bulk" in the - "Precedence" header. - - - - For actions, select "Move to Folder" and choose the - folder where you'd like to place bulk mail. - - - If you like, add another action and - choose Delete. - - - - Click OK. You're done. - - - - - - - - - - Editing Filters - - To edit a filter: - - - - Select - - Tools - Filters - - - - - - Select the filter in the Filter Rules section - and press Edit. - - - - - Change the desired settings. - - - - - Press OK in the filter editor window. - - - - - Press OK in the filter manager window. - - - - - - - - Deleting Filters - - To delete a filter: - - - - Select - - Tools - Filters - - - - - - Select the filter and press Delete. - - - - - - - Changing Folder Names and Filters - - - - - Incoming email that your filters don't move goes - into the Inbox; outgoing mail that they don't move - ends up in the Sent folder. So be sure to change - the filters that go with it. - - - - - - - - - - - Getting Really Organized with vFolders - - If filters aren't flexible enough for you, or you find - yourself performing the same search again and again, consider - a vFolder. vFolders, or virtual folders, are an advanced way - of viewing your email messages within - Ximian Evolution. If you get a lot of - mail or often forget where you put messages, vFolders - can help you stay on top of things. - - - A vFolder is really a hybrid of all the other organizational - tools: it looks like a folder, it acts like a search, and you - set it up like a filter. In other words, while a conventional - folder actually contains messages, a vFolder is a view of - messages that may be in several different folders. The - messages it contains are determined on the fly using a set of - criteria you choose in advance. - - - - As messages that meet the vFolder criteria arrive or are - deleted, Ximian Evolution will - automatically place them in and remove them from the - vFolder contents list. When you delete a message, it gets - erased from the folder in which it actually exists, as well as - any vFolders which display it. - - - - Imagine a business trying to keep track of mail from hundreds - of vendors and clients, or a university with overlapping and - changing groups of faculty, staff, administrators and - students. The more mail you need to organize, the less you - can afford the sort of confusion that stems from an - organizational system that's not flexible enough. vFolders - make for better organization because they can accept - overlapping groups in a way that regular folders and filing - systems can't. - - - - - The "Unmatched" vFolder - - The Unmatched vFolder is the mirror of all your other - vFolders: it displays whatever messages are not matched by - other vFolders. - - - If you use remote email storage like IMAP or Microsoft - Exchange, and have created vFolders to search through them, - the Unmatched vFolder will follow your lead, and search the - remote folders as well. If you do not create any vFolders that - search in remote mail stores, the Unmatched vFolder will not - search in them either. - - - - - - Using Folders, Searches, and vFolders - - To organize his mailbox, Jim sets up a virtual volder for emails from - his friend and co-worker Anna. He has another one for messages that - have ximian.com in the address and Ximian Evolution in the subject line, so he - can keep a record of what people from work send him about - evolution. If Anna sends him a message about - anything other than Ximian Evolution, it only shows up in the "Anna" folder. - When Anna sends him mail about the user interface for - evolution, he can see that message both in - the "Anna" vFolder and in the "Internal Evolution Discussion" - vFolder. - - - - - - - Creating vFolders - - To create a vFolder: - - - - - Tools - vFolder Editor - - - - - - Click Add - - - - - Name your vFolder in the Rule name field. - - - - - - Select your search criteria. For each criterion, you - must first select which of the following parts of the - message you want the search to examine: - - - Sender - The sender's address. - - - - - Recipients - The recipients of the message. - - - - Subject - The subject line of the message. - - - - Specific Header - The vFolder can look at any header you - want, even obscure or custom ones. Enter the header name - in the first text box, and put your search text in the - second one. - - - - Message Body - Search in the actual text of the message. - - - - - Expression - For programmers only: match a message according to an - expression you write in the Scheme language, used to - define vFolders in Ximian Evolution. - - - - Date sent - Search messages according to the date on - which they were sent: First, choose the conditions you - want a message to meet — before - a given time, after 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 - looking for messages less than two days old. - - - - Date Received - This works the same way as the Date Sent - option, except that it compares the time you got the message - with the dates you specify. - - - - Score - Emails have a standard priority range from -3 (least - important) to 3 (most important). You can have vFolders set the - priority of messages you receive, and then have other - vFolders - applied only to those messages which have a certain priority. - - - - - Size (kb) - Sorts based on the size of the message in kilobytes. - - - - - - Status - Searches according to the status of a message, such as - 'New'. - - - - - - Attachments - Create a vFolder based on whether or not you have an - attachment in the email. - - - - - - Mailing List - Search based on the mailing list it came from. - - - - - - Source Account - Search messages according the server you got them from. - You can enter a URL or choose one from the drop-down - list. This ability is only relevant if you use more - than one mail source. - - - - - - - - Select the folder sources. You can select: - - - - Specific folders only - - - If you select specific folders only, you need to specify the - source folders in the box below. - - - - - - - All local folders - - - - - With all active remote folders - - - - - With all local and active folders - - - - - - - - - - Remote folders are considered active if you are connected to the - server; you must be connected to your mail server for the vFolder to - include any messages from that source. - - -
- Selecting a vFolder Rule - - Creating a vFolder Rule - - - - - - -
- - - - diff --git a/help/C/usage-mail-org.xml b/help/C/usage-mail-org.xml new file mode 100644 index 0000000000..bb21abcf17 --- /dev/null +++ b/help/C/usage-mail-org.xml @@ -0,0 +1,1129 @@ + + Organizing and Managing your Email + + Even if you only get a few email messages a day, you probably + want to sort and organize them. When you get a hundred a day + and you want to refer to a message you received six weeks ago, + you need to sort and organize them. + Fortunately, Ximian Evolution has the tools + to help you do it. + + + + Importing Your Old Email and Settings + + Evolution allows you to import old + email and data so that you don't need to worry about losing your + old information. + + + Importing Email + + Ximian Evolution can import the + following types of files: + + + VCard (.vcf, gcrd): + + + The addressbook format used by the GNOME, KDE, and + many other contact management applications. You + should be able to export to VCard format from any + address book application. + + + + + + iCalendar (.ics): + + + A format for storing calendar files. iCalendar is used by + PalmOS based handhelds, Ximian + Evolution, and Microsoft + Outlook. + + + + + + Microsoft Outlook Express 4 (.mbx): + + + Email file format used by Microsoft Outlook Express + 4. For other versions of Microsoft Outlook and Outlook Express, see + the workaround described in the note below. + + + + + + MBox (mbox): + + + The email box format used by Mozilla, Netscape, + Ximian Evolution, Eudora, and many other email clients. + + + + + + + To import your old email: + + + + Click FileImport. + + + + + Click Next after reading the Welcome screen. + + + + + Select Import a single file. + + + + + Find the file that you wish to import into Evolution. + + + + + Click Import + + + + + + + Importing Preferences + + Evolution can import all your old + mail, contacts, and other information from other applications, + making your transition to Evolution + easy. + + + To import your old information: + + + + Click FileImport. + + + + + Click Next after reading the Welcome screen. + + + + + Select Import data and settings from older programs. + + + + + The left-most column shows the application which your + information will be imported from. You then select + checkboxes on each component to import different + properties of each application. + + + + + Click Next + + + + + Click Import + + + + + + + + Microsoft Outlook and Outlook Express Users + + Microsoft Outlook, and versions of Outlook Express after + version 4, use proprietary formats that Ximian + Evolution cannot read or import. For contacts, + you may have to email them to yourself and import them that + way. For email, there is a simpler workaround: + + + + + While using Windows, import the files into Mozilla Mail (or + another mailer, such as Netscape or Eudora, that uses the + standard mbox format). + + + + + + Copy the files to the system or partition you use for + Ximian Evolution. + + + + + + Use the Ximian Evolution import + tool to import the files. There's more information about + why this works, and how, at the Ximian support website. + + + + + + + + Netscape Users + + Before importing mail from Netscape, make sure you select + FileCompact All + Folders. If you don't, + Ximian Evolution will import and undelete + the messages in your Trash folders. + + + + + + + + + Sorting Mail with Column Headers + + By default, the message list has columns with the following + headings: an envelope icon indicating whether you have read + or replied to a message, an exclamation point indicating priority, and the + From, Subject, and + Date fields. You can change their order + and remove them by dragging and dropping them. + + To add columns: + + + + Right click on the column header + + + + + Click Add a Column + + + + + Click and drag a column you want into a space between + existing column headers. A red arrow will show you where + the column will be placed. + + + + + + Right-click on one of the column headers to get a list of + options: + + + Sort Ascending: + + Sorts the messages top to bottom. + + + + + Sort Descending: + + Sorts the messages bottom to top. + + + + + Group By this Field: + + Groups messages instead of sorting them. This makes each contact + with identical properties in the specified field to be placed in + its own group and physically separated from others. + + + + + Remove this + Column: + + + Remove this column from the display. You can also remove + columns by dragging the header off the list and + letting it drop. + + + + + + Field + Chooser: + When you choose this item, a list + of column headers will appear; just drag and drop them into + place between two existing headers. A red arrow will + appear to show you where you're about to put the + column. + + + + + + + + Getting Organized with Folders + + Ximian Evolution keeps mail, as well as + address cards and calendars, in folders. You start out with a + few mail folders, such as Inbox, + Outbox, and Drafts, + but you can create as many as you like. Create new folders by + selecting New and then + Folder from the + File menu. + Ximian Evolution will as you for the name + and the type of the folder, and will provide you with a folder + tree so you can pick where it goes. + + + When you click OK, your new folder will + appear in the folder view. You can + then put messages in it by dragging and dropping them, or by + using the Move button in the + toolbar. If you want to move several messages at once, click + on the ones you want to move while holding down the + Ctrl key, or use Shift to + select a range of messages. If you create a filter with the + filter assistant, you can have mail + filed automatically. + + + + Subfolders in IMAP + + The INBOX folder on most IMAP servers cannot contain both + subfolders and messages. When you create additional folders + on your IMAP mail server, branch them from the root of the + IMAP account's folder, tree, not from INBOX. If you create + subfolders in your INBOX folder, you will lose the ability + to read messages that exist in your INBOX until you move the + folders out of the way. + + + + + + + Searching for Messages + + Most mail clients can search through your messages for you, + but Ximian Evolution does it faster. You + can search through just the message subjects, just the message + body, or both body and subject. + + + To start searching, enter a word or phrase in the text area + right below the toolbar, and choose a search type: + + + Body or subject contains: + + + This will search message subjects and the messages + themselves for the word or phrase you've entered in + the search field. + + + + + Body contains: + + + This will search only in message text, not the subject + lines. + + + + + Subject contains: + + + This will show you messages where the search text is + in the subject line. It will not search in the + message body. + + + + + Body does not contain: + + + This finds every email message that does not have the + search text in the message body. It will still show + messages that have the search text in the subject + line, if it is not also in the body. + + + + + Subject does not contain: + + + This finds every mail whose subject does not contain + the search text. + + + + + + When you've entered your search phrase, press + Enter. Ximian Evolution + will show your search results in the message list. + + + + If you think you'll want to return to a search again, you can + save it as a virtual folder by selecting Store + Search as vFolder. + + + + When you're done with the search, go back to seeing all your + messages by choosing Show All from + the Search drop-down box. If you're + sneaky, just enter a blank search: since every message has at + least one space in it, you'll see every message in the + folder. + + + + If you'd like to perform a more complex search, open the + advanced search dialog by selecting + Advanced... from the + Search drop-down menu. Then, create your + search criteria (each with the same options you saw in the + regular search bar), and decide whether you want to find + messages that match all of them, or messages that match even + one. Then, click Search to go and find + those messages. + + + + You'll see a similar approach to sorting messages when you + create filters and vFolders in the next few sections. + + + + + + Create Rules to Automatically Organize Mail + + Filters work very much like the mail room in a large company. + Their purpose is to bundle, sort, and distribute mail to the + various folders. In addition, you can have multiple filters + performing multiple actions that may effect the same message + in several ways. For example, your filters could put copies + of one message into multiple folders, or keep a copy and send + one to another person as well, and it can do that quickly. Of + course, it's also faster and more flexible than an actual + person with a pile of envelopes. + + + + + Quick Filter Creation + + There is an easy shortcut for fast filter or vFolder + creation. Right-click on the message in the message + list, and select one of the items under the + Create Rule from Message + submenu. + + + + + Making New Filters + + To create a new filter: + + + + Click + + Tools + Filters + + + + + + Press the Add button. + + + + + Name your filter in the Rule name field. + For each filter criterion, you must first select + which of the following parts of the message you want the filter to + examine: + + + + Sender - The sender's address. + + + + + Recipients - The recipients of the message. + + + + Subject - The subject line of the message. + + + + Specific Header - The filter can look at any header you + want, even obscure or custom ones. Enter the header name + in the first text box, and put your search text in the + second one. + + + + Repeated Headers + + If a message uses a header more than once, Evolution will + pay attention only to the first instance, even if the + message defines the header differently the second + time. For example, if a message declares the Resent-From: + header as "engineering@rupertcorp.com" and then restates + it as "marketing@rupertcorp.com," Evolution will filter as + though the second declaration had not occurred. To filter + on messages that use headers multiple times, use a regular + expression. + + + + + + + Message Body - Search in the actual text of the message. + + + + + Expression - For programmers only: match a message according to an + expression you write in the Scheme language, used to + define filters in Ximian Evolution. + + + + + + What if Multiple Filters Match One Message? + + If you have several filters that match a single message, + they will all be applied to the message, in order, unless + one of the filters has the action Stop + Processing. If you use that action in a + filter, the messages that it affects will not be touched + by other filters. + + + + + + + + Date sent - Filter messages according to the date on + which they were sent: First, choose the conditions you + want a message to meet -- before + a given time, after 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 + looking for messages less than two days old. + + + + Date Received - This works the same way as the Date Sent + option, except that it compares the time you got the message + with the dates you specify. + + + + Score - Emails have a standard priority range from -3 (least + important) to 3 (most important). You can have filters set the + priority of messages you receive, and then have other filters + applied only to those messages which have a certain priority. + + + + + Size (kb) - Sorts based on the size of the message in kilobytes. + + + + + + Status - Filters according to the status of a message, such as + 'New'. + + + + + + Attachments - Create a filter based on whether or not you + have an attachment in the email. + + + + + + Mailing List - Filter based on the mailing list it came from. + + + How Does Filtering on Mailing Lists Work? + + Filtering on mailing list actually looks for a + specific mailing-list header called the + X-BeenThere + header, used to identify mailing lists or other + redistributors of mail. + + + + + + + Regex Match - If you know your way around a + regex, or + regular expression, put your knowledge to use + here. + + + + + + Source Account - Filter messages according the server you got them from. + You can enter a URL or choose one from the drop-down + list. This ability is only relevant if you use more + than one mail source. + + + + + + + + Select the criterion for the condition. If you want multiple + criteria for this filter, press Add + criterion and repeat the previous step. + + + + + Select the actions for the filter in the Then + section. You can select any of the following options. + + + Move to Folder - If you select this item, Ximian Evolution + will put the messages into a folder you specify. Click the + <click here to select a folder> button + to select a folder. + + + + Copy to Folder - If you select this item, Ximian Evolution + will put the messages into a folder you specify. Click the + <click here to select a folder> button + to select a folder. + + + + Forward to Address - Select this, enter an address, and the addressee will + get a copy of the message. + + + + Delete - Marks the message for deletion. You can still get the message + back, at least until you Expunge your + mail yourself. + + + + Stop Processing - Select this if you want to tell all other filters to ignore + this message, because whatever you've done with it so far + is plenty. + + + + Assign Color - Select this item, and Ximian Evolution + will mark the message with whatever color you please. + + + + Assign Score - If you know that all mail with + "important" somewhere in the message body line is + important, you can give it a high priority score. In a subsequent filter you can + then arrange your messages by their priority score. + + + + + + + Set Status - If you want to add multiple actions for this filter, press + Add action and repeat the previous step. + + + + + Press OK. + + + + + + + When Are Filters Applied? + + If you move mail from your server into your local system + using POP mail, filters are applied to incoming mail every + time you check for mail. + + + If you store your mail on the mail server and check your + mail with IMAP, filters are applied to the INBOX when you + open it. In some cases, you will see a number of unread + messages in the INBOX, click the INBOX, and then have the + messages move elsewhere as they are filtered out. + + + If you use Ximian Connector to store your mail on an + Exchange server, filters are not applied until you open + your INBOX folder and select + ActionsApply + Filters or press + CtrlY + + + + Using a Filter to Avoid Spam + + A good deal of bulk mail is eventually tagged with the + Precedence: Bulk header at + one point or another. Not all of it is, of course, and + there are "good" messages (mailing lists you subscribe to, + for example) that are also considered "Bulk" mail. + However, if you filter out all the mail with that header, + you'll catch a lot of the mail you don't want to get. + + + + + To catch them and automatically mark them for deletion, do + the following: + + + + Select ToolsFilters. + + + + Click New. + + + + Set the first part of your search critera to look in a Specific header. + + + + Enter Precedence as the name of the header. + + + + Choose contains at the second drop-down box. + + + + Enter Bulk as the content to search for. + You're now working with all email that has the word "Bulk" in the + "Precedence" header. + + + + For actions, select "Move to Folder" and choose the + folder where you'd like to place bulk mail. + + + If you like, add another action and + choose Delete. + + + + Click OK. You're done. + + + + + + + + + + Editing Filters + + To edit a filter: + + + + Select + + Tools + Filters + + + + + + Select the filter in the Filter Rules section + and press Edit. + + + + + Change the desired settings. + + + + + Press OK in the filter editor window. + + + + + Press OK in the filter manager window. + + + + + + + + Deleting Filters + + To delete a filter: + + + + Select + + Tools + Filters + + + + + + Select the filter and press Delete. + + + + + + + Changing Folder Names and Filters + + + + + Incoming email that your filters don't move goes + into the Inbox; outgoing mail that they don't move + ends up in the Sent folder. So be sure to change + the filters that go with it. + + + + + + + + + + + Getting Really Organized with vFolders + + If filters aren't flexible enough for you, or you find + yourself performing the same search again and again, consider + a vFolder. vFolders, or virtual folders, are an advanced way + of viewing your email messages within + Ximian Evolution. If you get a lot of + mail or often forget where you put messages, vFolders + can help you stay on top of things. + + + A vFolder is really a hybrid of all the other organizational + tools: it looks like a folder, it acts like a search, and you + set it up like a filter. In other words, while a conventional + folder actually contains messages, a vFolder is a view of + messages that may be in several different folders. The + messages it contains are determined on the fly using a set of + criteria you choose in advance. + + + + As messages that meet the vFolder criteria arrive or are + deleted, Ximian Evolution will + automatically place them in and remove them from the + vFolder contents list. When you delete a message, it gets + erased from the folder in which it actually exists, as well as + any vFolders which display it. + + + + Imagine a business trying to keep track of mail from hundreds + of vendors and clients, or a university with overlapping and + changing groups of faculty, staff, administrators and + students. The more mail you need to organize, the less you + can afford the sort of confusion that stems from an + organizational system that's not flexible enough. vFolders + make for better organization because they can accept + overlapping groups in a way that regular folders and filing + systems can't. + + + + + The "Unmatched" vFolder + + The Unmatched vFolder is the mirror of all your other + vFolders: it displays whatever messages are not matched by + other vFolders. + + + If you use remote email storage like IMAP or Microsoft + Exchange, and have created vFolders to search through them, + the Unmatched vFolder will follow your lead, and search the + remote folders as well. If you do not create any vFolders that + search in remote mail stores, the Unmatched vFolder will not + search in them either. + + + + + + Using Folders, Searches, and vFolders + + To organize his mailbox, Jim sets up a virtual volder for emails from + his friend and co-worker Anna. He has another one for messages that + have ximian.com in the address and Ximian Evolution in the subject line, so he + can keep a record of what people from work send him about + evolution. If Anna sends him a message about + anything other than Ximian Evolution, it only shows up in the "Anna" folder. + When Anna sends him mail about the user interface for + evolution, he can see that message both in + the "Anna" vFolder and in the "Internal Evolution Discussion" + vFolder. + + + + + + + Creating vFolders + + To create a vFolder: + + + + + Tools + vFolder Editor + + + + + + Click Add + + + + + Name your vFolder in the Rule name field. + + + + + + Select your search criteria. For each criterion, you + must first select which of the following parts of the + message you want the search to examine: + + + Sender - The sender's address. + + + + + Recipients - The recipients of the message. + + + + Subject - The subject line of the message. + + + + Specific Header - The vFolder can look at any header you + want, even obscure or custom ones. Enter the header name + in the first text box, and put your search text in the + second one. + + + + Message Body - Search in the actual text of the message. + + + + + Expression - For programmers only: match a message according to an + expression you write in the Scheme language, used to + define vFolders in Ximian Evolution. + + + + Date sent - Search messages according to the date on + which they were sent: First, choose the conditions you + want a message to meet -- before + a given time, after 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 + looking for messages less than two days old. + + + + Date Received - This works the same way as the Date Sent + option, except that it compares the time you got the message + with the dates you specify. + + + + Score - Emails have a standard priority range from -3 (least + important) to 3 (most important). You can have vFolders set the + priority of messages you receive, and then have other + vFolders + applied only to those messages which have a certain priority. + + + + + Size (kb) - Sorts based on the size of the message in kilobytes. + + + + + + Status - Searches according to the status of a message, such as + 'New'. + + + + + + Attachments - Create a vFolder based on whether or not you have an + attachment in the email. + + + + + + Mailing List - Search based on the mailing list it came from. + + + + + + Source Account - Search messages according the server you got them from. + You can enter a URL or choose one from the drop-down + list. This ability is only relevant if you use more + than one mail source. + + + + + + + + Select the folder sources. You can select: + + + + Specific folders only + + + If you select specific folders only, you need to specify the + source folders in the box below. + + + + + + + All local folders + + + + + With all active remote folders + + + + + With all local and active folders + + + + + + + + + + Remote folders are considered active if you are connected to the + server; you must be connected to your mail server for the vFolder to + include any messages from that source. + + +
+ Selecting a vFolder Rule + + Creating a vFolder Rule + + + + + + +
+ + + + diff --git a/help/C/usage-mail.sgml b/help/C/usage-mail.sgml deleted file mode 100644 index 4ce62894c5..0000000000 --- a/help/C/usage-mail.sgml +++ /dev/null @@ -1,2209 +0,0 @@ - - Using Evolution for Email - - This chapter, and , 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 . - - - - If you use IMAP Mail - - If you chose IMAP mail during the setup process, you must - subscribe to your mail folders before you can read mail in - them. Read to find out - how. - - - - - - Reading Mail - - Start the mail client by clicking on the - Inbox 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 - - Ctrl - O - . - - - - Reading Mail with the Keyboard - - 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. - - - - - Sorting the message list - - Evolution 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 - Date to sort messages by date from - oldest to newest. Click again, and - Evolution 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 . - - - - Email Headers - - To look at the complete headers for email messages, select - ViewMessage - DisplayShow Full - Headers. To see absolutely every - bit, choose - ViewMessage - DisplayShow Email Source - . - - - - - You can also choose a threaded message view. Select - - View - Threaded - - to turn the threaded view on or off. When you select this option, - Evolution groups the replies to a - message with the original, so you can follow the thread of a - conversation from one message to the next. - -
- Threaded Mail View - - Threaded Mail View - - - - -
- - - - - Deleting Mail - - Once you've read your mail, you may want to get rid of - it. - To delete a message: - - - - Click the message to select it - - - - - Press delete button or right click on the message and - choose Delete. - - - Why do I still see deleted mail? - - When you press Delete 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. - - - If you don't like this behavior, select - ViewHide - Deleted Messages. Then, - you will only see deleted messages when you look in - your Trash folder. - - - - - - Click - - Actions - Expunge - - or press - - Ctrl - E - - - - - - - Trash is Actually a vFolder? - - 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 . Since emptying - your trash expunges the messages in your Trash folder, - choosing Actions - Empty Trash is the - same as expunging deleted mail from all - your folders. - - - 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. - - - - - Undeleting Messages - - To undelete a message: - - - - Select a message you have marked for deletion. - - - - - Press CtrlU - - or choose - - Edit - Undelete - - - - - What does Undelete actually do? - - 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. - - - - - - - - - - Checking for New Mail - - Now that you've had a look around the - Inbox, it's time to check for new mail. - Click Get Mail in the toolbar to check - your mail. If you haven't entered any mail settings yet, the - setup assistant will ask you for the - information it needs to check your email. - - - The assistant will give you several dialog boxes where you configure: - - - - your personal information - - - - - your outgoing email server information - - - - - your mail account identity name - - - - - - To check your email, press the Check Mail - button. If this is your first time checking mail, or you - haven't asked Evolution to store your - password, you'll be prompted for the password. Enter your - password and your email will be downloaded. - - - Can't Check Mail? - - 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 , or ask your - system administrator. - - - - - - - Sharing Mailboxes with Other Mail Programs - - If you want to use Evolution - and another email client, such as - Mutt, at the same time, - here's how: - - - - Download your mail in the other application as - you would normally. - - - - - In Evolution - ToolsMail - Settings, 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. - - - - - Under the Receiving Mail - tab, select the type of mail file that your - other mail application uses, and then enter the - full path to that file. - - - - - Click the OK button. - - - - - - - - - - - Working with Attachments and HTML Mail - - If someone sends you an attachment, - a file attached to an email, - Evolution 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. - - - - Saving or Opening Attachments - - If you get an attachment with an email message, - Ximian Evolution can help you save - it or open it with the appropriate applications. - - - To save an attachment to disk: - - - - Click the downward pointing arrow on the attachment icon - and select Save to Disk. - - - - - Choose a location and name for the file. - - - - - Click OK. - - - - - - - To Open an Attachment in a Program: - - - - Open the mail message with the attachment you want to read. - - - - - Click the arrow next the attachment icon. - - - - - Select the program you'd like to use. It will start up - and open the document. - - - - - - - - - - Inline Images in HTML Mail - - 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 Ximian - Evolution) Evolution - will display the image inside the message. You can create - messages like this by using the - InsertImage - tool in the message composer. - - - - If the image isn't included in the message, but is, instead, - a link to an image, Evolution can - download the image from the Internet for you. However, - Evolution 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. - - - If you want the images to load for one message, select - - View - Message Display - Load Images - . - - If you want Ximian Evolution to - load remotely hosted images more often, go to the - Display tab of the - - Tools - Mail Settings - dialog. - - - Loading Images from the Net through an HTTP Proxy - - If you use an HTTP proxy, - Evolution must be able to find - it through the gnome-vfs 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: - - - Configure it with Nautilus - - - - - - Open a Nautilus window - - - - - Select - Preferences - Edit Preferences - . - - - - - Go to the Navigation tab. - - - - - Click the Use HTTP Proxy - checkbox and enter the location of your HTTP - proxy in the Location field. - - - - - - - - Configure it with the gconftool command - - - - - - Open a terminal. - - - - - Enter the command - - gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE" - - - - - - Enter the command - - gconftool --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url" - - - - - - Enter the command - - gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080" - - - - - - - For more information about the gconftool command, - read the gconftool man page. - - - - - - - - - - - - Composing New Email Messages - - You can start writing a new email message by selecting - File - New - Mail Message, or by pressing the - Compose button in the Inbox toolbar. - When you do so, the New Message window - will open, as shown in . - - - -
- New Message Window - - Evolution Main Window - - - -
- - - - Enter an address in the To: field. If you - wish, enter a subject in the Subject:, and - a message in the box at the bottom of the window. - Once you have written your message, press - Send. - - - - Sending Composed Messages Later - - Evolution will send mail - immediately unless you tell it to do otherwise by selecting - File Send - Later. This will add your - messages to the Outbox 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 - Send/Receive in the main window. - - - To learn more about how you can specify message queue and - filter behavior, see . - - - - You can also choose to save messages as drafts or as text - files. Your options are: - - - Choose - - File - Save Draft - - to store your messages in the drafts folder for later - revision. - - - - If you'd like to have the message sent later, you - can choose Send Later. That way, - the message will be added to the queue, and you can send a - batch of messages all at once. - - - - If you prefer to save your message as a text file, - choose Save As and then choose a - file name. - - - - - - - - Working Offline - - 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. - - - Select - FileWork - Offline to have - Ximian Evolution disconnect - from the Internet while you work. When you want to - reconnect, choose - FileWork - Online. Alternativly, you - can click the connection button at the bottom left side - of the window. - - - 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. - - - 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 - Settings - Preferences and - then click the Folders icon. In - the Offline Folders tab, click the - check-box next to the folders that you would like to - use while you are offline. Then, when you select - Go Offline, Evolution will - fetch their contents and store them for later - reference. - - - - More About Mail Composition - - In the next few sections, you'll see how - Evolution handles advanced email - features, including large recipient lists, attachments, and - forwarding. - - - Attachments - - To attach a file to your email: - - - - Push the attach button in the composer toolbar - - - - - Select the file you want to attach - - - - - Press OK - - - - - - You can drag a file from your desktop into the composer window to - attach it as well. - - - To hide the display of files you've attached to the - message, select - View Hide - Attachments ; to show them - again, choose Show Attachments. - - - 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. - - - - - Specifying Recipients for Email - - Evolution, like most email - programs, recognizes three types of addressee: primary - recipients, secondary recipients, and hidden ("blind") - recipients. - - - The simplest way to direct a message is to put the email - address or addresses in the To: - field, which denotes primary recipients. To send mail to - more than one or two people, you can use the - Cc: field. - - - 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. - - - Bcc: is a little more complex. You - use it like Cc:, but people on the - Bcc: 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 Bcc: field is absent, click - - View - Bcc Field - . - - - - - 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 . - - - - Setting Reply-to On a Per-Mail Basis - - Evolution 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: - - - - Open a composer window - - - - - Open the Reply-To field by selecting - - View - Reply To - - - - - - Enter the address you wish to have be the - Reply-To address in the new Reply-To field. - - - - - - - - - Choosing Recipients Quickly - - If you have created address cards in the contact manager, - you can also enter nicknames or other portions of address - data, and Evolution 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. - - - - - - - Alternately, you can click on the - To:, Cc:, or - Bcc: 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. - - - For more information about using email together with the - contact manager and the calendar, see and . - - - - - - Replying to Email Messages - - To reply to a message, press the - Reply: button while it is selected, - or choose Reply to Sender: from - the message's right-click menu. That will open the - message composer. The - To: and Subject: - 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 . - - -
- Reply Message Window - - Evolution Main Window - - - -
- - - - If you're reading a message with several recipients, you may - wish to use Reply to All instead of - Reply. If there are large numbers - of people in the Cc: or - To: fields, this can save substantial - amounts of time. - - Using the Reply to All feature - - 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 Reply to All, but if he - just wants to tell Susan that he agrees with her, he - uses Reply. Note that his reply - will not reach anyone that Susan put on her - Bcc list, since that list is not - shared with anyone. - - - - - If you're subscribed to a mailing list, and want your reply - to go just to the list, rather than to the sender, choose - Reply to List instead of - Reply or Reply to - All. - - What is a Mailing List? - - Mailing Lists are one of the most popular tools for - group collaboration on the Internet. Here's how they work: - - - Someone sends a message to a single address, like - evolution@ximian.com. - - - That address belongs to a program that distributes - the message to a list of recipients. - - - 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. - - - Mailing list servers can also let network administrators - control mail flow, list membership, and even moderate - the content of mailing lists. - - - - - - - Searching and Replacing with the Composer - - 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 - Find Regex 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. - - - - - Find: - Enter a word or phrase, and - Evolution will find it - in your message. - - - - - Find Regex: - - - Find a regex, also called a - regular - expression, in your composer window. - - - - - - Find Again: - - Select this item to repeat the last search you performed. - - - - - Replace: - - Find a word or phrase, and replace it with - something else. - - - - - - - - For all of these menu items, you can choose whether or not - to Search Backwards 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 Case Sensitive when it determines - a match. - - - - - Enhance your email with HTML - - 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 HTML, just like web pages do. - - - HTML Mail is not a Default Setting - - 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, - Evolution sends plain text - unless you explicitly ask for HTML. - - - - You can change the format of an email message between - plain text and HTML by choosing - Format - HTML. - - - To send all your mail as HTML by default, set your mail - format preferences in the mail configuration dialog. See - for more - information. - - - 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 Insert and - Format menus. - - - The icons in the toolbar are explained in tool-tips, which appear when - you hold your mouse over the buttons. The buttons fall - into four categories: - - - Headers and lists: - - - At the left edge of the toolbar, you can choose - Normal for a default text style - or Header 1 through - Header 6 for varying sizes of - header from large (1) to tiny (6). Other styles - include preformat, to use the HTML - tag for preformatted blocks of text, and three types - of bullet points for the highly - organized. - - - Using Bullets to Make Your Email More - Attractive - - Often times, people use asterisks instead of real bullets. - Not only do asterisks look nicer, but - Evolution will word wrap for you, - which makes your text looks nicer. - - - - - - Text style: - - - 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: - - Push B for bold text - Push I for italics - Push U to underline - Push S for a strikethrough. - - - - - - Alignment: - - - 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. - - - - - - Indentation rules: - - - The button with the arrow pointing left will reduce - a paragraph's indentation, and the right arrow will - increase its indentation. - - - - - - Color Selection: - - - 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 Page. - - - - - - - The Insert gives you opinions which let you - spruce up your email to make it more interesting: - - - Link: - - - 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 Evolution - will recognize it as a link. To add a link: - - - - Select the text you wish to link from. - - - - - Right click on the text and click on Link. - - - - - Put the URL you want to use in the URL field. - - - - - Click OK. - - - - - - - If you're typing a webpage address to be automatically formatted, keep in mind that a space terminates the link. - - - - - - Image: - - - Lets you put an image alongside text. - - - To insert an image into your email: - - - - Open a new email by clicking New Message - - - - - Make sure that you have the - - Format - HTML - - selector checked. - - - - - Click the Insert Image button in the toolbar, or select - - Insert - Image - . - - - - - Choose your image by clicking the Browse button. - - - - - Press Insert to insert the image. - - - - - - - - Rule: - - - Inserts a horizontal line into the text to help divide two - sections. - - - To insert a rule: - - - - Open a new email by clicking New Message - - - - - Make sure that you have the - - Format - HTML - - selector checked. - - - - - Click the Rule button in the Toolbar. - - - - - Select the type of rule. You can use a plain - line, a 3D line, or a yellow line with flowers. - - - - - Choose the size of the line, as a percentage of the width of the email window. - - - - - - 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. - - - - - - Click Insert to insert the rule. - - - - - - - - Table: - - - Inserts a table into the text to help divide two - sections. - - - To insert a rule: - - - - Open a new email by clicking New Message - - - - - Make sure that you have the - - Format - HTML - - selector checked. - - - - - Click the Table button in the Toolbar. - - - - - Select the Template you wish to use. Each template has a slightly different feel and layout. - - - - - If you so desire, you may change the other options such as: number of rows, columns, spacing of each cell, and more. - - - - - Click the Insert button. - - - - - - - - To add a hyperlink to your HTML message: - - - - Select the text you want to display as a link. - - - - - Right click on text and select - Link - - - - - Enter the address you wish to link to in the - URL field. - - - - - Press OK. - - - - - - - To add an image to your HTML message: - - - - Select - - Insert - Image - . - - - - - Click Browse to select the image - you want to include in your email. - - - - - - 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. - - - - - - If you would like to make the image a clickable link, - enter a URL in the Link tab of the - window. - - - - - - When you are finished, press - Insert to include the image in - your message. - - - - - - You can insert an image into the background of your message by - right-clicking on the message background and selecting - Page. From that dialog, you may - also select background color and set other general options - about the html message you are composing. - - - HTML Templates - - Evolution 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. - - - To include a template into your HTML based email: - - - - Create a new email by clicking New Message. - - - - - Make sure that the - - - Format - - - HTML - - - selector is checked. - - - - - Click the HTML Template button in the - Toolbar or select - - - Insert - - - HTML Template - - - - - - - Select the template type in the - Template selection box. Your - options are Note and - Image Frame. - - - - - Set the size and alignment of the HTML template. - - - - - - Click Insert to insert it where the - cursor is. - - - - - Click on the text in the template, and enter the text - you want to use. - - - If you have selected an image frame template, - right-click on the image and select - Image to select the image - you want to place in the frame. - - - - - - - Tables in Email - - Evolution 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 - Gnumeric. - - - To include a table in your email: - - - - Create a new email by clicking New Message. - - - - - Make sure you have the - - - Format - - - HTML - - - selector checked. - - - - - - Select - - - Insert - - - Table - - - or click the Table button in the - toolbar. - - - - - - Select the template, or style, you want to use for the - table. - - - - - Set the number of rows and columns you want. - - - - - Click the Insert button. - - - - - Click in a cell and type to insert text into the table. - - - - - - You can also edit a table after creation. Just right-click - on it and select Table to open - the table editing window again. Or, you can select items - from the Table Delete and Table - Insert menus. - - - - - Deleting an Entire Table - - You can delete an entire table by right-clicking on - a table or other HTML object in a message, and selecting - - Table Delete - Table . 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. - - - - - - - - - Forwarding Mail - - 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 Forward 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 inline 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. - - - To forward a message you are reading, press - Forward on the toolbar, or select - Message - Forward . If you - prefer to forward the message inline - instead of attached, select - Message Forward - Inline 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 - composition frame, and press - Send. - - - - - Seven Tips for Email Courtesy - - - - - - - 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. - - - - - - 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! - - - - - - WRITING IN CAPITAL LETTERS MEANS YOU'RE SHOUTING! - Don't write a whole message in capital letters. It - hurts people's ears. - - - - - - Check your spelling and use complete sentences. By - default, Evolution will put - a red line beneath words it doesn't recognize, as you - type them. - - - - - - Don't send nasty emails (flames). If you get one, - don't write back. - - - - - - When you reply or forward, include just enough of - the previous message to provide context: not too - much, not too little. - - - - - - Don't send spam. - - - - - - - Making Your Email More Fancy - - Evolution 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. - - - Sections Outlined in Bold - - 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: -
- Indented Text with Headlines - - - - -
- - - 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. - - - 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. - - - - Bulleted Lists - - Select the Bulleted List option - from the text style drop-down box to begin making a bulleted - list. Evolution 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 Evolution will convert - to a well-formed plain-text bulleted list, using asterisks - instead of HTML bullets. - - - - Images In Your Email - - Images can help people to understand your point. You can - even use a HTML Picture Frame Template in - Evolution, which looks very - attractive and sets your image off from the rest of your - message with a border and caption. - - - 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. -
- Images in an email - - - - -
- - - - Coloring Your Text - - 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: - - - - Light brown - - - - - Dull purple - - - - - Dark red - - - - - Notice how these colors are similar saturation - - - Happy mailing! - - - - - - RSVPs in Mail - - If you create an event in the calendar component, you can then - send invitations to the attendee list through the - Ximian Evolution email tool. The - invitation card is sent as an attachment in iCal format. - - - If you click on the attachment button and click the - View Inline, Ximian - Evolution 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 - OK button. - - - Your options are: - - - Accept: - - - Select this entry if you will attend the meeting. When you - click the OK button, the meeting will - be entered into your calendar. - - - - - - Tentatively Accept: - - - Select this entry if you will probably attend the meeting. - When you click the OK button, the - meeting will be entered into your calendar, but marked as - tentative. - - - - - - Decline: - - - 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 OK, although your - response will be sent to the meeting host if you have - checked the RSVP box. - - - - - - RSVP: - - - Check this box if you would like your response sent to - the meeting organizers. - - - - - - - - - Subscription Management - - 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 - Evolution 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. - - - Here's how: - - - - - Select - ToolsSubscribe - to Folders. - - - - - - If you have accounts on multiple IMAP servers, select the - server where you'd like to manage your - subscriptions. Evolution will - display a list of available files and folders. - - - - - - Select a file or folder by clicking on it. You will want - to select at least the INBOX - 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. - - - - - - Click the Subscribe to add it to - the subscribed list. - - - - - When you have subscribed to the folders you want, close - the window. - - - - - - - - Encryption - - What is Encryption? - - Encryption is an ancient method of keeping information safe - from prying eyes. Evolution helps - you you protect your privacy by using - gpg, an implementation of strong - Public Key - Encryption. - - - - Public Key? Private Key? What is the difference? - - 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. - Never give your private key to anyone, - ever. Your private key lets you decrypt any - message encrypted with your public key. - - - - - 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 get - 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. - - - - You can use encryption in two different ways: - - - Encrypt the entire message, so that nobody but the recipient can read it. - - - 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. - - - - - - Sending an Encrypted Messagee - - 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 - Evolution 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. - - - - Always Sign - - You can set Evolution to always sign your email messages: - - - - Open your account preferences. - - - - - Open the Security tab. - - - - - Click the Always sign outgoing messages when using this account button. - - - - - - - - - - - Making Encryption Keys - - Before you can get or send encrypted mail, you need to - generate your public and private keys with GPG. Here's how: - - - GPG Versions - - 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: gpg - --version. - - - - - - - Open a terminal and type gpg --gen-key. - - - - - - Choose the default algorythm, "DSA and ElGamal." - - - - - - Choose a key length. The default, 1024 bits, should be - long enough. - - - - - - Decide if you want your key to expire automatically, and if so, when. - - - - - - - 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. - - - - - - 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. - - - - - - 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. - - - - - - Once the keys are generated, you can view your key information - by typing gpg --list-keys. You should see - something similar to this: - - /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] - - - - 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 - ~/.gnupg/pubring.gpg. If you want to - give other people your key, send them that file. - - - If you wish, you can upload your keys to a keyserver. Here's - how: - - - - Check your public key ID with gpg ---list-keys. It will be the string after 1024D on the line -beginning with "pub." In this example, it's 32j38dk2. - - - - - Enter the command gpg --send-keys --keyserver -wwwkeys.pgp.net 32j38dk2. Substitute your key ID for -32j38dk2. You will need your password to do this. - - - - - - Why Use a Keyserver? - - 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. - - - 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. - - - - - - - - Getting and Using Public Keys - - To encrypt a message to your someone else you'll need to use - their public key in combination with your private key. - Evolution does that for you, but - you still need to get their key and add it to your keyring. - - - To get public keys from a public key server, enter the - command: - - gpg --recv-keys --keyserver wwwkeys.pgp.net keyid - , 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, Evolution will allow you to - encrypt your messages. - - - If someone sends you their public key directly, save it as a - plain text file and enter the command gpg - filename. This will add it to your keyring. - - - - - Setting up Evolution's Encryption - - You'll need to open - - Tools - Settings - - and select the Mail Accounts button, then - select the account you want to use securely, and click the - Edit button. Then, select the - Security tab in the account dialog. In the - Security tab is a section labeled - Pretty Good Privacy. Enter your key ID - and click OK. Your key is now - integrated into your identity in - Evolution. - - - What is my Key ID again? - - Evolution requires that you know your key ID. If you don't remember it, you can find it by typing gpg --list-keys in a console window. Your key ID will be an eight character string with random numbers and letters. - - - - - - Sending Encrypted Messages - - 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: - - - - - Signing a Message - - To sign a message, choose: - - Security - PGP Sign - - . You will be prompted for your PGP password. Once you enter it, - click OK and your message will be signed. - - - - - Encrypting a Message - - Encrypting a message is very similar to signing a message. - Just choose the menu item - - Security - PGP Encrypt - - - - - Unencrypting a Received Message - - 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. - - - When you view the message, - Evolution will ask you for your - PGP password. Enter it, and the message will be displayed - properly. - - - - diff --git a/help/C/usage-mail.xml b/help/C/usage-mail.xml new file mode 100644 index 0000000000..50c2245c84 --- /dev/null +++ b/help/C/usage-mail.xml @@ -0,0 +1,2209 @@ + + Using Evolution for Email + + This chapter, and , 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 . + + + + If you use IMAP Mail + + If you chose IMAP mail during the setup process, you must + subscribe to your mail folders before you can read mail in + them. Read to find out + how. + + + + + + Reading Mail + + Start the mail client by clicking on the + Inbox 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 + + Ctrl + O + . + + + + Reading Mail with the Keyboard + + 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. + + + + + Sorting the message list + + Evolution 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 + Date to sort messages by date from + oldest to newest. Click again, and + Evolution 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 . + + + + Email Headers + + To look at the complete headers for email messages, select + ViewMessage + DisplayShow Full + Headers. To see absolutely every + bit, choose + ViewMessage + DisplayShow Email Source + . + + + + + You can also choose a threaded message view. Select + + View + Threaded + + to turn the threaded view on or off. When you select this option, + Evolution groups the replies to a + message with the original, so you can follow the thread of a + conversation from one message to the next. + +
+ Threaded Mail View + + Threaded Mail View + + + + +
+ + + + + Deleting Mail + + Once you've read your mail, you may want to get rid of + it. + To delete a message: + + + + Click the message to select it + + + + + Press delete button or right click on the message and + choose Delete. + + + Why do I still see deleted mail? + + When you press Delete 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. + + + If you don't like this behavior, select + ViewHide + Deleted Messages. Then, + you will only see deleted messages when you look in + your Trash folder. + + + + + + Click + + Actions + Expunge + + or press + + Ctrl + E + + + + + + + Trash is Actually a vFolder? + + 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 . Since emptying + your trash expunges the messages in your Trash folder, + choosing Actions + Empty Trash is the + same as expunging deleted mail from all + your folders. + + + 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. + + + + + Undeleting Messages + + To undelete a message: + + + + Select a message you have marked for deletion. + + + + + Press CtrlU + + or choose + + Edit + Undelete + + + + + What does Undelete actually do? + + 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. + + + + + + + + + + Checking for New Mail + + Now that you've had a look around the + Inbox, it's time to check for new mail. + Click Get Mail in the toolbar to check + your mail. If you haven't entered any mail settings yet, the + setup assistant will ask you for the + information it needs to check your email. + + + The assistant will give you several dialog boxes where you configure: + + + + your personal information + + + + + your outgoing email server information + + + + + your mail account identity name + + + + + + To check your email, press the Check Mail + button. If this is your first time checking mail, or you + haven't asked Evolution to store your + password, you'll be prompted for the password. Enter your + password and your email will be downloaded. + + + Can't Check Mail? + + 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 , or ask your + system administrator. + + + + + + + Sharing Mailboxes with Other Mail Programs + + If you want to use Evolution + and another email client, such as + Mutt, at the same time, + here's how: + + + + Download your mail in the other application as + you would normally. + + + + + In Evolution + ToolsMail + Settings, 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. + + + + + Under the Receiving Mail + tab, select the type of mail file that your + other mail application uses, and then enter the + full path to that file. + + + + + Click the OK button. + + + + + + + + + + + Working with Attachments and HTML Mail + + If someone sends you an attachment, + a file attached to an email, + Evolution 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. + + + + Saving or Opening Attachments + + If you get an attachment with an email message, + Ximian Evolution can help you save + it or open it with the appropriate applications. + + + To save an attachment to disk: + + + + Click the downward pointing arrow on the attachment icon + and select Save to Disk. + + + + + Choose a location and name for the file. + + + + + Click OK. + + + + + + + To Open an Attachment in a Program: + + + + Open the mail message with the attachment you want to read. + + + + + Click the arrow next the attachment icon. + + + + + Select the program you'd like to use. It will start up + and open the document. + + + + + + + + + + Inline Images in HTML Mail + + 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 Ximian + Evolution) Evolution + will display the image inside the message. You can create + messages like this by using the + InsertImage + tool in the message composer. + + + + If the image isn't included in the message, but is, instead, + a link to an image, Evolution can + download the image from the Internet for you. However, + Evolution 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. + + + If you want the images to load for one message, select + + View + Message Display + Load Images + . + + If you want Ximian Evolution to + load remotely hosted images more often, go to the + Display tab of the + + Tools + Mail Settings + dialog. + + + Loading Images from the Net through an HTTP Proxy + + If you use an HTTP proxy, + Evolution must be able to find + it through the gnome-vfs 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: + + + Configure it with Nautilus + + + + + + Open a Nautilus window + + + + + Select + Preferences + Edit Preferences + . + + + + + Go to the Navigation tab. + + + + + Click the Use HTTP Proxy + checkbox and enter the location of your HTTP + proxy in the Location field. + + + + + + + + Configure it with the gconftool command + + + + + + Open a terminal. + + + + + Enter the command + + gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE" + + + + + + Enter the command + + gconftool --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url" + + + + + + Enter the command + + gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080" + + + + + + + For more information about the gconftool command, + read the gconftool man page. + + + + + + + + + + + + Composing New Email Messages + + You can start writing a new email message by selecting + File + New + Mail Message, or by pressing the + Compose button in the Inbox toolbar. + When you do so, the New Message window + will open, as shown in . + + + +
+ New Message Window + + Evolution Main Window + + + +
+ + + + Enter an address in the To: field. If you + wish, enter a subject in the Subject:, and + a message in the box at the bottom of the window. + Once you have written your message, press + Send. + + + + Sending Composed Messages Later + + Evolution will send mail + immediately unless you tell it to do otherwise by selecting + File Send + Later. This will add your + messages to the Outbox 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 + Send/Receive in the main window. + + + To learn more about how you can specify message queue and + filter behavior, see . + + + + You can also choose to save messages as drafts or as text + files. Your options are: + + + Choose + + File + Save Draft + + to store your messages in the drafts folder for later + revision. + + + + If you'd like to have the message sent later, you + can choose Send Later. That way, + the message will be added to the queue, and you can send a + batch of messages all at once. + + + + If you prefer to save your message as a text file, + choose Save As and then choose a + file name. + + + + + + + + Working Offline + + 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. + + + Select + FileWork + Offline to have + Ximian Evolution disconnect + from the Internet while you work. When you want to + reconnect, choose + FileWork + Online. Alternativly, you + can click the connection button at the bottom left side + of the window. + + + 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. + + + 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 + Settings + Preferences and + then click the Folders icon. In + the Offline Folders tab, click the + check-box next to the folders that you would like to + use while you are offline. Then, when you select + Go Offline, Evolution will + fetch their contents and store them for later + reference. + + + + More About Mail Composition + + In the next few sections, you'll see how + Evolution handles advanced email + features, including large recipient lists, attachments, and + forwarding. + + + Attachments + + To attach a file to your email: + + + + Push the attach button in the composer toolbar + + + + + Select the file you want to attach + + + + + Press OK + + + + + + You can drag a file from your desktop into the composer window to + attach it as well. + + + To hide the display of files you've attached to the + message, select + View Hide + Attachments ; to show them + again, choose Show Attachments. + + + 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. + + + + + Specifying Recipients for Email + + Evolution, like most email + programs, recognizes three types of addressee: primary + recipients, secondary recipients, and hidden ("blind") + recipients. + + + The simplest way to direct a message is to put the email + address or addresses in the To: + field, which denotes primary recipients. To send mail to + more than one or two people, you can use the + Cc: field. + + + 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. + + + Bcc: is a little more complex. You + use it like Cc:, but people on the + Bcc: 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 Bcc: field is absent, click + + View + Bcc Field + . + + + + + 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 . + + + + Setting Reply-to On a Per-Mail Basis + + Evolution 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: + + + + Open a composer window + + + + + Open the Reply-To field by selecting + + View + Reply To + + + + + + Enter the address you wish to have be the + Reply-To address in the new Reply-To field. + + + + + + + + + Choosing Recipients Quickly + + If you have created address cards in the contact manager, + you can also enter nicknames or other portions of address + data, and Evolution 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. + + + + + + + Alternately, you can click on the + To:, Cc:, or + Bcc: 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. + + + For more information about using email together with the + contact manager and the calendar, see and . + + + + + + Replying to Email Messages + + To reply to a message, press the + Reply: button while it is selected, + or choose Reply to Sender: from + the message's right-click menu. That will open the + message composer. The + To: and Subject: + 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 . + + +
+ Reply Message Window + + Evolution Main Window + + + +
+ + + + If you're reading a message with several recipients, you may + wish to use Reply to All instead of + Reply. If there are large numbers + of people in the Cc: or + To: fields, this can save substantial + amounts of time. + + Using the Reply to All feature + + 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 Reply to All, but if he + just wants to tell Susan that he agrees with her, he + uses Reply. Note that his reply + will not reach anyone that Susan put on her + Bcc list, since that list is not + shared with anyone. + + + + + If you're subscribed to a mailing list, and want your reply + to go just to the list, rather than to the sender, choose + Reply to List instead of + Reply or Reply to + All. + + What is a Mailing List? + + Mailing Lists are one of the most popular tools for + group collaboration on the Internet. Here's how they work: + + + Someone sends a message to a single address, like + evolution@ximian.com. + + + That address belongs to a program that distributes + the message to a list of recipients. + + + 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. + + + Mailing list servers can also let network administrators + control mail flow, list membership, and even moderate + the content of mailing lists. + + + + + + + Searching and Replacing with the Composer + + 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 + Find Regex 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. + + + + + Find: + Enter a word or phrase, and + Evolution will find it + in your message. + + + + + Find Regex: + + + Find a regex, also called a + regular + expression, in your composer window. + + + + + + Find Again: + + Select this item to repeat the last search you performed. + + + + + Replace: + + Find a word or phrase, and replace it with + something else. + + + + + + + + For all of these menu items, you can choose whether or not + to Search Backwards 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 Case Sensitive when it determines + a match. + + + + + Enhance your email with HTML + + 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 HTML, just like web pages do. + + + HTML Mail is not a Default Setting + + 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, + Evolution sends plain text + unless you explicitly ask for HTML. + + + + You can change the format of an email message between + plain text and HTML by choosing + Format + HTML. + + + To send all your mail as HTML by default, set your mail + format preferences in the mail configuration dialog. See + for more + information. + + + 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 Insert and + Format menus. + + + The icons in the toolbar are explained in tool-tips, which appear when + you hold your mouse over the buttons. The buttons fall + into four categories: + + + Headers and lists: + + + At the left edge of the toolbar, you can choose + Normal for a default text style + or Header 1 through + Header 6 for varying sizes of + header from large (1) to tiny (6). Other styles + include preformat, to use the HTML + tag for preformatted blocks of text, and three types + of bullet points for the highly + organized. + + + Using Bullets to Make Your Email More + Attractive + + Often times, people use asterisks instead of real bullets. + Not only do asterisks look nicer, but + Evolution will word wrap for you, + which makes your text looks nicer. + + + + + + Text style: + + + 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: + + Push B for bold text + Push I for italics + Push U to underline + Push S for a strikethrough. + + + + + + Alignment: + + + 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. + + + + + + Indentation rules: + + + The button with the arrow pointing left will reduce + a paragraph's indentation, and the right arrow will + increase its indentation. + + + + + + Color Selection: + + + 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 Page. + + + + + + + The Insert gives you opinions which let you + spruce up your email to make it more interesting: + + + Link: + + + 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 Evolution + will recognize it as a link. To add a link: + + + + Select the text you wish to link from. + + + + + Right click on the text and click on Link. + + + + + Put the URL you want to use in the URL field. + + + + + Click OK. + + + + + + + If you're typing a webpage address to be automatically formatted, keep in mind that a space terminates the link. + + + + + + Image: + + + Lets you put an image alongside text. + + + To insert an image into your email: + + + + Open a new email by clicking New Message + + + + + Make sure that you have the + + Format + HTML + + selector checked. + + + + + Click the Insert Image button in the toolbar, or select + + Insert + Image + . + + + + + Choose your image by clicking the Browse button. + + + + + Press Insert to insert the image. + + + + + + + + Rule: + + + Inserts a horizontal line into the text to help divide two + sections. + + + To insert a rule: + + + + Open a new email by clicking New Message + + + + + Make sure that you have the + + Format + HTML + + selector checked. + + + + + Click the Rule button in the Toolbar. + + + + + Select the type of rule. You can use a plain + line, a 3D line, or a yellow line with flowers. + + + + + Choose the size of the line, as a percentage of the width of the email window. + + + + + + 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. + + + + + + Click Insert to insert the rule. + + + + + + + + Table: + + + Inserts a table into the text to help divide two + sections. + + + To insert a rule: + + + + Open a new email by clicking New Message + + + + + Make sure that you have the + + Format + HTML + + selector checked. + + + + + Click the Table button in the Toolbar. + + + + + Select the Template you wish to use. Each template has a slightly different feel and layout. + + + + + If you so desire, you may change the other options such as: number of rows, columns, spacing of each cell, and more. + + + + + Click the Insert button. + + + + + + + + To add a hyperlink to your HTML message: + + + + Select the text you want to display as a link. + + + + + Right click on text and select + Link + + + + + Enter the address you wish to link to in the + URL field. + + + + + Press OK. + + + + + + + To add an image to your HTML message: + + + + Select + + Insert + Image + . + + + + + Click Browse to select the image + you want to include in your email. + + + + + + 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. + + + + + + If you would like to make the image a clickable link, + enter a URL in the Link tab of the + window. + + + + + + When you are finished, press + Insert to include the image in + your message. + + + + + + You can insert an image into the background of your message by + right-clicking on the message background and selecting + Page. From that dialog, you may + also select background color and set other general options + about the html message you are composing. + + + HTML Templates + + Evolution 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. + + + To include a template into your HTML based email: + + + + Create a new email by clicking New Message. + + + + + Make sure that the + + + Format + + + HTML + + + selector is checked. + + + + + Click the HTML Template button in the + Toolbar or select + + + Insert + + + HTML Template + + + + + + + Select the template type in the + Template selection box. Your + options are Note and + Image Frame. + + + + + Set the size and alignment of the HTML template. + + + + + + Click Insert to insert it where the + cursor is. + + + + + Click on the text in the template, and enter the text + you want to use. + + + If you have selected an image frame template, + right-click on the image and select + Image to select the image + you want to place in the frame. + + + + + + + Tables in Email + + Evolution 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 + Gnumeric. + + + To include a table in your email: + + + + Create a new email by clicking New Message. + + + + + Make sure you have the + + + Format + + + HTML + + + selector checked. + + + + + + Select + + + Insert + + + Table + + + or click the Table button in the + toolbar. + + + + + + Select the template, or style, you want to use for the + table. + + + + + Set the number of rows and columns you want. + + + + + Click the Insert button. + + + + + Click in a cell and type to insert text into the table. + + + + + + You can also edit a table after creation. Just right-click + on it and select Table to open + the table editing window again. Or, you can select items + from the Table Delete and Table + Insert menus. + + + + + Deleting an Entire Table + + You can delete an entire table by right-clicking on + a table or other HTML object in a message, and selecting + + Table Delete + Table . 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. + + + + + + + + + Forwarding Mail + + 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 Forward 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 inline 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. + + + To forward a message you are reading, press + Forward on the toolbar, or select + Message + Forward . If you + prefer to forward the message inline + instead of attached, select + Message Forward + Inline 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 + composition frame, and press + Send. + + + + + Seven Tips for Email Courtesy + + + + + + + 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. + + + + + + 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! + + + + + + WRITING IN CAPITAL LETTERS MEANS YOU'RE SHOUTING! + Don't write a whole message in capital letters. It + hurts people's ears. + + + + + + Check your spelling and use complete sentences. By + default, Evolution will put + a red line beneath words it doesn't recognize, as you + type them. + + + + + + Don't send nasty emails (flames). If you get one, + don't write back. + + + + + + When you reply or forward, include just enough of + the previous message to provide context: not too + much, not too little. + + + + + + Don't send spam. + + + + + + + Making Your Email More Fancy + + Evolution 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. + + + Sections Outlined in Bold + + 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: +
+ Indented Text with Headlines + + + + +
+ + + 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. + + + 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. + + + + Bulleted Lists + + Select the Bulleted List option + from the text style drop-down box to begin making a bulleted + list. Evolution 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 Evolution will convert + to a well-formed plain-text bulleted list, using asterisks + instead of HTML bullets. + + + + Images In Your Email + + Images can help people to understand your point. You can + even use a HTML Picture Frame Template in + Evolution, which looks very + attractive and sets your image off from the rest of your + message with a border and caption. + + + 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. +
+ Images in an email + + + + +
+ + + + Coloring Your Text + + 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: + + + + Light brown + + + + + Dull purple + + + + + Dark red + + + + + Notice how these colors are similar saturation + + + Happy mailing! + + + + + + RSVPs in Mail + + If you create an event in the calendar component, you can then + send invitations to the attendee list through the + Ximian Evolution email tool. The + invitation card is sent as an attachment in iCal format. + + + If you click on the attachment button and click the + View Inline, Ximian + Evolution 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 + OK button. + + + Your options are: + + + Accept: + + + Select this entry if you will attend the meeting. When you + click the OK button, the meeting will + be entered into your calendar. + + + + + + Tentatively Accept: + + + Select this entry if you will probably attend the meeting. + When you click the OK button, the + meeting will be entered into your calendar, but marked as + tentative. + + + + + + Decline: + + + 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 OK, although your + response will be sent to the meeting host if you have + checked the RSVP box. + + + + + + RSVP: + + + Check this box if you would like your response sent to + the meeting organizers. + + + + + + + + + Subscription Management + + 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 + Evolution 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. + + + Here's how: + + + + + Select + ToolsSubscribe + to Folders. + + + + + + If you have accounts on multiple IMAP servers, select the + server where you'd like to manage your + subscriptions. Evolution will + display a list of available files and folders. + + + + + + Select a file or folder by clicking on it. You will want + to select at least the INBOX + 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. + + + + + + Click the Subscribe to add it to + the subscribed list. + + + + + When you have subscribed to the folders you want, close + the window. + + + + + + + + Encryption + + What is Encryption? + + Encryption is an ancient method of keeping information safe + from prying eyes. Evolution helps + you you protect your privacy by using + gpg, an implementation of strong + Public Key + Encryption. + + + + Public Key? Private Key? What is the difference? + + 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. + Never give your private key to anyone, + ever. Your private key lets you decrypt any + message encrypted with your public key. + + + + + 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 get + 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. + + + + You can use encryption in two different ways: + + + Encrypt the entire message, so that nobody but the recipient can read it. + + + 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. + + + + + + Sending an Encrypted Messagee + + 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 + Evolution 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. + + + + Always Sign + + You can set Evolution to always sign your email messages: + + + + Open your account preferences. + + + + + Open the Security tab. + + + + + Click the Always sign outgoing messages when using this account button. + + + + + + + + + + + Making Encryption Keys + + Before you can get or send encrypted mail, you need to + generate your public and private keys with GPG. Here's how: + + + GPG Versions + + 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: gpg + --version. + + + + + + + Open a terminal and type gpg --gen-key. + + + + + + Choose the default algorythm, "DSA and ElGamal." + + + + + + Choose a key length. The default, 1024 bits, should be + long enough. + + + + + + Decide if you want your key to expire automatically, and if so, when. + + + + + + + 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. + + + + + + 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. + + + + + + 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. + + + + + + Once the keys are generated, you can view your key information + by typing gpg --list-keys. You should see + something similar to this: + + /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] + + + + 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 + ~/.gnupg/pubring.gpg. If you want to + give other people your key, send them that file. + + + If you wish, you can upload your keys to a keyserver. Here's + how: + + + + Check your public key ID with gpg +--list-keys. It will be the string after 1024D on the line +beginning with "pub." In this example, it's 32j38dk2. + + + + + Enter the command gpg --send-keys --keyserver +wwwkeys.pgp.net 32j38dk2. Substitute your key ID for +32j38dk2. You will need your password to do this. + + + + + + Why Use a Keyserver? + + 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. + + + 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. + + + + + + + + Getting and Using Public Keys + + To encrypt a message to your someone else you'll need to use + their public key in combination with your private key. + Evolution does that for you, but + you still need to get their key and add it to your keyring. + + + To get public keys from a public key server, enter the + command: + + gpg --recv-keys --keyserver wwwkeys.pgp.net keyid + , 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, Evolution will allow you to + encrypt your messages. + + + If someone sends you their public key directly, save it as a + plain text file and enter the command gpg + filename. This will add it to your keyring. + + + + + Setting up Evolution's Encryption + + You'll need to open + + Tools + Settings + + and select the Mail Accounts button, then + select the account you want to use securely, and click the + Edit button. Then, select the + Security tab in the account dialog. In the + Security tab is a section labeled + Pretty Good Privacy. Enter your key ID + and click OK. Your key is now + integrated into your identity in + Evolution. + + + What is my Key ID again? + + Evolution requires that you know your key ID. If you don't remember it, you can find it by typing gpg --list-keys in a console window. Your key ID will be an eight character string with random numbers and letters. + + + + + + Sending Encrypted Messages + + 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: + + + + + Signing a Message + + To sign a message, choose: + + Security + PGP Sign + + . You will be prompted for your PGP password. Once you enter it, + click OK and your message will be signed. + + + + + Encrypting a Message + + Encrypting a message is very similar to signing a message. + Just choose the menu item + + Security + PGP Encrypt + + + + + Unencrypting a Received Message + + 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. + + + When you view the message, + Evolution will ask you for your + PGP password. Enter it, and the message will be displayed + properly. + + + + diff --git a/help/C/usage-mainwindow.sgml b/help/C/usage-mainwindow.sgml deleted file mode 100644 index 41942e798e..0000000000 --- a/help/C/usage-mainwindow.sgml +++ /dev/null @@ -1,1512 +0,0 @@ - - - Getting Started with Ximian Evolution - - - What is Ximian Evolution, and What Can It Do for Me? - - Information is useless unless it's organized and accessible; - it's hardly even worth the name if you can't look at it and be - informed. The goal of - Ximian Evolution is to make the - tasks of storing, organizing, and retrieving your personal - information easier, so you can work and communicate with - others. That is, it's a highly evolved groupware program, an integral - part of the Internet-connected desktop. - - - In other words, Ximian Evolution is - a tool to help you get your work done. - - - Ximian Evolution is Free Software. The - program and its source code are released under the terms of - the GNU General Public License - (GPL), and the documentation falls under - the Free - Documentation License (FDL). For more - information about the GPL and the FDL, visit the Free Software - Foundation's website at http://www.fsf.org. - - - - Ximian Evolution can help you work in a - group by handling email, address and other contact - information, and one or more calendars. It can do that on one - or several computers, connected directly or over a network, - for one person or for large groups. - - - - With Ximian Evolution, you can - accomplish your most common daily tasks faster. For example, it - takes only one or two clicks to enter an appointment or an - address card sent to you by email, or to send email to a contact - or appointment. Ximian Evolution - 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 VFolders, - which let you save searches as though they were ordinary mail - folders. - - - - - The First Time you Start Ximian Evolution - - To start Ximian Evolution, do either - of the following: - - - - Select Programs - Evolution from your - menu panel. - - - - - - Type evolution at the command line. - - - - - - - - Command Line Options - - Evolution has a number of command-line options that you may - wish to make use of. You can find the full list by running - the commands man evolution or - evolution --help. The most - important ones are: - - - - To start Evolution in offline mode: evolution --offline - - - - - - To start Evolution and begin composing a message to the email address you name: evolution mailto:joe@somewhere.net - - - - - - To make your web browser use Evolution as the default email client, enter evolution "%s" as the email handler in your web browser or in the GNOME Control Center. - - - - - - - - The first time you run the program, it will create a directory - called evolution in your home directory, - where it will store all of its local data. Then, it will open a - first-run assistant to help you set up mail accounts and import - data from other applications. - - - Using the first-run assistant will take approximately two to - five minutes. - - - - Defining Your Identity - - The Identity window is the first step in the assistant. Here, - you will enter some basic personal information. You can - define multiple identities later on with the - Tools - Configure tool and - clicking the Mail Accounts button. - - - - Full Name: Your full name (Example: John Doe). - - - - - Email Address: Your email address (Example: john@doe.com) - - - - - Organization: The company where you work, or the - organization you represent when you send email - (optional). - - - - - - - - Receiving Email - - The Receiving Email lets you determine - which you will get your email. - - - - Server Type: There are numerous types of servers - from which Ximian Evolution - can fetch your mail. Ask your system administrator if - you're not sure which of the following are available to - you: - - - - - POP: Downloads your email to your hard disk for - permanent storage. - - - - - Microsoft Exchange: Available only if you have - purchased the Ximian Connector for Microsoft - Exchange, this will allow you to connect to a - Microsoft Exchange 2000 server, which stores - email, calendar, and contact information on the - server. - - - - - - - IMAP: Keeps the email on your server so you can - access your email from multiple systems. - - - - - - Standard Unix mbox spools: If you want - to read and store mail in the mail spool on your - local system, choose this option. You'll need to - provide the path to the mail spool - you want to use. - - - - - - Maildir format mail directories: If you download - your mail using qmail or another maildir-style - program, you'll want to use this option. You'll need - to provide the path to the mail directory you want to - use. - - - - - MH format mail directories: If you download your - mail using mh or another MH-style program, you'll - want to use this option. You'll need to provide - the path to the mail directory you want to use. - - - - - - Local Delivery: Choose this option if you want to - move mail from the spool and store it in your home - directory. If you would rather leave mail in your - system's spool files, choose the - Standard Unix mbox - spools option instead. You'll need - to provide the path to the mail spool you want to - use. - - - - - - Directory Tree of mbox files: If you wish to use a - directory tree full of mbox files, select this - option and enter the directory you wish to - use. This option is useful if you wish to use pine - or other email clients at the same time as - Evolution, while storing mail on your local system - in mbox format. - - - - - - None: Select this if you do not plan to - check mail with this account. - - - - - - - - - - If you selected POP, Microsoft Exchange, or IMAP as your mail - server, you'll need to enter some more information: - - - - The host name of your mail server. Ask - your system administrator if you're not - sure. - - - - The username for the account on that - system. - - - - Whether you want to use a secure (SSL) - connection. If your server supports it, it's - best to enable this security option. - - - - - The authentication options supported by - your server. If you're not sure, click the - Check for supported types - button or ask your system administrator. - - - - - Whether you'd like Evolution to remember - your password. - - - - - - - Ximian Evolution Talk to Microsoft Exchange? - - If you have purchased Ximian Connector for Microsoft - Exchange, you can access Microsoft Exchange 2000 servers - natively. If you do not have the Connector, or if you use - an older version of Microsoft Exchange, talk to your system - administrator about access to standard protocol services - like POP and IMAP. - - - - - - More Mail Configuration Options - - There are more extensive options for mail preferences, - especially if you've chosen POP, Microsoft Exchange, or IMAP - as incoming mail server type. If you want to set these - options after you've created the account, you can select - Tools Configure - , click the Mail - Accounts button. Then, select the account you want - to change and click Edit. See for details. - - - - If you chose POP mail: - - - - Checking for new mail: If you would like - Evolution to check for new mail - automatically, check the box and select a frequency in - minutes. - - - - - - Message Storage: If you'd like to store copies of your - mail on the server, check this option. - - - - - - - - If you chose Microsoft Exchange: - - - Checking for new mail: If you would like - Evolution to check for new mail - automatically, check the box and select a frequency in - minutes. - - - - - Mailbox Name is Different from Login Name: If your active directory user name - is different from your Exchange mailbox name, check this - box and enter your mailbox name here. - - - - - Override Outlook Web Access Path: In most cases, - the URL for web access is - "http://server.company.com/exchange." If your - system has a path that is not "exchange," check - the box and enter the custom path here. - - - - Create a Global Address List folder: If you want to - use your organization's Active Directory or Global Address - List, leave this box checked. - - - - Active Directory Server Name: Enter the Active Directory - server name here. - - - - - Limit number of Responses: Select a maximum number - of results for an address search. A maximum number of - results limits the load on your system and on your network. - - - - - - - - If you chose IMAP: - - - - - Checking for new mail: If you would like - Evolution to check for new mail - automatically, check the box and select a frequency in - minutes. - - - - - If you want Evolution - to check for new messages in all your - IMAP folders, make sure the Check for new - messages in all folders box is selected. - - - - Show only subscribed folders: Check this box if you - have more folders in your IMAP view than you want to - read. - - - - - Override server-supplied namespace: If you like, enter a - 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 . - - - - Apply filters to new messages in INBOX on this - server: If you'd like your filters to work on this account - as well as on locally downloaded mail, check this box. - - - - - - - - - What's an IMAP Namespace? - - For IMAP mail servers, your sysadmin may provide - you with a specific namespace, the directory on - where your server stores mail for you. If you - check your IMAP mail and your folder list includes - files that don't look like mail folders, you - probably need to change your mail - namespace. Typical values are "mail" and "Mail." - 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 . - - - - - - - Sending Email - - The Sending Email step lets you configure sending - email. - - - - Server Type: There are numerous server types that - Ximian Evolution supports for sending your - mail. - - - - SMTP: Sends mail directly from your system. - - - - - - Microsoft Exchange: Sends mail through a Microsoft - Exchange server using the Microsoft Exchange 2000 - protocol. Available only if you have are using the - Ximian Connector for Microsoft Exchange. You must - have a valid license key purchased from store.ximian.com. - - - - - - Sendmail: Uses the Sendmail program to send mail - from your system. Sendmail is more flexible, but - is not as easy to configure, so you should only - select this option if you know how to set up a - Sendmail service. - - - - - - - - Host: If you chose SMTP or - Microsoft Exchange, enter the - server's name or IP address here. - - - - - Server requires authentication: If your server - requires you to enter a password to send mail, check - this box. - - - - - Authentication Type: Unless you've been told otherwise, - your best bet is to leave this set at - Password. If you're not sure, ask - your system administrator or ISP, or have - Ximian Evolution check for - you by clicking Check for supported - types. - - - - - Username: The account name you use when you login to - check your email. Normally, this is the part of your - email address before the '@' character. For Exchange - servers, it is the username you would use to log in to a - Windows workstation at your company. - - - - - Remember Password: If you prefer to not enter - your password every time you check email, press this - button. - - - - - - - - Importing Mail (Optional) - - If Ximian Evolution finds mail or - address files from another application, it will offer to - import them. If you're not sure which file format your mail - program uses, ask your system administrator. If you want, you - can skip this step and return to it at a later time by - selecting - FileImport. - - - Ximian Evolution can import the following types of - files: - - - VCard (.vcf, gcrd): - - - The addressbook format used by the GNOME, KDE, and - many other contact management applications. You - should be able to export to VCard format from any - address book application. - - - - - - Microsoft Outlook Express 4 (.mbx): - - - Email file format used by Microsoft Outlook Express -4. For other versions of Microsoft Outlook and Outlook Express, see -the workaround described in the note below. - - - - - - MBox (mbox): - - - The email box format used by Mozilla, Netscape, - Ximian Evolution, Eudora, and many other email clients. - - - - - - - - Microsoft Outlook and Outlook Express Users - - Microsoft Outlook, and versions of Outlook Express after - version 4, use proprietary formats that Ximian - Evolution cannot read or import. For contacts, - you may have to email them to yourself and import them that - way. For email, there is a simpler workaround: - - - - - While using Windows, import the files into Mozilla Mail (or - another mailer, such as Netscape or Eudora, that uses the - standard mbox format). - - - - - - Copy the files to the system or partition you use for - Ximian Evolution. - - - - - - Use the Ximian Evolution import - tool to import the files. There's more information about - why this works, and how, at the Ximian support website. - - - - - - - - Netscape Users - - Before importing mail from Netscape, make sure you select - FileCompact All - Folders. If you don't, - Ximian Evolution will import and undelete - the messages in your Trash folders. - - - - - - - Exporting Files From Ximian Evolution - - Ximian Evolution uses standard file types for all its information, - so you should have no trouble taking your information - elsewhere if you want. - - - For mail, that's mbox, for calendar, - iCal, and for the address book, vCards - in a .db3 database. - - - - - - - Importing Mail from Other Mail Clients - - Chances are, you already have your email in another mail program - and don't want to lose the information. The following section - describes how to import mail from specific mail clients. - - - Importing Mail from mutt - - mutt is a text-based mail client - which is shipped with many Linux and Unix distributions. - mutt uses the standard mbox, - maildir, and MH file formats, which makes importing your mail - into Evolution easy. By default, - mutt uses the mbox file format. - - - - Open Ximian Evolution - - - - - Click - - File - Import - - or press - - Ctrl - I - . - - - - - Click Next. - - - - - Select Import a Single File - - - - - Click Browse and select the file - you would like to import from. By default, your email - is stored in ~/mbox for the mbox - format and ~/Maildir for the Maildir format. - - - - - When prompted for what folder in - Evolution to import to, - select a folder. You can also create a new folder and - drop it in there. - - - - - - - Importing Mail from KMail - - KMail is the mail client which is shipped with the KDE desktop - environment. KMail uses the standard mbox file format, which - means that importing your mail into - Evolution is easy. - - - - Open Ximian Evolution - - - - - Click - - File - Import - - or press - - Ctrl - I - . - - - - - Click Next. - - - - - Select Import a Single File - - - - - Click Browse and select the file - you would like to import from. By default, KMail stores - its information in the Mail directory of your home - directory. - - - - - When prompted for what folder in - Evolution to import to, - select a folder. You can also create a new folder and - drop it in there. - - - - - - - - - What's What in Ximian Evolution - - Now that you've gotten the first-run configuration out of the - way, you're ready to get down to work. Here's a quick - explanation of what's going on in your main - Ximian Evolution window. - - -
- The Ximian Evolution Main Window - - Inbox - - -
- - - - Menubar - - - - The Menubar gives you access to nearly all the - features that can be found in Ximian Evolution. - - - - - Toolbar - - - - The Toolbar gives you fast and easy access to the - most used features in each component. - - - - - Shortcut Bar - - - - The Shortcut Bar lets you go to your favorite - components with the click of a click of a button. - - - - - Status Bar - - - - Periodically, Ximian Evolution will need to quietly - display a message, or tell you the progress of a task. This most - often happens when you're checking or sending email. These progress - queues are shown here, in the Status Bar. - - - - - Search Tool - - - - The Search Tool lets you search through your email - with precision so you can easily find what you're looking for. - - - - - The Shortcut Bar - - Ximian Evolution's most important job is - to give you access to your information and help you use it - quickly. One way it does that is through the - shortcut bar, the column on the left - hand side of the main window. The large buttons with names - like Inbox and - Contacts are the shortcuts, and you can - select different groups of shortcuts by clicking the - rectangular group buttons. - - - Take a look at the Shortcut Bar - The shortcut buttons in that category are: - - - - Summary: - - - Start your day here. The Ximian Evolution - Summary gives you a quick - summary of new or important messages, daily - appointments and urgent tasks. You can customize - its appearance and content, and use it to access - Ximian Evolution services. - - - - - - Inbox: - - - Click the Inbox button to start - reading your mail. Your Inbox is also where you can - access Ximian Evolution's tools to filter, sort, organize, and - search your mail. - - - - - - Calendar: - - - The Calendar can store your appointments and task lists - for you. Connected to a network, you can use it to keep - a group of people on schedule and up to date. - - - - - - Tasks: - - - A full-size view of your calendar's task pad. - - - - - - Contacts: - - - The Addressbook holds contacts, with address, phone, and - other personal information. Like calendar information, - contact data can be synchronized with hand-held devices - and shared over a network. - - - - - - - - Folders and The Folder Bar - - The folder bar is a more comprehensive - way to view the information you've stored with - Ximian Evolution. It displays all your - appointments, address cards, and email in a tree that's a lot - like a file - tree-- it starts small at the top, and branches - downwards. On most computers, there will be three or four - folders at the base. First, of course, is the - Summary, a customizable summary of your - information. Below that are your Local - Folders, which hold all the - Ximian Evolution data that's stored on your - computer. After that are your network servers: LDAP servers that host shared contact - directories, and IMAP mail - folders to which you subscribe. Lastly, there are - vFolders, or virtual folders, discussed in - , - - - - A typical Local folder contains the following folders: - - - - Calendar, for appointments and - event listings. - - - - - Contacts, for address cards. - - - - - Drafts, for messages you started and didn't finish. - - - - - Inbox, for incoming mail. - - - - - - Outbox, for messages you have written - but not yet sent. This will be empty unless you use - Ximian Evolution while offline. - - - - - - Sent, for sent mail. - - - - - - Trash, a vFolder view of all the - messages you have marked for deletion but not yet - expunged. - - - - - - - Navigating without the Folder Bar or the Shortcut Bar - - You don't need the folder bar or the shortcut bar to move - around the main window. You can use the Tab - key to switch from one part of the window to another. When - you hide the folder bar, there is a menu on the left side of - the window just below the toolbar to move about the folder - tree, even with the folder and shortcut bars hidden. - - - - - If you get large volumes of mail, you'll want more folders than - just your Inbox. To create a new folder: - - - - Select - File - New - Folder - - Shift - Ctrl - E - . - - - - - Select the name of the folder in the Folder - Name field. - - - - - Select the folder type. The available options are. - - - - Calendar - - - - - Contacts - - - - - Mail - - - - - Tasks - - - - - - - - - Choose the location of the new folder. - - - - - - - Subfolders - - Ximian Evolution lets you nest folders - inside of each other, so that you can have a detailed - organizational system. - - - - Folders Have Limits - - Calendars must go in calendar folders, mail in mail - folders, and contacts in contact folders. - - - - - Right-clicking will bring up a menu for just about anything in - Ximian Evolution. If you right-click on a - folder, you'll have a menu with the following options: - - View, to view the folder. - Open in New Window to view the folder in another window. - Move, to move the folder to another location. - Copy, to duplicate the folder. - Delete, to delete the folder and all its contents. - Rename, to change its name. - Create New Folder, to create another folder in the same location. - Add to Shortcut Bar, to add the folder to your shortcut bar. - Properties, to view or change the folder properties. - - - - You can also rearrange folders and messages by dragging and - dropping them. - - - - Any time new mail arrives in a mail folder, that folder - label is displayed in bold text, along with the number of - new messages in that folder. - - - - - - The Menu Bar - - The menu bar's contents will always - provide all the possible actions for any given view of your - data. If you're looking at your Inbox, most of the menu items - will relate to mail; some will relate to other components of - Ximian Evolution and some, especially those - in the File Menu will relate to the - application as a whole. - - - - - File: - - Anything related to a file or to the - operations of the application generally falls under this - menu: creating things, saving them to disk, printing them, - and quitting the program itself. - - - - Edit: - - The Edit menu holds - useful tools that help you edit text and move it around. - - - - - View: - - This menu lets you decide how Ximian Evolution - should look. Some of the features control the appearance of - Ximian Evolution as a whole, and others - the way a particular kind of information appears. - - - - - Actions: - - Holds actions which maybe applied to a message. Normally, - if there is only one target for the action -- for - example, replying to a message -- you can find it in - the Actions menu. - - - - - Tools: - - Tools for configuring, changing, and - setting up go here. For mail, that means things like - and the - Virtual Folder Editor. For the - Calendar and the Contact - Manager, it's color, network, and layout - configuration. - - - - - Help: - - Select among these items to open the - Help Browser - and read the Ximian Evolution manual. - - - - - - - Once you've familiarized yourself with the main - window you can start doing things with it. We'll - start with the Summary, which provides a - quick overview of your Ximian - Evolution information. - - - - Introducing the Summary - - The Ximian Evolution Summary provides you with a quick - run-down of important information: your appointments for a - given day, how much new mail you have, headlines from - selected news services, and so forth. To see the Summary, - click on the Summary button in the - shortcut bar, or select the Summary - folder in the folder bar. - - - -
- The Evolution Summary - - - - -
- - - - Weather Summary - - -Shows you the latest weather updates from hundreds of cities around the world. - - - News Feeds - - -Displays up to the minute news from your favorite websites. - - - Mail Summary - - -Shows you how many email messages you have in your selected folders, waiting to be read. - - - Calendar Summary - - -Shows you your calendar. - - - Tasks - - -Shows your pending tasks - - - - - To add additional services to your Summary, or to edit the - existing services, select - - Tools - Configure and click - the Summary Settings button. - - - - - - Introducing Email - - Ximian Evolution email is like other - email programs in several ways: - - - - It can sort and organize your mail in a wide variety of - ways with folders, searches, and filters. - - - - - It can send and receive mail in HTML or as plain text, - and makes it easy to send and receive multiple file - attachments. - - - - - It supports multiple mail sources, including IMAP, POP3, and local - mbox or mh - spools and files created by other mail programs. - - - - - It lets you guard your privacy with encryption. - - - - - - However, Ximian Evolution has some - important differences. First, it's built to handle very large - amounts of mail. Both the filtering and - searching - functions were built for speed and efficiency on large volumes - of mail. There's also the Ximian Evolution - vFolder, - an advanced organizational feature not found in mainstream - mail clients. If you get a lot of mail, or if you keep every - message you get in case you need to refer to it later, you'll - find this feature especially useful. - - - Here's what the mailer looks like: - - - -
- Ximian Evolution Mail - - Inbox - - - -
- - - - Email - Viewer - - - - This is where your email is displayed. - - - - Message List - - - - The Message List displays all the emails - that you have. This includes all your read, unread, and email - that is flagged to be deleted. - - - - If you find the view pane too small, you can resize - the pane, enlarge the whole window, or double-click on the - message in the message list to have it - open in a new window. To change the sizes of a pane, just click - and hold on the divider between the two panes. Then you can drag - up and down to select the size of the panes. - - - Just like with folders, you can right-click on messages in the - message list and get a menu of possible actions: you can move, - delete, or undelete them, and create filters or vFolders based - on them. - - - Most of the mail-related actions you'll want to perform are - listed in the Message menu in the menu bar. - The most frequently used ones, like - Reply and - Forward, also appear as buttons in - the toolbar. Almost all of them are also located in the - right-click menu and as keyboard shortcuts, which tend to be - faster once you get the hang of them. You can choose - whichever way you like best; the idea is that the software - should work the way you want, rather than making you work the - way the it does. - - - - For an in-depth guide to the email capabilities of Ximian - Evolution, read . - - - - Introducing the Calendar - - To begin using the calendar, select - Calendar from the shortcut - bar. By default, the calendar starts showing - today's schedule on a ruled background. At the upper right, - there's a monthly calendar you can use to switch days. Below - that, there's a Task pad, where you can - keep a list of tasks separate from your calendar appointments. - The day view in the calendar looks like this: - - -
- Ximian Evolution Calendar View - - Ximian Evolution Contact Manager Window - - - -
- - - - - - Appointment - List - - - - The Appointment List is responsible for showing you all of - your scheduled appointments, whether they are all day appointments or simply one time - appointments that last a half an hour. - - - - - Task List - - - - The Task List compliments the - Appointment List as it keeps track of - tasks which don't have a time associated with them. Tasks can - have complex notes associated with them, and you can also note - their completeness on a percentage scale. - - - - - Calendar Window - - - - The Calendar Window has a graphical representation of - the calendar, so you can select what days to view in the Appointment - List. - - - - For more information about the calendar - read . - - - - - Introducing the Address Book - - The Ximian Evolution address book - can handle all of the functions of an address book, phone - book, or Rolodex. Of course, it's a lot easier to update - Ximian Evolution than it is to - change an actual paper book. Ximian - Evolution also allows easy synchronization with - hand-held devices and functions with LDAP directories on a network. - - - Another advantage of the Ximian Evolution - address book is its integration with the rest of the - application. For example, you can create an address card from - an email just by right-clicking on the sender's email address. - - - To open your address book, click on - Contacts in the shortcut bar, or select - one of your contacts folders from the folder bar. shows the address book in all its - organizational glory. By default, the address book shows all - your cards in alphabetical order, in a minicard view. You can select - other views from the View menu, and adjust - the width of the columns by clicking and dragging the gray - column dividers. - - - The address book looks like this: - -
- Ximian Evolution Contact Interface - - Ximian Evolution Contact List Window - - - -
- - - Contact - List - - - The Contact List lists your contacts. - - - For detailed instructions on how to use the address book, - read . - - - - \ No newline at end of file diff --git a/help/C/usage-mainwindow.xml b/help/C/usage-mainwindow.xml new file mode 100644 index 0000000000..58a5e1f17e --- /dev/null +++ b/help/C/usage-mainwindow.xml @@ -0,0 +1,1516 @@ + + + Getting Started with Ximian Evolution + + + What is Ximian Evolution, and What Can It Do for Me? + + Information is useless unless it's organized and accessible; + it's hardly even worth the name if you can't look at it and be + informed. The goal of + Ximian Evolution is to make the + tasks of storing, organizing, and retrieving your personal + information easier, so you can work and communicate with + others. That is, it's a highly evolved groupware program, an integral + part of the Internet-connected desktop. + + + In other words, Ximian Evolution is + a tool to help you get your work done. + + + Ximian Evolution is Free Software. The + program and its source code are released under the terms of + the GNU General Public License + (GPL), and the documentation falls under + the Free + Documentation License (FDL). For more + information about the GPL and the FDL, visit the Free Software + Foundation's website at http://www.fsf.org. + + + + Ximian Evolution can help you work in a + group by handling email, address and other contact + information, and one or more calendars. It can do that on one + or several computers, connected directly or over a network, + for one person or for large groups. + + + + With Ximian Evolution, you can + accomplish your most common daily tasks faster. For example, it + takes only one or two clicks to enter an appointment or an + address card sent to you by email, or to send email to a contact + or appointment. Ximian Evolution + 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 VFolders, + which let you save searches as though they were ordinary mail + folders. + + + + + The First Time you Start Ximian Evolution + + To start Ximian Evolution, do either + of the following: + + + + Select Programs + Evolution from your + menu panel. + + + + + + Type evolution at the command line. + + + + + + + + Command Line Options + + Evolution has a number of command-line options that you may + wish to make use of. You can find the full list by running + the commands man evolution or + evolution --help. The most + important ones are: + + + + To start Evolution in offline mode: evolution --offline + + + + + + To start Evolution and begin composing a message to the email address you name: evolution mailto:joe@somewhere.net + + + + + + To make your web browser use Evolution as the default email client, enter evolution "%s" as the email handler in your web browser or in the GNOME Control Center. + + + + + + + + The first time you run the program, it will create a directory + called evolution in your home directory, + where it will store all of its local data. Then, it will open a + first-run assistant to help you set up mail accounts and import + data from other applications. + + + Using the first-run assistant will take approximately two to + five minutes. + + + + Defining Your Identity + + The Identity window is the first step in the assistant. Here, + you will enter some basic personal information. You can + define multiple identities later on with the + Tools + Configure tool and + clicking the Mail Accounts button. + + + + Full Name: Your full name (Example: John Doe). + + + + + Email Address: Your email address (Example: john@doe.com) + + + + + Organization: The company where you work, or the + organization you represent when you send email + (optional). + + + + + + + + Receiving Email + + The Receiving Email lets you determine + which you will get your email. + + + + Server Type: There are numerous types of servers + from which Ximian Evolution + can fetch your mail. Ask your system administrator if + you're not sure which of the following are available to + you: + + + + + POP: Downloads your email to your hard disk for + permanent storage. + + + + + Microsoft Exchange: Available only if you have + purchased the Ximian Connector for Microsoft + Exchange, this will allow you to connect to a + Microsoft Exchange 2000 server, which stores + email, calendar, and contact information on the + server. + + + + + + + IMAP: Keeps the email on your server so you can + access your email from multiple systems. + + + + + + Standard Unix mbox spools: If you want + to read and store mail in the mail spool on your + local system, choose this option. You'll need to + provide the path to the mail spool + you want to use. + + + + + + Maildir format mail directories: If you download + your mail using qmail or another maildir-style + program, you'll want to use this option. You'll need + to provide the path to the mail directory you want to + use. + + + + + MH format mail directories: If you download your + mail using mh or another MH-style program, you'll + want to use this option. You'll need to provide + the path to the mail directory you want to use. + + + + + + Local Delivery: Choose this option if you want to + move mail from the spool and store it in your home + directory. If you would rather leave mail in your + system's spool files, choose the + Standard Unix mbox + spools option instead. You'll need + to provide the path to the mail spool you want to + use. + + + + + + Directory Tree of mbox files: If you wish to use a + directory tree full of mbox files, select this + option and enter the directory you wish to + use. This option is useful if you wish to use pine + or other email clients at the same time as + Evolution, while storing mail on your local system + in mbox format. + + + + + + None: Select this if you do not plan to + check mail with this account. + + + + + + + + + + If you selected POP, Microsoft Exchange, or IMAP as your mail + server, you'll need to enter some more information: + + + + The host name of your mail server. Ask + your system administrator if you're not + sure. + + + + The username for the account on that + system. + + + + Whether you want to use a secure (SSL) + connection. If your server supports it, it's + best to enable this security option. + + + + + The authentication options supported by + your server. If you're not sure, click the + Check for supported types + button or ask your system administrator. + + + + + Whether you'd like Evolution to remember + your password. + + + + + + + Ximian Evolution Talk to Microsoft Exchange? + + If you have purchased Ximian Connector for Microsoft + Exchange, you can access Microsoft Exchange 2000 servers + natively. If you do not have the Connector, or if you use + an older version of Microsoft Exchange, talk to your system + administrator about access to standard protocol services + like POP and IMAP. + + + + + + More Mail Configuration Options + + There are more extensive options for mail preferences, + especially if you've chosen POP, Microsoft Exchange, or IMAP + as incoming mail server type. If you want to set these + options after you've created the account, you can select + Tools Configure + , click the Mail + Accounts button. Then, select the account you want + to change and click Edit. See for details. + + + + If you chose POP mail: + + + + Checking for new mail: If you would like + Evolution to check for new mail + automatically, check the box and select a frequency in + minutes. + + + + + + Message Storage: If you'd like to store copies of your + mail on the server, check this option. + + + + + + + + If you chose Microsoft Exchange: + + + Checking for new mail: If you would like + Evolution to check for new mail + automatically, check the box and select a frequency in + minutes. + + + + + Mailbox Name is Different from Login Name: If your active directory user name + is different from your Exchange mailbox name, check this + box and enter your mailbox name here. + + + + + Override Outlook Web Access Path: In most cases, + the URL for web access is + "http://server.company.com/exchange." If your + system has a path that is not "exchange," check + the box and enter the custom path here. + + + + Create a Global Address List folder: If you want to + use your organization's Active Directory or Global Address + List, leave this box checked. + + + + Active Directory Server Name: Enter the Active Directory + server name here. + + + + + Limit number of Responses: Select a maximum number + of results for an address search. A maximum number of + results limits the load on your system and on your network. + + + + + + + + If you chose IMAP: + + + + + Checking for new mail: If you would like + Evolution to check for new mail + automatically, check the box and select a frequency in + minutes. + + + + + If you want Evolution + to check for new messages in all your + IMAP folders, make sure the Check for new + messages in all folders box is selected. + + + + Show only subscribed folders: Check this box if you + have more folders in your IMAP view than you want to + read. + + + + + Override server-supplied namespace: If you like, enter a + 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 . + + + + Apply filters to new messages in INBOX on this + server: If you'd like your filters to work on this account + as well as on locally downloaded mail, check this box. + + + + + + + + + What's an IMAP Namespace? + + For IMAP mail servers, your sysadmin may provide + you with a specific namespace, the directory on + where your server stores mail for you. If you + check your IMAP mail and your folder list includes + files that don't look like mail folders, you + probably need to change your mail + namespace. Typical values are "mail" and "Mail." + 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 . + + + + + + + Sending Email + + The Sending Email step lets you configure sending + email. + + + + Server Type: There are numerous server types that + Ximian Evolution supports for sending your + mail. + + + + SMTP: Sends mail directly from your system. + + + + + + Microsoft Exchange: Sends mail through a Microsoft + Exchange server using the Microsoft Exchange 2000 + protocol. Available only if you have are using the + Ximian Connector for Microsoft Exchange. You must + have a valid license key purchased from store.ximian.com. + + + + + + Sendmail: Uses the Sendmail program to send mail + from your system. Sendmail is more flexible, but + is not as easy to configure, so you should only + select this option if you know how to set up a + Sendmail service. + + + + + + + + Host: If you chose SMTP or + Microsoft Exchange, enter the + server's name or IP address here. + + + + + Server requires authentication: If your server + requires you to enter a password to send mail, check + this box. + + + + + Authentication Type: Unless you've been told otherwise, + your best bet is to leave this set at + Password. If you're not sure, ask + your system administrator or ISP, or have + Ximian Evolution check for + you by clicking Check for supported + types. + + + + + Username: The account name you use when you login to + check your email. Normally, this is the part of your + email address before the '@' character. For Exchange + servers, it is the username you would use to log in to a + Windows workstation at your company. + + + + + Remember Password: If you prefer to not enter + your password every time you check email, press this + button. + + + + + + + + Importing Mail (Optional) + + If Ximian Evolution finds mail or + address files from another application, it will offer to + import them. If you're not sure which file format your mail + program uses, ask your system administrator. If you want, you + can skip this step and return to it at a later time by + selecting + FileImport. + + + Ximian Evolution can import the following types of + files: + + + VCard (.vcf, gcrd): + + + The addressbook format used by the GNOME, KDE, and + many other contact management applications. You + should be able to export to VCard format from any + address book application. + + + + + + Microsoft Outlook Express 4 (.mbx): + + + Email file format used by Microsoft Outlook Express +4. For other versions of Microsoft Outlook and Outlook Express, see +the workaround described in the note below. + + + + + + MBox (mbox): + + + The email box format used by Mozilla, Netscape, + Ximian Evolution, Eudora, and many other email clients. + + + + + + + + Microsoft Outlook and Outlook Express Users + + Microsoft Outlook, and versions of Outlook Express after + version 4, use proprietary formats that Ximian + Evolution cannot read or import. For contacts, + you may have to email them to yourself and import them that + way. For email, there is a simpler workaround: + + + + + While using Windows, import the files into Mozilla Mail (or + another mailer, such as Netscape or Eudora, that uses the + standard mbox format). + + + + + + Copy the files to the system or partition you use for + Ximian Evolution. + + + + + + Use the Ximian Evolution import + tool to import the files. There's more information about + why this works, and how, at the Ximian support website. + + + + + + + + Netscape Users + + Before importing mail from Netscape, make sure you select + FileCompact All + Folders. If you don't, + Ximian Evolution will import and undelete + the messages in your Trash folders. + + + + + + + Exporting Files From Ximian Evolution + + Ximian Evolution uses standard file types for all its information, + so you should have no trouble taking your information + elsewhere if you want. + + + For mail, that's mbox, for calendar, + iCal, and for the address book, vCards + in a .db3 database. + + + + + + + Importing Mail from Other Mail Clients + + Chances are, you already have your email in another mail program + and don't want to lose the information. The following section + describes how to import mail from specific mail clients. + + + Importing Mail from mutt + + mutt is a text-based mail client + which is shipped with many Linux and Unix distributions. + mutt uses the standard mbox, + maildir, and MH file formats, which makes importing your mail + into Evolution easy. By default, + mutt uses the mbox file format. + + + + Open Ximian Evolution + + + + + Click + + File + Import + + or press + + Ctrl + I + . + + + + + Click Next. + + + + + Select Import a Single File + + + + + Click Browse and select the file + you would like to import from. By default, your email + is stored in ~/mbox for the mbox + format and ~/Maildir for the Maildir format. + + + + + When prompted for what folder in + Evolution to import to, + select a folder. You can also create a new folder and + drop it in there. + + + + + + + Importing Mail from KMail + + KMail is the mail client which is shipped with the KDE desktop + environment. KMail uses the standard mbox file format, which + means that importing your mail into + Evolution is easy. + + + + Open Ximian Evolution + + + + + Click + + File + Import + + or press + + Ctrl + I + . + + + + + Click Next. + + + + + Select Import a Single File + + + + + Click Browse and select the file + you would like to import from. By default, KMail stores + its information in the Mail directory of your home + directory. + + + + + When prompted for what folder in + Evolution to import to, + select a folder. You can also create a new folder and + drop it in there. + + + + + + + + + What's What in Ximian Evolution + + Now that you've gotten the first-run configuration out of the + way, you're ready to get down to work. Here's a quick + explanation of what's going on in your main + Ximian Evolution window. + + +
+ The Ximian Evolution Main Window + + Inbox + + + + + + +
+ + + + + + Menubar + + + + The Menubar gives you access to nearly all the + features that can be found in Ximian Evolution. + + + + + Toolbar + + + + The Toolbar gives you fast and easy access to the + most used features in each component. + + + + + Shortcut Bar + + + + The Shortcut Bar lets you go to your favorite + components with the click of a click of a button. + + + + + Status Bar + + + + Periodically, Ximian Evolution will need to quietly + display a message, or tell you the progress of a task. This most + often happens when you're checking or sending email. These progress + queues are shown here, in the Status Bar. + + + + + Search Tool + + + + The Search Tool lets you search through your email + with precision so you can easily find what you're looking for. + + + + + The Shortcut Bar + + Ximian Evolution's most important job is + to give you access to your information and help you use it + quickly. One way it does that is through the + shortcut bar, the column on the left + hand side of the main window. The large buttons with names + like Inbox and + Contacts are the shortcuts, and you can + select different groups of shortcuts by clicking the + rectangular group buttons. + + + Take a look at the Shortcut Bar + The shortcut buttons in that category are: + + + + Summary: + + + Start your day here. The Ximian Evolution + Summary gives you a quick + summary of new or important messages, daily + appointments and urgent tasks. You can customize + its appearance and content, and use it to access + Ximian Evolution services. + + + + + + Inbox: + + + Click the Inbox button to start + reading your mail. Your Inbox is also where you can + access Ximian Evolution's tools to filter, sort, organize, and + search your mail. + + + + + + Calendar: + + + The Calendar can store your appointments and task lists + for you. Connected to a network, you can use it to keep + a group of people on schedule and up to date. + + + + + + Tasks: + + + A full-size view of your calendar's task pad. + + + + + + Contacts: + + + The Addressbook holds contacts, with address, phone, and + other personal information. Like calendar information, + contact data can be synchronized with hand-held devices + and shared over a network. + + + + + + + + Folders and The Folder Bar + + The folder bar is a more comprehensive + way to view the information you've stored with + Ximian Evolution. It displays all your + appointments, address cards, and email in a tree that's a lot + like a file + tree-- it starts small at the top, and branches + downwards. On most computers, there will be three or four + folders at the base. First, of course, is the + Summary, a customizable summary of your + information. Below that are your Local + Folders, which hold all the + Ximian Evolution data that's stored on your + computer. After that are your network servers: LDAP servers that host shared contact + directories, and IMAP mail + folders to which you subscribe. Lastly, there are + vFolders, or virtual folders, discussed in + , + + + + A typical Local folder contains the following folders: + + + + Calendar, for appointments and + event listings. + + + + + Contacts, for address cards. + + + + + Drafts, for messages you started and didn't finish. + + + + + Inbox, for incoming mail. + + + + + + Outbox, for messages you have written + but not yet sent. This will be empty unless you use + Ximian Evolution while offline. + + + + + + Sent, for sent mail. + + + + + + Trash, a vFolder view of all the + messages you have marked for deletion but not yet + expunged. + + + + + + + Navigating without the Folder Bar or the Shortcut Bar + + You don't need the folder bar or the shortcut bar to move + around the main window. You can use the Tab + key to switch from one part of the window to another. When + you hide the folder bar, there is a menu on the left side of + the window just below the toolbar to move about the folder + tree, even with the folder and shortcut bars hidden. + + + + + If you get large volumes of mail, you'll want more folders than + just your Inbox. To create a new folder: + + + + Select + File + New + Folder + + Shift + Ctrl + E + . + + + + + Select the name of the folder in the Folder + Name field. + + + + + Select the folder type. The available options are. + + + + Calendar + + + + + Contacts + + + + + Mail + + + + + Tasks + + + + + + + + + Choose the location of the new folder. + + + + + + + Subfolders + + Ximian Evolution lets you nest folders + inside of each other, so that you can have a detailed + organizational system. + + + + Folders Have Limits + + Calendars must go in calendar folders, mail in mail + folders, and contacts in contact folders. + + + + + Right-clicking will bring up a menu for just about anything in + Ximian Evolution. If you right-click on a + folder, you'll have a menu with the following options: + + View, to view the folder. + Open in New Window to view the folder in another window. + Move, to move the folder to another location. + Copy, to duplicate the folder. + Delete, to delete the folder and all its contents. + Rename, to change its name. + Create New Folder, to create another folder in the same location. + Add to Shortcut Bar, to add the folder to your shortcut bar. + Properties, to view or change the folder properties. + + + + You can also rearrange folders and messages by dragging and + dropping them. + + + + Any time new mail arrives in a mail folder, that folder + label is displayed in bold text, along with the number of + new messages in that folder. + + + + + + The Menu Bar + + The menu bar's contents will always + provide all the possible actions for any given view of your + data. If you're looking at your Inbox, most of the menu items + will relate to mail; some will relate to other components of + Ximian Evolution and some, especially those + in the File Menu will relate to the + application as a whole. + + + + + File: + + Anything related to a file or to the + operations of the application generally falls under this + menu: creating things, saving them to disk, printing them, + and quitting the program itself. + + + + Edit: + + The Edit menu holds + useful tools that help you edit text and move it around. + + + + + View: + + This menu lets you decide how Ximian Evolution + should look. Some of the features control the appearance of + Ximian Evolution as a whole, and others + the way a particular kind of information appears. + + + + + Actions: + + Holds actions which maybe applied to a message. Normally, + if there is only one target for the action -- for + example, replying to a message -- you can find it in + the Actions menu. + + + + + Tools: + + Tools for configuring, changing, and + setting up go here. For mail, that means things like + and the + Virtual Folder Editor. For the + Calendar and the Contact + Manager, it's color, network, and layout + configuration. + + + + + Help: + + Select among these items to open the + Help Browser + and read the Ximian Evolution manual. + + + + + + + Once you've familiarized yourself with the main + window you can start doing things with it. We'll + start with the Summary, which provides a + quick overview of your Ximian + Evolution information. + + + + Introducing the Summary + + The Ximian Evolution Summary provides you with a quick + run-down of important information: your appointments for a + given day, how much new mail you have, headlines from + selected news services, and so forth. To see the Summary, + click on the Summary button in the + shortcut bar, or select the Summary + folder in the folder bar. + + + +
+ The Evolution Summary + + + + +
+ + + + Weather Summary + + +Shows you the latest weather updates from hundreds of cities around the world. + + + News Feeds + + +Displays up to the minute news from your favorite websites. + + + Mail Summary + + +Shows you how many email messages you have in your selected folders, waiting to be read. + + + Calendar Summary + + +Shows you your calendar. + + + Tasks + + +Shows your pending tasks + + + + + To add additional services to your Summary, or to edit the + existing services, select + + Tools + Configure and click + the Summary Settings button. + + + + + + Introducing Email + + Ximian Evolution email is like other + email programs in several ways: + + + + It can sort and organize your mail in a wide variety of + ways with folders, searches, and filters. + + + + + It can send and receive mail in HTML or as plain text, + and makes it easy to send and receive multiple file + attachments. + + + + + It supports multiple mail sources, including IMAP, POP3, and local + mbox or mh + spools and files created by other mail programs. + + + + + It lets you guard your privacy with encryption. + + + + + + However, Ximian Evolution has some + important differences. First, it's built to handle very large + amounts of mail. Both the filtering and + searching + functions were built for speed and efficiency on large volumes + of mail. There's also the Ximian Evolution + vFolder, + an advanced organizational feature not found in mainstream + mail clients. If you get a lot of mail, or if you keep every + message you get in case you need to refer to it later, you'll + find this feature especially useful. + + + Here's what the mailer looks like: + + + +
+ Ximian Evolution Mail + + Inbox + + + +
+ + + + Email + Viewer + + + + This is where your email is displayed. + + + + Message List + + + + The Message List displays all the emails + that you have. This includes all your read, unread, and email + that is flagged to be deleted. + + + + If you find the view pane too small, you can resize + the pane, enlarge the whole window, or double-click on the + message in the message list to have it + open in a new window. To change the sizes of a pane, just click + and hold on the divider between the two panes. Then you can drag + up and down to select the size of the panes. + + + Just like with folders, you can right-click on messages in the + message list and get a menu of possible actions: you can move, + delete, or undelete them, and create filters or vFolders based + on them. + + + Most of the mail-related actions you'll want to perform are + listed in the Message menu in the menu bar. + The most frequently used ones, like + Reply and + Forward, also appear as buttons in + the toolbar. Almost all of them are also located in the + right-click menu and as keyboard shortcuts, which tend to be + faster once you get the hang of them. You can choose + whichever way you like best; the idea is that the software + should work the way you want, rather than making you work the + way the it does. + + + + For an in-depth guide to the email capabilities of Ximian + Evolution, read . + + + + Introducing the Calendar + + To begin using the calendar, select + Calendar from the shortcut + bar. By default, the calendar starts showing + today's schedule on a ruled background. At the upper right, + there's a monthly calendar you can use to switch days. Below + that, there's a Task pad, where you can + keep a list of tasks separate from your calendar appointments. + The day view in the calendar looks like this: + + +
+ Ximian Evolution Calendar View + + Ximian Evolution Contact Manager Window + + + +
+ + + + + + Appointment + List + + + + The Appointment List is responsible for showing you all of + your scheduled appointments, whether they are all day appointments or simply one time + appointments that last a half an hour. + + + + + Task List + + + + The Task List compliments the + Appointment List as it keeps track of + tasks which don't have a time associated with them. Tasks can + have complex notes associated with them, and you can also note + their completeness on a percentage scale. + + + + + Calendar Window + + + + The Calendar Window has a graphical representation of + the calendar, so you can select what days to view in the Appointment + List. + + + + For more information about the calendar + read . + + + + + Introducing the Address Book + + The Ximian Evolution address book + can handle all of the functions of an address book, phone + book, or Rolodex. Of course, it's a lot easier to update + Ximian Evolution than it is to + change an actual paper book. Ximian + Evolution also allows easy synchronization with + hand-held devices and functions with LDAP directories on a network. + + + Another advantage of the Ximian Evolution + address book is its integration with the rest of the + application. For example, you can create an address card from + an email just by right-clicking on the sender's email address. + + + To open your address book, click on + Contacts in the shortcut bar, or select + one of your contacts folders from the folder bar. shows the address book in all its + organizational glory. By default, the address book shows all + your cards in alphabetical order, in a minicard view. You can select + other views from the View menu, and adjust + the width of the columns by clicking and dragging the gray + column dividers. + + + The address book looks like this: + +
+ Ximian Evolution Contact Interface + + Ximian Evolution Contact List Window + + + +
+ + + Contact + List + + + The Contact List lists your contacts. + + + For detailed instructions on how to use the address book, + read . + + + + \ No newline at end of file diff --git a/help/C/usage-print.sgml b/help/C/usage-print.sgml deleted file mode 100644 index c36a53fe2a..0000000000 --- a/help/C/usage-print.sgml +++ /dev/null @@ -1,115 +0,0 @@ - - Printing with Evolution - - If you've printed from most any other - Gnome application, you should be able - to print from Evolution without much - trouble. - - - Whether you're printing a message, a calendar page, or a selection - of address cards, you can choose to print directly to a printer, - or save the print output to a postscript file. You can also - use the preview feature to see how your printed output will look. - - - - Print Preview - - Print Preview appears both as a button in - the printing dialog and as an item in the - File menu. In both places, it does the same - thing: it opens a new window that shows you what would happen if - you were to print the current message, calendar, appointment, or - address card. - - - That window allows you to select which pages you want to see, - and how close you'd like to look at them. Zoom in or out, fit - the page to the window (the Fit button) - or match the width of the page and the window (the - Fit Width button). None of these buttons - changes the way the page will be printed, but they do let you - get a better look. If you're satisfied with the way the your paper - looks, click Print to send your document - on its way. If you'd like to change it, just close the - Print Preview window and make the changes - you want from your mail, calendar, or addressbook. - - - - - - - - - - - - File or Printer? - - The printer selection window, shown in , lets you choose the format for - printing— Generic Postscript, - 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 - lpr) which your system uses. If you - choose to print to a file, you'll need to decide upon a - filename. And of course, you'll want to choose a number of - copies, and whether to collate them. - - - Printing to PostScript? - - PostScript is the file format used by most laser printers, - and in UNIX world is the easiest way to print to a file. - However, most systems running Microsoft Windows can't - recognize or handle PostScript files. You'll need to print - to PDF if you want to share your file with Windows users. - - - - - - - - - - - If you're printing a message that's more than one page, you'll - have the option of choosing which pages to print. If you're - printing a calendar entry, you can decide what range of dates to - print. And, if you're printing contact cards, you can decide - whether to print only the selected cards, or all of them. - - - When you're ready, click Print to print, - Preview to have a look (or another look) - at the preview, or Cancel to cancel the - whole deal. - - - - - - - - - - diff --git a/help/C/usage-print.xml b/help/C/usage-print.xml new file mode 100644 index 0000000000..a9c124e9a0 --- /dev/null +++ b/help/C/usage-print.xml @@ -0,0 +1,115 @@ + + Printing with Evolution + + If you've printed from most any other + Gnome application, you should be able + to print from Evolution without much + trouble. + + + Whether you're printing a message, a calendar page, or a selection + of address cards, you can choose to print directly to a printer, + or save the print output to a postscript file. You can also + use the preview feature to see how your printed output will look. + + + + Print Preview + + Print Preview appears both as a button in + the printing dialog and as an item in the + File menu. In both places, it does the same + thing: it opens a new window that shows you what would happen if + you were to print the current message, calendar, appointment, or + address card. + + + That window allows you to select which pages you want to see, + and how close you'd like to look at them. Zoom in or out, fit + the page to the window (the Fit button) + or match the width of the page and the window (the + Fit Width button). None of these buttons + changes the way the page will be printed, but they do let you + get a better look. If you're satisfied with the way the your paper + looks, click Print to send your document + on its way. If you'd like to change it, just close the + Print Preview window and make the changes + you want from your mail, calendar, or addressbook. + + + + + + + + + + + + File or Printer? + + The printer selection window, shown in , lets you choose the format for + printing-- Generic Postscript, + 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 + lpr) which your system uses. If you + choose to print to a file, you'll need to decide upon a + filename. And of course, you'll want to choose a number of + copies, and whether to collate them. + + + Printing to PostScript? + + PostScript is the file format used by most laser printers, + and in UNIX world is the easiest way to print to a file. + However, most systems running Microsoft Windows can't + recognize or handle PostScript files. You'll need to print + to PDF if you want to share your file with Windows users. + + + + + + + + + + + If you're printing a message that's more than one page, you'll + have the option of choosing which pages to print. If you're + printing a calendar entry, you can decide what range of dates to + print. And, if you're printing contact cards, you can decide + whether to print only the selected cards, or all of them. + + + When you're ready, click Print to print, + Preview to have a look (or another look) + at the preview, or Cancel to cancel the + whole deal. + + + + + + + + + + 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 @@ + + Synchronizing Evolution with Hand-Held Devices + + This chapter is very short. It describes how to synchronize + the data on your Palm-OS device with the data you store in + Ximian Evolution. If you need + information on how to set up handheld synchronization, consult + . + + + + Using HotSync + + Put your hand-held device in its cradle and press the + HotSync button. + + + +Palm OS v. 4.0 with Passwords + +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. + + + + If you have followed the set up instructions properly, your + Palm-OS device will synchronize data with Ximian + Evolution. + + + + That's it. + + + + diff --git a/help/ChangeLog b/help/ChangeLog index c1f9da8698..095f29fe99 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,18 @@ +2002-11-04 Aaron Weber + + * C/*.sgml: All sgml files replaced with xml files. XML files + validated. Two new XML files-- apx-fdl.xml and legal.xml + + * C/evolution-C.omf: Altered to fit the GDP template. This may now + work with the GNOME 2.0 DTD, although I could be wrong. + + * sgmldocs.make: removed and replaced with xmldocs.make. This will + break all translations until they are also ported to XML. I will + probably begin doing that tomorrow, since it's just markup and not + language stuff. + + * C/Makefile.am: added two files + 2002-10-22 Aaron Weber * C/usage-mail.sgml: Edit-->Undelete, not Actions-->Undelete diff --git a/help/sgmldocs.make b/help/sgmldocs.make deleted file mode 100644 index 2bd7c5dc1e..0000000000 --- a/help/sgmldocs.make +++ /dev/null @@ -1,144 +0,0 @@ -# To use this template: -# 1) Define: figs, docname, lang, omffile, sgml_ents although figs, -# omffile, and sgml_ents may be empty in your Makefile.am which -# will "include" this one -# 2) Figures must go under figures/ and be in PNG format -# 3) You should only have one document per directory -# -# Note that this makefile forces the directory name under -# $prefix/share/gnome/help/ to be the same as the SGML filename -# of the document. This is required by GNOME. eg: -# $prefix/share/gnome/help/fish_applet/C/fish_applet.sgml -# ^^^^^^^^^^^ ^^^^^^^^^^^ -# Definitions: -# figs A list of screenshots which will be included in EXTRA_DIST -# Note that these should reside in figures/ and should be .png -# files, or you will have to make modifications below. -# docname This is the name of the SGML file: .sgml -# lang This is the document locale -# omffile This is the name of the OMF file. Convention is to name -# it -.omf. -# sgml_ents This is a list of SGML entities which must be installed -# with the main SGML file and included in EXTRA_DIST. -# eg: -# figs = \ -# figures/fig1.png \ -# figures/fig2.png -# docname = scrollkeeper-manual -# lang = C -# omffile=scrollkeeper-manual-C.omf -# sgml_ents = fdl.sgml -# include $(top_srcdir)/help/sgmldocs.make -# dist-hook: app-dist-hook -# - -docdir = $(datadir)/gnome/help/$(docname)/$(lang) - -doc_DATA = index.html - -sgml_files = $(sgml_ents) $(docname).sgml - -omf_dir=$(top_srcdir)/omf-install - -EXTRA_DIST = $(sgml_files) $(doc_DATA) $(omffile) $(figs) - -CLEANFILES = omf_timestamp - -all: index.html omf - -omf: omf_timestamp - -omf_timestamp: $(omffile) - -for file in $(srcdir)/$(omffile); do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - scrollkeeper-preinstall $(docdir)/index.html $$file $(omf_dir)/$$basefile; \ - done - touch omf_timestamp - -index.html: $(docname)/index.html - -cp $(docname)/index.html . - -$(docname).sgml: $(sgml_ents) - -ourdir=`pwd`; \ - cd $(srcdir); \ - cp $(sgml_ents) $$ourdir - - -# The weird srcdir trick is because the db2html from the Cygnus RPMs -# cannot handle relative filenames -$(docname)/index.html: $(srcdir)/$(docname).sgml - -srcdir=`cd $(srcdir) && pwd`; \ - if test "$(HAVE_JW)" = 'yes' ; then \ - jw -c /etc/sgml/catalog $$srcdir/$(docname).sgml -o $$srcdir/$(docname); \ - else \ - db2html $$srcdir/$(docname).sgml; \ - fi - -app-dist-hook: index.html - -$(mkinstalldirs) $(distdir)/$(docname)/stylesheet-images - -$(mkinstalldirs) $(distdir)/figures - -cp $(srcdir)/$(docname)/*.html $(distdir)/$(docname) - -for file in $(srcdir)/$(docname)/*.css; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - cp $$file $(distdir)/$(docname)/$$basefile ; \ - done - -for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - cp $$file $(distdir)/$(docname)/stylesheet-images/$$basefile ; \ - done - -if [ -f topic.dat ]; then \ - cp $(srcdir)/topic.dat $(distdir); \ - fi - -install-data-am: index.html omf - -$(mkinstalldirs) $(DESTDIR)$(docdir)/stylesheet-images - -$(mkinstalldirs) $(DESTDIR)$(docdir)/figures - -$(mkinstalldirs) $(DESTDIR)$(docdir)/sgml - - -for file in $(sgml_files); do \ - $(INSTALL_DATA) $(srcdir)/$$file $(DESTDIR)$(docdir)/sgml ; \ - done - - -for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$$basefile; \ - done - -for file in $(srcdir)/figures/*.png; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/figures/$$basefile; \ - done - -for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/stylesheet-images/$$basefile; \ - done - -if [ -f $(srcdir)/topic.dat ]; then \ - $(INSTALL_DATA) $(srcdir)/topic.dat $(DESTDIR)$(docdir); \ - fi - -$(docname).ps: $(srcdir)/$(docname).sgml - -srcdir=`cd $(srcdir) && pwd`; \ - db2ps $$srcdir/$(docname).sgml - -$(docname).rtf: $(srcdir)/$(docname).sgml - -srcdir=`cd $(srcdir) && pwd`; \ - db2ps $$srcdir/$(docname).sgml - -uninstall-local: - -for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - rm -f $(docdir)/stylesheet-images/$$basefile; \ - done - -for file in $(srcdir)/figures/*.png; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - rm -f $(docdir)/figures/$$basefile; \ - done - -for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \ - basefile=`echo $$file | sed -e 's,^.*/,,'`; \ - rm -f $(DESTDIR)$(docdir)/$$basefile; \ - done - -for file in $(sgml_files); do \ - rm -f $(DESTDIR)$(docdir)/$$file; \ - done - -rmdir $(DESTDIR)$(docdir)/stylesheet-images - -rmdir $(DESTDIR)$(docdir)/figures - -rmdir $(DESTDIR)$(docdir) diff --git a/help/xmldocs.make b/help/xmldocs.make new file mode 100644 index 0000000000..5d58b28b78 --- /dev/null +++ b/help/xmldocs.make @@ -0,0 +1,96 @@ +# +# No modifications of this Makefile should be necessary. +# +# To use this template: +# 1) Define: figdir, docname, lang, omffile, and entities in +# your Makefile.am file for each document directory, +# although figdir, omffile, and entities may be empty +# 2) Make sure the Makefile in (1) also includes +# "include $(top_srcdir)/xmldocs.make" and +# "dist-hook: app-dist-hook". +# 3) Optionally define 'entities' to hold xml entities which +# you would also like installed +# 4) Figures must go under $(figdir)/ and be in PNG format +# 5) You should only have one document per directory +# 6) Note that the figure directory, $(figdir)/, should not have its +# own Makefile since this Makefile installs those figures. +# +# example Makefile.am: +# figdir = figures +# docname = scrollkeeper-manual +# lang = C +# omffile=scrollkeeper-manual-C.omf +# entities = fdl.xml +# include $(top_srcdir)/xmldocs.make +# dist-hook: app-dist-hook +# +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# + + +# ************* Begin of section some packagers may need to modify ************** +# This variable (docdir) specifies where the documents should be installed. +# This default value should work for most packages. +# docdir = $(datadir)/@PACKAGE@/doc/$(docname)/$(lang) +docdir = $(datadir)/gnome/help/$(docname)/$(lang) + +# ************** You should not have to edit below this line ******************* +xml_files = $(entities) $(docname).xml + +EXTRA_DIST = $(xml_files) $(omffile) +CLEANFILES = omf_timestamp + +# If the following file is in a subdir (like help/) you need to add that to the path +include $(top_srcdir)/omf.make + +all: omf + +$(docname).xml: $(entities) + -ourdir=`pwd`; \ + cd $(srcdir); \ + cp $(entities) $$ourdir + +app-dist-hook: + if test "$(figdir)"; then \ + $(mkinstalldirs) $(distdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(distdir)/$(figdir)/$$basefile; \ + done \ + fi + +install-data-local: omf + $(mkinstalldirs) $(DESTDIR)$(docdir) + for file in $(xml_files); do \ + cp $(srcdir)/$$file $(DESTDIR)$(docdir); \ + done + if test "$(figdir)"; then \ + $(mkinstalldirs) $(DESTDIR)$(docdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$(figdir)/$$basefile; \ + done \ + fi + +install-data-hook: install-data-hook-omf + +uninstall-local: uninstall-local-doc uninstall-local-omf + +uninstall-local-doc: + -if test "$(figdir)"; then \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + rm -f $(docdir)/$(figdir)/$$basefile; \ + done; \ + rmdir $(DESTDIR)$(docdir)/$(figdir); \ + fi + -for file in $(xml_files); do \ + rm -f $(DESTDIR)$(docdir)/$$file; \ + done + -rmdir $(DESTDIR)$(docdir) + -- cgit v1.2.3