diff --git a/help/C/Makefile.am b/help/C/Makefile.am index 8b75954a13..dcd4722512 100644 --- a/help/C/Makefile.am +++ b/help/C/Makefile.am @@ -29,26 +29,28 @@ figs = \ figures/small_desktop.png \ figures/summary.png \ figures/vfolder-createrule-fig.png - +figdir = figures docname = evolution lang = C omffile = evolution-C.omf -sgml_ents = \ - apx-authors.sgml \ - apx-bugs.sgml \ - apx-gloss.sgml \ - config-prefs.sgml \ - config-sync.sgml \ - menuref.sgml \ - preface.sgml \ - usage-calendar.sgml \ - usage-contact.sgml \ - usage-exec-summary.sgml \ - usage-exchange.sgml \ - usage-mail-org.sgml \ - usage-mail.sgml \ - usage-mainwindow.sgml \ - usage-print.sgml \ - usage-sync.sgml -include $(top_srcdir)/help/sgmldocs.make +entities = \ + apx-authors.xml \ + apx-bugs.xml \ + apx-gloss.xml \ + config-prefs.xml \ + config-sync.xml \ + menuref.xml \ + preface.xml \ + usage-calendar.xml \ + usage-contact.xml \ + usage-exec-summary.xml \ + usage-exchange.xml \ + usage-mail-org.xml \ + usage-mail.xml \ + usage-mainwindow.xml \ + usage-print.xml \ + usage-sync.xml \ + legal.xml \ + apx-fdl.xml \ +include $(top_srcdir)/help/xmldocs.make dist-hook: app-dist-hook diff --git a/help/C/apx-authors.sgml b/help/C/apx-authors.xml similarity index 100% rename from help/C/apx-authors.sgml rename to help/C/apx-authors.xml diff --git a/help/C/apx-bugs.sgml b/help/C/apx-bugs.xml similarity index 100% rename from help/C/apx-bugs.sgml rename to help/C/apx-bugs.xml diff --git a/help/C/apx-fdl.xml b/help/C/apx-fdl.xml new file mode 100644 index 0000000000..4af2a495fa --- /dev/null +++ b/help/C/apx-fdl.xml @@ -0,0 +1,667 @@ + + + + + + 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.xml similarity index 99% rename from help/C/apx-gloss.sgml rename to help/C/apx-gloss.xml index 40fa9a0ce9..e3b945e488 100644 --- a/help/C/apx-gloss.sgml +++ b/help/C/apx-gloss.xml @@ -405,7 +405,7 @@ - + SMTP: diff --git a/help/C/config-prefs.sgml b/help/C/config-prefs.xml similarity index 98% rename from help/C/config-prefs.sgml rename to help/C/config-prefs.xml index 67f1029bd3..08252a59b8 100644 --- a/help/C/config-prefs.sgml +++ b/help/C/config-prefs.xml @@ -29,7 +29,7 @@ Changing Mail Settings Changing Mail Settings - + @@ -47,7 +47,7 @@ accounts: the servers to which you connect, the way you download mail, your password authentication mode, and so forth. This is the most complex item in the list, and is - covered in . + covered in . @@ -72,7 +72,7 @@ These are overall mail reading preferences: display settings, notification options, security, and so forth. These are covered in . + linkend="config-prefs-mail-display"/>. @@ -86,7 +86,7 @@ feature here is the ability to substitute graphical smiley-faces for "emoticons" such as :) that many people use in email. This tool is covered in . + linkend="config-prefs-mail-composer"/>. @@ -351,7 +351,7 @@ smtp.omniport.com:143 specific directory where your server stores mail for you. Typical values are "mail" and "Mail." For more information about how to use IMAP mail, see . + linkend="usage-mail-subscriptions"/>. @@ -410,7 +410,7 @@ smtp.omniport.com:143 this account. Enter your PGP Key ID and decide how frequently to encrypt and sign your messages. You can learn more about PGP and encryption in . + linkend="encryption"/>. @@ -432,7 +432,7 @@ smtp.omniport.com:143 Ximian Evolution to handle inline images in HTML mail that you get. There is a detailed discussion of the issues surrounding these options in . + linkend="usage-mail-getnsend-get-attach-html"/>. To hange the font which Ximian @@ -586,14 +586,14 @@ smtp.omniport.com:143 The calendar configuration tool has two tabs General and Display, and is illustrated in . + linkend="config-prefs-cal-fig"/>.
Calendar Preferences Dialog Calendar Configuration - +
diff --git a/help/C/config-sync.sgml b/help/C/config-sync.xml similarity index 100% rename from help/C/config-sync.sgml rename to help/C/config-sync.xml diff --git a/help/C/evolution-C.omf b/help/C/evolution-C.omf index 44aae32de7..23dc3fdb86 100644 --- a/help/C/evolution-C.omf +++ b/help/C/evolution-C.omf @@ -1,16 +1,24 @@ - - 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.xml similarity index 52% rename from help/C/evolution.sgml rename to help/C/evolution.xml index 88a75bd6c0..80975cb2ba 100644 --- a/help/C/evolution.sgml +++ b/help/C/evolution.xml @@ -1,22 +1,26 @@ - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + ]> @@ -38,38 +42,15 @@ entity names correspond. APX is for appendix. --> 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. + This is version 1.4 of the Ximian Evolution manual. It describes + version 1.4 of the Ximian Evolution groupware suite. + + &LEGAL; &PREFACE; 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.xml similarity index 100% rename from help/C/menuref.sgml rename to help/C/menuref.xml diff --git a/help/C/preface.sgml b/help/C/preface.xml similarity index 99% rename from help/C/preface.sgml rename to help/C/preface.xml index c69e058917..c7ac8ef870 100644 --- a/help/C/preface.sgml +++ b/help/C/preface.xml @@ -37,7 +37,7 @@ in Text output from a computer Words - that are defined in the . + that are defined in the . @@ -116,7 +116,7 @@ Lastly, we'll have warnings, in cases where you should be careful: . Detailed help for the preferences dialogs has been added to . + linkend="config-prefs"/>. diff --git a/help/C/usage-calendar.sgml b/help/C/usage-calendar.xml similarity index 97% rename from help/C/usage-calendar.sgml rename to help/C/usage-calendar.xml index 93e4aa4d3b..dd60c54b20 100644 --- a/help/C/usage-calendar.sgml +++ b/help/C/usage-calendar.xml @@ -71,7 +71,7 @@ appointments, set alarms, and determine appointment recurrence. If you have installed the Ximian Connector for Microsoft Exchange, you can also read to learn about how to take full + linkend="full-advantage"/> to learn about how to take full advantage of the collaborative group scheduling functions available on the Microsoft Exchange Server. @@ -101,8 +101,8 @@ - Your appointment must have a starting and ending date — by - default, today — but you can choose whether to give it + Your appointment must have a starting and ending date (by + default, today) but you can choose whether to give it starting and ending times or to mark it as an 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 @@ -225,7 +225,7 @@ 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 @@ -518,15 +518,15 @@ Appointment Scheduling Window - + - + Invitee List @@ -539,7 +539,7 @@ - + Schedule Grid @@ -553,7 +553,7 @@ - + Meeting Scheduler @@ -590,7 +590,7 @@ - Read to learn about how to + Read to learn about how to use this feature with the Ximian Connector for Microsoft Exchange. diff --git a/help/C/usage-contact.sgml b/help/C/usage-contact.xml similarity index 97% rename from help/C/usage-contact.sgml rename to help/C/usage-contact.xml index ff94b3393e..3131118803 100644 --- a/help/C/usage-contact.sgml +++ b/help/C/usage-contact.xml @@ -10,7 +10,7 @@ any amount of contact information, share addresses over a network, and several ways to save time with everyday tasks. To learn about configuring the addressbook, see . You can import contacts from + linkend="config-prefs-contact"/>. You can import contacts from other contact management tools with the Import tool by selecting FileImport, @@ -89,8 +89,8 @@ Evolution Contact Editor + fileref="figures/contact-editor" format="PNG" srccredit="Aaron + Weber"/> @@ -204,7 +204,7 @@ The last item in the General tab is the Categories organization tool; for information on that, read . + linkend="usage-contact-organize"/>. The Details tab is much simpler: @@ -317,7 +317,7 @@ does, however, allow each card to fall under several categories, and allow you to create your own categories. To learn about categories, read . + linkend="usage-contact-organize-group-category"/>. - - - 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. - - - - + + 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.xml similarity index 95% rename from help/C/usage-mainwindow.sgml rename to help/C/usage-mainwindow.xml index 41942e798e..58a5e1f17e 100644 --- a/help/C/usage-mainwindow.sgml +++ b/help/C/usage-mainwindow.xml @@ -49,7 +49,7 @@ makes displays faster and more efficient, so searches are faster and memory usage is lower. People who get lots of mail will appreciate advanced features like VFolders, + linkend="usage-mail-organize-vfolders">VFolders, which let you save searches as though they were ordinary mail folders. @@ -319,7 +319,7 @@ , click the Mail Accounts button. Then, select the account you want to change and click Edit. See for details. + linkend="config-prefs-mail"/> for details. @@ -424,7 +424,7 @@ specific directory where your server stores mail for you. Typical values are "mail" and "Mail." For more information about how to use IMAP mail, see . + linkend="usage-mail-subscriptions"/>. @@ -451,7 +451,7 @@ If you prefer, you can choose to subscribe to individual mail folders one at a time. For more information about how to use IMAP mail, see . + linkend="usage-mail-subscriptions"/>. @@ -796,14 +796,18 @@ the workaround described in the note below. The Ximian Evolution Main Window Inbox - + + + + + - + + + Menubar @@ -813,7 +817,7 @@ the workaround described in the note below. - + Toolbar @@ -823,7 +827,7 @@ the workaround described in the note below. - + Shortcut Bar @@ -833,7 +837,7 @@ the workaround described in the note below. - + Status Bar @@ -845,7 +849,7 @@ the workaround described in the note below. - + Search Tool @@ -953,7 +957,7 @@ the workaround described in the note below. directories, and IMAP mail folders to which you subscribe. Lastly, there are vFolders, or virtual folders, discussed in - , + , @@ -1220,37 +1224,37 @@ the workaround described in the note below. The Evolution Summary - + - Weather Summary + Weather Summary Shows you the latest weather updates from hundreds of cities around the world. - News Feeds + News Feeds Displays up to the minute news from your favorite websites. - Mail Summary + Mail Summary Shows you how many email messages you have in your selected folders, waiting to be read. - Calendar Summary + Calendar Summary Shows you your calendar. - Tasks + Tasks Shows your pending tasks @@ -1311,7 +1315,7 @@ Shows your pending tasks searching functions were built for speed and efficiency on large volumes of mail. There's also the Ximian Evolution - vFolder, + 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 @@ -1326,7 +1330,7 @@ Shows your pending tasks Ximian Evolution Mail Inbox - + @@ -1334,7 +1338,7 @@ Shows your pending tasks Email + format="PNG"/> Email Viewer @@ -1344,7 +1348,7 @@ Shows your pending tasks Message List + format="PNG"/> Message List @@ -1383,7 +1387,7 @@ Shows your pending tasks For an in-depth guide to the email capabilities of Ximian - Evolution, read . + Evolution, read . @@ -1403,7 +1407,7 @@ Shows your pending tasks Ximian Evolution Calendar View Ximian Evolution Contact Manager Window - + @@ -1413,7 +1417,7 @@ Shows your pending tasks Appointment + format="PNG"/> Appointment List @@ -1424,7 +1428,7 @@ Shows your pending tasks - + Task List @@ -1437,7 +1441,7 @@ Shows your pending tasks - + Calendar Window @@ -1449,7 +1453,7 @@ Shows your pending tasks For more information about the calendar - read . + read . @@ -1475,7 +1479,7 @@ Shows your pending tasks 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 + linkend="usage-contact-fig"/> shows the address book in all its organizational glory. By default, the address book shows all your cards in alphabetical order, in a minicard view. You can select @@ -1490,14 +1494,14 @@ Shows your pending tasks Ximian Evolution Contact Interface Ximian Evolution Contact List Window - + Contact + format="PNG"/> Contact List @@ -1505,7 +1509,7 @@ Shows your pending tasks For detailed instructions on how to use the address book, - read . + read . diff --git a/help/C/usage-print.sgml b/help/C/usage-print.xml similarity index 95% rename from help/C/usage-print.sgml rename to help/C/usage-print.xml index c36a53fe2a..a9c124e9a0 100644 --- a/help/C/usage-print.sgml +++ b/help/C/usage-print.xml @@ -45,7 +45,7 @@ Print Preview Print Preview - + @@ -57,8 +57,8 @@ File or Printer? The printer selection window, shown in , lets you choose the format for - printing— Generic Postscript, + linkend="print-dest"/>, 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 @@ -85,7 +85,7 @@ Choosing a Printer Choosing a Printer - + 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) +