diff options
| author | pknbe <pknbe> | 2009-08-12 19:42:41 +0000 |
|---|---|---|
| committer | pknbe <pknbe> | 2009-08-12 19:42:41 +0000 |
| commit | bd952779ad427ec72c88160f2d6931ac74ed262c (patch) | |
| tree | d3f489a63efcc6d457809563005be6ef297c7567 /manual | |
| parent | 75c10dd2e36f5aba922ff1df2cef697ab068c01e (diff) | |
| download | sylpheeddoc-doc-bd952779ad427ec72c88160f2d6931ac74ed262c.tar.gz sylpheeddoc-doc-bd952779ad427ec72c88160f2d6931ac74ed262c.tar.xz sylpheeddoc-doc-bd952779ad427ec72c88160f2d6931ac74ed262c.zip | |
Finished porting to DocBook XML.
Diffstat (limited to 'manual')
| -rw-r--r-- | manual/en/ChangeLog | 4 | ||||
| -rw-r--r-- | manual/en/fdl.xml | 416 | ||||
| -rw-r--r-- | manual/en/manual.xml | 105 | ||||
| -rw-r--r-- | manual/en/manual_001.xml | 338 | ||||
| -rw-r--r-- | manual/en/manual_002.xml | 80 | ||||
| -rw-r--r-- | manual/en/manual_003.xml | 34 | ||||
| -rw-r--r-- | manual/en/manual_004.xml | 189 | ||||
| -rw-r--r-- | manual/en/manual_005.xml | 92 | ||||
| -rw-r--r-- | manual/en/manual_006.xml | 730 | ||||
| -rw-r--r-- | manual/en/manual_007.xml | 140 | ||||
| -rw-r--r-- | manual/en/manual_008.xml | 710 | ||||
| -rw-r--r-- | manual/en/manual_009.xml | 99 | ||||
| -rw-r--r-- | manual/en/manual_010.xml | 23 | ||||
| -rw-r--r-- | manual/en/manual_011.xml | 42 | ||||
| -rw-r--r-- | manual/en/manual_012.xml | 317 | ||||
| -rw-r--r-- | manual/en/manual_013.xml | 667 | ||||
| -rw-r--r-- | manual/en/manual_014.xml | 155 | ||||
| -rw-r--r-- | manual/en/manual_015.xml | 38 | ||||
| -rw-r--r-- | manual/en/manual_016.xml | 78 | ||||
| -rw-r--r-- | manual/en/manual_017.xml | 295 | ||||
| -rw-r--r-- | manual/en/manual_018.xml | 7 | ||||
| -rw-r--r-- | manual/en/manual_019.xml | 57 | ||||
| -rw-r--r-- | manual/en/manual_020.xml | 49 |
23 files changed, 3806 insertions, 859 deletions
diff --git a/manual/en/ChangeLog b/manual/en/ChangeLog index 2a01b10..e989f57 100644 --- a/manual/en/ChangeLog +++ b/manual/en/ChangeLog @@ -1,3 +1,7 @@ +2009-08-12 Petr Kovar <pknbe@volny.cz> + + * *.xml: Finished porting to DocBook XML. + 2004-03-22 * In syl_001.sgml, included the changes submitted by diff --git a/manual/en/fdl.xml b/manual/en/fdl.xml index 6db14c0..a10eb98 100644 --- a/manual/en/fdl.xml +++ b/manual/en/fdl.xml @@ -1,91 +1,77 @@ -<appendix id="gfdl"> -<appendixinfo> -<title>GNU Free Documentation License</title> - - <pubdate>Version 1.2, November 2002</pubdate> - <copyright><year>2000,2001,2002</year> - <holder>Free Software Foundation, Inc.</holder></copyright> - <legalnotice id="gfdl-legalnotice"> - <para><address>Free Software Foundation, Inc. - <street>51 Franklin St, Fifth Floor</street>, - <city>Boston</city>, - <state>MA</state> - <postcode>02110-1301</postcode> - <country>USA</country> - </address></para> - <para>Everyone is permitted to copy and distribute verbatim copies +<?xml version='1.0' encoding='UTF-8'?><appendix id="sylpheed-21"> + <appendixinfo> + <title>GNU Free Documentation License</title> + <pubdate>Version 1.2, November 2002</pubdate> + <copyright> + <year>2000,2001,2002</year> + <holder>Free Software Foundation, Inc.</holder> + </copyright> + <legalnotice id="gfdl-legalnotice"> + <para><address>Free Software Foundation, Inc. <street>51 Franklin St, Fifth Floor</street>, <city>Boston</city>, <state>MA</state><postcode>02110-1301</postcode><country>USA</country></address></para> + <para>Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.</para> - </legalnotice> - <releaseinfo>Version 1.2, November 2002</releaseinfo> -</appendixinfo> - -<title>GNU Free Documentation License</title> -<section id="gfdl-0"><title>PREAMBLE</title> - -<para>The purpose of this License is to make a manual, textbook, or -other functional and useful document "free" in the sense of freedom: to + </legalnotice> + <releaseinfo>Version 1.2, November 2002</releaseinfo> + </appendixinfo> + <title>GNU Free Documentation License</title> + <section id="gfdl-0"> + <title>PREAMBLE</title> + <para>The purpose of this License is to make a manual, textbook, or +other functional and useful 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.</para> - -<para>This License is a kind of "copyleft", which means that derivative + <para>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.</para> - -<para>We have designed this License in order to use it for manuals for + <para>We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.</para> -</section> - -<section id="gfdl-1"><title>APPLICABILITY AND DEFINITIONS</title> - -<para id="gfdl-doc">This License applies to any manual or other work, in + </section> + <section id="gfdl-1"> + <title>APPLICABILITY AND DEFINITIONS</title> + <para id="gfdl-doc">This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use -that work under the conditions stated herein. The "Document", below, +that work under the conditions stated herein. The "Document", below, refers to any such manual or work. Any member of the public is a -licensee, and is addressed as "you". You accept the license if you +licensee, and is addressed as "you". You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.</para> - -<para id="gfdl-mod-ver">A "Modified Version" of the Document means any + <para id="gfdl-mod-ver">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.</para> - -<para id="gfdl-secnd-sect">A "Secondary Section" is a named appendix or + <para id="gfdl-secnd-sect">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 +Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.</para> - -<para id="gfdl-inv-sect">The "Invariant Sections" are certain Secondary + <para id="gfdl-inv-sect">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. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.</para> - -<para id="gfdl-cov-text">The "Cover Texts" are certain short passages of + <para id="gfdl-cov-text">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 Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.</para> - -<para id="gfdl-transparent">A "Transparent" copy of the Document means a + <para id="gfdl-transparent">A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images @@ -96,10 +82,9 @@ for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any -substantial amount of text. A copy that is not "Transparent" is called -"Opaque".</para> - -<para>Examples of suitable formats for Transparent copies include plain +substantial amount of text. A copy that is not "Transparent" is called +"Opaque".</para> + <para>Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of @@ -109,34 +94,30 @@ proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.</para> - -<para id="gfdl-title-page">The "Title Page" means, for a printed book, + <para id="gfdl-title-page">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 +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.</para> - -<para id="gfdl-entitled">A section "Entitled XYZ" means a named subunit + <para id="gfdl-entitled">A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as -"Acknowledgements", "Dedications", "Endorsements", or "History".) To -"Preserve the Title" of such a section when you modify the Document -means that it remains a section "Entitled XYZ" according to this +"Acknowledgements", "Dedications", "Endorsements", or "History".) To +"Preserve the Title" of such a section when you modify the Document +means that it remains a section "Entitled XYZ" according to this definition.</para> - -<para>The Document may include Warranty Disclaimers next to the notice + <para>The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.</para> -</section> - -<section id="gfdl-2"><title>VERBATIM COPYING</title> - -<para>You may copy and distribute the Document in any medium, either + </section> + <section id="gfdl-2"> + <title>VERBATIM COPYING</title> + <para>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 @@ -146,16 +127,14 @@ 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. </para> - -<para>You may also lend copies, under the same conditions stated above, + <para>You may also lend copies, under the same conditions stated above, and you may publicly display copies.</para> -</section> - -<section id="gfdl-3"><title>COPYING IN QUANTITY</title> - -<para>If you publish printed copies (or copies in media that commonly + </section> + <section id="gfdl-3"> + <title>COPYING IN QUANTITY</title> + <para>If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the -Document's license notice requires Cover Texts, you must enclose 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 @@ -165,13 +144,11 @@ 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.</para> - -<para>If the required texts for either cover are too voluminous to fit + <para>If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.</para> - -<para>If you publish or distribute Opaque copies of the Document + <para>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 computer-network location from which the general @@ -183,103 +160,80 @@ to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.</para> - -<para>It is requested, but not required, that you contact the authors of + <para>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.</para> -</section> - -<section id="gfdl-4"><title>MODIFICATIONS</title> - -<para>You may copy and distribute a Modified Version of the Document + </section> + <section id="gfdl-4"> + <title>MODIFICATIONS</title> + <para>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:</para> - -<orderedlist id="gfdl-modif-cond" numeration="upperalpha"> - <title>GNU FDL Modification Conditions</title> -<listitem><simpara>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. -</simpara></listitem> -<listitem><simpara>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 fewer - than five), unless they release you from this requirement. -</simpara></listitem> -<listitem><simpara>State on the Title page the name of the publisher of - the Modified Version, as the publisher.</simpara></listitem> -<listitem><simpara>Preserve all the copyright notices of the Document. -</simpara></listitem> -<listitem><simpara>Add an appropriate copyright notice for your - modifications adjacent to the other copyright notices. -</simpara></listitem> -<listitem><simpara>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 - <link linkend="gfdl-addendum">Addendum</link> below. -</simpara></listitem> -<listitem><simpara>Preserve in that license notice the full lists of - Invariant Sections and required Cover Texts given in the Document's - license notice.</simpara></listitem> -<listitem><simpara>Include an unaltered copy of this License. -</simpara></listitem> -<listitem><simpara>Preserve the section Entitled "History", Preserve 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. -</simpara></listitem> -<listitem><simpara>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. -</simpara></listitem> -<listitem><simpara>For any section Entitled "Acknowledgements" or - "Dedications", Preserve the Title of the section, and preserve in the - section all the substance and tone of each of the contributor - acknowledgements and/or dedications given therein. -</simpara></listitem> -<listitem><simpara>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. -</simpara></listitem> -<listitem><simpara>Delete any section Entitled "Endorsements". - Such a section may not be included in the Modified Version. -</simpara></listitem> -<listitem><simpara>Do not retitle any existing section to be Entitled - "Endorsements" or to conflict in title with any Invariant Section. -</simpara></listitem> -<listitem><simpara>Preserve any Warranty Disclaimers. -</simpara></listitem> -</orderedlist> - -<para>If the Modified Version includes new front-matter sections or + <orderedlist numeration="upperalpha" id="gfdl-modif-cond"> + <title>GNU FDL Modification Conditions</title> + <listitem> + <simpara>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. </simpara> + </listitem> + <listitem> + <simpara>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 fewer than five), unless they release you from this requirement. </simpara> + </listitem> + <listitem> + <simpara>State on the Title page the name of the publisher of the Modified Version, as the publisher.</simpara> + </listitem> + <listitem> + <simpara>Preserve all the copyright notices of the Document. </simpara> + </listitem> + <listitem> + <simpara>Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. </simpara> + </listitem> + <listitem> + <simpara>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 <link linkend="gfdl-addendum">Addendum</link> below. </simpara> + </listitem> + <listitem> + <simpara>Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.</simpara> + </listitem> + <listitem> + <simpara>Include an unaltered copy of this License. </simpara> + </listitem> + <listitem> + <simpara>Preserve the section Entitled "History", Preserve 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. </simpara> + </listitem> + <listitem> + <simpara>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. </simpara> + </listitem> + <listitem> + <simpara>For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. </simpara> + </listitem> + <listitem> + <simpara>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. </simpara> + </listitem> + <listitem> + <simpara>Delete any section Entitled "Endorsements". Such a section may not be included in the Modified Version. </simpara> + </listitem> + <listitem> + <simpara>Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with any Invariant Section. </simpara> + </listitem> + <listitem> + <simpara>Preserve any Warranty Disclaimers. </simpara> + </listitem> + </orderedlist> + <para>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. +list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.</para> - -<para>You may add a section Entitled "Endorsements", provided it + <para>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.</para> - -<para>You may add a passage of up to five words as a Front-Cover Text, + <para>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 @@ -288,23 +242,19 @@ a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.</para> - -<para>The author(s) and publisher(s) of the Document do not by this + <para>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.</para> -</section> - -<section id="gfdl-5"><title>COMBINING DOCUMENTS</title> - -<para>You may combine the Document with other documents released under -this License, under the terms defined in <link linkend="gfdl-4">section -4</link> above for modified versions, provided that you include in the + </section> + <section id="gfdl-5"> + <title>COMBINING DOCUMENTS</title> + <para>You may combine the Document with other documents released under +this License, under the terms defined in <link linkend="gfdl-4">section 4</link> 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, and that you preserve all their Warranty Disclaimers.</para> - -<para>The combined work need only contain one copy of this License, and + <para>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 @@ -312,53 +262,47 @@ at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.</para> - -<para>In the combination, you must combine any sections Entitled -"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".</para> -</section> - -<section id="gfdl-6"><title>COLLECTIONS OF DOCUMENTS</title> - -<para>You may make a collection consisting of the Document and other + <para>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".</para> + </section> + <section id="gfdl-6"> + <title>COLLECTIONS OF DOCUMENTS</title> + <para>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.</para> - -<para>You may extract a single document from such a collection, and + <para>You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.</para> -</section> - -<section id="gfdl-7"><title>AGGREGATION WITH INDEPENDENT WORKS</title> - -<para>A compilation of the Document or its derivatives with other + </section> + <section id="gfdl-7"> + <title>AGGREGATION WITH INDEPENDENT WORKS</title> + <para>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, is called an "aggregate" if the +storage or distribution medium, is called an "aggregate" if the copyright resulting from the compilation is not used to limit the legal -rights of the compilation's users beyond what the individual works +rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.</para> - -<para>If the Cover Text requirement of section 3 is applicable to these + <para>If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of -the entire aggregate, the Document's Cover Texts may be placed on covers +the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.</para> -</section> - -<section id="gfdl-8"><title>TRANSLATION</title> - -<para>Translation is considered a kind of modification, so you may + </section> + <section id="gfdl-8"> + <title>TRANSLATION</title> + <para>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 @@ -370,77 +314,69 @@ the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.</para> - -<para>If a section in the Document is Entitled "Acknowledgements", -"Dedications", or "History", the requirement (section 4) to Preserve its + <para>If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.</para> -</section> - -<section id="gfdl-9"><title>TERMINATION</title> - -<para>You may not copy, modify, sublicense, or distribute the Document + </section> + <section id="gfdl-9"> + <title>TERMINATION</title> + <para>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.</para> -</section> - -<section id="gfdl-10"><title>FUTURE REVISIONS OF THIS LICENSE</title> - -<para>The Free Software Foundation may publish new, revised versions of + </section> + <section id="gfdl-10"> + <title>FUTURE REVISIONS OF THIS LICENSE</title> + <para>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/.</para> - -<para>Each version of the License is given a distinguishing version + <para>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 +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.</para> -</section> - -<section id="gfdl-addendum"><title>ADDENDUM: How to use this License for - your documents</title> - -<para>To use this License in a document you have written, include a copy + </section> + <section id="gfdl-addendum"> + <title>ADDENDUM: How to use this License for your documents</title> + <para>To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:</para> - -<blockquote id="copyright-sample"> - <title>Sample Invariant Sections list</title><para> + <blockquote id="copyright-sample"> + <title>Sample Invariant Sections list</title> + <para> Copyright (c) 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.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. - A copy of the license is included in the section entitled "GNU - Free Documentation License". -</para></blockquote> - -<para>If you have Invariant Sections, Front-Cover Texts and Back-Cover -Texts, replace the "with...Texts." line with this:</para> - -<blockquote id="inv-cover-sample"> - <title>Sample Invariant Sections list</title> -<para> + A copy of the license is included in the section entitled "GNU + Free Documentation License". +</para> + </blockquote> + <para>If you have Invariant Sections, Front-Cover Texts and Back-Cover +Texts, replace the "with...Texts." line with this:</para> + <blockquote id="inv-cover-sample"> + <title>Sample Invariant Sections list</title> + <para> with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. -</para></blockquote> - -<para>If you have Invariant Sections without Cover Texts, or some other +</para> + </blockquote> + <para>If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation.</para> - -<para>If your document contains nontrivial examples of program code, we + <para>If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.</para> -</section> -</appendix> + </section> +</appendix>
\ No newline at end of file diff --git a/manual/en/manual.xml b/manual/en/manual.xml index 3a55792..46e33a4 100644 --- a/manual/en/manual.xml +++ b/manual/en/manual.xml @@ -1,71 +1,94 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" -"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ +<?xml version='1.0' encoding='UTF-8'?> +<!-- This document was created with Syntext Serna Free. --><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ <!ENTITY __chapter__001 SYSTEM "manual_001.xml"> <!ENTITY __chapter__002 SYSTEM "manual_002.xml"> <!ENTITY __chapter__003 SYSTEM "manual_003.xml"> <!ENTITY __chapter__004 SYSTEM "manual_004.xml"> <!ENTITY __chapter__005 SYSTEM "manual_005.xml"> +<!ENTITY __chapter__006 SYSTEM "manual_006.xml"> +<!ENTITY __chapter__007 SYSTEM "manual_007.xml"> +<!ENTITY __chapter__008 SYSTEM "manual_008.xml"> +<!ENTITY __chapter__009 SYSTEM "manual_009.xml"> +<!ENTITY __chapter__010 SYSTEM "manual_010.xml"> +<!ENTITY __chapter__011 SYSTEM "manual_011.xml"> +<!ENTITY __chapter__012 SYSTEM "manual_012.xml"> +<!ENTITY __chapter__013 SYSTEM "manual_013.xml"> +<!ENTITY __chapter__014 SYSTEM "manual_014.xml"> +<!ENTITY __chapter__015 SYSTEM "manual_015.xml"> +<!ENTITY __chapter__016 SYSTEM "manual_016.xml"> +<!ENTITY __chapter__017 SYSTEM "manual_017.xml"> +<!ENTITY __chapter__018 SYSTEM "manual_018.xml"> +<!ENTITY __chapter__019 SYSTEM "manual_019.xml"> +<!ENTITY __chapter__020 SYSTEM "manual_020.xml"> <!ENTITY __license SYSTEM "fdl.xml"> ]> <book> - <title>Sylpheed user's manual</title> - + <title>Sylpheed User's Manual</title> <bookinfo> <abstract> - <para></para> + <para>Sylpheed User's Manual authored by the Sylpheed Documentation Team deals with both the basic and advanced usage description of Sylpheed.</para> </abstract> - <copyright> - <year>2005</year> - - <holder>The Sylpheed documentation team</holder> + <year>2009</year> + <holder>The Sylpheed Documentation Team</holder> </copyright> - <legalnotice> <para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. - A copy of the license is included in the section entitled "GNU - Free Documentation License".</para> + A copy of the license is included in the section entitled "GNU + Free Documentation License".</para> </legalnotice> - <author> - <firstname>François</firstname> - + <firstname>Paul</firstname> + <surname>Kater</surname> + <affiliation> + <address> + <email>paul AT nlpagan DOT net</email> + </address> + </affiliation> + </author> + <author> + <firstname>Nick</firstname> + <surname>Selby</surname> + <affiliation> + <address> + <email>sylpheed AT nickselby DOT com</email> + </address> + </affiliation> + </author> + <author> + <firstname>Francois</firstname> <surname>Barriere</surname> - <affiliation> <address> - <email>barriere.francois@libertysurf.fr</email> - </address> + <email>barriere DOT francois AT libertysurf DOT fr</email> + </address> + </affiliation> + </author> + <author> + <firstname>Petr</firstname> + <surname>Kovář</surname> + <affiliation> + <address> + <email>pknbe AT volny DOT cz</email> + </address> </affiliation> </author> - <revhistory> - <!-- ******************************************************************************** --> - - <revision> +<!-- ******************************************************************************** --> <revision> <revnumber>2.1</revnumber> - - <date>2005/XX/XX</date> - + <date>2006/01/15</date> <authorinitials>FBe</authorinitials> - - <revremark>Ported to DocBook/XML.</revremark> + <revremark>Ported to DocBook XML.</revremark> + </revision> + <revision> + <revnumber>2.2</revnumber> + <date>2009/08/12</date> + <authorinitials>PK</authorinitials> + <revremark>Finished porting to DocBook XML.</revremark> </revision> - - <!-- ******************************************************************************** --> - </revhistory> +<!-- ******************************************************************************** --> </revhistory> </bookinfo> - - &__chapter__001; - &__chapter__002; - &__chapter__003; - &__chapter__004; - &__chapter__005; - - &__license; - -</book>
\ No newline at end of file +&__chapter__001;&__chapter__002;&__chapter__003;&__chapter__004;&__chapter__005;&__chapter__006;&__chapter__007;&__chapter__008;&__chapter__009;&__chapter__010;&__chapter__011;&__chapter__012;&__chapter__013;&__chapter__014;&__chapter__015;&__chapter__016;&__chapter__017;&__chapter__018;&__chapter__019;&__chapter__020;&__license;</book> diff --git a/manual/en/manual_001.xml b/manual/en/manual_001.xml index 84a1c0a..49ad27d 100644 --- a/manual/en/manual_001.xml +++ b/manual/en/manual_001.xml @@ -1,231 +1,177 @@ -<?xml version="1.0" encoding="iso-8859-1"?> - <chapter> - <title>What is Sylpheed?</title> - - <mediaobject> - <imageobject> - <imagedata fileref="snapshots/full_split.png" format="PNG" /> - </imageobject> - </mediaobject> - - <section> - <title>Introduction to Sylpheed</title> - - <para>Sylpheed is a fast e-mail and news client. It will run on just +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-1"> + <title>What is Sylpheed?</title> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/full_split.png" format="PNG"/> + </imageobject> + </mediaobject> + <section> + <title>Introduction to Sylpheed</title> + <para>Sylpheed is a fast e-mail and news client. It will run on just about any Linux or Unix compliant system.</para> - - <para>Sylpheed is:</para> - - <itemizedlist> - <listitem> - <para>Light on system resources.</para> - </listitem> - - <listitem> - <para>Very fast.</para> - </listitem> - - <listitem> - <para>easy to learn and operate, due to its graceful and + <para>Sylpheed is:</para> + <itemizedlist> + <listitem> + <para>Light on system resources.</para> + </listitem> + <listitem> + <para>Very fast.</para> + </listitem> + <listitem> + <para>easy to learn and operate, due to its graceful and sophisticated interface.</para> - </listitem> - - <listitem> - <para>Loaded with features.</para> - </listitem> - </itemizedlist> - </section> - - <section> - <title>Main features</title> - - <para>This list is not complete, but the most common features of + </listitem> + <listitem> + <para>Loaded with features.</para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Main features</title> + <para>This list is not complete, but the most common features of Sylpheed are:</para> - - <itemizedlist> - <listitem> - <para>Unlimited multiple account handling</para> - </listitem> - - <listitem> - <para>Thread display</para> - </listitem> - - <listitem> - <para>Filtering</para> - </listitem> - - <listitem> - <para>MIME (attachments)</para> - </listitem> - - <listitem> - <para>built-in image view</para> - </listitem> - - <listitem> - <para>X-Face support</para> - </listitem> - - <listitem> - <para>External editor support</para> - </listitem> - - <listitem> - <para>Message queueing</para> - </listitem> - - <listitem> - <para>Draft message function</para> - </listitem> - - <listitem> - <para>Template</para> - </listitem> - - <listitem> - <para>Line-wrapping</para> - </listitem> - - <listitem> - <para>Clickable URI</para> - </listitem> - - <listitem> - <para>XML-based addressbook</para> - </listitem> - - <listitem> - <para>LDAP addressbook</para> - </listitem> - - <listitem> - <para>Jpilot addressbook (for Palm types handhelds)</para> - </listitem> - - <listitem> - <para>Newly arrived and unread message management</para> - </listitem> - - <listitem> - <para>Multiple MH folder support</para> - </listitem> - - <listitem> - <para>Mew/Wanderlust compatible key bindings</para> - </listitem> - - <listitem> - <para>News reader function</para> - </listitem> - - <listitem> - <para>Printing</para> - </listitem> - - <listitem> - <para>UIDL support</para> - </listitem> - - <listitem> - <para>APOP authentication</para> - </listitem> - - <listitem> - <para>SMTP AUTH support</para> - </listitem> - - <listitem> - <para>IPv6 support</para> - </listitem> - - <listitem> - <para>GPG encryption and signature</para> - </listitem> - - <listitem> - <para>Autoconf, automake support</para> - </listitem> - - <listitem> - <para>Support of i18n of messages by gettext</para> - </listitem> - - <listitem> - <para>Supports many locales, including UTF-8 (Unicode), when using + <itemizedlist> + <listitem> + <para>Unlimited multiple account handling</para> + </listitem> + <listitem> + <para>Thread display</para> + </listitem> + <listitem> + <para>Filtering</para> + </listitem> + <listitem> + <para>MIME (attachments)</para> + </listitem> + <listitem> + <para>built-in image view</para> + </listitem> + <listitem> + <para>X-Face support</para> + </listitem> + <listitem> + <para>External editor support</para> + </listitem> + <listitem> + <para>Message queueing</para> + </listitem> + <listitem> + <para>Draft message function</para> + </listitem> + <listitem> + <para>Template</para> + </listitem> + <listitem> + <para>Line-wrapping</para> + </listitem> + <listitem> + <para>Clickable URI</para> + </listitem> + <listitem> + <para>XML-based addressbook</para> + </listitem> + <listitem> + <para>LDAP addressbook</para> + </listitem> + <listitem> + <para>Jpilot addressbook (for Palm types handhelds)</para> + </listitem> + <listitem> + <para>Newly arrived and unread message management</para> + </listitem> + <listitem> + <para>Multiple MH folder support</para> + </listitem> + <listitem> + <para>Mew/Wanderlust compatible key bindings</para> + </listitem> + <listitem> + <para>News reader function</para> + </listitem> + <listitem> + <para>Printing</para> + </listitem> + <listitem> + <para>UIDL support</para> + </listitem> + <listitem> + <para>APOP authentication</para> + </listitem> + <listitem> + <para>SMTP AUTH support</para> + </listitem> + <listitem> + <para>IPv6 support</para> + </listitem> + <listitem> + <para>GPG encryption and signature</para> + </listitem> + <listitem> + <para>Autoconf, automake support</para> + </listitem> + <listitem> + <para>Support of i18n of messages by gettext</para> + </listitem> + <listitem> + <para>Supports many locales, including UTF-8 (Unicode), when using libjconv</para> - </listitem> - - <listitem> - <para>IMAP4 compliant</para> - </listitem> - </itemizedlist> - </section> - - <section> - <title>Methods for managing messages</title> - - <para>There are several ways to manage messages. The best known is + </listitem> + <listitem> + <para>IMAP4 compliant</para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Methods for managing messages</title> + <para>There are several ways to manage messages. The best known is <quote>not at all</quote>.</para> - - <para>Many people receive an unmanageable amount of e-mail, which + <para>Many people receive an unmanageable amount of e-mail, which usually ends up in the INBOX folder, ignored and forgotten. If you are one of these people, you are constantly trying to locate that one important email you got 5 days ago in a inbox that contains more than 5000 messages. Locating one email out of very many unsorted messages is always a time-consuming and frustrating experience.</para> - - <para>Sylpheed helps this situation with its mailfolders and + <para>Sylpheed helps this situation with its mailfolders and mailboxes.</para> - - <para>Different mailboxes can store different kinds of mails. Suppose + <para>Different mailboxes can store different kinds of mails. Suppose you are a member of a kiting club, and you get at least 30 e-mails per day from that club. You can create a separate kiting club mailbox, in which you can move any e-mail that comes from this club. You will always have all your kiting e-mails in one place.</para> - - <para>Tedious, you say, to move 30 mails a day to that box, when email + <para>Tedious, you say, to move 30 mails a day to that box, when email comes in at random moments? It is certain that you will miss that very important email about transport to the kiting ground where you will have the contest of biggest and most beautiful kite!</para> - - <para>Well, for this situation there is also a solution- filters.</para> - - <para>Filters can automate the process of moving e-mails to new + <para>Well, for this situation there is also a solution- filters.</para> + <para>Filters can automate the process of moving e-mails to new mailboxes. Further on in this manual you will also learn about setting up filters, so you do not have to manually move these kiting e-mails to the kiting club mailbox.</para> - - <section> - <title>Okay, so what is the difference between a mailbox and a - mailfolder?</title> - - <para>This is the same way you organize information on your harddisk. + <section> + <title>Okay, so what is the difference between a mailbox and a mailfolder?</title> + <para>This is the same way you organize information on your harddisk. You create directories in which you put files or more directories.</para> - - <para>In Sylpheed, you can create mailboxes within mailboxes For + <para>In Sylpheed, you can create mailboxes within mailboxes For example, you could create a mailbox (folder) that contains the mailboxes for all the different mailing lists to which you belong .</para> - - <para>A word of clarification- In Sylpheed, a maillbox is nothing more + <para>A word of clarification- In Sylpheed, a maillbox is nothing more than a directory. In a directory you can create either a new directory or files. Sylpheed stores each e-mail in a separate file on disk. An example of how a mailbox tree could look is</para> - - <para><mediaobject> - <imageobject> - <imagedata fileref="snapshots/folder_tree.png" format="PNG" /> - </imageobject> - </mediaobject> As you can see, there is no real limit to the way you + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/folder_tree.png" format="PNG"/> + </imageobject> + </mediaobject> + <para>As you can see, there is no real limit to the way you can set up your mailboxes. As long as you have diskspace available, you can create mailboxes and mailboxes within mailboxes.</para> - - <para>Of course, you should observe some common sense when you start + <para>Of course, you should observe some common sense when you start creating mailboxes. It is not a good idea to keep all mail in one place but to create a maze of mailboxes is not a good idea either!</para> - </section> </section> - </chapter> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_002.xml b/manual/en/manual_002.xml index 9c6a82d..26a64d6 100644 --- a/manual/en/manual_002.xml +++ b/manual/en/manual_002.xml @@ -1,161 +1,125 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<chapter> +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-2"> <title>Quick-guide to mail setup</title> - <section> <title>Starting Sylpheed for the first time</title> - <para>When starting Sylpheed for the first time, you will be guided through the first basic steps of the setup. First a pop-up window will show up and you will be asked to define the directory Sylpheed will use to store your messages and folders. This directory will be created under your home directory (or under C:\windows\Application Data\Sylpheed on windows). - The default name for this directory is "Mail".</para> - + The default name for this directory is "Mail".</para> <mediaobject> <imageobject> - <imagedata fileref="snapshots/wizard_1.png" /> + <imagedata fileref="snapshots/wizard_1.png"/> </imageobject> </mediaobject> - <para>Then the account preferences window shows up. Based on your configuration (local UNIX mailbox or POP account), read one of the following sections for the next steps of the configuration.</para> </section> - <section> <title>Setup for reading your Unix mailbox in a hurry</title> - <itemizedlist> <listitem> - <para>In the configuration menu, select "Create new account".</para> + <para>In the configuration menu, select "Create new account".</para> </listitem> - <listitem> <para>In the Basic tab, name the account. You can select this account - to be the default account ("Usually used").</para> + to be the default account ("Usually used").</para> </listitem> - <listitem> <para>Enter your name and e-mail address.</para> </listitem> - <listitem> <para>To select your local unix mailbox, in the Protocol box you - select "None (local)".</para> + select "None (local)".</para> </listitem> - <listitem> - <para>When you select this option, the "Server for receiving" is + <para>When you select this option, the "Server for receiving" is greyed out, since this is not relevant. You can enter the server to send (SMTP) in this tab also.</para> </listitem> </itemizedlist> - <para>Settings in the remaining tabs can usually be left at default values.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_basic.png" /> + <imagedata fileref="snapshots/account_basic.png"/> </imageobject> </mediaobject> - <para>The Receive tab is not used in this setup, since you are not polling a server, your mail is delivered to you.</para> - <para>In the Send tab you can select headers and SMTP authentication.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_send.png" /> + <imagedata fileref="snapshots/account_send.png"/> </imageobject> </mediaobject> - <para>In the Compose tab you can define your signature file.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_compose.png" /> + <imagedata fileref="snapshots/account_compose.png"/> </imageobject> </mediaobject> - <para>In the Advanced tab you can edit the portnumbers for the servers you will be using. This normally will need no change.</para> - <para>This is basically everything you need to start using Sylpheed for - local mailboxes. You can select "Message -> receive new mail" or press + local mailboxes. You can select "Message -> receive new mail" or press the shortcut and see if there is new mail!</para> </section> - <section> <title>Setup for reading POP3 mail in a hurry</title> - <itemizedlist> <listitem> - <para>In the configuration menu, select "Create new account".</para> + <para>In the configuration menu, select "Create new account".</para> </listitem> - <listitem> <para>In the Basic tab, name the account. You can select this account - to be the default account ("Usually used").</para> + to be the default account ("Usually used").</para> </listitem> - <listitem> <para>Enter your name and e-mail address.</para> </listitem> - <listitem> - <para>To check your POP3 mail, in the Protocol box you select "POP3 - (normal)".</para> + <para>To check your POP3 mail, in the Protocol box you select "POP3 + (normal)".</para> </listitem> - <listitem> - <para>Enter the server information for "Server for receiving". You can + <para>Enter the server information for "Server for receiving". You can then enter the server to send (SMTP) in this tab.</para> </listitem> </itemizedlist> - <para>Settings in the remaining tabs can usually be left at default values.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_pop_basic.png" /> + <imagedata fileref="snapshots/account_pop_basic.png"/> </imageobject> </mediaobject> - <para>The Receive tab offers advanced POP3 options.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_pop_receive.png" /> + <imagedata fileref="snapshots/account_pop_receive.png"/> </imageobject> </mediaobject> - <para>In the Send tab you can select headers and SMTP authentication.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_send.png" /> + <imagedata fileref="snapshots/account_send.png"/> </imageobject> </mediaobject> - <para>In the Compose tab you can define your signature file.</para> - <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_compose.png" /> + <imagedata fileref="snapshots/account_compose.png"/> </imageobject> </mediaobject> - <para>In the Advanced tab you can edit the portnumbers for the servers you will be using. This normally will need no change.</para> - <para>This is basically everything you need to start using Sylpheed for - POP3 mailsystems. You select "Message -> receive new mail" or press the + POP3 mailsystems. You select "Message -> receive new mail" or press the shortcut and see if there is new mail!</para> </section> -</chapter> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_003.xml b/manual/en/manual_003.xml index 9ee1d8d..22a4bab 100644 --- a/manual/en/manual_003.xml +++ b/manual/en/manual_003.xml @@ -1,41 +1,29 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<chapter> +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-3"> <title>Quick-guide for news setup</title> - <section> <title>Getting news in a hurry.</title> - - <para>In the configuration menu, select "Create new account"</para> - - <para>In the "Basic" tab, enter the relevant data. You name the account, + <para>In the configuration menu, select "Create new account"</para> + <para>In the "Basic" tab, enter the relevant data. You name the account, enter your name and e-mail address, etc. To connect to news, in the - Protocol box you select "News (NNTP)".</para> - + Protocol box you select "News (NNTP)".</para> <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_news_basic.png" /> + <imagedata fileref="snapshots/account_news_basic.png"/> </imageobject> </mediaobject> - <para>Enter the newsserver information.</para> - - <para>Skip the "Receive" tab.</para> - - <para>In the "Send" tab you can set up some more settings.</para> - - <para>In the "Compose" tab you can define your signature file.</para> - + <para>Skip the "Receive" tab.</para> + <para>In the "Send" tab you can set up some more settings.</para> + <para>In the "Compose" tab you can define your signature file.</para> <mediaobject> <imageobject> - <imagedata fileref="snapshots/account_compose.png" /> + <imagedata fileref="snapshots/account_compose.png"/> </imageobject> </mediaobject> - - <para>In the "Advanced" tab you can edit the portnumbers for the servers + <para>In the "Advanced" tab you can edit the portnumbers for the servers you will be using. This normally will need no change.</para> - <para>Close the dialogs, right click the new News folder in the folder - pane and select "Subscribe to newsgroups". If not done already, a list of + pane and select "Subscribe to newsgroups". If not done already, a list of groups will be downloaded from the server. From there you will find your way, so good luck!</para> </section> diff --git a/manual/en/manual_004.xml b/manual/en/manual_004.xml index c8ef4fa..ed74f25 100644 --- a/manual/en/manual_004.xml +++ b/manual/en/manual_004.xml @@ -1,532 +1,402 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<chapter> +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-4"> <title id="chap_installation">Installation</title> - <section id="required_environment"> <title>Required environment</title> - <para>To succesfully compile Sylpheed, you need at least:</para> - <itemizedlist> <listitem> <para>Any POSIX compliant UNIX or similar OS, eg. Linux, FreeBSD, Solaris.</para> </listitem> - <listitem> - <para>A recent ANSI C compiler, like <ulink - url="http://gcc.gnu.org/">GCC</ulink>. Note: it is reported that Sun C + <para>A recent ANSI C compiler, like <ulink url="http://gcc.gnu.org/">GCC</ulink>. Note: it is reported that Sun C can not compile Sylpheed.</para> </listitem> - <listitem> <para>The <ulink url="http://www.gtk.org/">Gtk+</ulink> library, with a 2.4.0 or better version (v2.6.0 or better is recommended).</para> </listitem> </itemizedlist> - <para>Optionally you need:</para> - <itemizedlist> <listitem> - <para><ulink - url="http://ftp.gnome.org/pub/GNOME/unstable/sources/gdk-pixbuf/">Gdk-pixbuf</ulink> + <para><ulink url="http://ftp.gnome.org/pub/GNOME/unstable/sources/gdk-pixbuf/">Gdk-pixbuf</ulink> for the built-in image viewer.</para> </listitem> - <listitem> - <para><ulink - url="ftp://ftp.cs.indiana.edu/pub/faces/compface/">libcompface</ulink> + <para><ulink url="ftp://ftp.cs.indiana.edu/pub/faces/compface/">libcompface</ulink> for X-Face icons.</para> </listitem> - <listitem> <para><ulink url="http://www.kondara.org/libjconv/">libjconv</ulink> for non latin character sets.</para> </listitem> - <listitem> <para><ulink url="http://www.gnupg.org/gpgme.html">GPGME</ulink> and <ulink url="http://www.gnupg.org/">GNUPG</ulink> for encryption and signature.</para> </listitem> - <listitem> <para><ulink url="http://www.openssl.org/">OpenSSL</ulink> for SSL support.</para> </listitem> - <listitem> <para><ulink url="http://www.openldap.org/">OpenLDAP</ulink> to connect to a LDAP directory server.</para> </listitem> - <listitem> <para>The IPv6 support can be turned on (if your system supports it) without any additional library.</para> </listitem> - <listitem> <para><ulink url="http://www.jpilot.org/">Jpilot</ulink> for Palm addressbook use.</para> </listitem> - <listitem> <para>The equivalent of Gtk+-devel and Xfree86-devel, otherwise .configure will fail.</para> </listitem> </itemizedlist> - <para>Notice: Sylpheed may be unstable depending on the environment. Please use the newest version of libraries if possible.</para> </section> - <section id="environment_known_valid"> <title>Environments known as valid for Sylpheed</title> - <itemizedlist> <listitem> <para>Debian GNU/Linux (sid, glibc 2.3.2) (development environment)</para> </listitem> - <listitem> <para>Debian GNU/Linux (amd64/sid, glibc 2.3.2)</para> </listitem> - <listitem> <para>Debian GNU/Linux (sarge, glibc 2.3.2)</para> </listitem> - <listitem> <para>Debian GNU/Linux 3.0 (woody) (glibc 2.2.5)</para> </listitem> - <listitem> <para>Debian GNU/Linux 2.2 (potato) (glibc 2.1.3)</para> </listitem> - <listitem> <para>Kondara MNU/Linux (glibc 2.1.x)</para> </listitem> - <listitem> <para>Kondara MNU/Linux 1.2</para> </listitem> - <listitem> <para>Kondara MNU/Linux 2.0</para> </listitem> - <listitem> <para>Vine Linux 1.1 (glibc 2.0.x + libwcsmbs)</para> </listitem> - <listitem> <para>Vine Linux 2.0 (glibc 2.1.x) (Intel, PPC)</para> </listitem> - <listitem> <para>Vine Linux 2.1</para> </listitem> - <listitem> <para>Vine Linux 2.1.5, 2.5, 2.6, 3.0</para> </listitem> - <listitem> <para>Laser5 Linux 6.0 (glibc 2.1.x)</para> </listitem> - <listitem> <para>Laser5 Linux 6.2 (glibc 2.1.x)</para> </listitem> - <listitem> <para>Laser5 Linux 6.4 (glibc 2.1.x)</para> </listitem> - <listitem> <para>TurboLinux 4.0 (glibc 2.0.7 + libwcsmbs)</para> </listitem> - <listitem> <para>TurboLinux 6.0 (glibc 2.1.2)</para> </listitem> - <listitem> <para>TurboLinux 7.0 (glibc 2.2.x)</para> </listitem> - <listitem> <para>Miracle Linux Standard Edition Version1.0</para> </listitem> - <listitem> <para>Miracle Linux for PostgreSQL Version1.0</para> </listitem> - <listitem> <para>Miracle Linux for Samba Version1.0</para> </listitem> - <listitem> <para>RedHat Linux 5.2 (glibc 2.0.7)</para> </listitem> - <listitem> <para>RedHat Linux 6.0</para> </listitem> - <listitem> <para>RedHat Linux 6.1 + Helix GNOME (glibc 2.1.x)</para> </listitem> - <listitem> <para>RedHat Linux 6.2 / 6.2J (glibc 2.1.x)</para> </listitem> - <listitem> <para>RedHat Linux 7.0 / 7.0J</para> </listitem> - <listitem> <para>RedHat Linux 7.1, 7.2, 7.3</para> </listitem> - <listitem> <para>RedHat Linux 8.0, 9.0</para> </listitem> - <listitem> <para>Fedora core 2, 3</para> </listitem> - <listitem> <para>LinuxPPC2000 + Yukikaze(Japanization kit)</para> </listitem> - <listitem> <para>Linux2000G (Intel, PowerPC)</para> </listitem> - <listitem> <para>HOLON Linux 2.0 (Intel / PPC)</para> </listitem> - <listitem> <para>Linux for PPC Japanese Edition 2.0 (glibc 2.1.x)</para> </listitem> - <listitem> <para>Linux for PPC Japanese Edition 3.0 (glibc 2.1.x)</para> </listitem> - <listitem> <para>Linux MLD4</para> </listitem> - <listitem> <para>Linux MLD5</para> </listitem> - <listitem> <para>Plamo Linux 2.0</para> </listitem> - <listitem> <para>Plamo Linux 2.1</para> </listitem> - <listitem> <para>Slackware 7.0</para> </listitem> - <listitem> <para>Slackware 7.1</para> </listitem> - <listitem> <para>Slackware 8.0</para> </listitem> - <listitem> <para>Linux Mandrake 7.0</para> </listitem> - <listitem> <para>Linux Mandrake 7.1</para> </listitem> - <listitem> <para>Linux Mandrake 7.2</para> </listitem> - <listitem> <para>Linux Mandrake 8.0</para> </listitem> - <listitem> <para>Linux Mandrake 8.1, 9.0, 9.1, 10.0</para> </listitem> - <listitem> <para>SuSE Linux 6.3 (glibc 2.1.2)</para> </listitem> - <listitem> <para>SuSE Linux 6.4</para> </listitem> - <listitem> <para>SuSE Linux 7.0</para> </listitem> - <listitem> <para>SuSE Linux 7.1</para> </listitem> - <listitem> <para>SuSE Linux 7.2</para> </listitem> - <listitem> <para>SuSE Linux 7.3, 8.0, 8.1, 8.2</para> </listitem> - <listitem> <para>OpenLinux 2.3 (glibc 2.1.1 -> 2.1.3)</para> </listitem> - <listitem> <para>Caldera OpenDesktop 2.4</para> </listitem> - <listitem> <para>Caldera Workstation 3.1</para> </listitem> - <listitem> <para>Conectiva Linux 4.0</para> </listitem> - <listitem> <para>Conectiva Linux 5.0</para> </listitem> - <listitem> <para>Conectiva Linux 7.0</para> </listitem> - <listitem> <para>Vector Linux 1.5</para> </listitem> - <listitem> <para>Yellow Dog Linux 2.0 (glibc 2.2.1)</para> </listitem> - <listitem> <para>Yellow Dog Linux 2.1 (PowerPC)</para> </listitem> - <listitem> <para>ASP Linux 7.2 (glibc 2.2.4)</para> </listitem> - <listitem> <para>Redmond Linux (Lycoris)</para> </listitem> </itemizedlist> - <itemizedlist> <listitem> <para>FreeBSD release 3.2</para> </listitem> - <listitem> <para>FreeBSD release 3.4</para> </listitem> - <listitem> <para>FreeBSD release 4.0</para> </listitem> - <listitem> <para>FreeBSD release 4.1</para> </listitem> - <listitem> <para>FreeBSD release 4.2</para> </listitem> - <listitem> <para>FreeBSD release 4.3</para> </listitem> - <listitem> <para>FreeBSD release 4.4</para> </listitem> - <listitem> <para>FreeBSD release 4.5</para> </listitem> - <listitem> <para>FreeBSD release 5.0</para> </listitem> - <listitem> <para>NetBSD 1.4.2</para> </listitem> - <listitem> <para>NetBSD 1.5 + XPG4DL</para> </listitem> - <listitem> <para>NetBSD 1.5.1</para> </listitem> - <listitem> <para>NetBSD 1.5.2</para> </listitem> - <listitem> <para>OpenBSD 2.7</para> </listitem> - <listitem> <para>OpenBSD 2.8 (i386)</para> </listitem> - <listitem> <para>OpenBSD 2.9</para> </listitem> - <listitem> <para>OpenBSD 3.0</para> </listitem> - <listitem> <para>BSD/OS 4.0.1</para> </listitem> </itemizedlist> - <itemizedlist> <listitem> <para>Solaris 2.5</para> </listitem> - <listitem> <para>Solaris 2.5.1</para> </listitem> - <listitem> <para>Solaris 2.6</para> </listitem> - <listitem> <para>Solaris 7, 8, 9</para> </listitem> - <listitem> <para>IRIX 6.3</para> </listitem> - <listitem> <para>IRIX 6.4</para> </listitem> - <listitem> <para>IRIX 6.5, 6.5.8m</para> </listitem> - <listitem> <para>HP-UX 10.20</para> </listitem> - <listitem> <para>HP-UX 11.00</para> </listitem> - <listitem> <para>HP-UX 11i</para> </listitem> - <listitem> <para>Tru64 Unix 5.0 (OSF1 v5.0)</para> </listitem> - <listitem> <para>SCO UnixWare 7</para> </listitem> - <listitem> <para>Mac OS X 10.1.3 (Darwin 5.3) + XDarwin (without XLocale support) + libxpg4</para> </listitem> </itemizedlist> - <itemizedlist> <listitem> <para>Windows (MSVC + GTK+ for win32), in progress</para> </listitem> </itemizedlist> </section> - <section id="nuts_and_bolts_of_installation"> <title>Nuts and bolts of installation</title> - <para><itemizedlist> <listitem> - <para>Dowload the latest Sylpheed package from: <ulink - url="http://sylpheed.good-day.net/">http://sylpheed.good-day.net/</ulink></para> + <para>Dowload the latest Sylpheed package from: <ulink url="http://sylpheed.good-day.net/">http://sylpheed.good-day.net/</ulink></para> </listitem> - <listitem> <para>Untar the source file into a new directory.</para> </listitem> - <listitem> <para><command>tar xvfz sylpheed-<version>.tar.gz</command> (for a tar.gz package).</para> </listitem> - <listitem> <para><command>tar xvfj sylpheed-<version>.tar.bz2</command> (for a bzip2 package).</para> </listitem> - <listitem> <para>Change to the sylpheed directory.</para> </listitem> - <listitem> <para>Run the configure script (<command>./configure</command>) to check your environment and create the installation make files.</para> </listitem> - <listitem> <para>Run the make program which will compile the sources. Do not proceed with this step if there are fatal errors in the previous step. Fatal errors indicate that things are missing inorder to compile Sylpheed properly.</para> </listitem> - </itemizedlist>If the make process has completed, run <command>make - install</command> (as root), to install the program and the support + </itemizedlist>If the make process has completed, run <command>make install</command> (as root), to install the program and the support files.</para> - <section id="nuts_and_bolts__compiling_with_options"> <title>Compiling Sylpheed with options</title> - <para>You can choose to compile Sylpheed with some optional features enabled. Use <command>./configure --help</command> to list configuration syntax and options.</para> - <para>The following optional features can be enabled:</para> - <itemizedlist> <listitem> <para><application>Jpilot</application>: to use your PDA addressbook @@ -534,7 +404,6 @@ too). Enable this option with the <option>--enable-jpilot</option> configure switch.</para> </listitem> - <listitem> <para><application>GnuPG</application>: Sylpheed can encrypt and sign your messages (and also decrypt and verify the signature of the @@ -544,14 +413,12 @@ option with the <option>--disable-gpgme</option> configure switch.</para> </listitem> - <listitem> <para><application>LDAP</application>: Sylpheed can connect to a LDAP server in order to query mail addresses. To enable this feature you will need the OpenLDAP library. Enable this option with the <option>--enable-ldap</option> configure switch.</para> </listitem> - <listitem> <para><application>X-Faces</application>: you can create a small picture (of your face, or of anything else) that will be sent in the @@ -559,13 +426,11 @@ library is found and can be disabled using the <option>--disable-compface</option> configure switch.</para> </listitem> - <listitem> <para>Images can appear inline (embedded in the message window, without the need of an external viewer) if Sylpheed is compiled with the gdk-pixbuf library.</para> </listitem> - <listitem> <para><application>SSL</application>: Sylpheed can encrypt its connection to the mail server using SSL, if the OpenSSL library is @@ -573,106 +438,72 @@ <option>--disable-ssl</option> configure switch. </para> </listitem> </itemizedlist> - <para>All these features require additional libraries and tools that may not be part of your distribution. You can find them at the addresses listed at the beginning of this chapter, here.</para> </section> - <section id="nuts_and_bolts__installing_rpm"> <title>Installation on Linux using RPM</title> - <para>As root, run the rpm -ivh command on the RPM file you downloaded. As soon as this process is comlete you can run Sylpheed as a normal user.</para> </section> - <section id="nuts_and_bolts__installing_debian"> <title>Installation on Debian Linux</title> - <para>With an internet connection: apt-get install sylpheed</para> - <para>Without an internet connection, fetch the debian package, for - example on: <ulink - url="http://packages.debian.org/unstable/mail/sylpheed.html">http://packages.debian.org/unstable/mail/sylpheed.html</ulink>, + example on: <ulink url="http://packages.debian.org/unstable/mail/sylpheed.html">http://packages.debian.org/unstable/mail/sylpheed.html</ulink>, then:</para> - <para><command>dpkg -i sylpheedx.x.x-1i386.deb</command></para> - <para><command>dpkg --install sylpheedx.x.x-1i386.deb</command></para> </section> - <section id="nuts_and_bolts__installing_gentoo"> <title>Installation on Gentoo Linux</title> - <para>Use the standard ebuild for the portage tree and select the options with the use flags:</para> - <itemizedlist> <listitem> <para>crypt: to enable the gpgme option.</para> </listitem> - <listitem> <para>ldap: to enable to use of the OpenLDAP library.</para> </listitem> - <listitem> <para>pda: to turn on the use of the Jpilot link.</para> </listitem> - <listitem> <para>ssl: to use openssl encryption.</para> </listitem> - <listitem> <para>xface: to enable the X-Faces support.</para> </listitem> </itemizedlist> </section> - <section id="nuts_and_bolts__installing_freebsd"> <title>Installation on FreeBSD</title> - <para>Using the <command>/stand/sysinstall</command> tool (it is a menu based interface):</para> - <para>run /<command>stand/sysinstall</command> as root</para> - <para>In the main menu choose <guimenu>configure</guimenu>-><guisubmenu>Packages</guisubmenu>-><guimenuitem>mail</guimenuitem>, then <guimenuitem>Sylpheed</guimenuitem>. Back to the packages list choose <guimenuitem>install</guimenuitem>.</para> - - <para>Using the ports: get the Sylpheed port on <ulink - url="ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-4.3-release/mail">ftp://ftp.freesd.org/pub/FreeBSD/ports/i386/packages-4.3-release/mail</ulink></para> - + <para>Using the ports: get the Sylpheed port on <ulink url="ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-4.3-release/mail">ftp://ftp.freesd.org/pub/FreeBSD/ports/i386/packages-4.3-release/mail</ulink></para> <para>Then as root: <command>pkg-add sylpheed-x.x.x.tgz</command></para> - <para>Using the ports and compiling: first update your port, fetch it on - <ulink - url="ftp://www.freebsd.org/ports/mail.html">http://www.freebsd.org/ports/mail.html</ulink>, + <ulink url="ftp://www.freebsd.org/ports/mail.html">http://www.freebsd.org/ports/mail.html</ulink>, </para> - <para><command>cd /usr/ports/mail/sylpheed</command></para> - <para><command>make</command></para> - <para>If it succeds, type <command>make install</command>.</para> - <para>In case it fails, fetch the required package if necessary (on the same page), put the package file in <filename>/usr/ports/distfiles/</filename>, then: </para> - <para><command>cd /usr/ports/mail/sylpheed</command></para> - <para><command>make</command></para> - <para><command>make install</command></para> - <para>Need a more up-to-date version? Just use the Unix standard method - (see <link linkend="nuts_and_bolts_of_installation">Nuts and bolts of - installation</link>)</para> + (see <link linkend="nuts_and_bolts_of_installation">Nuts and bolts of installation</link>)</para> </section> </section> </chapter>
\ No newline at end of file diff --git a/manual/en/manual_005.xml b/manual/en/manual_005.xml index 7e03424..83d1c91 100644 --- a/manual/en/manual_005.xml +++ b/manual/en/manual_005.xml @@ -1,51 +1,41 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<chapter> - <title id="chap_starting">Starting and quitting Sylpheed</title> - - <section id="starting_sylpheed"> - <title>Starting Sylpheed</title> - - <para> - Starting Sylpheed can be done by typing <command>sylpheed</command> - on a prompt in a terminal and pressing Enter. You can also - add Sylpheed to a menu in KDE or Gnome, or create a shortcut - to it on the desktop, if your window manager allows that. - </para> - - <para> - When you first start Sylpheed, the program will ask you where - you want to store the mails that you downloaded. You can accept - the default (<filename>$HOME/Mail</filename>) or set up your own - mail folder. - </para> - - <para> - Sylpheed will then load with it's default settings. The way to - change these are written about further on in this manual. - </para> - - <para> - </para> - - </section> - - <section id="quitting_sylpheed"> - <title>Quitting Sylpheed</title> - - <para> - Ending Sylpheed can be done in several ways: - </para> - <itemizedlist> - <listitem> - <para>Select "quit" from the File menu.</para> - </listitem> - <listitem> - <para>Press Ctrl-Q</para> - </listitem> - <listitem> - <para>Click the "program close" button in the titlebar.</para> - </listitem> - </itemizedlist> - - </section> -</chapter> +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-5"> + <title id="chap_starting">Starting and quitting Sylpheed</title> + <section id="starting_sylpheed"> + <title>Starting Sylpheed</title> + <para> + Starting Sylpheed can be done by typing <command>sylpheed</command> + on a prompt in a terminal and pressing Enter. You can also + add Sylpheed to a menu in KDE or Gnome, or create a shortcut + to it on the desktop, if your window manager allows that. + </para> + <para> + When you first start Sylpheed, the program will ask you where + you want to store the mails that you downloaded. You can accept + the default (<filename>$HOME/Mail</filename>) or set up your own + mail folder. + </para> + <para> + Sylpheed will then load with it's default settings. The way to + change these are written about further on in this manual. + </para> + <para> + </para> + </section> + <section id="quitting_sylpheed"> + <title>Quitting Sylpheed</title> + <para> + Ending Sylpheed can be done in several ways: + </para> + <itemizedlist> + <listitem> + <para>Select "quit" from the File menu.</para> + </listitem> + <listitem> + <para>Press Ctrl-Q</para> + </listitem> + <listitem> + <para>Click the "program close" button in the titlebar.</para> + </listitem> + </itemizedlist> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_006.xml b/manual/en/manual_006.xml new file mode 100644 index 0000000..fe5a40e --- /dev/null +++ b/manual/en/manual_006.xml @@ -0,0 +1,730 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-6"> + <title>The menu options of Sylpheed</title> + <para> +The menu in Sylpheed is the primary entry to all the things +you can do with Sylpheed. The menu structure gives you following +options: +</para> + <section> + <title>File menu</title> + <itemizedlist> + <listitem> + <para> + <computeroutput>Add mailbox:</computeroutput> this option lets you add a new MH mail-directory. + It will generate IN, OUT, QUEUE, DRAFT and TRASH mailfolders + inside the new mailbox.</para> + </listitem> + <listitem> + <para> + <computeroutput>Check for new messages in all folders:</computeroutput> rescans the entire tree + of existing mailboxes to reflect the correct state (usually + won't be necessary).</para> + </listitem> + <listitem> + <para> + <computeroutput>Folder:</computeroutput> lets you add, rename or delete a mailfolder.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Create new folder:</computeroutput> to create a new folder. You must select + the top level node of the folder tree of a sub folder before + using this menu entry, in order to define the location of the + new folder to create.</para> + </listitem> + <listitem> + <para> + <computeroutput>Rename folder:</computeroutput> change the name of the selected folder.</para> + </listitem> + <listitem> + <para> + <computeroutput>Delete folder:</computeroutput> delete the selected folder (also delete the + messages contained in the selected folder).</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <computeroutput>Import mbox file...:</computeroutput> lets you import an mbox file + (like created by Pine) into an MH mailbox.</para> + </listitem> + <listitem> + <para> + <computeroutput>Export to mbox file:</computeroutput> lets you export an MH mailbox to an mbox file.</para> + </listitem> + <listitem> + <para> + <computeroutput>Empty trash:</computeroutput> obviously, this will empty the trash folder.</para> + </listitem> + <listitem> + <para> + <computeroutput>Save as:</computeroutput> lets you save the selected e-mail to a plain textfile + on disk.</para> + </listitem> + <listitem> + <para> + <computeroutput>Print:</computeroutput> lets you print the selected e-mail to a printer.</para> + </listitem> + <listitem> + <para> + <computeroutput>Exit:</computeroutput> ends Sylpheed.</para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Edit menu </title> + <itemizedlist> + <listitem> + <para> + <computeroutput>copy:</computeroutput> lets you copy the selected text to a buffer, + from where you can paste it into a different place. + Shortcut: Ctrl-C</para> + </listitem> + <listitem> + <para> + <computeroutput>select all:</computeroutput> selects all the text in the current window. + Shortcut: Ctrl-A</para> + </listitem> + <listitem> + <para> + <computeroutput>select thread:</computeroutput> selects all the messages of the current thread.</para> + </listitem> + <listitem> + <para> + <computeroutput>Find in current message:</computeroutput> searches a string in the current message. + Shortcut: Ctrl-F</para> + </listitem> + <listitem> + <para> + <computeroutput>search messages:</computeroutput> searches a message based on its To, From, Subject + header fields or body content. Start searching from the selected + message, in the selected folder. + Shortcut: Shift-Ctrl-F</para> + </listitem> + </itemizedlist> + </section> + <section> + <title>View menu </title> + <para> +The view menu allows you to change the way that Sylpheed appears. +You can set different windows separately (folder view, messages etc.), +enable or disable the statusbar and so on. +It contains also the commands to toggle the display of some parts +of the current message, or sort the messsages in the selected folder +based on different attributes. +</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Show or hide:</computeroutput> let you control the parts of the Sylpheed user interface + you want to display.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Folder tree:</computeroutput> not implemented yet</para> + </listitem> + <listitem> + <para> + <computeroutput>Message view:</computeroutput> show or hide the message pane. When hidden, the + messages are displayed in a separate window. To read a message + double click in the summary pane. The message is then opened in + a new window. You can close this new window by pressing the escape + key.</para> + </listitem> + <listitem> + <para> + <computeroutput>Toolbar:</computeroutput> sets how you want to see the toolbar. Icons and text, + or one of these.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Icon and Text:</computeroutput> show icons and text in the toolbar.</para> + </listitem> + <listitem> + <para> + <computeroutput>Icon:</computeroutput> only display the icons, do not display the text + below them.</para> + </listitem> + <listitem> + <para> + <computeroutput>Text:</computeroutput> only the text, hide the icons.</para> + </listitem> + <listitem> + <para> + <computeroutput>None:</computeroutput> hide the toolbar.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <computeroutput>Status bar:</computeroutput> show it or hide it.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <computeroutput>Separate folder tree:</computeroutput> selects between having the folder tree + attached to the main window, or floating separately.</para> + </listitem> + <listitem> + <para> + <computeroutput>Separate message view:</computeroutput> selects between having the selected + message in the summary pane attached to the main window, or + floating separately.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort:</computeroutput> controls the way the messages are sorted in the selected + folder. Each option sorts the messages in descending order (the + bigger one being on the top of the summary pane), and can be + reversed by selecting the same menu entry a second time (each + time you select the same menu entry the order is reversed).</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Sort by number:</computeroutput> sort the message based on their MH number.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by size:</computeroutput> sort the message on their size.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by date:</computeroutput> sort the messages based on their date.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by from:</computeroutput> the messages are sorted by their sender address + (From field, sorted alphabetically).</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by recipient:</computeroutput> the messages are sorted by their recipient + (sorted alphabetically).</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by subject:</computeroutput> the messages are sorted by their subject + (sorted alphabetically).</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by color label:</computeroutput> sort the messages based on their color. + Read the context menu description below to find how to assign + colors to messages.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by mark:</computeroutput> separate marked and unmarked messages. Read the + context menu description below to find how to mark messages.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by unread:</computeroutput> separate read and unread messages.</para> + </listitem> + <listitem> + <para> + <computeroutput>Sort by attachment:</computeroutput> separate messages with and without attachment.</para> + </listitem> + <listitem> + <para> + <computeroutput>Don't sort:</computeroutput> do not sort the messages.</para> + </listitem> + <listitem> + <para> + <computeroutput>Ascending:</computeroutput> sort the messages in ascending order. If the field used + to sort the messages is displayed in the summary view, a little + arrow on the right side of the corresponding summay column header + reflects the sort order you select from the menu.</para> + </listitem> + <listitem> + <para> + <computeroutput>Descending:</computeroutput> sort the messages in descending order.</para> + </listitem> + <listitem> + <para> + <computeroutput>Attract by subject:</computeroutput> move close to each other the messages + having the same subject (or a close subject).</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <computeroutput>Thread view:</computeroutput> turn the threaded view on or off. When turned on the + messages of the same thread (the same discussion generated by replying + to each other mail) are grouped as a tree representing the discussion + flow. Each reply being linked to its orignal message. Each branch can + be open or closed by using the small plus or minus sign next to it. + The threads are based on the In-Reply-To and Reference fields of the + mail header, so never start a new conversation by replying to an + old message, this will add your new mail to the old unrelated thread. + Shortcut: Ctrl-T</para> + </listitem> + <listitem> + <para> + <computeroutput>Expand all threads:</computeroutput> if the threaded view is selected, expand all the + threads in the opened folder.</para> + </listitem> + <listitem> + <para> + <computeroutput>Collapse all threads:</computeroutput> if the threaded view is selected, collapse all the + threads in the opened folder.</para> + </listitem> + <listitem> + <para> + <computeroutput>Set display item:</computeroutput> use it to change the list of items to display + in the summary view. This setting can also be changed through + the common preferences.</para> + </listitem> + <listitem> + <para> + <computeroutput>Go to:</computeroutput> use it to navigate from message to message based on the + sub-menu criterias.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Prev. message:</computeroutput> go to the previous message in the current + folder. + Shortcut: P</para> + </listitem> + <listitem> + <para> + <computeroutput>Next message:</computeroutput> go to the next message in the current + folder. + Shortcut: N</para> + </listitem> + <listitem> + <para> + <computeroutput>Prev. unread:</computeroutput> go to the previous unread message. + Shortcut: Shift-P</para> + </listitem> + <listitem> + <para> + <computeroutput>Next unread:</computeroutput> go to the next unread message. + Shortcut: Shift-N</para> + </listitem> + <listitem> + <para> + <computeroutput>Prev. new:</computeroutput> go to the previous new message.</para> + </listitem> + <listitem> + <para> + <computeroutput>Next new:</computeroutput> go to the next new message.</para> + </listitem> + <listitem> + <para> + <computeroutput>Prev. marked:</computeroutput> go to the previous marked message.</para> + </listitem> + <listitem> + <para> + <computeroutput>Next marked:</computeroutput> go to the next marked message.</para> + </listitem> + <listitem> + <para> + <computeroutput>Prev. labeled:</computeroutput> go to the previous labeled message.</para> + </listitem> + <listitem> + <para> + <computeroutput>Next labeled:</computeroutput> go to the next labeled message.</para> + </listitem> + <listitem> + <para> + <computeroutput>Other folder:</computeroutput> change the current folder. Opens a new window + with the folder tree, and open the selected folder.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <computeroutput>Code set:</computeroutput> allows you to select what codeset you want to use + for your e-mails. This codeset will be used when sending + mails. Note Sylpheed will always try to use the more compatible + codeset based on the characters used in your message, so unless + you use special latin-1 characters in your mail, the encoding + will be defined as 7bits ASCII even if you have selected the + ISO-8859-1 character set. + The auto-detect option let Sylpheed automatically detect the + character set based on the content of the messages.</para> + </listitem> + <listitem> + <para> + <computeroutput>Open in new window:</computeroutput> open the selected message in a new window. + This new window can be closed by pressing the escape key. + Shortcut: Ctrl-Alt-N</para> + </listitem> + <listitem> + <para> + <computeroutput>Message source:</computeroutput> opens a new window and display the complete + source of the message in it (without any formatting and with + all the header fields). + Shortcut: Ctrl-U</para> + </listitem> + <listitem> + <para> + <computeroutput>Show all header:</computeroutput> toggles on and off the display of the complete + message header. + Shortcut: Ctrl-H</para> + </listitem> + <listitem> + <para> + <computeroutput>Update summary:</computeroutput> update the Sylpheed window. + Shortcut: Ctrl-Alt-U</para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Message menu </title> + <para> +Here you find the following options:</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Get new mail:</computeroutput> this will collect all new mail for your + default mail-identity. + Shortcut: Ctrl-I</para> + </listitem> + <listitem> + <para> + <computeroutput>Get from all accounts:</computeroutput> Sylpheed will poll all defined + mail-identities for new mail. + Shortcut: Shift-Ctrl-I</para> + </listitem> + <listitem> + <para> + <computeroutput>Cancel receiving:</computeroutput> stop the new mails reception.</para> + </listitem> + <listitem> + <para> + <computeroutput>Send queued messages:</computeroutput> all the messages that you put into + the "Queue" folder will now be sent off.</para> + </listitem> + <listitem> + <para> + <computeroutput>Compose new message:</computeroutput> allows you to write a new e-mail + message. + Shortcut: Ctrl-M</para> + </listitem> + <listitem> + <para> + <computeroutput>Reply:</computeroutput> an e-mail message will be created with the sender + of the selected message in the summary pane as recipient. + Depending on the settings, your signature will be added + to the mail, and the original mail text will be quoted. + If a part of the original mail is selected, only this + part will be quoted in the reply. + Shortcut: Ctrl-R</para> + </listitem> + <listitem> + <para> + <computeroutput>Reply to</computeroutput> </para> + <itemizedlist> + <listitem> + <para> + <computeroutput>all:</computeroutput> as Reply, but the recipients will be all + e-mail addresses in the original messages (including + the ones in the cc: part). + Shortcut: Shift-Ctrl-R</para> + </listitem> + <listitem> + <para> + <computeroutput>sender:</computeroutput> as Reply.</para> + </listitem> + <listitem> + <para> + <computeroutput>Mailing list:</computeroutput> reply to the mailing list. To use + when replying to a mailing list (unless you want to reply + only to the poster of the message). + Shortcut: Ctrl-L</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + Reply to sender: as Reply, but the recipient is the address + defined in the Sender header field (not the Reply-To address).</para> + </listitem> + <listitem> + <para> + <computeroutput>Forward:</computeroutput> a message will be created with the original + message in the summary pane as text. You can then + enter a recipient e-mail address, edit the text if + you want, and send it. + Shortcut: Ctrl-Alt-F</para> + </listitem> + <listitem> + <para> + <computeroutput>Forward as attachment:</computeroutput> as Forward, but the message + text will sent along as a separate textfile. + Shortcut: Shift-Ctrl-Alt-F</para> + </listitem> + <listitem> + <para> + <computeroutput>Redirect:</computeroutput> re-send the selected message to someone else. Compared + to a forward, the message is not marked as forwarded, and the sender + is the original mail sender.</para> + </listitem> + <listitem> + <para> + <computeroutput>Re-edit:</computeroutput> lets you open all already sent message in + edition mode to re-send it.</para> + </listitem> + <listitem> + <para> + <computeroutput>Move:</computeroutput> lets you move the message to a different folder. + You can select the destination folder from a browse-window.</para> + </listitem> + <listitem> + <para> + <computeroutput>Copy:</computeroutput> as Move, only that the message is copied to the + new folder, instead of moved. + Shortcut: Shift-Ctrl-O</para> + </listitem> + <listitem> + <para> + <computeroutput>Delete:</computeroutput> lets you delete the message that is selected + in the summary pane. + Shortcut: Ctrl-D</para> + </listitem> + <listitem> + <para> + <computeroutput>Mark:</computeroutput> Gives a submenu: <computeroutput>Mark/Unmark/Mark as read/Unmark as read</computeroutput>. When you mark messages, you can do a specific + action (e.g. move, delete) on all of the marked messages. + You can unmark messages that you mistakenly marked. + The other options do as they say, they mark or unmark + a message as read, and mark all read, marks all the messages + of the current folder as read.</para> + </listitem> + </itemizedlist> + <para> +A note on functions like Move, Copy and Delete: if you did not +specify to execute the commands immediately (in the configuration), +you will have to select the <computeroutput>Execute</computeroutput> command. This is a button +in the toolbar, and can also be found in the Summary menu.</para> + </section> + <section> + <title>Tool menu </title> + <para> +In the Tool menu are grouped the filters control, address book +access and log window control.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Address book:</computeroutput> opens the address book window. + Shortcut: Shift-Ctrl-A</para> + </listitem> + <listitem> + <para> + <computeroutput>Add sender to address book:</computeroutput> adds the sender of the selected + message to one of your address books. When selected a window + opens to let you select the target address book.</para> + </listitem> + <listitem> + <para> + <computeroutput>Filter messages:</computeroutput> apply the filter rules to the messages + of the inbox.</para> + </listitem> + <listitem> + <para> + <computeroutput>Create filter rule:</computeroutput> create a new filter rule based on the + selected message.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Automatically:</computeroutput> open the filter rules creation window + to define a new rule.</para> + </listitem> + <listitem> + <para> + <computeroutput>By From:</computeroutput> opens the filter rules creation window and + fills the filter settings fields to build a filter based + on the sender of the selected message.</para> + </listitem> + <listitem> + <para> + <computeroutput>By To:</computeroutput> opens the filter rules creation window and + fills the filter settings fields to build a filter based + on the receiver of the selected message.</para> + </listitem> + <listitem> + <para> + <computeroutput>By Subject:</computeroutput> opens the filter rules creation window and + fills the filter settings fields to build a filter based + on the subject of the selected message.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <computeroutput>Actions:</computeroutput> this menu is empty until you define some actions (see the + configuration menu description).</para> + </listitem> + <listitem> + <para> + <computeroutput>Delete duplicated messages:</computeroutput> This will remove messages from the + active folder that were sent twice to you. For example you + received a message directly and through a mailing list at + the same time.</para> + </listitem> + <listitem> + <para> + <computeroutput>Execute:</computeroutput> execute all the pending move, delete, and copy commands. + Only if execute immediately is off in the common preferences. + Shortcut: X</para> + </listitem> + <listitem> + <para> + <computeroutput>Log window:</computeroutput> opens the log window. In the log window, you + can see what Sylpheed is doing. Keeping track of things + in that way is very good when you suspect there is something + wrong. You can paste the info of the log window into an + e-mail and send it to the developer or the mailing list. + Shortcut: Shift-Ctrl-L</para> + </listitem> + </itemizedlist> + <para> +In the log window, you can see what Sylpheed is doing. Keeping +track of things in that way is very good when you suspect there +is something wrong. You can paste the info of the log window +into an e-mail and send it to the developer or the mailing list.</para> + </section> + <section> + <title>Configuration menu </title> + <para> +In the Configuration menu, clearly, you can set up Sylpheed +the way you want it to work and react.</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Common preferences:</computeroutput> in this option you will be + presented a dialog in which you can select a number + of tabs. Each tab represents a specific set of settings + in Sylpheed. In the next chapter, these dialog options + are explained in more detail.</para> + </listitem> + <listitem> + <para> + <computeroutput>Filter setting:</computeroutput> this option shows you a dialog in which you + can set up the filtering rules that you want Sylpheed + to process on receiving new e-mails. You first specify + on which part(s) of the e-mail Sylpheed has to check, + and then you tell Sylpheed what to do. You can move the + message to a different directory (including trash to get + rid of spam mail). Selecting the destination folder is + possible through a browser window that comes up when you + press "Select..." + </para> + <para> + You can choose not to receive the e-mail. Note that + this will leave the message on the mailserver of your + provider, the message will not be removed! + </para> + <para> + When you press the "Register" button, the filter + rule is added to the list of rules. Do you select + "Substitute", then the selected rule is replaced by the + information of the setting entered. "Delete" in the end + will delete the selected filtering rule. + </para> + <para> + Please note that you can set up two selections for a rule, + which can be "OR'd" or "AND'd". OR means that one of the + two selections will have to match for the rule to be + executed. AND means that both selections have to match + before an action is performed. + </para> + <para> + To the right of the selection rules you see buttons + called UP and DOWN. You can move rules up and down in + the list. This will often trigger different behaviour + in the selections, so consider the order in which + you set the rules.</para> + </listitem> + <listitem> + <para> + <computeroutput>Template:</computeroutput> let your create a new message template. + When composing a new message you can then used one + of the defined templates and insert it (or use it to + completely replace the content of your mail). + The templates can contain some special characters + that are replaced when the template is used in order + to create a dynamic text. Use the symbols button on + the templates definition window to see the list of + the available symbols.</para> + </listitem> + <listitem> + <para> + <computeroutput>Actions:</computeroutput> let your create new commands to be added to the + 'Tools/Actions' menu. An action is a command that processes + the select part of a message, the message body or the complete + message file. It can be a background process, used as a filter + (reads, modifies and replaces a message),...</para> + </listitem> + <listitem> + <para> + <computeroutput>Preferences for current account:</computeroutput> here you can set the + specifics for the account you are currently using. + Should mail be deleted after fetching, what is the + server it comes from, etc. Basically it is the same + dialog form as shown in setting up a new account.</para> + </listitem> + <listitem> + <para> + <computeroutput>Create new account:</computeroutput> here you name the account (each + account has a recognizable name), you set up your name + and e-mail address etc. You set up the type of server + you access (POP4, IMAP4, local mailbox, newsserver) + and where the downloaded messages have to go (default + folder is the inbox). In the RECEIVE tab you select or + unselect options, in SEND you can set up how to send + your messages. In COMPOSE you can point to a specific + signature file, and in ADVANCED you can set up alternate + ports for the server, if these exist. (Do not mess + with these unless you are sure you have to!!)</para> + </listitem> + <listitem> + <para> + <computeroutput>Edit accounts:</computeroutput> here you can select one of the accounts + you created, from a list, and edit the information about + them. Note that you cannot edit an account for which + you are writing a message at the same time. This to + ensure data integrity.</para> + </listitem> + <listitem> + <para> + <computeroutput>Change current account:</computeroutput> here you can select what + account you want to use, to write a message. + If you have enabled the status bar (in the view menu), + the name of the current account is shown in the bottom + right corner of the Sylpheed window (in the status bar) + and can be changed by a click on it (then a menu appears + and lists all your accounts).</para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Help menu </title> + <para> +This menu lets you look at the manual and FAQ of Sylpheed, +and you can also see the "about" info, who wrote Sylpheed. +</para> + </section> + <section> + <title>Context menu </title> + <para> +You can pull up context menus (through clicking button2) for +the folder tree and the summary pane. (windows users: button2 +is the right mouse button.) +</para> + <para> +In the folder view you can add, rename and remove folders +through the context menu. You can also set the folder +properties (define the selected folder as an inbox, outbox, +trash, ...). +</para> + <para> +In the message summary you can do a host of things from the +context menu, like viewing message headers, opening a message +in a separate window (also possible by double clicking on a +message) etc... +</para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_007.xml b/manual/en/manual_007.xml index 633480e..a2e1eb5 100644 --- a/manual/en/manual_007.xml +++ b/manual/en/manual_007.xml @@ -1,17 +1,13 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<chapter> - <title id="chap_starting">Dialogs and views</title> - +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-7"> + <title>Dialogs and views</title> <para> The appearance of the Sylpheed windows is controlled by a Gtk+ theme (as Sylpheed is based on the Gtk+ toolkit). Read the Gtk+ or your distribution documentation to find how to change the Gtk+ theme. </para> - <section> <title>Folder view</title> - <para> The folder view shows you all the mail folders that you have created, in a tree-like structure. If you want to see the headers of the messages @@ -20,7 +16,7 @@ </para> <para> When you see a + sign in front of a folder name, that means the folder - branch of that part of the tree is 'collapsed'. You can expand that + branch of that part of the tree is 'collapsed'. You can expand that part by clicking the + sign. In that same manner you can also collapse the - sign in front of an expanded branch of the folder tree. </para> @@ -30,119 +26,121 @@ </para> <para> The folder window can be detached from the main Sylpheed window - by selecting the menu action: <tt>View -> Separate folder tree</tt>. + by selecting the menu action: <guilabel>View -> Separate folder tree</guilabel>. When exiting the current state of the folder window (attached or detached) is saved to be restored when re-starting Sylpheed. To re-attach the folder window, de-select the menu entry. </para> - <section> - <title>Special folders</title> - + <title>Special folders</title> <para> Draft: here you store messages that you want to send out more often, - or you want to work on some more. Using the 'reedit' option from the + or you want to work on some more. Using the 'reedit' option from the message menu, you can edit the message further. </para> - <para> + <para> Trash: in here all your deleted messages go. Depending on the common preferences setting, this box is or is not emptied when you end Sylpheed. </para> - <para> + <para> Sent: in here are saved the messages you send (enabled by a common preference setting and the folder can be changed by an account preference setting). </para> - <para> + <para> Queue: this folder contains the composed messaged waiting to be sent (with Sylpheed message sending can be delayed). </para> - </section> </section> - <section> <title>Summary view</title> - <para> The summary pane can show you many things. You can select what you want to see from the Summary menu, selecting the option Set display item. A list of all options is: </para> <itemizedlist> - <listitem>Mark: shows if the message is marked.</listitem> - <listitem>Unread: shows if the message is read or not</listitem> - <listitem>MIME: shows MIME attachments</listitem> - <listitem>Number: shows the MH number of the message</listitem> - <listitem>Size: the size of the entire message including attachments</listitem> - <listitem>Date: the date of sending by the sender</listitem> - <listitem>From: who sent the message</listitem> - <listitem>Subject: what the message is about</listitem> + <listitem> + <para>Mark: shows if the message is marked.</para> + </listitem> + <listitem> + <para>Unread: shows if the message is read or not</para> + </listitem> + <listitem> + <para>MIME: shows MIME attachments</para> + </listitem> + <listitem> + <para>Number: shows the MH number of the message</para> + </listitem> + <listitem> + <para>Size: the size of the entire message including attachments</para> + </listitem> + <listitem> + <para>Date: the date of sending by the sender</para> + </listitem> + <listitem> + <para>From: who sent the message</para> + </listitem> + <listitem> + <para>Subject: what the message is about</para> + </listitem> </itemizedlist> - <para> You can sort the summary view in many ways, by clicking the button that is above the column. Click once to sort going up (a-z), click once more to sort going down (z-a). </para> - <para> - If you think the size of a column is not right, you can adjust that - by placing the mouse cursor next to the button of the column you - want to adjust, press mousebutton1 (left button) and drag the - column to the width you want it to have. + If you think the size of a column is not right, you can adjust that + by placing the mouse cursor next to the button of the column you + want to adjust, press mousebutton1 (left button) and drag the + column to the width you want it to have. </para> - <para> - Select a message by clicking on it with the mouse. Once the summary - pane has the focus of the program, you can also move up and down - in the list through the cursor keys, or pressing "p"(revious) and - "n"(ext) as in Pine. + Select a message by clicking on it with the mouse. Once the summary + pane has the focus of the program, you can also move up and down + in the list through the cursor keys, or pressing "p"(revious) and + "n"(ext) as in Pine. </para> </section> - <section> - <title>Message view</title> - + <title>Message view</title> <para> - In the message view you can read the message that you selected in - the summary pane. If you entered the summary pane without selecting - a message, the message view will be empty. At the top of the - message view some info is presented about the message you are - reading, as well as some statistics on the selected folder. + In the message view you can read the message that you selected in + the summary pane. If you entered the summary pane without selecting + a message, the message view will be empty. At the top of the + message view some info is presented about the message you are + reading, as well as some statistics on the selected folder. </para> - <para> - You can scroll up and down in the message by using the arrow keys - (after clicking inside the message), or by using the scrollbar. + You can scroll up and down in the message by using the arrow keys + (after clicking inside the message), or by using the scrollbar. </para> - <para> - The size of the message and summary views can be adjusted by dragging - (with the left mouse button down) the handle that appears between - the two panes. + The size of the message and summary views can be adjusted by dragging + (with the left mouse button down) the handle that appears between + the two panes. </para> - <para> - The small arrow located just below the summary pane scrollbar can - be used to detach the message view. When clicked, the summary view - is extended down to the bottom of the Sylpheed window, and the messages - are displayed is a separate window (when you double click them in the - summary pane). This state is not saved on exit, and the message window - can be restored below the summary one by clicking again the small arrow. + The small arrow located just below the summary pane scrollbar can + be used to detach the message view. When clicked, the summary view + is extended down to the bottom of the Sylpheed window, and the messages + are displayed is a separate window (when you double click them in the + summary pane). This state is not saved on exit, and the message window + can be restored below the summary one by clicking again the small arrow. </para> - <para> - When the current message contains attachments, two tabs - are displayed in the message window. Selecting the first one makes - the message window display the text body of the message, while selecting - the second tab makes the message window display the attachment part - of the message. In the latter case, the message window is splitted - in two parts, the top one contains the attachments as a tree - with the MIME type, size and file name of each part, while the bottom - part contains the content of the selected attachment (if the attachment - is an image and Sylpheed has been compiled with the gdk-pixbuf or - the imlib library). + When the current message contains attachments, two tabs + are displayed in the message window. Selecting the first one makes + the message window display the text body of the message, while selecting + the second tab makes the message window display the attachment part + of the message. In the latter case, the message window is splitted + in two parts, the top one contains the attachments as a tree + with the MIME type, size and file name of each part, while the bottom + part contains the content of the selected attachment (if the attachment + is an image and Sylpheed has been compiled with the gdk-pixbuf or + the imlib library). </para> </section> -</chapter> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_008.xml b/manual/en/manual_008.xml new file mode 100644 index 0000000..6cca81b --- /dev/null +++ b/manual/en/manual_008.xml @@ -0,0 +1,710 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-8"> + <title>Sylpheed configuration</title> + <para> +All the configuration settings of Sylpheed are accessible from +the <computeroutput>Configuration</computeroutput> menu and consist of common settings +(<computeroutput>Common preferences</computeroutput>, <computeroutput>Filter settings</computeroutput>, +<computeroutput>Template</computeroutput> and <computeroutput>actions</computeroutput>) and account specific +settings. +</para> + <para> +With Sylpheed, there is no limit to the number of accounts +you can create. You can create new accounts for each of your +mail account, but also to change the default behaviour of +Sylpheed. As folders can be attached to accounts, the account +specific part of the configuration automatically change based +on the current folder (you can have a different signature when +replying to messages from different folders).</para> + <section> + <title>Common preferences </title> + <para> +The Common Preferences, found in the Configuration menu, controls +the window layout and the different options of the graphical +interface of Sylpheed. Depending on some compile time switches +(and on the availability of some extra libraries), some tabs +may be included (or not) in your version of Sylpheed. These tabs +are not listed here but are described (or will be described) in +the sections covering the optional features they control (like the +<computeroutput>Privacy</computeroutput> tab for the GnuPG interface).</para> + <section> + <title>Receive tab </title> + <para> +In here you can set up how to receive messages.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_receive..png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + You can define a special program to pick up messages from + the default unix mailbox. Usually this is not used, but + you can use it. Actually, this information may be wrong. + If someone knows better, please let me know. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Local spool</computeroutput> lets you define where your local mailbox is + located. You can also tell Sylpheed whether or not to + filter the incoming messages from that mail spool file. + The spool directory defined here is used by all the accounts + of the <computeroutput>local</computeroutput> type, by default it is set to the + standard UNIX mailbox location. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Autocheck new mail</computeroutput>. When you check this option, Sylpheed + will check if there is new mail on the set interval. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Check new mail on startup</computeroutput> means that Sylpheed will + immediately look for new mail on all the selected accounts + when it loads. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Update all local folders after incorporation</computeroutput> + Well, if you know the use of this option, feel free to + write this part... + </para> + </listitem> + <listitem> + <para> + In the news section you can specify how many articles + should be downloaded when opening a newsgroup. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Send tab </title> + <para> +In here you can set up how to send messages.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_send..png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + You can choose to use an external program (like sendmail) for + sending mail. By default no external program is necessary + and Sylpheed can directly send the outgoing messages to a + SMTP server. + </para> + </listitem> + <listitem> + <para> + The sent messages can be saved in the outbox (<computeroutput>Sent</computeroutput> + folder), the name of the outbox folder can be specified + for each account (see the account setting section). + </para> + </listitem> + <listitem> + <para> + The outgoing codeset selection can be changed to force + the definition of the character set used in sent mails. + The default and recommended value is <computeroutput>automatic</computeroutput>, + so Sylpheed determines the codeset when sending each + message. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Compose tab </title> + <para> +Controls the composition window's behaviour...</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_compose.png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + You can change the signature separator and choose to insert + it automatically (unless your signature file already contains + this separator). Leave it as it is by default (unless you really + need to change it, and are ready to face a religion war), a lot + of mail clients rely on this separator to cut the signature when + quoting mails, and this one is accepted as the standard one. + </para> + </listitem> + <listitem> + <para> + If you hate the editor that comes with Sylpheed, you can choose + to automatically start an editor of your choice when composing + new messages (the editor can be defined in the <computeroutput>Other</computeroutput> tab). + </para> + </listitem> + <listitem> + <para> + The <computeroutput>wrap</computeroutput> settings defines how Sylpheed will wrap long + lines. You can choose to wrap quoted messages, wrap as you type, + or wrap when sending. You can also change the maximum line length. + </para> + </listitem> + <listitem> + <para> + The <computeroutput>reply</computeroutput> settings let you control the way you will reply + to mails. If <computeroutput>Automatically select account(...)</computeroutput> is set, + the account used when replying to a message is automatically + selected based on the folder the original message is in (as you + where already told, accounts can be attached to folders). + If <computeroutput>Quote message when replying</computeroutput> is selected, when hiting + the <computeroutput>Reply</computeroutput> button, the composition window pops up and is + filled with either the complete message you are replying to (if + nothing is selected in the body of this message) or the selected + part of its body. When this option is not selected, the composition + window is always empty, and you must cut-and-paste the parts of + the original message you want to quote manually. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Quote tab </title> + <para> +In here you can control the quotation of your replies and forwarded +messages.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_quote.png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + You can individually define the quotation mark that appears + at the beginning of each quoted line when replying and forwarding + a message. + </para> + </listitem> + <listitem> + <para> + You can also define the text that appears before and after the + quotation. The format of the quotation contains placeholders for + parts of the original message that are explains in the window + that appears when hiting the <computeroutput>Description of symbols</computeroutput> + button. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Display tab </title> + <para> +In here you can control the display options of Sylpheed.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_display..png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + You can change the font used to display the messages. Pressing + the button next to the font name field will open the font selection + window, then you can select among all the available fonts. + </para> + </listitem> + <listitem> + <para> + Turning on the translation of the header fields will change the + content of the header summary (between the summary and the message + pane), and use the localized header fields name based on the + selected language (selected by the 'LANG' environment variable). + This setting will only take effect the next time you will start + Sylpheed. + </para> + </listitem> + <listitem> + <para> + Selecting <computeroutput>Display unread next to folder name</computeroutput> will add + the number of unread messages next to the folder name in the + folder pane (so you can minimize the width of the folder pane + and hide the unread column). + </para> + </listitem> + <listitem> + <para> + You can also control the content of the summary pane. If you choose + to display the recipient name for the mail you send, in the <computeroutput>From</computeroutput> + column, for any mail you have sent, the name of the recipient will + appear preceded by an arrow (the characters sequence: -->). + The <computeroutput>Expand threads</computeroutput> controls the initial state of the message + threads when opening a folder (expanded or collapsed). + The <computeroutput>Set display item of summary</computeroutput> button opens a selection + window that contains all the available items to display in the + left column, the currently selected items in the right column. + Items can be added or removed using the two arrows that appears + between the columns. Using the <computeroutput>up</computeroutput> and <computeroutput>down</computeroutput> buttons + on the right side of the window, you can change the display order + of the selected item in the summary window (from left to right). + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Message tab </title> + <para> +The message tab controls the message window options.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_message..png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + The message text can use colours to highlight the different levels + of quotation and URIs. The colours can be changed by using the + colours selection dialog that pops up when pressing the <computeroutput>Edit</computeroutput> + button next to the <computeroutput>Enable coloration of messages</computeroutput> toggle. + </para> + </listitem> + <listitem> + <para> + The display of the header summary between the summary and message + panes can also be turned on and off (<computeroutput>Display header pane above message view</computeroutput> dialog). + </para> + </listitem> + <listitem> + <para> + <computeroutput>Display short header on message view</computeroutput> and the <computeroutput>Edit</computeroutput> + button next to it, control the inclusion of some header fields + in the message view. If the message coloration has been turned on, + the addresses that appear in the header part of the message view + are highlighted as URIs. + </para> + </listitem> + <listitem> + <para> + The <computeroutput>Line space</computeroutput> setting controls the lines spacing of the + message view. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Leave space on head</computeroutput>. Checking this box will make the + start of new lines (unwrapped, where the writer has pressed + the Enter/Return key) indent a few pixels. This can be useful + to read larger e-mails. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Scroll half page</computeroutput>. When enabled, the text in the message + view will only scroll half a page instead of a whole page when + pressing the space bar. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Smooth scroll</computeroutput>. Enabling this box will make the text + in the message view scroll in a smooth, sliding way. For the + eye this can be pleasing, it is a personal preference. + </para> + </listitem> + <listitem> + <para> + Select the <computeroutput>Resize attached image</computeroutput> if you want all the + images (attachment) to be resized to fit in the message window. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Interface tab </title> + <para> +The interface tab controls the Sylpheed's Graphical User Interface +behaviour.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_interface..png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + The <computeroutput>Open message when cursor keys are pressed</computeroutput> toggles controls + the opening of the messages while you go through them in the summary + pane using the cursor (up and down arrows) keys. If this toggle is on, + each time you press the <computeroutput>down</computeroutput> (or <computeroutput>up</computeroutput>) key in the + summary window, the current message changes and the content of the + message view changes to the content of the newly selected message. + Otherwise, the content of the message view does not change unless you + press enter (then the message view contains the content of the selected + message). + This does not change the behaviour of the left mouse button (always selects + and open the pointed message). + </para> + </listitem> + <listitem> + <para> + <computeroutput>Open first unread message when entering a folder</computeroutput> if selected, + when opening a folder, the message view will contain the first unread + message of this folder (or the latest message in the order the folder + uses for sorting messages). If not selected, the message view remains + empty until a message is selected (by changing the current message with + the cursor keys or with the left mouse button). + </para> + </listitem> + <listitem> + <para> + <computeroutput>Only marks message read when open in new window</computeroutput> leaves the + selected message unread (but display it in the message view) until you + open it in a new window (double click the left mouse button). + </para> + </listitem> + <listitem> + <para> + If <computeroutput>Execute immediately when moving or deleting messages</computeroutput> is not + selected, a new button appears in the button bar marked <computeroutput>Execute</computeroutput>. + When deleting or moving messages, they are first marked as deleted or + moved but Sylpheed does not move or delete them until you press the + <computeroutput>Execute</computeroutput> button (or the <computeroutput>Execute</computeroutput> entry of the + <computeroutput>Tools</computeroutput> menu). + </para> + </listitem> + <listitem> + <para> + The <computeroutput>Receive dialog</computeroutput> settings controls the dialog that pops + up (if you have set <computeroutput>Show receive dialog</computeroutput> to <computeroutput>always</computeroutput>) + when receiving new mails. + The default is to open a pop up window upon reception error unless + you select the <computeroutput>Dont't pop up error dialog (...)</computeroutput> toggle. + </para> + </listitem> + <listitem> + <para> + <computeroutput>The Set key bindings</computeroutput> button when pressed, opens a selection + window that contains a list of pre-defined key bindings (<computeroutput>Mew</computeroutput>, + <computeroutput>Mutt</computeroutput>, <computeroutput>Old Sylpheed</computeroutput>) to change all the key bindings + at once. The key bindings can also be changed one by one as described in + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Other tab </title> + <para> +The other tab contains the settings that does not fit the +previous categories.</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/pref_other..png"/> + </imageobject> + </mediaobject> + <itemizedlist> + <listitem> + <para> + <computeroutput>Web browser</computeroutput>. Here you can enter the name of your favorite + web browser (Netscape, Opera, Mozilla, Lynx etc.). Add the %s parameter + to the command so Sylpheed knows it has to provide the text you clicked + on as the URL that the browser has to visit. + The arrow next to the text field can be used to display a scrolling + list of predefined URL browsing command lines. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Printing</computeroutput>. Here you can define the program that should be used + to print. Default is lpr, and the %s is the name of the temporary file + that Sylpheed creates for lpr to print. + When using the <computeroutput>File->Print</computeroutput> menu entry to print the selected + message, a text window pops up to allow you to change the command + used to print. + </para> + </listitem> + <listitem> + <para> + <computeroutput>External editor</computeroutput>. You can select an external editor to write + your e-mails with, for example vi, emacs or gedit. Note that for + text-based editors like vi, you need to define a terminal window, + e.g. <guilabel>xterm -e vi %s</guilabel>. Otherwise there is no place that the + editor will be able to show up. Here too, the %s parameter is the + name of a temporary file that is created by Sylpheed. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Add address to destination (...)</computeroutput> when selected, + double clicking an e-mail address (in the address book, + when the composition window is opened) can be used to add + this address to the <computeroutput>To:</computeroutput> field. + </para> + </listitem> + <listitem> + <para> + Confirming if you want to exit Sylpheed (or just exit quietly). + </para> + </listitem> + <listitem> + <para> + Cleaning the trashbox when exiting Sylpheed. + </para> + </listitem> + <listitem> + <para> + Have Sylpheed ask you to clean the trash before it is done. + </para> + </listitem> + <listitem> + <para> + Warn you when exiting Sylpheed when there are still messages + queued to be sent. + </para> + </listitem> + </itemizedlist> + </section> + </section> + <section> + <title>Setting up an account/changing an account </title> + <para> +In order to set up an account in Sylpheed, in the <computeroutput>Configuration</computeroutput> +menu you select <computeroutput>Create new account</computeroutput>. If you want to change the +settings of an existing account and this account is the current +one, in the <computeroutput>Configuration</computeroutput> menu select <computeroutput>Preferences for current account</computeroutput>, otherwise select <computeroutput>Edit accounts...</computeroutput>. +There you select the account you want to change. After that you press +<computeroutput>edit</computeroutput>. Then a dialog appears in which you can enter or update +the following areas: +</para> + <section> + <title id="Basic">Basic tab </title> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/account_basic..png"/> + </imageobject> + </mediaobject> + <para>In the "Basic" tab you name the account. This is to make identifying +the account easier. The name is then used in the <computeroutput>Change current account</computeroutput> +part of the <computeroutput>Configuration</computeroutput> menu, or in menu found in the lower +right corner of the main window (used to quickly switch to another account). +</para> + <para> +Choose a name that tells something about the account, like the +name of the ISP, mailbox or news-server you are setting up. +You can select this account to be the default account ("Usually used"). +The default account can also be defined from the <computeroutput>Edit accounts</computeroutput> +window (toggle the <computeroutput>D</computeroutput> column next to the account name). +</para> + <para> +Enter your name and e-mail address, and if you have one, the +organization that you use Sylpheed for. +In the Protocol box you select the type of service that this +account will be using. The flavors you can choose are: <computeroutput>POP3 normal</computeroutput>, +<computeroutput>POP3 APOP auth</computeroutput>, <computeroutput>IMAP4</computeroutput>, <computeroutput>NNTP news</computeroutput> or <computeroutput>None (local)</computeroutput>. +</para> + <para> +For POP3 and IMAP services you can then specify the server where +your mail is stored. Details about this name, and also the name +that goes into the field for <computeroutput>SMTP server (send)</computeroutput> should be given +to you by your ISP. +</para> + <para> +For a local unix mailbox, the <computeroutput>Server for receiving</computeroutput> is disabled, +since the mail will be received for you. +</para> + <para> +The fields for <computeroutput>User ID</computeroutput> and <computeroutput>Password</computeroutput> will also be +disabled for accounts that do no deal with POP3 or IMAP services. +Otherwise you can enter the login name and password for the e-mail +server with your ISP here. Usually these are the same as your login +name and password to access the dial-in service, but this is +not standard. If in doubt, contact the helpdesk of your ISP.</para> + <section> + <title>Passwords: </title> + <para> +The password is not printed in the entry field (replaced by stars) but +is stored in plaintext in the Sylpheed configuration files. The Sylpheed +configuration directory (~/.sylpheed) is only readable by 'owner', and +not by 'group' and 'other', do not change these access rights.</para> + </section> + </section> + <section> + <title id="Receive">Receive tab</title> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/account_pop_receive..png"/> + </imageobject> + </mediaobject> + <para>The <computeroutput>Receive</computeroutput> tab is only used for POP3 accounts. Here you +specify if the mails that were successfully retrieved should be removed +from the server. You can also tell Sylpheed to get all the +messages there, not only the ones you already received (in case +you leave your messages on the server). +You can choose to leave the messages on the server during a selectable +number of days (then remove them). +</para> + <para> +You can also define a limit for the size of the messages to +download. Any message bigger than this limit will not be +downloaded. +</para> + <para> +You can also choose to filter messages on receiving, if not +set, the messages are only filtered when you use the filter +entry of the Tools menu. +</para> + <para> +The default inbox defines the folder that receives the incoming +(and not filtered) messages for this account. +You can define a different folder as inbox for each of your +accounts. +</para> + <para> +If the <computeroutput>Get all checks for messages on this account</computeroutput> is turned +off, when using the <computeroutput>Get all</computeroutput> menu entry (or toolbar button) +this account will not be checked. To check for new mails for +this account, you must select the account, then use the <computeroutput>Get</computeroutput> +toolbar button (or menu entry). +</para> + </section> + <section> + <title id="Send">Send tab</title> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/account_send..png"/> + </imageobject> + </mediaobject> + <para>In the <computeroutput>Send</computeroutput> tab you can define the settings that apply +to sending mails. +</para> + <para> +You can choose to add the date field to the messages you send, +generate a unique message identifier, or add custom header +fields. + +</para> + <para> +If your SMTP server needs authentication, define the user ID and +password to use in this tab. You can also choose to first authenticate with +POP3 before sending.</para> + <section> + <title>X-face pictures: </title> + <para> +The user defined header field should be set up to contain your +X-face picture. +Thanks to Jeff Dairiki, you can have a complete online course in this. +Visit <ulink url="http://www.dairiki.org/xface/">this page</ulink> for the details.</para> + </section> + </section> + <section> + <title id="Compose">Compose tab</title> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/account_compose..png"/> + </imageobject> + </mediaobject> + <para>In the <computeroutput>Compose</computeroutput> tab you can define your signature file, +choose to always copy someone when sending mails (you can +choose to always copy your boss, or yourself), and define the +Reply-To field for the current account.</para> + </section> + <section> + <title id="Privacy">Privacy tab</title> + <para> +This tab is only available when Sylpheed has been compiled +with GPGME and GNUPG (for signature and encryption). + +</para> + <para> +With this tab you can choose the keys to use when signing +or encrypting mails for this account.</para> + </section> + <section> + <title id="Advanced">Advanced tab </title> + <para> +The Advanced tab contains some settings you normally do +not need to change (unless you really know what you are +doing).</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/account_advanced..png"/> + </imageobject> + </mediaobject> + <para> +You can change the default SMTP or POP3 ports used when +connecting to your mail server, define a domain name to +use when sending a mail. Some ISP (or mail relays) reject +mails without a valid domain name. +</para> + <para> +The default folders for the sent messages, drafts and +trash can be defined here. If not changed the current account +will use the default folders.</para> + </section> + <section> + <title>Attaching accounts to folders </title> + <para> +Pressing the right mouse button over a folder (in the folder pane), +and selecting the <computeroutput>Properties</computeroutput> entry will open the folder properties +form. In this form, in the <computeroutput>General</computeroutput> tab you can see (but not modify) +the folder name and the corresponding directory path (relative to the mail +directory). In the <computeroutput>Compose</computeroutput> tab:</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/folder_prop_compose..png"/> + </imageobject> + </mediaobject> + <para>You can select the account, choose to apply this setting also to +the sub-folders. +You can also force the address used when sending mail (to force a mailing +list address, for example), choose to send a copy of the sent mails +to a list of addresses different from the default one defined for the +selected account.</para> + </section> + <section> + <title>Using accounts in the real life </title> + <para> +Accounts can, of course be used to retrieve mails from different ISPs, +separate your personal and professional messages, but also to make your +life easier. +You can define different accounts just to change your address (as sender), +your signature, change the sent folder, etc... +Here is a summary of the account specific settings, feel free to +find your own use for them:</para> + <itemizedlist> + <listitem> + <para> + Sender name, address and organization. Signature, extra header + fields. + </para> + </listitem> + <listitem> + <para> + Leave or remove message from server (usefull for debug). + </para> + </listitem> + <listitem> + <para> + Incoming mails filtering and size limit. + </para> + </listitem> + <listitem> + <para> + Default field (<computeroutput>Reply-To</computeroutput>:, <computeroutput>Cc:</computeroutput>, <computeroutput>Bcc:</computeroutput>). + </para> + </listitem> + <listitem> + <para> + <computeroutput>Draft</computeroutput>, <computeroutput>Trash</computeroutput> and <computeroutput>Sent</computeroutput> folders. + </para> + </listitem> + </itemizedlist> + <para>By attaching accounts to folders, you can control all these settings +on a folder basis, but you can also change the <computeroutput>To:</computeroutput>, <computeroutput>Cc:</computeroutput>, +<computeroutput>Bcc:</computeroutput>, and <computeroutput>Reply-To:</computeroutput> for each folder (overrides the account +settings).</para> + </section> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_009.xml b/manual/en/manual_009.xml new file mode 100644 index 0000000..cc96cb0 --- /dev/null +++ b/manual/en/manual_009.xml @@ -0,0 +1,99 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-9"> + <title>Viewing messages</title> + <section> + <title>Reading a message </title> + <para> +Reading a message is quite simple. If you have the message pane +within view, all you need to do is once click the message you +want to read and it already appears in the message view. +When you double-click the message, a separate window will open, +showing you the message. You can close the opened window by +pressing ESCape or clicking the 'close' button. +</para> + </section> + <section> + <title>Viewing Multipart MIME (Attached Files) </title> + <para> +When a message contains an attachment, you can have several +options to view the information in that file. Sylpheed can +be able, when compiled against the proper libraries, to +display images "inline". This means you can click the name +of the image and you can see it in the lower part of the +message screen. +</para> + <para> +How do you see an attachment is in an e- mail? +</para> + <para> +This shows through an extra section that appears between +the summary pane and the message view. In it you can see +the separate parts of the e-mail. Sometimes you can't +view the contents of an attachment directly. Then you +can rightclick the name of the file and select "OPEN" +from the appearing menu. If this does not work, it means +that the extension of the file is not recognized through +the directives in the mailcap file. In that case you +can always use the "Save as..." option in the popup menu, +save the file to disk and open the file with the proper +program. +</para> + </section> + <section> + <title>Extending and Closing Threads </title> + <para> +Sylpheed offers the option to view messages in threads. +Threads are no more than series of e-mails in a logical +sequence. Suppose 15 people sent you a mail called +"Re: bananas". You can't easily tell which one is the +first and which one is the last in that sequence. +</para> + <para> +By activating threads (summary menu), Sylpheed will +attempt to show the sequence of mails as they were +written/sent from first to last. +</para> + <para> +To undo the threads view, you simply select the same +menu option again and the e-mails are displayed in +standard order again. +</para> + </section> + <section> + <title>Message Operations (Moving, Deleting, etc.) </title> + <para> +Sylpheed gives you many ways to manage your messages. +You can move them to new mailboxes, or delete them. +Through the message menu (see that section for more +details) plenty of options are available to do with +your e-mails what you want done. The advantage of +moving messages to different mailboxes (also see +Filtering for that, as described in the Configuration +menu section) is that you keep an overview of your +inbox. Suppose you are collecting e-mails in there +of 8 different subjects. And you are looking for a +specific one on a specific subject. That will give +you a lot of work, trying to find the right message. +Creating a new mail folder for each subject, and +moving the messages to that new one, lifts a lot of +work afterwards from your hands. +</para> + </section> + <section> + <title>URL in a Message </title> + <para> +At times you may find a URL in a message. A URL is +a link to a website. Usually it is shown in the +form "http://www.somewhere.something". +</para> + <para> +If you want to visit that website, you only need to +double-click the URL, and the default webbrowser +you set up (usually Netscape) will activate and load +the website. +</para> + <para> +In the configuration options, Sylpheed has a color +setting specific for URL's so you can spot a URL easily. +</para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_010.xml b/manual/en/manual_010.xml new file mode 100644 index 0000000..a6c4e94 --- /dev/null +++ b/manual/en/manual_010.xml @@ -0,0 +1,23 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-10"> + <title>Recieving Messages</title> + <section> + <title>Using POP Reception Function in Sylpheed</title> + <para> +<!-- added 2001/07/19 --> +Receiving messages from a POP server is very easy, once you set up Sylpheed the proper way. You can refer to the section "Setting up an account" on how to do this.</para> + <para> +Once you are connected to the internet, or by another network that gives you access to the POP server, simply press the "Get new mail" button (or press Alt-I) and Sylpheed will connect to the server to fetch your new mail. Once this is retrieved, any filters you may have set up will be executed and then the folder pane will show you, marked in bold, which folder/mailbox contains new messages. +<!-- end addition 2001/07/19 --></para> + </section> + <section> + <title>Using Other Programs such as fetchmail</title> + <para> +<!-- added 2001/07/19 --> +Although it is not within the scope of this manual, a bit of information on fetchmail or getmail.</para> + <para> +You need to have either of these programs installed, and configured correctly. See the man pages/README files of the appropriate program on doing this.</para> + <para> +After setting the program up, you can invoke it, either by hand or through CRON, to get your mail. The mail will usually be downloaded into /var/spool/mail/your_user_id. You can then tell Sylpheed, through an account that looks in your local unix mailbox, to get mail from there. For this you press the "Get mail" button, or press "Alt-I". +<!-- end addition 2001/07/19 --></para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_011.xml b/manual/en/manual_011.xml new file mode 100644 index 0000000..eeabcf9 --- /dev/null +++ b/manual/en/manual_011.xml @@ -0,0 +1,42 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-11"> + <title>Composing Messages</title> + <section> + <title>Composing a New Message</title> + <para> +When you start writing a new message, you are presented a nice dialog in which you can enter all kinds of information. In the From: line you find a dropdown list. In there you can select the e-mail account you want to use as the sending account.</para> + <para> +In the To: / Cc: / Bcc: part, you write the e-mail address of the receiver. You can enter several e-mail addresses, as long as they are separated by commas. An important utility here is the button "Address". When you click that, you see the address book. You can point at an address, click the "To:", "Cc:" or "Bcc:" button, and Sylpheed will place the address in the selected line. The Bcc: may be greyed out. In order to make that accessible, you need to add the Bcc: line to the message. You do that through the Message menu, and checking the Bcc option.</para> + <para> +In the Subject line you enter a short descriptive text what your message will be about.</para> + <para> +You can move between these lines by pressing TAB (to skip to the next line) and SHIFT-TAB (to go back up). When you press TAB in the last line, you will be moved to the message body.</para> + <para> +Did you select a signature file in the settings for the active account, it will be in the message text already. You can now write your message. When you are done, you can click Send, Send later or Draft in the toolbar. Send attempts to send the message immediately. Send later will place it in the Send folder, and Draft will place it in the Draft folder. +</para> + </section> + <section> + <title>Replying to a Message</title> + <para> +<!-- added 2001/07/19 --> +To reply to a message, you use the "reply" function. In Sylpheed you activate this through either the "Reply" button, or by pressing Alt-R.</para> + <para> +A new message window will be created, with the e-mail address of the recipient and the subject already set for you. Most of the things described in Composing a new message are also applicable to this window. +<!-- end add 2001/07/19 --></para> + </section> + <section> + <title>Replying to a Message with Quotation</title> + <para> +<!-- added 2001/07/19 --> +If you want to have Sylpheed quote the text you are replying to, you need to go into the Configuration menu. There you select Common preferences, go to the Compose tab, and check the "Quote message when replying" box. There you can also edit the quotation mark (the mark put in front of each quoted line in the reply mail) and the reply attribution (which is placed in front of the reply text). +<!-- end add 2001/07/19 --> +</para> + </section> + <section> + <title>Forwarding Messages</title> + <para> +<!-- added 2001/07/19 --> +Forwarding a message means: you send the entire message, including headers (Sender address, date sent etc.) on to someone else. For this you press the "Forward" button, or you press Ctrl-F. A new message window is created, containing the text of the selected message. You can then supply the name(s) of the recipient(s) of the message as in composing a new message, perhaps add a few lines of text to the message and send it on its way. +<!-- end add 2001/07/19 --> +</para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_012.xml b/manual/en/manual_012.xml new file mode 100644 index 0000000..7d928ec --- /dev/null +++ b/manual/en/manual_012.xml @@ -0,0 +1,317 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-12"> + <title>Address Book</title> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/address_book..png"/> + </imageobject> + </mediaobject> + <para> +In the address book, accessible through Shift-Ctrl-A, +the Addressbook button, or through the "Tools" menu, you +store e-mail addresses of the people and places you want +to write more often. +</para> + <para> +If the options have been compiled into Sylpheed, the +address book can connect to a LDAP server for address +lookup, and you can use the address book stored on your +Palm PDA. +</para> + <section> + <title>Adding and Deleting Addresses </title> + <para> +Adding an address to the address book is quite easy too. +Rightclick the folder or group you want to add the address +to, select "new address" and fill in the dialog that comes +up. You can also directly click the Add button in the +address book window, and the dialog comes up. In this +case the address is moved into the folder/group that is +selected at the moment of adding. +</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/address_book_basic..png"/> + </imageobject> + </mediaobject> + <para> +In the "Basic data" tab, you can fill the first +and last name and provide a nickname. The "Display name" +will be used by the "Name" column of the address book +window. +</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/address_book_address..png"/> + </imageobject> + </mediaobject> + <para> +In the "E-Mail address" tab, fill the address field +and use the "Add" button to add the address to the list. +An alias can also be assigned to this address and used +when searching for an address. +Several addresses can be assigned to the same person +in your address book by repeating the sequence described +above. The addresses can then be sorted by using the +"Move up" and "Move down" buttons. The address on the top +will be the first one listed in the address book main window. +</para> + <para> +Deleting an address is equally simple. Find the address, +click it once, and press the Delete button. +</para> + </section> + <section> + <title>Folders and Groups </title> + <para> +You can use groups and folders to organize your address +book into categories, hierarchies and aliases. +The folders are used to generate a hierarchical organization +and contain the actual addresses, while the groups are +used to group together addresses that lives in separate +folders. +</para> + <para> +Sounds complicated, so let's see an example: consider +your workmates, they are arnaud (arnaud@company.com), +sandra (sandra@company.com), xavier (xavier@company.com) +and the chief, helene (helene@company.com). You can +create a folder named <guilabel>myGroup</guilabel>, create the entries +for all your workmates in this folder. Now you can create one +groupe named <guilabel>jokes</guilabel> that includes all but the boss +to use when sending your daily jokes, another one named +<guilabel>team</guilabel> that includes everybody for the usual group +(serious) communication, and a third group named +<guilabel>reports</guilabel> that includes the boss, and the one working +with you on some projects for the weekly reports. +</para> + <para> +To generate this kind of addresses organization +you only need to create the entries once, then when +creating groups you can select among the existing entries +to fill the groups. +</para> + <para> +The address book, like the mail folders, can be expanded +into an entire tree of sections. For this you right-click +on the folder where you want to add a new folder, and +select "new folder". Then you can enter a descriptive +name for the folder, click Ok, and your folder is created. +</para> + <para> +In this same way you can create a new group in a folder. +Right-click on the folder, select "new group", enter a name +for it, and that's it. +</para> + <para> +The group settings window pops up in order to fill the group +with addresses. Use the two arrows to add to or remove from +the group the selected address. +Once the group contains the list of addresses you want it to +contain, click the "OK" button to close the window. +</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/address_book_group..png"/> + </imageobject> + </mediaobject> + </section> + <section> + <title>Combination with Message Composition Window </title> + <para> +You can either enter the first letters of an address +(or alias) in the <guilabel>To:</guilabel> or <guilabel>Cc:</guilabel> field +of the composition window and press the TAB key to +let Sylpheed do the completion or open the address book, +select addresses from there and use the <guilabel>To:</guilabel> +and <guilabel>Cc:</guilabel> buttons to copy the selected addresses +into the corresponding fields of the composition window. +</para> + <para> +When using the completion mode, when one or more address +matches the start you have entered, a dropdown list appears. +Select the correct address from this list and press enter +to complete the composition window's field. +</para> + <para> +In completion mode, the search is made on the E-mail +address and on the alias. The other fields of the +address book entry are not used (name, nickname,...). +</para> + <para> +When the address book is opened, if you select a group, +using the <guilabel>To:</guilabel> or <guilabel>Cc:</guilabel> buttons will +copy all the addresses of the selected group into the +corresponding field of the composition window. +</para> + <para> +Using our previous example, you can select the <guilabel>jokes</guilabel> +group when sending you morning jokes, and the <guilabel>reports</guilabel> +one when sending your weekly reports... +</para> + </section> + <section> + <title>Using your PDA addressbook (with Jpilot) </title> + <para> +Sylpheed can optionally use your PDA addressbook. This option is +available if you have compiled Sylpheed with the support of Jpilot. +For more details regarding the compilation of Sylpheed with (or without) +optional features, see the compilation section. +</para> + <para> +Sylpheed uses the Jpilot side copy of your address book, so you do +not need to put your PDA on the craddle to find an address (but do +not forget to synchronize). +</para> + <para> +In order to use your PDA's addressbook in Sylpheed, open the addressbook +window, select the <computeroutput>JPilot</computeroutput> icon in the left tree view, +use the <computeroutput>File -> New Jpilot</computeroutput> menu entry and choose a name for +this addressbook. +Define the name of the Jpilot addressbook file (usually in: +<guilabel>~/.jpilot/AddressDB.pdb</guilabel>) and press <computeroutput>OK</computeroutput>. +You can use one (or more) of the custom fields to store alternate +Email addresses for the same person. +</para> + <para> +Now you can browse your PDA addressbook. Sylpheed only has read +access to this addressbook, so you can't modify your PDA addressbook +from Sylpheed. +</para> + </section> + <section> + <title>LDAP server connection </title> + <para>Contributed by Tom Hollins. +</para> + <para> +In order to add an LDAP server to the sylpheed program, you will click +on the <guilabel>Tools</guilabel> menu item, then click on <guilabel>Address book</guilabel>. +Sylpheed will open the address book window. +Select (click once) the <guilabel>LDAP Server</guilabel> line located in the left window +pane of the address book. +Now Click on the <guilabel>File</guilabel> menu item. +Click on the <guilabel>New server</guilabel> menu item. +Sylpheed opens a dialog box with standard LDAP text entry boxes. +</para> + <para> +We'll assume you work for <computeroutput>Spacely Sprockets Corporation</computeroutput>. This will be +used in the examples below. +</para> + <para> +The <guilabel>NAME</guilabel> line is the name you want to give to the LDAP server. It can +be anything but you should select, roughly the one that helps you to +identify it quickly. If you are doing this at a company, just enter +"Spacely LDAP" without the quotation marks. +</para> + <para> +The <guilabel>HOSTNAME</guilabel> line is the human name of the server from the DNS lookup +entry, OR the IP address of the LDAP server (important if the LDAP +server is used for authentication). So your company may have a server +called <computeroutput>ldap.spacely.com</computeroutput>. Your company may use something like 10.0.0.200. +Either of these should work. +NOTE: if you are a home user, you can specify "localhost" (no quotes) +or 127.0.0.1 as your hostname if your LDAP server runs on the same +machine as your mail client. Sylpheed automatically assumes a local +configuration and does this for you. I include this in case your +configuration is changing back to a local. +</para> + <para> +The <guilabel>PORT</guilabel> entry shouldn't have to be modified unless your IT department +has changed this. The normal port for LDAP is 389. +</para> + <para> +The <guilabel>SEARCH BASE</guilabel> text entry need not concern you since you can click +the <guilabel>Check Server</guilabel> button on this dialog box. After clicking this +button the <guilabel>SEARCH BASE</guilabel> will be automatically filled in. +The following paragraph gets technical and can be skipped for the +faint of heart. +</para> + <para> +For the sake of clarity, this is the DN (distinguished name) of the +LDAP server with only the DC entries. So for our example the LDAP +server has been setup with a DN = dc=spacely, dc=com. We would type +into the <guilabel>SEARCH BASE</guilabel> line (without quotes) "dc=spacely, dc=com". +I hope this is clear for the technically minded. +</para> + <para> +If your LDAP server allows anonymous binding and you do not have "virtual" +LDAP domains then you should be able to click on the <guilabel>OK</guilabel> button. +Now click once on the entry for your server so that it becomes highlighted. +Click once in the <guilabel>NAME</guilabel> text entry field below the right pane. +Enter someone's first name. +Click once on the <guilabel>Lookup</guilabel> button. It should work. Below the lookup +button is a status line which will tell you whether you have an error +or not. Also, while it is searching it will blink (a good sign because +this means the login to the server worked). +If it does work you can skip the rest of this discussion. +</para> + <para> +If your LDAP server does not allow anonymous binding then you will +need to look at the top of the dialog box and find the "tab" marked +<guilabel>Extended</guilabel> and click it once. +You may need to enter the top level DN because you may have an LDAP +server which is setup with multiple virtual domains. Your IT guy +needs to get involved here by telling you what the DN really is +along with, maybe, its password. It really depends upon how it is +setup. Maybe the DN includes a CN (common name). +So for our example (and in the OpenLDAP examples) you have entered +a DN = cn=manager, dc=spacely, dc=com. +In the <guilabel>BIND DN</guilabel> text entry box enter (without quotes) +"cn=manager, dc=spacely, dc=com". +In the <guilabel>PASSWORD</guilabel> text entry box enter just the password itself no +equals sign or anything. +Click the <guilabel>OK</guilabel> and try the test lookup above. +</para> + <para> +If you are still experiencing a problem, then it may be the +search criteria you are using or the attributes used by your +LDAP server. +</para> + <para> +The attributes" of the server are "field names" that are being +searched. The acceptable fields are automatically entered for +the Sylpheed defaults, and they are <guilabel>(&(mail=*)(cn=%s*))</guilabel>. I will +use words to now describe that line, just in case it is hard for +you to figure out what is entered here: left open parenthesis, +ampersand, left open parenthesis, the word mail (or any attribute +in LDAP speak or called field in database speak), an equal sign, +an asterisk (means search all), right closing parenthesis, left +open parenthesis, the letters "cn", an equal sign,a percent sign, +the letter "s", an asterisk, right closing parenthesis, right +closing parenthesis. +While not necessarily the best criteria it should work, but only +if your IT department has formatted the Common Name (CN) the way +you are searching for it. +The entry essentially states "search on ALL email addresses, and +the common name starts with" (whatever you have typed into the +lookup field). +Another way to test this is to work through the alphabet and enter +one character only, and see if this retrieves some entries. Once +you see some entries you will understand how to effectively search. +If this doesn't work then you will need to get someone from your +IT department involved. The "mail" or "cn" either isn't used in a +normal way, doesn't exist, or it is stored some way that can not +be debugged in a document like this one. +</para> + <para> +Additional searching for people who get some results but not exactly +what they want: +Try using and asterisk before your search criteria. This will say +to the LDAP server "I want you to return all entries where this +text exists anywhere in the CN field". +By now you should realize that if you are entering this asterisk +all the time then you right click your LDAP server entry in the +left pane and choose <guilabel>Edit</guilabel> from the pop-up menu. Click on the +<guilabel>Extended</guilabel> tab and change that first line to have an asterisk +before the percent sign. I use this since I don't always know +whether the name was entered as a formal name like Thomas or +informal like Tom. +</para> + <para> +If you still can't do anything with LDAP then there is a proxy +between you and the LDAP server that your IT department has to +address, or there is something about the "attributes" (fields) +of your LDAP database you will need to enter into that extended +tab of the LDAP server edit dialog box. +</para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_013.xml b/manual/en/manual_013.xml new file mode 100644 index 0000000..a0e4da9 --- /dev/null +++ b/manual/en/manual_013.xml @@ -0,0 +1,667 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-13"> + <title>Filters, actions and templates</title> + <para> +Sylpheed offers three powerfull tools to help you automatically +and efficently manage you mails. These tools are:</para> + <itemizedlist> + <listitem> + <para> + The <computeroutput>filters</computeroutput>, that let you sort you incoming messages and move + them into your folders based on their sender, their content, + using regular expressions. + </para> + </listitem> + <listitem> + <para> + The <computeroutput>actions</computeroutput> feature is a convenient way for the user to launch + external commands to process a complete message file including + headers and body or just one of its parts. + It allows also the use of an external command to filter the whole + text or just a selected part in the message window or in the + compose window. + </para> + </listitem> + <listitem> + <para> + The <computeroutput>templates</computeroutput> that let you pre-define complete messages + leaving placeholders in the text to be filled at composition time. + </para> + </listitem> + </itemizedlist> + <section> + <title>Filters </title> + <para> +Written by Nick Selby (sylpheed@nickselby.com) +</para> + <para> +Sylpheed provides powerful filters to allow users to automatically +pre-sort incoming mail based on a set of rules that the user defines. +As a most simple example, let's say you work at the Acme Grommet Company, +and you want all e-mail from your co-workers to be placed in one mailbox. +To accomplish this, you would set up a filter that would place all mail +whose "From" header includes the phrase "acmegrommet.com" into a specific +mailbox. +</para> + <para> +Sylpheed allows you much more control than just that simple setup; +you may create filters based on several variables, including an +"If this AND that" or "If the message contains this OR does NOT contain that" +etc. It's very cool. +</para> + </section> + <section> + <title>Finding The Filter Setting Dialog </title> + <para> +The filter settings dialog is located in the <computeroutput>Configuration</computeroutput> menu, +under the title "Filter Setting" or from the <computeroutput>Tools</computeroutput> menu, under in +the <computeroutput>Create filter rules</computeroutput> sub menu. You may also use establish a +keyboard shortcut (see Keyboard Shortcuts). +</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/filters..png"/> + </imageobject> + </mediaobject> + </section> + <section> + <title>Setting Up Filters</title> + <para> +Operator(s) and Processing instructions combine to create a Filter Rule. + +* Operators +The dialog's first setting option establishes the Operator, the variable +that will tell the filter what specific text to look for to trigger a +filter. Each Filter Rule may have up to two operator sets. +</para> + <para> +Each Operator variable contains three sections: <computeroutput>Header</computeroutput>, +<computeroutput>Keyword</computeroutput> and <computeroutput>Predicate</computeroutput>. +</para> + <para> +Header is a drop-down box which defines in which message header +Sylpheed's filter will search. Choices range from <computeroutput>Subject</computeroutput> +to <computeroutput>X-Mailer</computeroutput>. </para> + <para><computeroutput>Keyword</computeroutput> is a a text box in which you may enter the text +for which the filter will search. </para> + <para>Predicate allows you to choose to filter based on whether the operator +contains, or does not contain, the text you enter in the Keyword field. +</para> + <para> +Example: Create an Operator in which the X-Mailer field of an incoming +message contains the word 'Eudora'.</para> + <itemizedlist> + <listitem> + <para> + Step 1. Under the <computeroutput>Header</computeroutput> drop-down box, select + <computeroutput>X-Mailer</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 2. In the <computeroutput>Keyword</computeroutput> text box, type 'eudora' + (case insensitive) + </para> + </listitem> + <listitem> + <para> + Step 3. Determine appropriate Predicate setting. Default + is <computeroutput>Contains</computeroutput>. + </para> + </listitem> + </itemizedlist> + <para>The second Operator setting, which is set identically to the +first, also allows the user to select an AND/OR setting +declaring the relationship between the two operators. +</para> + <para> +Example: Create an Operator set which will process mail with +a <computeroutput>From</computeroutput> header of bob@acmegrommet.com AND a subject +of "2001 Spring Grommet Collection"</para> + <itemizedlist> + <listitem> + <para> + Step 1. Under the first Operator set's Header drop-down + box, select <computeroutput>From</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 2. In the <computeroutput>Keyword</computeroutput> text box, type + 'bob@acmegrommet.com' (case insensitive). + </para> + </listitem> + <listitem> + <para> + Step 3. Leave <computeroutput>Predicate</computeroutput> setting on default, + <computeroutput>Contains</computeroutput> + </para> + </listitem> + <listitem> + <para> + Step 4. Leave <computeroutput>AND/OR</computeroutput> box on default setting, <computeroutput>and</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 5. Under the second Operator set's <computeroutput>Header</computeroutput> + drop-down box, select <computeroutput>Subject</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 6. In the <computeroutput>Keyword</computeroutput> text box, type + '2001 spring grommet collection' (case insensitive). + </para> + </listitem> + <listitem> + <para> + Step 7. Leave <computeroutput>Predicate</computeroutput> setting on default, + <computeroutput>Contains</computeroutput>. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Message Processing </title> + <para> +Once you've established the Operator(s) that will define +which messages will be processed, it's time to tell +Sylpheed what to do with messages that match the operator(s). +You may choose between two radio button-selected settings: +<computeroutput>Destination</computeroutput> and <computeroutput>Don't Receive</computeroutput>. +</para> + <para> +Selecting <computeroutput>Destinations</computeroutput> will enable you to route +the mail into a mailbox which you specify. +</para> + <para> +Selecting <computeroutput>Don't Receive</computeroutput> will instruct Sylpheed +to not download messages with that operator. Note that with +<computeroutput>Don't Receive</computeroutput>, Sylpheed merely leaves the message +on your mailserver - it does not delete it. </para> + <para>To specify a mailbox to which you want the message transfered, +click on the radio button to the left of the word <computeroutput>Destination</computeroutput> +in the dialog. (Currently, in order to specify a mailbox you +must have created that mailbox prior to activating the Filter +Setting dialog.) Clicking the <computeroutput>Select</computeroutput> button will open +a pop-up window containing all mail folders currently active +in your copy of Sylpheed. Select the mailbox you wish by either </para> + <itemizedlist> + <listitem> + <para> + (a) double clicking on the mail folder name or + </para> + </listitem> + <listitem> + <para> + (b) clicking the mail folder name and then clicking <computeroutput>OK</computeroutput>. + </para> + </listitem> + </itemizedlist> + <para> +To specify that the message not be retrieved, and left +on your mail server, click the radio button to the left +of the words <computeroutput>Don't Receive</computeroutput>. +</para> + </section> + <section> + <title>Filter Registration </title> + <para> +Now that you have set the Operator and the Processing Rule, +all that's left to do is tell Sylpheed to save the entire +Filter Rule. <emphasis>If you skip this step, the filter won't work</emphasis>. +</para> + <para> +The <computeroutput>Register Rules</computeroutput> configuration has three options: +<computeroutput>Register</computeroutput>, <computeroutput>Substitute</computeroutput> and <computeroutput>Delete</computeroutput>. +</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>Register</computeroutput> saves the Filter Rule. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Substitute</computeroutput> modifies an existing registered + Filter Rule. + </para> + </listitem> + <listitem> + <para> + <computeroutput>Delete</computeroutput> will remove a previously registered + Filter Rule. + </para> + </listitem> + </itemizedlist> + <para>Example of Registering A Filter Rule: Create a Filter Rule +that moves all mail with the subject of "Sylpheed Manual" +into the (previously created) mail folder "Sylpheed Manual Mail".</para> + <itemizedlist> + <listitem> + <para> + Step 1. Under the first Operator set's <computeroutput>Header</computeroutput> + drop-down box, select <computeroutput>Subject</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 2. In the <computeroutput>Keyword</computeroutput> text box, type + 'sylpheed manual' (case insensitive). + </para> + </listitem> + <listitem> + <para> + Step 3. Leave <computeroutput>Predicate</computeroutput> setting on default, + <computeroutput>Contains</computeroutput>. Leave second Operator set empty. + </para> + </listitem> + <listitem> + <para> + Step 4. Click <computeroutput>Destinations</computeroutput> radio button; + select "Sylpheed Manual Mail" folder. + </para> + </listitem> + <listitem> + <para> + Step 5. Click <computeroutput>Register</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 6. Click <computeroutput>OK</computeroutput>. + </para> + </listitem> + </itemizedlist> + <para>Example of Substituting A Filter Rule: Modify a previously +created Filter Rule that moves all mail with the subject +of "Sylpheed Manual" to sort mail not to the mail folder +"Sylpheed Manual Mail" but rather the mail folder "Sylpheed Questions"</para> + <itemizedlist> + <listitem> + <para> + Step 1. Under the first Operator set's <computeroutput>Header</computeroutput> + drop-down box, select <computeroutput>Subject</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 2. In the <computeroutput>Keyword</computeroutput> text box, type + 'sylpheed manual' (case insensitive). + </para> + </listitem> + <listitem> + <para> + Step 3. Leave <computeroutput>Predicate</computeroutput> setting on default, + <computeroutput>Contains</computeroutput>. Leave second Operator set empty. + </para> + </listitem> + <listitem> + <para> + Step 4. Click <computeroutput>Destinations</computeroutput> radio button; + select "Sylpheed Questions" folder. + </para> + </listitem> + <listitem> + <para> + Step 5. Click <computeroutput>Substitute</computeroutput>. + </para> + </listitem> + <listitem> + <para> + Step 6. Click <computeroutput>OK</computeroutput>. + </para> + </listitem> + </itemizedlist> + <para>Example of Deleting a Filter Rule: Remove the previously +created Filter Rule which refers to Subject:Sylpheed Questions.</para> + <itemizedlist> + <listitem> + <para> + Step 1. In the <computeroutput>Registered Rules</computeroutput> select box, + highlight the filter entitled + "<computeroutput>Subject:Sylpheed Manual: :::Sylpheed Questions:1:1:m</computeroutput>" + </para> + </listitem> + <listitem> + <para> + Step 2. Click the <computeroutput>Delete</computeroutput> Button. + </para> + </listitem> + <listitem> + <para> + Step 3. Confirm the deletion by clicking <computeroutput>Yes</computeroutput> in the + confirmation pop-up that asks, + <computeroutput>Do you really want to delete this rule?</computeroutput> + </para> + </listitem> + <listitem> + <para> + Step 4. Click <computeroutput>OK</computeroutput>. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Registered Rule Order </title> + <para> +One caveat about all this: the order in which Filter Rules +are created could adversely affect your intended message sorting, +and one needs to consider this when creating or updating Filter Rules. +</para> + <para> +For example, a Filter Rule saying, "Move anything containing 'ABC' +to Mailbox X" listed above another Filter Rule saying "Move anything +containing 'ABCDEF' to Mailbox Y" will cause the latter of these +filters not to process. +</para> + <para> +Think about the way Sylpheed goes down its list: first, it would say.. +"Hmm, any messages with ABC? Ah, there's one! Move it". +Then it would think, "Okay, any messages with ABCDEF?" +To which the answer would be "no" - that ABCDEF was already +filtered because it contained "ABC". +</para> + <para> +Bummer. +</para> + <para> +In order to avoid this, you must ensure that the more complex +Filter Rule is processed first, by placing it higher than a +similar, conflicting Filter Rule. +</para> + <para> +To move a Registered Rule higher or lower within the Registered +Rule box, select the rule you would like to move, and click on +the <computeroutput>Up</computeroutput> or <computeroutput>Down</computeroutput> buttons. This will "move" the +rule up or down, above or below a potentially conflicting Filter Rule. +</para> + </section> + <section> + <title>How to Filter Messages </title> + <para> +Filtering messages can be done in several ways:</para> + <itemizedlist> + <listitem> + <para> + Sylpheed automatically filters incoming mail from + POP servers. + </para> + </listitem> + <listitem> + <para> + If you incorporate mail from a unix mailbox, then + in the <computeroutput>Common preferences</computeroutput> (<computeroutput>Configuration</computeroutput> menu), + you need to check the box called <computeroutput>Filter on incorporation</computeroutput>. + You find this box in the <computeroutput>Receive</computeroutput> tab in the space + <computeroutput>Local spool</computeroutput>. + </para> + </listitem> + <listitem> + <para> + You can also select the option <computeroutput>Filter messages</computeroutput> + from the Summary menu. + </para> + </listitem> + </itemizedlist> + <para>Please note that, at time of writing, Sylpheed does -NOT YET- +has filtering of IMAP messages enabled.</para> + </section> + <section> + <title>Filtering mail with Procmail </title> + <para> +If you feel that Sylpheed has not enough options to perform +filtering for you, then you can look at Sylpheed Claws which +has more options for filtering. You can find the Claws version +(the cutting edge, experimental version of Sylpheed) +sylpheed-claws.sourceforge.net. +</para> + <para> +Another option, if you do not want to work with an experimental +version of Sylpheed, is Procmail. Procmail is a powerful mail +filtering program that is triggered from the Mail Transport +Agent (i.e. Sendmail, Postfix, Qmail). Procmail is called by +default from these programs after receiving e-mail. +</para> + <para> +The trick to procmail is to tell it that mail has to be filtered +into MH mail folders. This is not difficult though. +</para> + <para> +Normally procmail moves mail into MBOX format, this is one large +file containing all mails in a folder. MH uses separate files +for each e-mail. All you need to do is point the destination +of a procmail rule to <destination folder>/. +It is the "slash dot" that does the trick.</para> + </section> + <section> + <title>Actions </title> + <para> +The following section is a copy of +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/index.html">Melvin's page</ulink>. + +</para> + <para> +The "actions" feature is a convenient way for the user to +launch external commands to process a complete message file +including headers and body or just one of its parts. +It allows also the use of an external command to filter the +whole text or just a selected part in the message window or +in the compose window. This is a generic tool that allows +to do any uncommon actions on the messages, and thus extends +the possibilities of Sylpheed. For example, Sylpheed does not +include the rot13 cyphering algorithm popular in some +newsgroups. It does not support natively armored encryption +or clear signing. It does not support uuencoded messages. +As all these features can be handled by external programs, +the actions provide a convenient way to use them from the menu bar.</para> + </section> + <section> + <title>Usage </title> + <para> +To create a new action, go to the <computeroutput>Configuration</computeroutput> menu, +select the <computeroutput>Actions...</computeroutput> entry. The <computeroutput>Actions setting</computeroutput> +dialog offers to enter the Menu name that will trigger the command. +The created menu will be found in the <computeroutput>Tools -> Actions</computeroutput> submenu. +By inserting a slash / in the menu name, you create a submenu.</para> + <para>The command is entered in the Command line entry. Note that +Sylpheed stores every single email in a separate file. This allows +to use the following syntax for the command:</para> + <itemizedlist> + <listitem> + <para> + <computeroutput>%f</computeroutput> denotes the file name of the selected message. + If you selected more than one, then the command will be + launched for each message with the appropriate file name. + </para> + </listitem> + <listitem> + <para> + <computeroutput>%F</computeroutput> denotes the list of the file names of the + selected message. If only one message is selected, + this amounts to <computeroutput>%f</computeroutput>, but if more messages are + selected, then the command will be launched only once + with the list of the file names. (You can use both + <computeroutput>%f</computeroutput> and <computeroutput>%F</computeroutput> in one command: then the + command will be launched for each selected message + with the name of this message and with the list of + all selected messages. I did not find a practical + example for this.). + </para> + </listitem> + <listitem> + <para> + <computeroutput>%p</computeroutput> denotes the current selected message part + of a multipart message. The part is decoded accordingly. + If the message is not a multipart message, it denotes + the message body. + </para> + </listitem> + <listitem> + <para> + Prepending <computeroutput>></computeroutput>: this will allow you to send + to the command's standard input a text that you will + enter in a dialog window. + </para> + </listitem> + <listitem> + <para> + Prepending <computeroutput>*</computeroutput>: this will allow you to send to + the command's standard input a text that you will enter + in a dialog window. But in contrast to prepending + <computeroutput>></computeroutput>, the entered text is hidden + (useful when entering passwords). + </para> + </listitem> + <listitem> + <para> + Appending an ampersand <computeroutput>&</computeroutput>: this will run + the command asynchronously. That means "fire and forget". + Sylpheed won't wait for the command to finish, nor will + it catch its output or its error messages. + </para> + </listitem> + <listitem> + <para> + Prepending the vertical bar <computeroutput>|</computeroutput> (pipe-in): + this will send the current displayed text or the current + selected text from the message view or the compose + window to the command standard input. The command will + silently fail if more than one message is selected. + </para> + </listitem> + <listitem> + <para> + Appending the vertical bar <computeroutput>|</computeroutput> (pipe-out): this + will replace the current displayed text or the current + selected text from the message window or the compose + window with the command standard output. The command + will silently fail if more than one message is selected. + </para> + </listitem> + <listitem> + <para> + Appending the "greater than" sign <computeroutput>></computeroutput> will + insert the command output in the message. The difference + between the trailing <computeroutput>|</computeroutput> is that no text will be + deleted or replaced. Most used when composing mails to + insert text. + </para> + </listitem> + </itemizedlist> + <para><emphasis>Note</emphasis>: It is not possible to use actions containing +<computeroutput>%f</computeroutput>, <computeroutput>%F</computeroutput> or <computeroutput>%p</computeroutput> from the compose window. +</para> + <para> +When a command is run, and unless it is run asynchronously, +Sylpheed will be insensitive to any interaction and it will wait +for the command to finish. If the command takes too long +(5 seconds), it will popup a dialog window allowing to stop it. +This dialog will also be displayed as soon as the command has +some output: error messages or even its standard output when +the command is not a "pipe-out" command. When multiple commands +are being run, they are run in parallel and each command output +is separated from the outputs of the others. +</para> + </section> + <section> + <title>Examples </title> + <para> +Here are some examples that are listed in the same syntax +as used for storing the actions list. You can copy and past +the definition in your <computeroutput>~/.sylpheed/actionsrc</computeroutput> file +(exit Sylpheed before). The syntax is very simple: one line +per action, each action contains the menu name and the command +line separated by a colon and a space ": ". +Alternatively, you can use <computeroutput>Configuration -> Actions...</computeroutput> +and for each example enter a menu name and copy&paste the +text after the colon and space ": " in the command definition. +</para> +<!-- missing table --> <para>The gpg-enc-syl script is to be found +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/gpg-enc-syl">here (gpg-enc-syl)</ulink>. +It calls gpg with the --yes command line option that you may want +to remove it. See gpg manual page for info.</para> + <para>The gpg-sign-syl script is to be found +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/gpg-sign-syl">here (gpg-sign-syl)</ulink>. +It needs the ssh-askpass utility found in OpenSSH. It can be +replaced by any X11 tool that asks some (hidden) text which +is then sent to standard output. Another version that uses +an xterm is to be found +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/gpg-sign-syl-xterm">here (gpg-sign-syl-xterm)</ulink>.</para> + <para>The uudec script is to be found +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/uudec">here (uudec)</ulink>. +It needs uudecode and ImageMagick's display. The latter can be +replaced by any image viewer that can get input from standard +input. The script could also be modified to use temporary +files instead of standard input.</para> + <para>The google_msgid.pl script is to be found +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/google_msgid.pl">here (google_msgid.pl)</ulink> +Example and script by Thorsten Maerz. Edit the script to change +the browser (default is mozilla).</para> + <para>The tnef-claws bash script was written by Shawn Lamson and is +to be found +<ulink url="http://melvin.hadasht.free.fr/home/sylpheed/actions/tnef-claws">here</ulink>. +The script is well commented. You need to have the tnef package +already installed.</para> + </section> + <section> + <title>Templates </title> + <para> +With Sylpheed you can define mail templates to use when replying +to messages. A template can contain raw text (that will be inserted +in the composed mail without any change), and placeholders that are +replaced at composition time by the actual value of the selected +fields from the original message. +</para> + <para> +A typical use of the template could be to define the legal notice +to be appended to your messages (the usual notice that contains a +text like: "here are my own words and not those of my company, my +boss is not liable for them, bla, bla, bla"). +</para> + <para> +To define a new template, in the <computeroutput>Configuration</computeroutput> menu select +the <computeroutput>Templates</computeroutput> entry and fill the form:</para> + <mediaobject> + <imageobject> + <imagedata fileref="snapshots/template..png"/> + </imageobject> + </mediaobject> + <para> +The name parameter is used to identify each template, this name +will then appear in the <computeroutput>Tools/Templates</computeroutput> menu in the +composition window. +The content of the <computeroutput>To</computeroutput> field will be appended to the original +content of the corresponding field in the message you are composing. +The content of the <computeroutput>Subject</computeroutput> field will replace the orignal subject +of the message you are composing. +</para> + <para> +In the upper pane, type in the text you want to put in the template, +use the <computeroutput>Symbols</computeroutput> button to open a help window that contains +the description of all the placeholders you can use in a template +(there is one for the sender, one for the date, one for the message +ID, ...), then use the <computeroutput>Register</computeroutput> button to validate the +template. If you do not register the template, when leaving the form +the template will be canceled. To modify an existing template, select +it in the lower pane, modify its text, then use the <computeroutput>Substitute</computeroutput> +button. As you may guess, the <computeroutput>Delete</computeroutput> button removes the selected +template. Finally validate your changes with the <computeroutput>OK</computeroutput> button. +If you use the <computeroutput>Cancel</computeroutput> button, the form is closed and your changes +are lost (deleted templates are back, added templates are lost). + +</para> + <para> +To use a template, open the composition window and select the template +from the <computeroutput>Tools/Templates</computeroutput> menu. You can then choose to insert +the template into your message or to completely replace the text of the +message by the template. This only affects the body of the message. +If you choose to insert the template, its text will be inserted at the +cursor location. +</para> + <para> +The placeholders are taken from the source message when replying, so +they have no meaning when composing a new message. +</para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_014.xml b/manual/en/manual_014.xml new file mode 100644 index 0000000..53164e6 --- /dev/null +++ b/manual/en/manual_014.xml @@ -0,0 +1,155 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-14"> + <title>Handling MIME types</title> + <section> + <title>How Sylpheed checks for Mime types </title> + <para> +When attaching a file to a message (composing a new message), the +MIME type of the attached file is choosen based on the file extension +from the mapping list defined in the <computeroutput>mime.types</computeroutput> file(s). +Sylpheed defines its MIME type mapping table by loading the +system wide MIME types file, then the user file. +The systeme file is <computeroutput>SYSCONFDIR/mime.types</computeroutput> (SYSCONFDIR can +be defined a compile time), or if it does not exist, <computeroutput>/etc/mime.types</computeroutput>. +The user file is <computeroutput>$HOME/.sylpheed/mime.types</computeroutput>. +</para> + <para> +A <computeroutput>mime.types</computeroutput> file consist of one MIME type definition per line, +each definition line starting with the name of the MIME type, followed by +a space separated list of the corresponding file extensions. +The file can contain empty lines, and comments start with the <guilabel>#</guilabel> +character and close at line's end. +</para> + <para> +Following is a typical <computeroutput>mime.types</computeroutput> file (an extract of mine): + +<literallayout> +# This file controls what Internet media types are sent to the client for +# given file extension(s). Sending the correct media type to the client +# is important so they know how to handle the content of the file. +# The Internet media type registry is at +# ftp://ftp.iana.org/in-notes/iana/assignments/media-types/. + +# MIME type Extension +application/mac-binhex40 hqx +application/mac-compactpro cpt +application/msword doc +application/pdf pdf +application/postscript ai eps ps +application/rtf rtf +application/x-bcpio bcpio +application/x-bzip2 bz2 +application/x-csh csh +application/x-gtar gtar +application/x-gzip gz tgz +application/x-kword kwd kwt +application/x-kspread ksp +application/x-kpresenter kpr kpt +application/x-kchart chrt +application/x-latex latex +application/x-sh sh +application/x-shar shar +application/x-shockwave-flash swf +application/x-tar tar +application/x-tcl tcl +application/x-tex tex +application/x-texinfo texinfo texi +application/x-troff t tr roff +application/x-troff-man man +application/zip zip +audio/mpeg mpga mp2 mp3 +audio/x-aiff aif aiff aifc +audio/x-wav wav +image/gif gif +image/ief ief +image/jpeg jpeg jpg jpe +image/png png +image/tiff tiff tif +text/plain asc txt +text/rtf rtf +text/sgml sgml sgm +text/xml xml +video/mpeg mpeg mpg mpe +video/x-msvideo avi +text/html html htm + +</literallayout> + +</para> + <para> +If the file can be found or has the wrong format, Sylpheed will assume +the default MIME type for all the attachments: <computeroutput>application/octet-stream</computeroutput>. +In such a case, the recipients mail client may not know what application +to use to view the attachment. +</para> + </section> + <section> + <title>How Sylpheed handles attachments (reception) </title> + <para> +When opening an attachment (select the attachment, right click and select +<computeroutput>Open</computeroutput>) Sylpheed uses one of the following methods to determine +the application to launch:</para> + <itemizedlist> + <listitem> + <para> + The attachment is an image: the application is the one defined by the + <computeroutput>mime_image_viewer</computeroutput> variable of the common preferences configuration + file (<computeroutput>$HOME/.sylpheed/sylpheedrc</computeroutput>). If no application is defined, or + if the format of the definition is not valid, the default application + command is <computeroutput>display</computeroutput> (ImageMagick viewer). + </para> + </listitem> + <listitem> + <para> + The attachment is a sound file: the application is the one defined by the + <computeroutput>mime_audio_player</computeroutput> variable of the common preferences configuration + file (<computeroutput>$HOME/.sylpheed/sylpheedrc</computeroutput>). If no application is defined, or + if the format of the definition is not valid, the default application + command is <computeroutput>play</computeroutput>. + </para> + </listitem> + <listitem> + <para> + The attachment is a HTML file: the application is the one defined by the + <computeroutput>uri_cmd</computeroutput> variable of the common preferences configuration + file (<computeroutput>$HOME/.sylpheed/sylpheedrc</computeroutput>). This can also be changed in the + <computeroutput>Common preferences</computeroutput>, by changing the <computeroutput>Web browser</computeroutput> defined + in the <computeroutput>Other</computeroutput> tab. + </para> + </listitem> + <listitem> + <para> + Any other attachment type: Sylpheed relies on <computeroutput>metamail</computeroutput> to use + the correct application (Sylpheed starts <computeroutput>metamail</computeroutput> giving it + the attachment file and the MIME type taken from the mail). + </para> + </listitem> + </itemizedlist> + <para> +The binding of the applications to each MIME type is defined in the +<computeroutput>mailcap</computeroutput> file. The systeme wide file is <computeroutput>/etc/mailcap</computeroutput>, +while the user file is <computeroutput>$HOME/.mailcap</computeroutput>.</para> + <para> +In the mailcap file, there is one definition per line, big lines +can be broken by escaping the newline with a <computeroutput>\</computeroutput> character, +the first element of the line is the MIME type, then a semi-colon, +(<computeroutput>;</computeroutput>), and finally the application to launch. +The application part (right side of the semi-colon) can contain several +shell commands separated by an escaped semi-colon (<computeroutput>\;</computeroutput>) and +the <computeroutput>%s</computeroutput> string is replaced by the name of the file when +launching the command.</para> + <para> +Following is a typical <computeroutput>mailcap</computeroutput> file (an extract of mine):</para> + <literallayout> + +image/*; ee %s + +video/mpeg; gtv %s +video/*; xanim %s + +application/pdf; xpdf %s + +text/html; dillo %s + +</literallayout> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_015.xml b/manual/en/manual_015.xml new file mode 100644 index 0000000..ed4f5a1 --- /dev/null +++ b/manual/en/manual_015.xml @@ -0,0 +1,38 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-15"> + <title>Conversion of Other Mail Format into Sylpheed (MH Format)</title> + <section> + <title>Importing Messages of mbox Format</title> + <para> +<!-- added 2001/07/20 --> +Sylpheed lets you import messages of the Mbox format from the File menu. First you create +the mail folder where you want the messages to end up in, then you select File->import +Mbox file. Use the browse function to select the Mbox file and the Sylpheed mail folder, +and press Ok. And voila, there is your mail, imported. +</para> + <para> +That was easy, wasn't it?</para> + </section> + <section> + <title>Importing from Windows Mailers (Becky!, AL-Mail, Outlook Express4, etc.) </title> + <para> +For import possibilities of the mail folders of these and more mail programs you +can download the program mbx2mbox at sourceforge.net. The project is located at +<ulink url="http://mbx2mbox.sourceforge.net">http://mbx2mbox.sourceforge.net</ulink>.</para> + </section> + <section> + <title>Importing dbx Format of Outlook Express 5</title> + <para> +For import possibilities of the mail folders of these and more mail programs you +can download the program mbx2mbox at sourceforge.net. The project is located at +<ulink url="http://mbx2mbox.sourceforge.net">http://mbx2mbox.sourceforge.net</ulink>.</para> + </section> +<!-- End added 2001/07/21 --><!-- start add 2001/09/04 --> <section> + <title>Exporting from Sylpheed MH format to mbox</title> + <para> +Sylpheed offers a way to export a mailbox to the standard mbox format through the +File menu. Just select the "Export to mbox file..." option and you can select the +folder to export (assisted by a browse dialog) and also select or enter the name +of the mbox file you wish to generate. +<!-- end add 2001/09/04 --></para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_016.xml b/manual/en/manual_016.xml new file mode 100644 index 0000000..9166091 --- /dev/null +++ b/manual/en/manual_016.xml @@ -0,0 +1,78 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-16"> + <title>NetNews</title> + <para> +What is netnews?</para> + <para> +Netnews, also called Usenet, is a collection of "news servers" that contain a great deal of information. News, as it is called in short, can be about anything. About making your own wine, about old cars or radios. You name it, and there probably is a newsgroup about it.</para> + <para> +This is what we will set up here. Accessing newsgroups. Note that this is different from e-mails. You can almost compare it to a mailing list, but yet the concept is a bit different. +<!-- added 2001/07/20 --></para> + <section> + <title>Adding and Deleting Servers</title> + <section> + <title> Adding a news server</title> + <para> +To add a news server, go to the configuration menu and select the "create new account" option. +There you can name the news-account to anything of your liking. This is important, so you can identify the account later.</para> + <para> +In the BASIC tab, in the block 'personal information' you also can enter your own name, your e-mail address (so you can reply to news message by e-mail), optionally your organization (if you are organized at all).</para> + <para> +In the block 'Server information' you select the "News (NNTP)" protocol. Forget about "Inbox", that does not matter in this setup. Next you enter the name of the newsserver you want to connect to. You can get that name from your ISP, if you don't already have that.</para> + <para> +If you need to log into the news server, check the box next to "This server requires authentication", and then fill the fields for User ID and Password.</para> + <para> +Next step is to go to the Send tab. Since Receive is only there for e-mail, there is no need to do anything there. You can't even do anything in the Receive tab, for that matter. So, in Send you can select a few options:</para> + <itemizedlist> + <listitem> + <para>If you want a date header field added to posts</para> + </listitem> + <listitem> + <para>If Sylpheed should generate a Message-ID</para> + </listitem> + <listitem> + <para>If you want to add user-defined headers</para> + </listitem> + </itemizedlist> + <para>The next items only apply to when you reply to a news message through e-mail. You can set an automatic CC, BCC or Reply-To address here. In case your ISP requires SMTP authentication, you can select the checkbox here below.</para> + <para> +The next tab, Compose, allows you to select a default signature file. This will be added to each post to the newsgroups you do.</para> + <para> +Finally, in the "Advanced" tab, you can specify the port on which Sylpheed has to connect to the news server. The default is 119, and only in rare cases you should have to do something about that.</para> + <para> +Now you click "OK" and the account is created! You can verify this by checking the folder pane in Sylpheed. There you will see a new folder created with the name of the account you entered, and (news) behind it.</para> + </section> + <section> + <title> Deleting a news-server.</title> + <para> +If you want to delete a news-account, right-click the news-folder and select "Remove news account". After confirming that you want this to be done, the account and all files related will be removed. +</para> + </section> + </section> + <section> + <title>Subscribing and Unsubscribing to NewsGroups</title> + <para> +Okay. Here the real stuff begins. First you have to let Sylpheed load the list of news groups that is on the news system. Right-click the new NEWS folder and select "Subscribe to newsgroups". Sylpheed will tell you that the groups need to be downloaded, so sit back and wait a while. Of course, during time, new groups are added, and dead groups are removed. For this you can click the "refresh" button in the newsgroup dialog, so a new list is downloaded and you are up to date</para> + <para> +After a while the groups are loaded and displayed in a window. Now you can look up a group that is interesting, for example comp.os.linux.networking. Click the name once and then select OK. The group will be added to the news folder as a subfolder. When you now click the name of the new subfolder, Sylpheed will connect to the news server and download the headers (subject lines, in e-mail talk), to your computer. Some groups have -large- amounts of articles, so this may take a while!!</para> + </section> + <section> + <title>Reading News</title> + <para> +When the articles are displayed, in the summary view, you can click one of them to be downloaded so you can read it. This will usually go very quickly on discussion groups.</para> + <para> +If you want to respond to a message, press Alt-R (or press "Reply") and a message window will pop up, with the name of the newsgroup already in the "To" field. Depending on whether or not you selected quoting of the message, the original message will be in the body of the message already. Write away, then send, and soon the entire world will be able to read what you wrote on the subject.</para> + <para> +Starting a new message in a newsgroup is equally simple: press Alt-N (or click "New"), the name of the newsgroup is in the "To" field, and you can write your question or reply. +</para> + <section> + <title>A note about binary files</title> + <para> +In newsgroups you can download binary files. These are programs, images etc. Often these are posted as so called UUencoded files. Sylpheed will as upto version 0.5.1 not decode UUencoded files. You need to save these articles to disk as separate files, and use a separate decoder program, like juju, to decode the garble of text. A UUencoded file usually looks something like this:</para> + <para> +begin 666 sundown.jpg</para> + <para> +after which you will find nicely formatted blocks of characters that don't seem to mean anything. +</para> + </section> + </section> +<!-- end add 2001/07/20 --></chapter>
\ No newline at end of file diff --git a/manual/en/manual_017.xml b/manual/en/manual_017.xml new file mode 100644 index 0000000..cbfc373 --- /dev/null +++ b/manual/en/manual_017.xml @@ -0,0 +1,295 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-17"> + <title>References, tips and tricks</title> + <para> +In this section you will find a few pieces of information +that might be handy in making Sylpheed more clear for you +in respect to the used shortcut keys, and a layout of +the format of the address book.</para> + <section> + <title id="shortcut">Short-Cut Key List</title> + <section> + <title>Shortcuts to the File menu: </title> + <itemizedlist> + <listitem> + <para> + Ctrl-S: Save-As + </para> + </listitem> + <listitem> + <para> + Ctrl-Q: exit + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Shortcuts to the Edit menu </title> + <itemizedlist> + <listitem> + <para> + Ctrl-C: copy + </para> + </listitem> + <listitem> + <para> + Ctrl-A: select all + </para> + </listitem> + <listitem> + <para> + Ctrl-F: Find in current message + </para> + </listitem> + <listitem> + <para> + Shift-Ctrl-F: Search messages + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Shortcuts to the View menu </title> + <itemizedlist> + <listitem> + <para> + V: show or hide message view. + </para> + </listitem> + <listitem> + <para> + Ctrl-T: turn on and off thread display. + </para> + </listitem> + <listitem> + <para> + P: open previous message (in current folder). + </para> + </listitem> + <listitem> + <para> + N: open next message (in current folder). + </para> + </listitem> + <listitem> + <para> + Shift-P: open previous unread message. + </para> + </listitem> + <listitem> + <para> + Shift-N: open next unread message. + </para> + </listitem> + <listitem> + <para> + G: change the current folder. + </para> + </listitem> + <listitem> + <para> + Ctrl-Alt-N: open the selected message in a new window. + </para> + </listitem> + <listitem> + <para> + Ctrl-U: view the message source. + </para> + </listitem> + <listitem> + <para> + Ctrl-H: toggle the header display (turn it on and off). + </para> + </listitem> + <listitem> + <para> + Ctrl-Alt-U: update the sumary view. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Shortcuts to the Message menu </title> + <itemizedlist> + <listitem> + <para> + Ctrl-I: get new mail (for current account). + </para> + </listitem> + <listitem> + <para> + Shift-Ctrl-I: get new mail (for all accounts). + </para> + </listitem> + <listitem> + <para> + Ctrl-M: compose a new message. + </para> + </listitem> + <listitem> + <para> + Ctrl-R: reply to message (reply to sender only). + </para> + </listitem> + <listitem> + <para> + Shift-Ctrl-R: reply to all (includes all addresses + in To: and Cc:). + </para> + </listitem> + <listitem> + <para> + Ctrl-L: reply to mailing list. + </para> + </listitem> + <listitem> + <para> + Ctrl-Alt-F: forward message + </para> + </listitem> + <listitem> + <para> + Ctrl-O: move message + </para> + </listitem> + <listitem> + <para> + Shift-Ctrl-O: copy message + </para> + </listitem> + <listitem> + <para> + Ctrl-D: delete message + </para> + </listitem> + <listitem> + <para> + Shift-*: mark selected message. + </para> + </listitem> + <listitem> + <para> + U: unmark selected message. + </para> + </listitem> + <listitem> + <para> + Shift-!: mark selected message as unread. + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Shortcuts to the Tool menu </title> + <itemizedlist> + <listitem> + <para> + Shift-Ctrl-A: open addressbook. + </para> + </listitem> + <listitem> + <para> + X: execute (execute pending moves and deletes).</para> + </listitem> + <listitem> + <para> + Shift-Ctrl-L: open log window. + </para> + </listitem> + </itemizedlist> + </section> + </section> + <section> + <title>Changing Key Binding of Short-Cut Key </title> + <para> +Sylpheed's graphical interface is based on GTK. This means +that it is very simple to change the key binding +(shortcut key, hotkey) for menu items. If you are used to +a certain key combination from another program, you can tell +Sylpheed to use that same key combination. +</para> + <para> +The procedure is very simple. Suppose you want to change the +key binding for getting new mail (message menu) from Alt-I +to Ctrl-M. +</para> + <itemizedlist> + <listitem> + <para> + Open the message menu with the mouse or by + pressing Alt-M + </para> + </listitem> + <listitem> + <para> + Select the "get new mail" option (do not click it, + this will activate the function!). If you use the + mouse, just move the mouse cursor over the option. + </para> + </listitem> + <listitem> + <para> + Now you press Ctrl-M. You will immediately see the + new key combination appear on the menu. + </para> + </listitem> + </itemizedlist> + <para>Congratulations, you have just changed a key binding. +This way you can change all the options that you want. +Do note that it is best to use just the alt, shift and +ctrl key combinations. Several functions within Sylpheed +are called up by one-key actions which are programmed in.</para> + <section> + <title>Predefined shortcuts </title> + <para> + You can also choose among predefined shortcuts lists, + from the preference settings. Open the <computeroutput>Common preferences</computeroutput> + window, choose the <computeroutput>Interface</computeroutput> tab, click the + <computeroutput>Set key bindings</computeroutput> button. Select one of the predefined + set of key bindings from the list found in the new window + that pops up.</para> + </section> + </section> + <section> + <title>Changing Fonts on Menu, etc. </title> + <para> +If you want to change the font that shows the menu of Sylpheed, +this is controlled by the window manager that you are using. +You have to go into the setup of the window manager (KDE, Gnome, XFCE) +and change the font to your desired one.</para> + <para> +Changing the font of the views of Sylpheed is done by selecting +<guilabel>Common preferences</guilabel> in the Configuration menu. There you select +the <guilabel>Display</guilabel> tab, and in the first section of the window you +can browse the fonts available on your computer.</para> + </section> + <section> + <title>How to tell another program to use Sylpheed as e-mail program </title> + <para> +If you wish to use Sylpheed from within for example Netscape or Opera, +then you need to go to the `preferences` section, then choose +`applications` and in the email client part, you need to enter +<guilabel>sylpheed --compose</guilabel>.</para> + </section> + <section> + <title>Data Format of Address Book </title> + <para> +The addressbook is located in ~/.sylpheed. It is named +addressbook.xml. As you may guess it from its extension, +the format is XML. +The general format of the addressbook is: +</para> + <literallayout> +< addressbook > <p> + < common_address ><p> + < group name="Common addresses" ><p> + < item ><p> + < name > Paul < /name ><p> + < address > paul@nlpagan.net < /address ><p> + < remarks > Writes Sylph. manual < /remarks ><p> + < /item ><p> + < /group ><p> + < /common_address ><p> +< /addressbook > +</literallayout> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_018.xml b/manual/en/manual_018.xml new file mode 100644 index 0000000..eb29b1c --- /dev/null +++ b/manual/en/manual_018.xml @@ -0,0 +1,7 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-18"> + <title>FAQ</title> + <para> +You can find the latest, updated, FAQ (Frequently Asked Questions list) at +<ulink url="http://sylpheeddoc.sf.net">http://sylpheeddoc.sf.net</ulink> +</para> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_019.xml b/manual/en/manual_019.xml new file mode 100644 index 0000000..d80fe99 --- /dev/null +++ b/manual/en/manual_019.xml @@ -0,0 +1,57 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-19"> + <title>Information</title> + <section> + <title>Websites on Sylpheed</title> + <para> +Here are some links to the Sylpheed FAQ in other languages:</para> +<!-- missing links itemizedlist --> </section> + <section> + <title>Mailing Lists</title> + <para> +If you want to stay up to date on Sylpheed, and want to talk about the program with other users, you can join the mailing list.</para> + <para> +Send a mail to sylpheed-ctl@good-day.net that says</para> + <para> +<guilabel>subscribe Your Name</guilabel></para> + <para> +in the body.</para> + <para> +The server returns the mail once for the first registration request that asks the confirmation: "May I put you on this mailing list?" that includes the following phrase (this number is merely an example).</para> + <para> +<guilabel>confirm 84682771 Anne Shirley</guilabel></para> + <para> +This is a precaution for mischief like subscribing you to the list against your wish.</para> + <para> +If you received the entry confirmation mail, send a mail that includes the phrase:</para> + <para> +<guilabel>confirm Password(a number) Your Name</guilabel></para> + <para> +to the address for registration: sylpheed-ctl@good-day.net again. Then, it is considered that you have confirmed the registration and you are registered to the server.</para> + <para> +The address for posting to the list is sylpheed@good-day.net.</para> + <para> +Notice: If you lost the mail that says</para> + <para> +confirm Password(a number) Your Name</para> + <para> +or you became confused and want to do from start, do them over from the start, in other words, send</para> + <para> +<guilabel>subscribe Anne Shirley</guilabel></para> + <para> +to sylpheed-ctl@good-day.net again.</para> + </section> + <section> + <title>How to unsubscribe.</title> + <para> +Send a mail to sylpheed-ctl@good-day.net that says</para> + <para> +<guilabel>unsubscribe</guilabel></para> + <para> +in the body.</para> +<!-- added aug. 13, 2001 --> </section> + <section> + <title>Anonymous CVS</title> + <para> +This section has not been written yet.</para> + </section> +</chapter>
\ No newline at end of file diff --git a/manual/en/manual_020.xml b/manual/en/manual_020.xml new file mode 100644 index 0000000..48e0d91 --- /dev/null +++ b/manual/en/manual_020.xml @@ -0,0 +1,49 @@ +<?xml version='1.0' encoding='UTF-8'?><chapter id="sylpheed-20"> + <title>About This Document</title> + <section> + <title>Copyright Notice</title> + <para> +Copyright (C) 2001 Hiroyuki Yamamoto</para> + <para> +This program has been placed in the GPL.</para> + </section> + <section> + <title>GNU General Public License</title> + <para> +This program is free software; you can redistribute it and/or +modify it under the terms of the GNU General Public License +as published by the Free Software Foundation; either version 2 +of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +</para> + </section> +<!-- add 2001/07/21 --> <section> + <title>Where to Get the Latest Version of This Document</title> + <para> +You can find the latest version of this document on the site of the Sylpheed documentation project at</para> + <para><ulink url="http://sylpheeddoc.sf.net">http://sylpheeddoc.sf.net"</ulink></para> + <para>Here FAQ and manual are uploaded as HTML pages, and in form of SGML files within the CVS repository.</para> + </section> + <section> + <title>Ending Remark</title> + <para> +I wish to thank everyone involved in the Sylpheed project.</para> + <para> +Hiroyuki Yamamoto and all the other developers for the fabulous program they have created.</para> + <para> +Francois Barriere who helped me become friends with the CVS system.</para> + <para> +All the help I received from everyone on the Sylpheed mailing list while writing the FAQ and this manual.</para> + <para> +Nick Selby, for offering his well appreciated assistance in writing along in this manual.</para> + <para> +All the people around the world who work hard on keeping the manual and FAQ up to date</para> + <para> +And Linus Torvald, who got us a great operating system! ;-) +<!-- end add 2001/07/21 --></para> + </section> +</chapter>
\ No newline at end of file |