summaryrefslogtreecommitdiff
path: root/manual/en/sylpheed.sgml
diff options
context:
space:
mode:
authorSimeon Simeonov2018-02-26 11:23:00 +0100
committerSimeon Simeonov2018-02-26 11:23:00 +0100
commit0b3cbf57875fd692e4ba0b336fefa4bee1ed00dc (patch)
treeaf916a30553c78ce9d4f2d8658656a175c5b6921 /manual/en/sylpheed.sgml
Initial commit for sylpheed 3.7.0
Diffstat (limited to 'manual/en/sylpheed.sgml')
-rw-r--r--manual/en/sylpheed.sgml3806
1 files changed, 3806 insertions, 0 deletions
diff --git a/manual/en/sylpheed.sgml b/manual/en/sylpheed.sgml
new file mode 100644
index 0000000..9a8c276
--- /dev/null
+++ b/manual/en/sylpheed.sgml
@@ -0,0 +1,3806 @@
1<!doctype linuxdoc system>
2<article>
3 <title>Sylpheed User's Manual
4 <author>Paul Kater (paul@nlpagan.net)
5 Nick Selby
6 <abstract>
7 Sylpheed User's Manual for Sylpheed-0.8.10
8 </abstract>
9
10<toc>
11
12<p>
13Copyright (c) 2002 <it>The sylpheed documentation team</it>.
14Permission is granted to copy, distribute and/or modify this document
15under the terms of the GNU Free Documentation License, Version 1.1
16or any later version published by the Free Software Foundation;
17with no Invariant Sections, with no Front-Cover Texts, and no Back-Cover Texts.
18A copy of the license is included in the
19<ref id="GNU Free Documentation License" name="section"> entitled
20"GNU Free Documentation License".
21</p>
22
23<p>
24The list of the members of <it>The sylpheed documentation team</it> is
25detailed in the <ref id="The Sylpheed documentation team" name="appendix">.
26
27
28<sect>What is Sylpheed?
29
30<p>
31
32
33
34<sect1>Introduction to Sylpheed.
35<p>
36Sylpheed is a fast e-mail and news client. It will run on just about any Linux or Unix compliant system.
37<p>
38The power of Sylpheed is that it is
39<itemize>
40<item>light on resources
41<item>very fast
42<item>intuitive for most people
43<item>easy to work with
44<item>loaded with features
45<item>graceful and sophisticated in its interface
46</itemize>
47</sect1>
48
49<sect1>Interface
50<p>
51The appearance and interface are similar to some popular e-mail clients for
52Windows, such as Outlook Express, Becky!, and Datula. The interface is
53also designed to emulate the mailers on Emacsen, and almost all commands
54are accessible with the keyboard.
55<p>
56The messages are managed by MH format, and you'll be able to use it
57together with another mailer based on MH format (like Mew). You can
58also utilize fetchmail or/and procmail, and external programs for
59receiving (like inc or imget).
60</sect1>
61
62<sect1>Main features
63<p>
64Currently implemented features are:
65<itemize>
66<item>Unlimited multiple account handling
67<item>Thread display
68<item>Filtering
69<item>MIME (attachments)
70<item>built-in image view
71<item>X-Face support
72<item>External editor support
73<item>Message queueing
74<item>Draft message function
75<item>Template
76<item>Line-wrapping
77<item>Clickable URI
78<item>XML-based addressbook
79<item>LDAP addressbook
80<item>Jpilot addressbook (for Palm types handhelds)
81<item>Newly arrived and unread message management
82<item>Multiple MH folder support
83<item>Mew/Wanderlust compatible key bindings
84<item>News reader function
85<item>Printing
86<item>UIDL support
87<item>APOP authentication
88<item>SMTP AUTH support
89<item>IPv6 support
90<item>GPG encryption and signature
91<item>Autoconf, automake support
92<item>Support of i18n of messages by gettext
93<item>Supports many locales, including UTF-8 (Unicode), when using libjconv
94<!-- added 2001/07/19 -->
95<item>IMAP4 compliant
96</itemize>
97This list is not complete, but this will at least show you the most common features in Sylpheed.
98</sect1>
99
100<sect1>Methods for managing messages<p>
101<!-- added 2001/09/06 -->
102There are several ways to manage messages. The best known is <tt>not at all.</tt><p>
103Too many people receive lots of e-mails and just let them end up in the INBOX folder. Which after a while becomes unmanageable. Try to locate that one mail about an important event you got 5 days ago, in a mailbox that has over 5000 messages in it. Even when sorted on date, it might take you a tremendous time to locate it.<p>
104For this there are <tt>mailfolders and mailboxes.</tt><p>
105When you read on in this manual, you will learn about creating mailboxes and also folders that can contain more mailboxes. What are these good for?<p>
106Overview. Simple as that. In different mailboxes you 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. The smart thing to do now is to create a separate mailbox for these mails. So when an e-mail comes in from the kiting club, you can move it to the kiting club mailbox. That way you know that you have all your kiting e-mails in one place.<p>
107Tedious, you say? To move 30 mails a day to that box, when they come in at random moments? You bet that is a tedious job. You can be certain that you will miss that very important one about transport to the kiting ground where you will have the contest of biggest and most beautiful kite!<p>
108Well, also for this there is a solution. Those are called <tt>filters</tt>.<p>
109Filters can automate the process of moving e-mails to new locations. Further on in this manual you will also learn about setting up filters, so you do not have to move these kiting e-mails to the kiting club mailbox.<p>
110<sect2>Okay, so what is the difference between a mailbox and a mailfolder?<p>
111This is actually the exact same thing as you do on your harddisk. You create directories in which you can put files and more directories.<p>
112In the case of Sylpheed, you can create a mailbox in which you can put more mailboxes that somehow belong together. For example, you could create a mailbox (folder) that contains the mailboxes for all the mailing lists you belong to.<p>
113A word of clarification is perhaps in need here. In Sylpheed, a maillbox is nothing more than a directory. And in a directory you can create a new directory. But also files. And Sylpheed stores each e-mail in a separate file on disk.
114An example of how a mailbox tree could look is<p>
115
116
117
118
119As 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.<p>
120Of course, you should observe some common sense when you start creating mailboxes. To keep all mail in one place is not a good idea, but to create a maze of mailboxes is not a good idea either!
121</sect2>
122</sect1>
123
124<sect1>Features for the future<p>
125This is a special chapter. As with all open source programs, many features can be requested by you, the user of Sylpheed. The best way to join in on the talks is to join one of the mailing lists on Sylpheed. For this, you can turn to the Information section of this manual and read up on how to join a mailing list.
126</sect1>
127
128</sect>
129
130<sect>Quick-guide to mail setup
131
132<sect1>Starting Sylpheed for the first time
133
134<p>
135When starting Sylpheed for the first time, you will be
136guided through the first basic steps of the setup.
137First a pop-up window will show up and you will be asked
138to define the directory Sylpheed will use to store your
139messages and folders. This directory will be created under
140your home directory (or under C:\windows\Application Data\Sylpheed
141on windows). The default name for this directory is "Mail".
142
143
144
145
146Then the account preferences window shows up. Based on
147your configuration (local UNIX mailbox or POP account),
148read one of the following sections for the next steps
149of the configuration.
150
151<sect1>Setup for reading your Unix mailbox in a hurry<p>
152<itemize>
153<item>In the configuration menu, select "Create new account".
154<item>In the <ref id="Basic"> tab, name the account. You can select this account to be the default account ("Usually used").
155<item>Enter your name and e-mail address.
156<item>To select your local unix mailbox, in the Protocol box you select "None (local)".
157<item>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.
158</itemize>
159Settings in the remaining tabs can usually be left at default values.
160
161
162
163
164The <ref id="Receive"> tab is not used in this setup, since you are not polling a server, your mail is delivered to you.
165
166In the <ref id="Send"> tab you can select headers and SMTP authentication.
167
168
169
170
171In the <ref id="Compose"> tab you can define your signature file.
172
173
174
175
176In the <ref id="Advanced"> tab you can edit the portnumbers for the servers you will be using. This normally will need no change.
177
178This is basically everything you need to start using Sylpheed for local mailboxes. You can select "Message -> receive new mail" or press the <ref id="shortcut"> and see if there is new mail!
179</sect1>
180<sect1>Setup for reading POP3 mail in a hurry<p>
181<itemize>
182<item>In the configuration menu, select "Create new account".
183<item>In the <ref id="Basic"> tab, name the account. You can select this account to be the default account ("Usually used").
184<item>Enter your name and e-mail address.
185<item>To check your POP3 mail, in the Protocol box you select "POP3 (normal)".
186<item>Enter the server information for "Server for receiving". You can then enter the server to send (SMTP) in this tab.
187</itemize>
188Settings in the remaining tabs can usually be left at default values.
189
190
191
192
193The <ref id="Receive"> tab offers advanced POP3 options.
194
195
196
197
198In the <ref id="Send"> tab you can select headers and SMTP authentication.
199
200
201
202
203In the <ref id="Compose"> tab you can define your signature file.
204
205
206
207
208In the <ref id="Advanced"> tab you can edit the portnumbers for the servers you will be using. This normally will need no change.
209
210This is basically everything you need to start using Sylpheed for POP3 mailsystems. You select "Message -> receive new mail" or press the <ref id="shortcut"> and see if there is new mail!
211</sect1>
212</sect>
213<!-- added 2001/07/20 -->
214<sect>Quick-guide for news setup<p>
215<sect1>Getting news in a hurry.<p>
216<p>
217In the configuration menu, select "Create new account"
218<p>
219In 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)".
220
221
222
223
224<p>
225Enter the newsserver information.
226<p>
227Skip the "Receive" tab.
228<p>
229In the "Send" tab you can set up some more settings.
230<p>
231In the "Compose" tab you can define your signature file.
232
233
234
235
236<p>
237In the "Advanced" tab you can edit the portnumbers for the servers you will be using. This normally will need no change.
238<p>
239Close the dialogs, right click the new News folder in the folder 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!
240<!-- end added 2001/07/20 -->
241</sect1>
242</sect>
243
244<sect>Installation.
245
246<sect1>Required environment
247<p>
248To succesfully compile Sylpheed, you need at least:
249<itemize>
250<item>Any POSIX compliant UNIX or similar OS eg. Linux, FreeBSD, Solaris
251<item>
252 <url name="GTK+" url="http://www.gtk.org/">
253 1.2.6 or later
254</item>
255<item>
256 A recent ANSI C compiler
257 (<url name="gcc" url="http://gcc.gnu.org/"> 2.7.2.3 should also work)
258 Note: it is reported that Sun C will not compile Sylpheed.
259</item>
260</itemize>
261Optionally you need:<label id="option_libraries">
262<itemize>
263<item>
264 <url url="http://sourceforge.net/project/showfiles.php?group_id=2" name="Imlib">
265 or
266 <url url="http://ftp.gnome.org/pub/GNOME/unstable/sources/gdk-pixbuf/" name="gdk-pixbuf">
267 (for built-in image view)
268</item>
269<item>
270 <url name="libcompface" url="ftp://ftp.cs.indiana.edu/pub/faces/compface/">
271 (for X-Face)
272</item>
273<item>
274 <url name="libjconv" url="http://www.kondara.org/libjconv/">
275 (for non latin character sets)
276</item>
277<item>
278 <url name="GPGME" url="http://www.gnupg.org/gpgme.html">
279 and
280 <url name="GNUPG" url="http://www.gnupg.org/">
281 (for encryption and signature)
282</item>
283<item>
284 <url name="OpenSSL" url="http://www.openssl.org/">
285 (for SSL support)
286</item>
287<item>
288 <url name="OpenLDAP" url="http://www.openldap.org/">
289 (for LDAP connection)
290</item>
291<item>
292 IPv6 support can be turned on (if your system supports it)
293</item>
294<item>
295 <url name="Jpilot" url="http://www.jpilot.org/">
296 (for Palm addressbook use)
297</item>
298<item>the equivalent of GTK+-devel and Xfree86-devel. (Otherwise ./configure will fail.)
299</itemize>
300<p>
301Notice: Sylpheed may be unstable depending on the environment. Please use the newest version of libraries if possible.
302</sect1>
303
304<sect1>Environments known as valid for Sylpheed
305<p>
306<itemize>
307<item>Debian GNU/Linux unstable (sid) (glibc 2.2.5) (development environment)
308<item>Debian GNU/Linux testing (woody) (glibc 2.2.5)
309<item>Debian GNU/Linux 2.2 (potato) (glibc 2.1.3)
310<item>Kondara MNU/Linux (glibc 2.1.x)
311<item>Kondara MNU/Linux 1.2
312<item>Kondara MNU/Linux 2.0
313<item>Vine Linux 1.1 (glibc 2.0.x + libwcsmbs)
314<item>Vine Linux 2.0 (glibc 2.1.x) (Intel, PPC)
315<item>Vine Linux 2.1
316<item>Vine Linux 2.1.5
317<item>Laser5 Linux 6.0 (glibc 2.1.x)
318<item>Laser5 Linux 6.2 (glibc 2.1.x)
319<item>Laser5 Linux 6.4 (glibc 2.1.x)
320<item>TurboLinux 4.0 (glibc 2.0.7 + libwcsmbs)
321<item>TurboLinux 6.0 (glibc 2.1.2)
322<item>TurboLinux 7.0 (glibc 2.2.x)
323<item>Miracle Linux Standard Edition Version1.0
324<item>Miracle Linux for PostgreSQL Version1.0
325<item>Miracle Linux for Samba Version1.0
326<item>RedHat Linux 5.2 (glibc 2.0.7)
327<item>RedHat Linux 6.0
328<item>RedHat Linux 6.1 + Helix GNOME (glibc 2.1.x)
329<item>RedHat Linux 6.2 / 6.2J (glibc 2.1.x)
330<item>RedHat Linux 7.0 / 7.0J
331<item>RedHat Linux 7.1
332<item>RedHat Linux 7.2
333<item>LinuxPPC2000 + Yukikaze(Japanization kit)
334<item>Linux2000G (Intel, PowerPC)
335<item>HOLON Linux 2.0 (Intel / PPC)
336<item>Linux for PPC Japanese Edition 2.0 (glibc 2.1.x)
337<item>Linux for PPC Japanese Edition 3.0 (glibc 2.1.x)
338<item>Linux MLD4
339<item>Linux MLD5
340<item>Plamo Linux 2.0
341<item>Plamo Linux 2.1
342<item>Slackware 7.0
343<item>Slackware 7.1
344<item>Slackware 8.0
345<item>Linux Mandrake 7.0
346<item>Linux Mandrake 7.1
347<item>Linux Mandrake 7.2
348<item>Linux Mandrake 8.0
349<item>Linux Mandrake 8.1
350<item>SuSE Linux 6.3 (glibc 2.1.2)
351<item>SuSE Linux 6.4
352<item>SuSE Linux 7.0
353<item>SuSE Linux 7.1
354<item>SuSE Linux 7.2
355<item>SuSE Linux 7.3
356<item>OpenLinux 2.3 (glibc 2.1.1 -> 2.1.3)
357<item>Caldera OpenDesktop 2.4
358<item>Caldera Workstation 3.1
359<item>Conectiva Linux 4.0
360<item>Conectiva Linux 5.0
361<item>Conectiva Linux 7.0
362<item>Vector Linux 1.5
363<item>Yellow Dog Linux 2.0 (glibc 2.2.1)
364<item>Yellow Dog Linux 2.1 (PowerPC)
365<item>ASP Linux 7.2 (glibc 2.2.4)
366<item>Redmond Linux (Lycoris)
367</itemize>
368
369<itemize>
370<item>FreeBSD release 3.2
371<item>FreeBSD release 3.4
372<item>FreeBSD release 4.0
373<item>FreeBSD release 4.1
374<item>FreeBSD release 4.2
375<item>FreeBSD release 4.3
376<item>FreeBSD release 4.4
377<item>FreeBSD release 4.5
378<item>FreeBSD release 5.0
379<item>NetBSD 1.4.2
380<item>NetBSD 1.5 + XPG4DL
381<item>NetBSD 1.5.1
382<item>NetBSD 1.5.2
383<item>OpenBSD 2.7
384<item>OpenBSD 2.8 (i386)
385<item>OpenBSD 2.9
386<item>OpenBSD 3.0
387<item>BSD/OS 4.0.1
388</itemize>
389
390<itemize>
391<item>Solaris 2.5
392<item>Solaris 2.5.1
393<item>Solaris 2.6
394<item>Solaris 7
395<item>Solaris 8
396<item>IRIX 6.3
397<item>IRIX 6.4
398<item>IRIX 6.5, 6.5.8m
399<item>HP-UX 10.20
400<item>HP-UX 11.00
401<item>HP-UX 11i
402<item>Tru64 Unix 5.0 (OSF1 v5.0)
403<item>SCO UnixWare 7
404<item>Mac OS X 10.1.3 (Darwin 5.3) + XDarwin (without XLocale support) + libxpg4
405</itemize>
406
407<itemize>
408<item>Windows (MSVC + GTK+ for win32), in progress
409</itemize>
410</sect1>
411
412<sect1>Nuts and bolts of installation
413<p>
414<itemize>
415<item>Download the latest version of the Sylpheed package from
416<url url="http://sylpheed.good-day.net/" name="http://sylpheed.good-day.net/">
417</item>
418<item>Untar the sourcefiles to a new directory
419<item>tar -xvfz sylpheed-.tar.gz (for tar.gz)
420<item>tar -xvfI sylpheed-.tar.bz2 (for tar.bz2)
421<item>cd to the new sylpheed- directory
422<item>Run ./configure to check your environment and create the installation make files
423<item>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 in order to compile Sylpheed properly.
424</itemize>
425<p>
426If the make process has completed, run "make install" (as root), to install the program and the supportfiles
427
428<sect2>Compiling Sylpheed with options<label id="compile_sylpheed">
429<p>
430You can choose to compile Sylpheed with some optional features enabled.
431Use <it>./configure --help</it> to list configuration syntax and options.
432<p>
433The following optional features can be enabled:
434
435<itemize>
436 <item>
437 <it>Jpilot</it>: to use you PDA addressbook with Sylpheed. You will
438 need the <it>Jpilot</it> library (and <it>pilot-link</it>, too).
439 Enable this option with the <it>--enable-jpilot</it> configure switch.
440 </item>
441 <item>
442 <it>GnuPG</it>: Sylpheed can encrypt and sign your messages (also decrypt
443 and verify the signatures of the incoming messages) using GnuPG.
444 GnuPG follows the OpenPGP standard and is compatible with PGP.
445 To enable this feature, you need to install GnuPG and GPGME (interface
446 library to GnuPG).
447 Enable this option with the <it>--enable-gpgme</it> configure switch.
448 </item>
449 <item>
450 <it>LDAP</it>: Sylpheed can connect to a LDAP server in order to
451 query mail addresses. To enable this feature you will need the
452 OpenLDAP library.
453 Enable this option with the <it>--enable-ldap</it> configure switch.
454 </item>
455 <item>
456 <it>X-Faces</it>: you can create a small picture (of your face, or
457 of anything else) that will be sent in the header of your mails.
458 This option is enabled if the compface library is found and
459 can be disabled using the <it>--disable-compface</it> configure switch.
460 </item>
461 <item>
462 Images can appear "inline" (embedded in the message window, without
463 the need of an external viewer) if Sylpheed is compiled
464 with either the <it>gdk-pixbuf</it> or the <it>imlib</it> library.
465 You can choose the library (if both are installed) by using the
466 <it>--disable-gdk-pixbuf</it> or <it>--disable-imlib</it> configure switch.
467 </item>
468</itemize>
469
470All these features require additional libraries and tools that may not be part
471of your distribution. You can find them at the addresses listed at the beginning
472of this chapter, <ref id="option_libraries" name="here">.
473
474</sect2>
475
476</sect1>
477
478<sect1>Installation on Linux using RPM
479<p>
480As root, run the "rpm -ivh " command on the RPM file you downloaded. As soon as this process is complete you can run Sylpheed as user.
481</sect1>
482
483<sect1>Installation on Debian Linux
484<p>
485With an internet connection :
486<p>
487apt-get install sylpheed (to install it with a internet connection)
488<p>
489Without internet connection, fetch the debian package for example on
490<url url="http://packages.debian.org/unstable/mail/sylpheed.html" name="http://packages.debian.org/unstable/mail/sylpheed.html">
491<p>
492dpkg -i sylpheedx.x.x-1i386.deb
493<p>
494dpkg --install sylpheedx.x.x-1i386.deb
495</sect1>
496
497<sect1>Installation on FreeBSD
498<p>
499using the /stand/sysinstall tool (it is a menu-based interface) :
500<p>
501run "/stand/sysinstall" as root
502<p>
503in the main menu choose "Configure" -> "Packages" -> "mail", then "sylpheed" then, back to the "Packages" list, choose "Install"
504<p>
505Using the ports
506<p>
507Get the sylpheed port on :
508<p>
509<url url="ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-4.3-release/mail" name="ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-4.3-release/mail">
510<p>
511then, as root: pkg-add sylpheed-0.x.x.tgz
512<p>
513using the ports with compiling:
514<p>
515first, update your port, fetch it on
516<url url="http://www.freebsd.org/ports/mail.html" name ="http://www.freebsd.org/ports/mail.html">
517<p>
518cd /usr/ports/mail/sylpheed
519<p>
520make
521<p>
522If it succeeds, type "make install"
523<p>
524In case it fails, fetch the required package if necessary
525(on the same page), put the package file in /usr/ports/distfiles/
526then :
527<itemize>
528<item>cd /usr/ports/mail/sylpheed
529<item>make
530<item>make install
531</itemize>
532<p>
533Need a more up-to-date version ?
534<p>
535Just use the Unix standard method (see "Nuts and bolts of installation")
536</sect1>
537
538</sect>
539
540<sect>Starting and quitting Sylpheed
541
542<sect1>Starting Sylpheed
543<p>
544Starting Sylpheed can be done by typing "sylpheed" 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.
545<p>
546When you first start Sylpheed, the program will ask you where you want to store the mails that you downloaded. You can accept the default ($HOME/Mail) or set up your own mail folder.
547<p>
548Sylpheed will then load with it's default settings. The way to change these are written about further on in this manual.
549</sect1>
550
551<sect1>Quitting Sylpheed
552<p>
553Ending Sylpheed can be done in several ways:
554<itemize>
555<item>Select "quit" from the File menu
556<item>Press Ctrl-Q
557<item>Click the "program close" button in the titlebar.
558</itemize>
559</sect1>
560
561</sect>
562
563<sect>The menu options of Sylpheed.
564<p>
565The menu in Sylpheed is the primary entry to all the things
566you can do with Sylpheed. The menu structure gives you following
567options:
568
569<sect1>File menu
570<p>
571<itemize>
572 <item>
573 <it>Add mailbox:</it> this option lets you add a new MH mail-directory.
574 It will generate IN, OUT, QUEUE, DRAFT and TRASH mailfolders
575 inside the new mailbox.
576 </item>
577 <item>
578 <it>Check for new messages in all folders:</it> rescans the entire tree
579 of existing mailboxes to reflect the correct state (usually
580 won't be necessary).
581 </item>
582 <item>
583 <it>Folder:</it> lets you add, rename or delete a mailfolder.
584 <itemize>
585 <item>
586 <it>Create new folder:</it> to create a new folder. You must select
587 the top level node of the folder tree of a sub folder before
588 using this menu entry, in order to define the location of the
589 new folder to create.
590 </item>
591 <item>
592 <it>Rename folder:</it> change the name of the selected folder.
593 </item>
594 <item>
595 <it>Delete folder:</it> delete the selected folder (also delete the
596 messages contained in the selected folder).
597 </item>
598 </itemize>
599 </item>
600 <item>
601 <it>Import mbox file...:</it> lets you import an mbox file
602 (like created by Pine) into an MH mailbox.
603 </item>
604 <item>
605 <it>Export to mbox file:</it> lets you export an MH mailbox to an mbox file.
606 </item>
607 <item>
608 <it>Empty trash:</it> obviously, this will empty the trash folder.
609 </item>
610 <item>
611 <it>Save as:</it> lets you save the selected e-mail to a plain textfile
612 on disk.
613 </item>
614 <item>
615 <it>Print:</it> lets you print the selected e-mail to a printer.
616 </item>
617 <item>
618 <it>Exit:</it> ends Sylpheed.
619 </item>
620</itemize>
621</sect1>
622
623<sect1>Edit menu
624<p>
625<itemize>
626 <item>
627 <it>copy:</it> lets you copy the selected text to a buffer,
628 from where you can paste it into a different place.
629 Shortcut: Ctrl-C
630 </item>
631 <item>
632 <it>select all:</it> selects all the text in the current window.
633 Shortcut: Ctrl-A
634 </item>
635 <item>
636 <it>select thread:</it> selects all the messages of the current thread.
637 </item>
638 <item>
639 <it>Find in current message:</it> searches a string in the current message.
640 Shortcut: Ctrl-F
641 </item>
642 <item>
643 <it>search messages:</it> searches a message based on its To, From, Subject
644 header fields or body content. Start searching from the selected
645 message, in the selected folder.
646 Shortcut: Shift-Ctrl-F
647 </item>
648</itemize>
649</sect1>
650
651<sect1>View menu
652<p>
653The view menu allows you to change the way that Sylpheed appears.
654You can set different windows separately (folder view, messages etc.),
655enable or disable the statusbar and so on.
656It contains also the commands to toggle the display of some parts
657of the current message, or sort the messsages in the selected folder
658based on different attributes.
659<p>
660<itemize>
661 <item>
662 <it>Show or hide:</it> let you control the parts of the Sylpheed user interface
663 you want to display.
664 <itemize>
665 <item>
666 <it>Folder tree:</it> not implemented yet
667 </item>
668 <item>
669 <it>Message view:</it> show or hide the message pane. When hidden, the
670 messages are displayed in a separate window. To read a message
671 double click in the summary pane. The message is then opened in
672 a new window. You can close this new window by pressing the escape
673 key.
674 </item>
675 <item>
676 <it>Toolbar:</it> sets how you want to see the toolbar. Icons and text,
677 or one of these.
678 <itemize>
679 <item>
680 <it>Icon and Text:</it> show icons and text in the toolbar.
681 </item>
682 <item>
683 <it>Icon:</it> only display the icons, do not display the text
684 below them.
685 </item>
686 <item>
687 <it>Text:</it> only the text, hide the icons.
688 </item>
689 <item>
690 <it>None:</it> hide the toolbar.
691 </item>
692 </itemize>
693 </item>
694 <item>
695 <it>Status bar:</it> show it or hide it.
696 </item>
697 </itemize>
698 </item>
699 <item>
700 <it>Separate folder tree:</it> selects between having the folder tree
701 attached to the main window, or floating separately.
702 </item>
703 <item>
704 <it>Separate message view:</it> selects between having the selected
705 message in the summary pane attached to the main window, or
706 floating separately.
707 </item>
708 <item>
709 <it>Sort:</it> controls the way the messages are sorted in the selected
710 folder. Each option sorts the messages in descending order (the
711 bigger one being on the top of the summary pane), and can be
712 reversed by selecting the same menu entry a second time (each
713 time you select the same menu entry the order is reversed).
714 <itemize>
715 <item>
716 <it>Sort by number:</it> sort the message based on their MH number.
717 </item>
718 <item>
719 <it>Sort by size:</it> sort the message on their size.
720 </item>
721 <item>
722 <it>Sort by date:</it> sort the messages based on their date.
723 </item>
724 <item>
725 <it>Sort by from:</it> the messages are sorted by their sender address
726 (From field, sorted alphabetically).
727 </item>
728 <item>
729 <it>Sort by recipient:</it> the messages are sorted by their recipient
730 (sorted alphabetically).
731 </item>
732 <item>
733 <it>Sort by subject:</it> the messages are sorted by their subject
734 (sorted alphabetically).
735 </item>
736 <item>
737 <it>Sort by color label:</it> sort the messages based on their color.
738 Read the context menu description below to find how to assign
739 colors to messages.
740 </item>
741 <item>
742 <it>Sort by mark:</it> separate marked and unmarked messages. Read the
743 context menu description below to find how to mark messages.
744 </item>
745 <item>
746 <it>Sort by unread:</it> separate read and unread messages.
747 </item>
748 <item>
749 <it>Sort by attachment:</it> separate messages with and without attachment.
750 </item>
751 <item>
752 <it>Don't sort:</it> do not sort the messages.
753 </item>
754 <item>
755 <it>Ascending:</it> sort the messages in ascending order. If the field used
756 to sort the messages is displayed in the summary view, a little
757 arrow on the right side of the corresponding summay column header
758 reflects the sort order you select from the menu.
759 </item>
760 <item>
761 <it>Descending:</it> sort the messages in descending order.
762 </item>
763 <item>
764 <it>Attract by subject:</it> move close to each other the messages
765 having the same subject (or a close subject).
766 </item>
767 </itemize>
768 </item>
769 <item>
770 <it>Thread view:</it> turn the threaded view on or off. When turned on the
771 messages of the same thread (the same discussion generated by replying
772 to each other mail) are grouped as a tree representing the discussion
773 flow. Each reply being linked to its orignal message. Each branch can
774 be open or closed by using the small plus or minus sign next to it.
775 The threads are based on the In-Reply-To and Reference fields of the
776 mail header, so never start a new conversation by replying to an
777 old message, this will add your new mail to the old unrelated thread.
778 Shortcut: Ctrl-T
779 </item>
780 <item>
781 <it>Expand all threads:</it> if the threaded view is selected, expand all the
782 threads in the opened folder.
783 </item>
784 <item>
785 <it>Collapse all threads:</it> if the threaded view is selected, collapse all the
786 threads in the opened folder.
787 </item>
788 <item>
789 <it>Set display item:</it> use it to change the list of items to display
790 in the summary view. This setting can also be changed through
791 the common preferences.
792 </item>
793 <item>
794 <it>Go to:</it> use it to navigate from message to message based on the
795 sub-menu criterias.
796 <itemize>
797 <item>
798 <it>Prev. message:</it> go to the previous message in the current
799 folder.
800 Shortcut: P
801 </item>
802 <item>
803 <it>Next message:</it> go to the next message in the current
804 folder.
805 Shortcut: N
806 </item>
807 <item>
808 <it>Prev. unread:</it> go to the previous unread message.
809 Shortcut: Shift-P
810 </item>
811 <item>
812 <it>Next unread:</it> go to the next unread message.
813 Shortcut: Shift-N
814 </item>
815 <item>
816 <it>Prev. new:</it> go to the previous new message.
817 </item>
818 <item>
819 <it>Next new:</it> go to the next new message.
820 </item>
821 <item>
822 <it>Prev. marked:</it> go to the previous marked message.
823 </item>
824 <item>
825 <it>Next marked:</it> go to the next marked message.
826 </item>
827 <item>
828 <it>Prev. labeled:</it> go to the previous labeled message.
829 </item>
830 <item>
831 <it>Next labeled:</it> go to the next labeled message.
832 </item>
833 <item>
834 <it>Other folder:</it> change the current folder. Opens a new window
835 with the folder tree, and open the selected folder.
836 </item>
837 </itemize>
838 </item>
839 <item>
840 <it>Code set:</it> allows you to select what codeset you want to use
841 for your e-mails. This codeset will be used when sending
842 mails. Note Sylpheed will always try to use the more compatible
843 codeset based on the characters used in your message, so unless
844 you use special latin-1 characters in your mail, the encoding
845 will be defined as 7bits ASCII even if you have selected the
846 ISO-8859-1 character set.
847 The auto-detect option let Sylpheed automatically detect the
848 character set based on the content of the messages.
849 </item>
850 <item>
851 <it>Open in new window:</it> open the selected message in a new window.
852 This new window can be closed by pressing the escape key.
853 Shortcut: Ctrl-Alt-N
854 </item>
855 <item>
856 <it>Message source:</it> opens a new window and display the complete
857 source of the message in it (without any formatting and with
858 all the header fields).
859 Shortcut: Ctrl-U
860 </item>
861 <item>
862 <it>Show all header:</it> toggles on and off the display of the complete
863 message header.
864 Shortcut: Ctrl-H
865 </item>
866 <item>
867 <it>Update summary:</it> update the Sylpheed window.
868 Shortcut: Ctrl-Alt-U
869 </item>
870</itemize>
871</sect1>
872
873<sect1>Message menu
874<p>
875Here you find the following options:
876
877<itemize>
878 <item>
879 <it>Get new mail:</it> this will collect all new mail for your
880 default mail-identity.
881 Shortcut: Ctrl-I
882 </item>
883 <item>
884 <it>Get from all accounts:</it> Sylpheed will poll all defined
885 mail-identities for new mail.
886 Shortcut: Shift-Ctrl-I
887 </item>
888 <item>
889 <it>Cancel receiving:</it> stop the new mails reception.
890 </item>
891 <item>
892 <it>Send queued messages:</it> all the messages that you put into
893 the "Queue" folder will now be sent off.
894 </item>
895 <item>
896 <it>Compose new message:</it> allows you to write a new e-mail
897 message.
898 Shortcut: Ctrl-M
899 </item>
900 <item>
901 <it>Reply:</it> an e-mail message will be created with the sender
902 of the selected message in the summary pane as recipient.
903 Depending on the settings, your signature will be added
904 to the mail, and the original mail text will be quoted.
905 If a part of the original mail is selected, only this
906 part will be quoted in the reply.
907 Shortcut: Ctrl-R
908 </item>
909 <item>
910 <it>Reply to</it>
911 <itemize>
912 <item>
913 <it>all:</it> as Reply, but the recipients will be all
914 e-mail addresses in the original messages (including
915 the ones in the cc: part).
916 Shortcut: Shift-Ctrl-R
917 </item>
918 <item>
919 <it>sender:</it> as Reply.
920 </item>
921 <item>
922 <it>Mailing list:</it> reply to the mailing list. To use
923 when replying to a mailing list (unless you want to reply
924 only to the poster of the message).
925 Shortcut: Ctrl-L
926 </item>
927 </itemize>
928 </item>
929 <item>
930 Reply to sender: as Reply, but the recipient is the address
931 defined in the Sender header field (not the Reply-To address).
932 </item>
933 <item>
934 <it>Forward:</it> a message will be created with the original
935 message in the summary pane as text. You can then
936 enter a recipient e-mail address, edit the text if
937 you want, and send it.
938 Shortcut: Ctrl-Alt-F
939 </item>
940 <item>
941 <it>Forward as attachment:</it> as Forward, but the message
942 text will sent along as a separate textfile.
943 Shortcut: Shift-Ctrl-Alt-F
944 </item>
945 <item>
946 <it>Redirect:</it> re-send the selected message to someone else. Compared
947 to a forward, the message is not marked as forwarded, and the sender
948 is the original mail sender.
949 </item>
950 <item>
951 <it>Re-edit:</it> lets you open all already sent message in
952 edition mode to re-send it.
953 </item>
954 <item>
955 <it>Move:</it> lets you move the message to a different folder.
956 You can select the destination folder from a browse-window.
957 </item>
958 <item>
959 <it>Copy:</it> as Move, only that the message is copied to the
960 new folder, instead of moved.
961 Shortcut: Shift-Ctrl-O
962 </item>
963 <item>
964 <it>Delete:</it> lets you delete the message that is selected
965 in the summary pane.
966 Shortcut: Ctrl-D
967 </item>
968 <item>
969 <it>Mark:</it> Gives a submenu: <it>Mark/Unmark/Mark as read/Unmark
970 as read</it>. When you mark messages, you can do a specific
971 action (e.g. move, delete) on all of the marked messages.
972 You can unmark messages that you mistakenly marked.
973 The other options do as they say, they mark or unmark
974 a message as read, and mark all read, marks all the messages
975 of the current folder as read.
976 </item>
977</itemize>
978
979A note on functions like Move, Copy and Delete: if you did not
980specify to execute the commands immediately (in the configuration),
981you will have to select the <it>Execute</it> command. This is a button
982in the toolbar, and can also be found in the Summary menu.
983</sect1>
984
985<sect1>Tool menu
986<p>
987In the Tool menu are grouped the filters control, address book
988access and log window control.
989
990<itemize>
991 <item>
992 <it>Address book:</it> opens the address book window.
993 Shortcut: Shift-Ctrl-A
994 </item>
995 <item>
996 <it>Add sender to address book:</it> adds the sender of the selected
997 message to one of your address books. When selected a window
998 opens to let you select the target address book.
999 </item>
1000 <item>
1001 <it>Filter messages:</it> apply the filter rules to the messages
1002 of the inbox.
1003 </item>
1004 <item>
1005 <it>Create filter rule:</it> create a new filter rule based on the
1006 selected message.
1007 <itemize>
1008 <item>
1009 <it>Automatically:</it> open the filter rules creation window
1010 to define a new rule.
1011 </item>
1012 <item>
1013 <it>By From:</it> opens the filter rules creation window and
1014 fills the filter settings fields to build a filter based
1015 on the sender of the selected message.
1016 </item>
1017 <item>
1018 <it>By To:</it> opens the filter rules creation window and
1019 fills the filter settings fields to build a filter based
1020 on the receiver of the selected message.
1021 </item>
1022 <item>
1023 <it>By Subject:</it> opens the filter rules creation window and
1024 fills the filter settings fields to build a filter based
1025 on the subject of the selected message.
1026 </item>
1027 </itemize>
1028 </item>
1029 <item>
1030 <it>Actions:</it> this menu is empty until you define some actions (see the
1031 configuration menu description).
1032 </item>
1033 <item>
1034 <it>Delete duplicated messages:</it> This will remove messages from the
1035 active folder that were sent twice to you. For example you
1036 received a message directly and through a mailing list at
1037 the same time.
1038 </item>
1039 <item>
1040 <it>Execute:</it> execute all the pending move, delete, and copy commands.
1041 Only if execute immediately is off in the common preferences.
1042 Shortcut: X
1043 </item>
1044 <item>
1045 <it>Log window:</it> opens the log window. In the log window, you
1046 can see what Sylpheed is doing. Keeping track of things
1047 in that way is very good when you suspect there is something
1048 wrong. You can paste the info of the log window into an
1049 e-mail and send it to the developer or the mailing list.
1050 Shortcut: Shift-Ctrl-L
1051 </item>
1052</itemize>
1053
1054
1055In the log window, you can see what Sylpheed is doing. Keeping
1056track of things in that way is very good when you suspect there
1057is something wrong. You can paste the info of the log window
1058into an e-mail and send it to the developer or the mailing list.
1059</sect1>
1060
1061<sect1>Configuration menu
1062<p>
1063In the Configuration menu, clearly, you can set up Sylpheed
1064the way you want it to work and react.
1065
1066<itemize>
1067 <item>
1068 <it>Common preferences:</it> in this option you will be
1069 presented a dialog in which you can select a number
1070 of tabs. Each tab represents a specific set of settings
1071 in Sylpheed. In the next chapter, these dialog options
1072 are explained in more detail.
1073 </item>
1074 <item>
1075 <it>Filter setting:</it> this option shows you a dialog in which you
1076 can set up the filtering rules that you want Sylpheed
1077 to process on receiving new e-mails. You first specify
1078 on which part(s) of the e-mail Sylpheed has to check,
1079 and then you tell Sylpheed what to do. You can move the
1080 message to a different directory (including trash to get
1081 rid of spam mail). Selecting the destination folder is
1082 possible through a browser window that comes up when you
1083 press "Select..."
1084 <p>
1085 You can choose not to receive the e-mail. Note that
1086 this will leave the message on the mailserver of your
1087 provider, the message will not be removed!
1088 <p>
1089 When you press the "Register" button, the filter
1090 rule is added to the list of rules. Do you select
1091 "Substitute", then the selected rule is replaced by the
1092 information of the setting entered. "Delete" in the end
1093 will delete the selected filtering rule.
1094 <p>
1095 Please note that you can set up two selections for a rule,
1096 which can be "OR'd" or "AND'd". OR means that one of the
1097 two selections will have to match for the rule to be
1098 executed. AND means that both selections have to match
1099 before an action is performed.
1100 <p>
1101 To the right of the selection rules you see buttons
1102 called UP and DOWN. You can move rules up and down in
1103 the list. This will often trigger different behaviour
1104 in the selections, so consider the order in which
1105 you set the rules.
1106 </item>
1107 <item>
1108 <it>Template:</it> let your create a new message template.
1109 When composing a new message you can then used one
1110 of the defined templates and insert it (or use it to
1111 completely replace the content of your mail).
1112 The templates can contain some special characters
1113 that are replaced when the template is used in order
1114 to create a dynamic text. Use the symbols button on
1115 the templates definition window to see the list of
1116 the available symbols.
1117 </item>
1118 <item>
1119 <it>Actions:</it> let your create new commands to be added to the
1120 'Tools/Actions' menu. An action is a command that processes
1121 the select part of a message, the message body or the complete
1122 message file. It can be a background process, used as a filter
1123 (reads, modifies and replaces a message),...
1124 </item>
1125 <item>
1126 <it>Preferences for current account:</it> here you can set the
1127 specifics for the account you are currently using.
1128 Should mail be deleted after fetching, what is the
1129 server it comes from, etc. Basically it is the same
1130 dialog form as shown in setting up a new account.
1131 </item>
1132 <item>
1133 <it>Create new account:</it> here you name the account (each
1134 account has a recognizable name), you set up your name
1135 and e-mail address etc. You set up the type of server
1136 you access (POP4, IMAP4, local mailbox, newsserver)
1137 and where the downloaded messages have to go (default
1138 folder is the inbox). In the RECEIVE tab you select or
1139 unselect options, in SEND you can set up how to send
1140 your messages. In COMPOSE you can point to a specific
1141 signature file, and in ADVANCED you can set up alternate
1142 ports for the server, if these exist. (Do not mess
1143 with these unless you are sure you have to!!)
1144 </item>
1145 <item>
1146 <it>Edit accounts:</it> here you can select one of the accounts
1147 you created, from a list, and edit the information about
1148 them. Note that you cannot edit an account for which
1149 you are writing a message at the same time. This to
1150 ensure data integrity.
1151 </item>
1152 <item>
1153 <it>Change current account:</it> here you can select what
1154 account you want to use, to write a message.
1155 If you have enabled the status bar (in the view menu),
1156 the name of the current account is shown in the bottom
1157 right corner of the Sylpheed window (in the status bar)
1158 and can be changed by a click on it (then a menu appears
1159 and lists all your accounts).
1160 </item>
1161</itemize>
1162
1163</sect1>
1164
1165<sect1>Help menu
1166<p>
1167This menu lets you look at the manual and FAQ of Sylpheed,
1168and you can also see the "about" info, who wrote Sylpheed.
1169<p>
1170
1171</sect1>
1172
1173<sect1>Context menu
1174<p>
1175You can pull up context menus (through clicking button2) for
1176the folder tree and the summary pane. (windows users: button2
1177is the right mouse button.)
1178<p>
1179In the folder view you can add, rename and remove folders
1180through the context menu. You can also set the folder
1181properties (define the selected folder as an inbox, outbox,
1182trash, ...).
1183<p>
1184In the message summary you can do a host of things from the
1185context menu, like viewing message headers, opening a message
1186in a separate window (also possible by double clicking on a
1187message) etc...
1188
1189</sect1>
1190<sect>Dialogs and views<p>
1191
1192
1193
1194
1195<p>
1196The appearance of the Sylpheed windows is controlled by
1197a Gtk+ theme (as Sylpheed is based on the Gtk+ toolkit).
1198Read the Gtk+ or your distribution documentation to find
1199how to change the Gtk+ theme.
1200
1201<sect1>Folder view
1202<p>
1203The folder view shows you all the mail folders that you have created,
1204in a tree-like structure. If you want to see the headers of the messages
1205in a specific folder, just click the name of the folder once, and in the
1206summary view (2) you can see the messages in the selected mail folder.
1207<p>
1208When you see a + sign in front of a folder name, that means the folder
1209branch of that part of the tree is 'collapsed'. You can expand that
1210part by clicking the + sign. In that same manner you can also collapse
1211the - sign in front of an expanded branch of the folder tree.
1212<p>
1213The folder pane can be resized be dragging (left mouse button down)
1214the handle found on the left of the folder view.
1215<p>
1216The folder window can be detached from the main Sylpheed window
1217by selecting the menu action: <tt>View -> Separate folder tree</tt>.
1218When exiting the current state of the folder window (attached or
1219detached) is saved to be restored when re-starting Sylpheed.
1220To re-attach the folder window, de-select the menu entry.
1221<p>
1222<sect2>Special folders:
1223<p>
1224<it>Draft:</it> here you store messages that you want to send out more often,
1225or you want to work on some more. Using the 'reedit' option from the
1226message menu, you can edit the message further.
1227<p>
1228<it>Trash:</it> in here all your deleted messages go. Depending on the common
1229preferences setting, this box is or is not emptied when you end Sylpheed.
1230<p>
1231<it>Sent:</it> in here are saved the messages you send (enabled by a
1232common preference setting and the folder can be changed by an account
1233preference setting).
1234<p>
1235<it>Queue:</it> this folder contains the composed messaged waiting to
1236be sent (with Sylpheed message sending can be delayed).
1237
1238</sect2>
1239</sect1>
1240
1241<sect1>Summary view
1242<p>
1243The summary pane can show you many things. You can select what you
1244want to see from the Summary menu, selecting the option
1245"Set display item". A list of all options is:
1246<itemize>
1247<item>Mark: shows if the message is marked.
1248<item>Unread: shows if the message is read or not
1249<item>MIME: shows MIME attachments
1250<item>Number: shows the MH number of the message
1251<item>Size: the size of the entire message including attachments
1252<item>Date: the date of sending by the sender
1253<item>From: who sent the message
1254<item>Subject: what the message is about
1255</itemize>
1256
1257You can sort the summary view in many ways, by clicking the button
1258that is above the column. Click once to sort going up (a-z), click
1259once more to sort going down (z-a).
1260<p>
1261If you think the size of a column is not right, you can adjust that
1262by placing the mouse cursor next to the button of the column you
1263want to adjust, press mousebutton1 (left button) and drag the
1264column to the width you want it to have.
1265<p>
1266Select a message by clicking on it with the mouse. Once the summary
1267pane has the focus of the program, you can also move up and down
1268in the list through the cursor keys, or pressing "p"(revious) and
1269"n"(ext) as in Pine.
1270</sect1>
1271
1272<sect1>Message view
1273<p>
1274In the message view you can read the message that you selected in
1275the summary pane. If you entered the summary pane without selecting
1276a message, the message view will be empty. At the top of the
1277message view some info is presented about the message you are
1278reading, as well as some statistics on the selected folder.
1279<p>
1280You can scroll up and down in the message by using the arrow keys
1281(after clicking inside the message), or by using the scrollbar.
1282<p>
1283The size of the message and summary views can be adjusted by dragging
1284(with the left mouse button down) the handle that appears between
1285the two panes.
1286<p>
1287The small arrow located just below the summary pane scrollbar can
1288be used to detach the message view. When clicked, the summary view
1289is extended down to the bottom of the Sylpheed window, and the messages
1290are displayed is a separate window (when you double click them in the
1291summary pane). This state is not saved on exit, and the message window
1292can be restored below the summary one by clicking again the small arrow.
1293<p>
1294When the current message contains attachments, two tabs
1295are displayed in the message window. Selecting the first one makes
1296the message window display the text body of the message, while selecting
1297the second tab makes the message window display the attachment part
1298of the message. In the latter case, the message window is splitted
1299in two parts, the top one contains the attachments as a tree
1300with the MIME type, size and file name of each part, while the bottom
1301part contains the content of the selected attachment (if the attachment
1302is an image and Sylpheed has been compiled with the gdk-pixbuf or
1303the imlib library).
1304</sect1>
1305
1306</sect>
1307<sect>Sylpheed configuration
1308<p>
1309All the configuration settings of Sylpheed are accessible from
1310the <it>Configuration</it> menu and consist of common settings
1311(<it>Common preferences</it>, <it>Filter settings</it>,
1312<it>Template</it> and <it>actions</it>) and account specific
1313settings.
1314<p>
1315With Sylpheed, there is no limit to the number of accounts
1316you can create. You can create new accounts for each of your
1317mail account, but also to change the default behaviour of
1318Sylpheed. As folders can be attached to accounts, the account
1319specific part of the configuration automatically change based
1320on the current folder (you can have a different signature when
1321replying to messages from different folders).
1322
1323<sect1>Common preferences
1324<p>
1325The Common Preferences, found in the Configuration menu, controls
1326the window layout and the different options of the graphical
1327interface of Sylpheed. Depending on some compile time switches
1328(and on the availability of some extra libraries), some tabs
1329may be included (or not) in your version of Sylpheed. These tabs
1330are not listed here but are described (or will be described) in
1331the sections covering the optional features they control (like the
1332<it>Privacy</it> tab for the GnuPG interface).
1333
1334<sect2>Receive tab
1335<p>
1336In here you can set up how to receive messages.
1337
1338
1339
1340
1341<itemize>
1342 <item>
1343 You can define a special program to pick up messages from
1344 the default unix mailbox. Usually this is not used, but
1345 you can use it. Actually, this information may be wrong.
1346 If someone knows better, please let me know.
1347 </item>
1348 <item>
1349 <it>Local spool</it> lets you define where your local mailbox is
1350 located. You can also tell Sylpheed whether or not to
1351 filter the incoming messages from that mail spool file.
1352 The spool directory defined here is used by all the accounts
1353 of the <it>local</it> type, by default it is set to the
1354 standard UNIX mailbox location.
1355 </item>
1356 <item>
1357 <it>Autocheck new mail</it>. When you check this option, Sylpheed
1358 will check if there is new mail on the set interval.
1359 </item>
1360 <item>
1361 <it>Check new mail on startup</it> means that Sylpheed will
1362 immediately look for new mail on all the selected accounts
1363 when it loads.
1364 </item>
1365 <item>
1366 <it>Update all local folders after incorporation</it>
1367 Well, if you know the use of this option, feel free to
1368 write this part...
1369 </item>
1370 <item>
1371 In the news section you can specify how many articles
1372 should be downloaded when opening a newsgroup.
1373 </item>
1374</itemize>
1375</sect2>
1376
1377<sect2>Send tab
1378<p>
1379In here you can set up how to send messages.
1380
1381
1382
1383
1384<itemize>
1385 <item>
1386 You can choose to use an external program (like sendmail) for
1387 sending mail. By default no external program is necessary
1388 and Sylpheed can directly send the outgoing messages to a
1389 SMTP server.
1390 </item>
1391 <item>
1392 The sent messages can be saved in the outbox (<it>Sent</it>
1393 folder), the name of the outbox folder can be specified
1394 for each account (see the account setting section).
1395 </item>
1396 <item>
1397 The outgoing codeset selection can be changed to force
1398 the definition of the character set used in sent mails.
1399 The default and recommended value is <it>automatic</it>,
1400 so Sylpheed determines the codeset when sending each
1401 message.
1402 </item>
1403</itemize>
1404</sect2>
1405
1406<sect2>Compose tab
1407<p>
1408Controls the composition window's behaviour..
1409
1410
1411
1412
1413<itemize>
1414 <item>
1415 You can change the signature separator and choose to insert
1416 it automatically (unless your signature file already contains
1417 this separator). Leave it as it is by default (unless you really
1418 need to change it, and are ready to face a religion war), a lot
1419 of mail clients rely on this separator to cut the signature when
1420 quoting mails, and this one is accepted as the standard one.
1421 </item>
1422 <item>
1423 If you hate the editor that comes with Sylpheed, you can choose
1424 to automatically start an editor of your choice when composing
1425 new messages (the editor can be defined in the <it>Other</it> tab).
1426 </item>
1427 <item>
1428 The <it>wrap</it> settings defines how Sylpheed will wrap long
1429 lines. You can choose to wrap quoted messages, wrap as you type,
1430 or wrap when sending. You can also change the maximum line length.
1431 </item>
1432 <item>
1433 The <it>reply</it> settings let you control the way you will reply
1434 to mails. If <it>Automatically select account(...)</it> is set,
1435 the account used when replying to a message is automatically
1436 selected based on the folder the original message is in (as you
1437 where already told, accounts can be attached to folders).
1438 If <it>Quote message when replying</it> is selected, when hiting
1439 the <it>Reply</it> button, the composition window pops up and is
1440 filled with either the complete message you are replying to (if
1441 nothing is selected in the body of this message) or the selected
1442 part of its body. When this option is not selected, the composition
1443 window is always empty, and you must cut-and-paste the parts of
1444 the original message you want to quote manually.
1445 </item>
1446</itemize>
1447</sect2>
1448
1449<sect2>Quote tab
1450<p>
1451In here you can control the quotation of your replies and forwarded
1452messages.
1453
1454
1455
1456
1457<itemize>
1458 <item>
1459 You can individually define the quotation mark that appears
1460 at the beginning of each quoted line when replying and forwarding
1461 a message.
1462 </item>
1463 <item>
1464 You can also define the text that appears before and after the
1465 quotation. The format of the quotation contains placeholders for
1466 parts of the original message that are explains in the window
1467 that appears when hiting the <it>Description of symbols</it>
1468 button.
1469 </item>
1470</itemize>
1471</sect2>
1472
1473<sect2>Display tab
1474<p>
1475In here you can control the display options of Sylpheed.
1476
1477
1478
1479
1480<itemize>
1481 <item>
1482 You can change the font used to display the messages. Pressing
1483 the button next to the font name field will open the font selection
1484 window, then you can select among all the available fonts.
1485 </item>
1486 <item>
1487 Turning on the translation of the header fields will change the
1488 content of the header summary (between the summary and the message
1489 pane), and use the localized header fields name based on the
1490 selected language (selected by the 'LANG' environment variable).
1491 This setting will only take effect the next time you will start
1492 Sylpheed.
1493 </item>
1494 <item>
1495 Selecting <it>Display unread next to folder name</it> will add
1496 the number of unread messages next to the folder name in the
1497 folder pane (so you can minimize the width of the folder pane
1498 and hide the unread column).
1499 </item>
1500 <item>
1501 You can also control the content of the summary pane. If you choose
1502 to display the recipient name for the mail you send, in the <it>From</it>
1503 column, for any mail you have sent, the name of the recipient will
1504 appear preceded by an arrow (the characters sequence: -->).
1505 The <it>Expand threads</it> controls the initial state of the message
1506 threads when opening a folder (expanded of collapsed).
1507 The <it>Set display item of summary</it> button opens a selection
1508 window that contains all the available items to display in the
1509 left column, the currently selected items in the right column.
1510 Items can be added or removed using the two arrows that appears
1511 between the columns. Using the <it>up</it> and <it>down</it> buttons
1512 on the right side of the window, you can change the display order
1513 of the selected item in the summary window (from left to right).
1514 </item>
1515</itemize>
1516</sect2>
1517
1518<sect2>Message tab
1519<p>
1520The message tab controls the message window options.
1521
1522
1523
1524
1525<itemize>
1526 <item>
1527 The message text can use colours to highlight the different levels
1528 of quotation and URIs. The colours can be changed by using the
1529 colours selection dialog that pops up when pressing the <it>Edit</it>
1530 button next to the <it>Enable coloration of messages</it> toggle.
1531 </item>
1532 <item>
1533 The dispaly of the header summary between the summary and message
1534 panes can also be turned on and off (<it>Display header pane above message
1535 view</it> dialog).
1536 </item>
1537 <item>
1538 <it>Display short header on message view</it> and the <it>Edit</it>
1539 button next to it, control the inclusion of some header fields
1540 in the message view. If the message coloration has been turned on,
1541 the addresses that appear in the header part of the message view
1542 are highlighted as URIs.
1543 </item>
1544 <item>
1545 The <it>Line space</it> setting controls the lines spacing of the
1546 message view.
1547 </item>
1548 <item>
1549 <it>Leave space on head</it>. Checking this box will make the
1550 start of new lines (unwrapped, where the writer has pressed
1551 the Enter/Return key) indent a few pixels. This can be useful
1552 to read larger e-mails.
1553 </item>
1554 <item>
1555 <it>Scroll half page</it>. When enabled, the text in the message
1556 view will only scroll half a page instead of a whole page when
1557 pressing the space bar.
1558 </item>
1559 <item>
1560 <it>Smooth scroll</it>. Enabling this box will make the text
1561 in the message view scroll in a smooth, sliding way. For the
1562 eye this can be pleasing, it is a personal preference.
1563 </item>
1564 <item>
1565 Select the <it>Resize attached image</it> if you wnat all the
1566 images (attachment) to be resized to fit in the message window.
1567 </item>
1568</itemize>
1569</sect2>
1570
1571<sect2>Interface tab
1572<p>
1573The interface tab controls the Sylpheed's Graphical User Interface
1574behaviour.
1575
1576
1577
1578
1579<itemize>
1580 <item>
1581 The <it>Open message when cursor keys are pressed</it> toggles controls
1582 the opening of the messages while you go through them in the summary
1583 pane using the cursor (up and down arrows) keys. If this toggle is on,
1584 each time you press the <it>down</it> (or <it>up</it>) key in the the
1585 summary window, the current message changes and the content of the
1586 message view changes to the content of the newly selected message.
1587 Otherwise, the content of the message view does not change unless you
1588 press enter (then the message view contains the content of the selected
1589 message).
1590 This does not change the behaviour of the left mouse button (always selects
1591 and open the pointed message).
1592 </item>
1593 <item>
1594 <it>Open first unread message when entering a folder</it> if selected,
1595 when opening a folder, the message view will contain the first unread
1596 message of this folder (or the latest message in the order the folder
1597 uses for sorting messages). If not selected, the message view remains
1598 empty until a message is selected (by changing the current message with
1599 the cursor keys or with the left mouse button).
1600 </item>
1601 <item>
1602 <it>Only marks message read when open in new window</it> leaves the
1603 selected message unread (but display it in the message view) until you
1604 open it in a new window (double click the left mouse button).
1605 </item>
1606 <item>
1607 If <it>Execute immediately when moving or deleting messages</it> is not
1608 selected, a new button appears in the button bar marked <it>Execute</it>.
1609 When deleting or moving messages, they are first marked as deleted or
1610 moved but Sylpheed does not move or delete them until you press the
1611 <it>Execute</it> button (or the <it>Execute</it> entry of the
1612 <it>Tools</it> menu).
1613 </item>
1614 <item>
1615 The <it>Receive dialog</it> settings controls the dialog that pops
1616 up (if you have set <it>Show receive dialog</it> to <it>always</it>)
1617 when receiving new mails.
1618 The default is to open a pop up window upon reception error unless
1619 you select the <it>Dont't pop up error dialog (...)</it> toggle.
1620 </item>
1621 <item>
1622 <it>The Set key bindings</it> button when pressed, opens a selection
1623 window that contains a list of pre-defined key bindings (<it>Mew</it>,
1624 <it>Mutt</it>, <it>Old Sylpheed</it>) to change all the key bindings
1625 at once. The key bindings can also be changed one by one as described in
1626 </item>
1627</itemize>
1628</sect2>
1629
1630<sect2>Other tab
1631<p>
1632The other tab contains the settings that does not fit the
1633previous categories.
1634
1635
1636
1637
1638<itemize>
1639 <item>
1640 <it>Web browser</it>. Here you can enter the name of your favorite
1641 web browser (Netscape, Opera, Mozilla, Lynx etc.). Add the %s parameter
1642 to the command so Sylpheed knows it has to provide the text you clicked
1643 on as the URL that the browser has to visit.
1644 The arrow next to the text field can be used to display a scrolling
1645 list of predefined URL browsing command lines.
1646 </item>
1647 <item>
1648 <it>Printing</it>. Here you can define the program that should be used
1649 to print. Default is lpr, and the %s is the name of the temporary file
1650 that Sylpheed creates for lpr to print.
1651 When using the <it>File->Print</it> menu entry to print the selected
1652 message, a text window pops up to allow you to change the command
1653 used to print.
1654 </item>
1655 <item>
1656 <it>External editor</it>. You can select an external editor to write
1657 your e-mails with, for example vi, emacs or gedit. Note that for
1658 text-based editors like vi, you need to define a terminal window,
1659 e.g. <tt>xterm -e vi %s</tt>. Otherwise there is no place that the
1660 editor will be able to show up. Here too, the %s parameter is the
1661 name of a temporary file that is created by Sylpheed.
1662 </item>
1663 <item>
1664 <it>Add address to destination (...)</it> when selected,
1665 double clicking an e-mail address (in the address book,
1666 when the composition window is opened) can be used to add
1667 this address to the <it>To:</it> field.
1668 </item>
1669 <item>
1670 Confirming if you want to exit Sylpheed (or just exit quietly).
1671 </item>
1672 <item>
1673 Cleaning the trashbox when exiting Sylpheed.
1674 </item>
1675 <item>
1676 Have Sylpheed ask you to clean the trash before it is done.
1677 </item>
1678 <item>
1679 Warn you when exiting Sylpheed when there are still messages
1680 queued to be sent.
1681 </item>
1682</itemize>
1683</sect2>
1684
1685</sect1>
1686
1687<sect1>Setting up an account/changing an account
1688<p>
1689In order to set up an account in Sylpheed, in the <it>Configuration</it>
1690menu you select <it>Create new account</it>. If you want to change the
1691settings of an existing account and this account is the current
1692one, in the <it>Configuration</it> menu select <it>Preferences for
1693current account</it>, otherwise select <it>Edit accounts...</it>.
1694There you select the account you want to change. After that you press
1695<it>edit</it>. Then a dialog appears in which you can enter or update
1696the following areas:
1697<p>
1698
1699<sect2>Basic tab<label id="Basic">
1700<p>
1701
1702
1703
1704
1705In the "Basic" tab you name the account. This is to make identifying
1706the account easier. The name is then used in the <it>Change current account</it>
1707part of the <it>Configuration</it> menu, or in menu found in the lower
1708right corner of the main window (used to quickly switch to another account).
1709<p>
1710Choose a name that tells something about the account, like the
1711name of the ISP, mailbox or news-server you are setting up.
1712You can select this account to be the default account ("Usually used").
1713The default account can also be defined from the <it>Edit accounts</it>
1714window (toggle the <it>D</it> column next to the account name).
1715<p>
1716Enter your name and e-mail address, and if you have one, the
1717organization that you use Sylpheed for.
1718In the Protocol box you select the type of service that this
1719account will be using. The flavors you can choose are: <it>POP3 normal</it>,
1720<it>POP3 APOP auth</it>, <it>IMAP4</it>, <it>NNTP news</it> or <it>None (local)</it>.
1721<p>
1722For POP3 and IMAP services you can then specify the server where
1723your mail is stored. Details about this name, and also the name
1724that goes into the field for <it>SMTP server (send)</it> should be given
1725to you by your ISP.
1726<p>
1727For a local unix mailbox, the <it>Server for receiving</it> is disabled,
1728since the mail will be received for you.
1729<p>
1730The fields for <it>User ID</it> and <it>Password</it> will also be
1731disabled for accounts that do no deal with POP3 or IMAP services.
1732Otherwise you can enter the login name and password for the e-mail
1733server with your ISP here. Usually these are the same as your login
1734name and password to access the dial-in service, but this is
1735not standard. If in doubt, contact the helpdesk of your ISP.
1736
1737<sect3>Passwords:
1738<p>
1739The password is not printed in the entry field (replaced by stars) but
1740is stored in plaintext in the Sylpheed configuration files. The Sylpheed
1741configuration directory (~/.sylpheed) is only readable by 'owner', and
1742not by 'group' and 'other', do not change these access rights.
1743</sect3>
1744
1745</sect2>
1746
1747<sect2>Receive tab<label id="Receive">
1748<p>
1749
1750
1751
1752
1753The <it>Receive</it> tab is only used for POP3 accounts. Here you
1754specify if the mails that were successfully retrieved should be removed
1755from the server. You can also tell Sylpheed to get all the
1756messages there, not only the ones you already received (in case
1757you leave your messages on the server).
1758You can choose to leave the messages on the server during a selectable
1759number of days (then remove them).
1760<p>
1761You can also define a limit for the size of the messages to
1762download. Any message bigger than this limit will not be
1763downloaded.
1764<p>
1765You can also choose to filter messages on receiving, if not
1766set, the messages are only filtered when you use the filter
1767entry of the Tools menu.
1768<p>
1769The default inbox defines the folder that receives the incoming
1770(and not filtered) messages for this account.
1771You can define a different folder as inbox for each of your
1772accounts.
1773<p>
1774If the <it>Get all checks for messages on this account</it> is turned
1775off, when using the <it>Get all</it> menu entry (or toolbar button)
1776this account will not be checked. To check for new mails for
1777this account, you must select the account, then use the <it>Get</it>
1778toolbar button (or menu entry).
1779</sect2>
1780
1781<sect2>Send tab<label id="Send">
1782<p>
1783
1784
1785
1786
1787In the <it>Send</it> tab you can define the settings that apply
1788to sending mails.
1789<p>
1790You can choose to add the date field to the messages you send,
1791generate a unique message identifier, or add custom header
1792fields.
1793
1794<sect3>X-face pictures:
1795<p>
1796The user defined header field should be set up to contain your
1797X-face picture.
1798Thanks to Jeff Dairiki, you can have a complete online course in this.
1799Visit <url url="http://www.dairiki.org/xface/" name="this page"> for the details.
1800</sect3>
1801
1802<p>
1803If your SMTP server needs authentication, define the user ID and
1804password to use in this tab. You can also choose to first authenticate with
1805POP3 before sending.
1806
1807</sect2>
1808
1809<sect2>Compose tab<label id="Compose"><p>
1810
1811
1812
1813
1814In the <it>Compose</it> tab you can define your signature file,
1815choose to always copy someone when sending mails (you can
1816choose to always copy your boss, or yourself), and define the
1817Reply-To field for the current account.
1818</sect2>
1819
1820<sect2>Privacy tab<label id="Privacy">
1821<p>
1822This tab is only available when Sylpheed has been compiled
1823with GPGME and GNUPG (for signature and encryption).
1824
1825<p>
1826With this tab you can choose the keys to use when signing
1827or encrypting mails for this account.
1828</sect2>
1829
1830<sect2>Advanced tab<label id="Advanced">
1831
1832<p>
1833The Advanced tab contains some settings you normally do
1834not need to change (unless you really know what you are
1835doing).
1836
1837
1838
1839
1840<p>
1841You can change the default SMTP or POP3 ports used when
1842connecting to your mail server, define a domain name to
1843use when sending a mail. Some ISP (or mail relays) reject
1844mails without a valid domain name.
1845<p>
1846The default folders for the sent messages, drafts and
1847trash can be defined here. If not changed the current account
1848will use the default folders.
1849</sect2>
1850
1851<sect2>Attaching accounts to folders
1852<p>
1853Pressing the right mouse button over a folder (in the folder pane),
1854and selecting the <it>Properties</it> entry will open the folder properties
1855form. In this form, in the <it>General</it> tab you can see (but not modify)
1856the folder name and the corresponding directory path (relative to the mail
1857directory). In the <it>Compose</it> tab:
1858
1859
1860
1861
1862you can select the account, choose to apply this setting also to
1863the sub-folders.
1864You can also force the address used when sending mail (to force a mailing
1865list address, for example), choose to send a copy of the sent mails
1866to a list of addresses different from the default one defined for the
1867selected account.
1868</sect2>
1869
1870<sect2>Using accounts in the real life
1871<p>
1872Accounts can, of course be used to retrieve mails from different ISPs,
1873separate your personal and professional messages, but also to make your
1874life easier.
1875You can define different accounts just to change your address (as sender),
1876your signature, change the sent folder, etc...
1877Here is a summary of the account specific settings, feel free to
1878find your own use for them:
1879
1880<itemize>
1881 <item>
1882 Sender name, address and organization. Signature, extra header
1883 fields.
1884 </item>
1885 <item>
1886 Leave or remove message from server (usefull for debug).
1887 </item>
1888 <item>
1889 Incoming mails filtering and size limit.
1890 </item>
1891 <item>
1892 Default field (<it>Reply-To</it>:, <it>Cc:</it>, <it>Bcc:</it>).
1893 </item>
1894 <item>
1895 <it>Draft</it>, <it>Trash</it> and <it>Sent</it> folders.
1896 </item>
1897</itemize>
1898
1899By attaching accounts to folders, you can control all these settings
1900on a folder basis, but you can also change the <it>To:</it>, <it>Cc:</it>,
1901<it>Bcc:</it>, and <it>Reply-To:</it> for each folder (overrides the account
1902settings).
1903
1904</sect2>
1905
1906</sect1>
1907</sect>
1908
1909<sect>Viewing messages
1910<sect1>Reading a message<p>
1911Reading 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.
1912</sect1>
1913<sect1>Viewing Multipart MIME (Attached Files)<p>
1914When 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.<p>
1915How do you see an attachment is in an e- mail?<p>
1916This 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.
1917</sect1>
1918<sect1>Extending and Closing Threads
1919<p>
1920Sylpheed 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.<p>
1921By activating threads (summary menu), Sylpheed will attempt to show the sequence of mails as they were written/sent from first to last.<p>
1922To undo the threads view, you simply select the same menu option again and the e-mails are displayed in standard order again.
1923</sect1>
1924<sect1>Message Operations (Moving, Deleting, etc.)
1925<p>
1926Sylpheed 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.
1927</sect1>
1928<sect1>URL in a Message
1929<p>
1930At 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".<p>
1931If 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.<p>
1932In the configuration options, Sylpheed has a color setting specific for URL's so you can spot a URL easily.
1933</sect1>
1934</sect>
1935
1936<sect>Recieving Messages
1937
1938<sect1>Using POP Reception Function in Sylpheed<p>
1939<!-- added 2001/07/19 -->
1940Receiving 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.<p>
1941Once 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.
1942<!-- end addition 2001/07/19 -->
1943</sect1>
1944<sect1>Using Other Programs such as fetchmail<p>
1945<!-- added 2001/07/19 -->
1946Although it is not within the scope of this manual, a bit of information on fetchmail or getmail.<p>
1947You need to have either of these programs installed, and configured correctly. See the man pages/README files of the appropriate program on doing this.<p>
1948After 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".
1949<!-- end addition 2001/07/19 -->
1950</sect1>
1951
1952</sect>
1953
1954<sect>Composing Messages
1955
1956<sect1>Composing a New Message<p>
1957When 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.<p>
1958In 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.<p>
1959In the Subject line you enter a short descriptive text what your message will be about.<p>
1960You 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.<p>
1961Did 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.
1962</sect1>
1963<sect1>Replying to a Message<p>
1964<!-- added 2001/07/19 -->
1965To reply to a message, you use the "reply" function. In Sylpheed you activate this through either the "Reply" button, or by pressing Alt-R.<p>
1966A 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.
1967<!-- end add 2001/07/19 -->
1968</sect1>
1969<sect1>Replying to a Message with Quotation<p>
1970<!-- added 2001/07/19 -->
1971If 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).
1972<!-- end add 2001/07/19 -->
1973</sect1>
1974<sect1>Forwarding Messages<p>
1975<!-- added 2001/07/19 -->
1976Forwarding 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.
1977<!-- end add 2001/07/19 -->
1978</sect1>
1979</sect>
1980
1981<sect>Address Book
1982<p>
1983
1984
1985
1986
1987<p>
1988In the address book, accessible through Shift-Ctrl-A,
1989the Addressbook button, or through the "Tools" menu, you
1990store e-mail addresses of the people and places you want
1991to write more often.
1992<p>
1993If the options have been compiled into Sylpheed, the
1994address book can connect to a LDAP server for address
1995lookup, and you can use the address book stored on your
1996Palm PDA.
1997
1998<sect1>Adding and Deleting Addresses
1999
2000<p>
2001Adding an address to the address book is quite easy too.
2002Rightclick the folder or group you want to add the address
2003to, select "new address" and fill in the dialog that comes
2004up. You can also directly click the Add button in the
2005address book window, and the dialog comes up. In this
2006case the address is moved into the folder/group that is
2007selected at the moment of adding.
2008
2009<p>
2010
2011
2012<p>
2013In the "Basic data" tab, you can fill the first
2014and last name and provide a nickname. The "Display name"
2015will be used by the "Name" column of the address book
2016window.
2017
2018<p>
2019<p>
2020
2021
2022<p>
2023In the "E-Mail address" tab, fill the address field
2024and use the "Add" button to add the address to the list.
2025An alias can also be assigned to this address and used
2026when searching for an address.
2027Several addresses can be assigned to the same person
2028in your address book by repeating the sequence described
2029above. The addresses can then be sorted by using the
2030"Move up" and "Move down" buttons. The address on the top
2031will be the first one listed in the address book main window.
2032
2033<p>
2034Deleting an address is equally simple. Find the address,
2035click it once, and press the Delete button.
2036
2037</sect1>
2038
2039<sect1>Folders and Groups
2040<p>
2041You can use groups and folders to organize your address
2042book into categories, hierarchies and aliases.
2043The folders are used to generate a hierarchical organization
2044and contain the actual addresses, while the groups are
2045used to group together addresses that lives in separate
2046folders.
2047<p>
2048Sounds complicated, so let's see an example: consider
2049your workmates, they are arnaud (arnaud@company.com),
2050sandra (sandra@company.com), xavier (xavier@company.com)
2051and the chief, helene (helene@company.com). You can
2052create a folder named <tt>myGroup</tt>, create the entries
2053for all your workmates in this folder. Now you can create one
2054groupe named <tt>jokes</tt> that includes all but the boss
2055to use when sending your daily jokes, another one named
2056<tt>team</tt> that includes everybody for the usual group
2057(serious) communication, and a third group named
2058<tt>reports</tt> that includes the boss, and the one working
2059with you on some projects for the weekly reports.
2060<p>
2061To generate this kind of addresses organization
2062you only need to create the entries once, then when
2063creating groups you can select among the existing entries
2064to fill the groups.
2065<p>
2066The address book, like the mail folders, can be expanded
2067into an entire tree of sections. For this you right-click
2068on the folder where you want to add a new folder, and
2069select "new folder". Then you can enter a descriptive
2070name for the folder, click Ok, and your folder is created.
2071<p>
2072In this same way you can create a new group in a folder.
2073Right-click on the folder, select "new group", enter a name
2074for it, and that's it.
2075<p>
2076The group settings window pops up in order to fill the group
2077with addresses. Use the two arrows to add to or remove from
2078the group the selected address.
2079Once the group contains the list of addresses you want it to
2080contain, click the "OK" button to close the window.
2081<p>
2082
2083
2084
2085</sect1>
2086
2087<sect1>Combination with Message Composition Window
2088<p>
2089You can either enter the first letters of an address
2090(or alias) in the <tt>To:</tt> or <tt>Cc:</tt> field
2091of the composition window and press the TAB key to
2092let Sylpheed do the completion or open the address book,
2093select addresses from there and use the <tt>To:</tt>
2094and <tt>Cc:</tt> buttons to copy the selected addresses
2095into the corresponding fields of the composition window.
2096<p>
2097When using the completion mode, when one or more address
2098matches the start you have entered, a dropdown list appears.
2099Select the correct address from this list and press enter
2100to complete the composition window's field.
2101<p>
2102In completion mode, the search is made on the E-mail
2103address and on the alias. The other fields of the
2104address book entry are not used (name, nickname,...).
2105<p>
2106When the address book is opened, if you select a group,
2107using the <tt>To:</tt> or <tt>Cc:</tt> buttons will
2108copy all the addresses of the selected group into the
2109corresponding field of the composition window.
2110<p>
2111Using our previous example, you can select the <tt>jokes</tt>
2112group when sending you morning jokes, and the <tt>reports</tt>
2113one when sending your weekly reports...
2114
2115</sect1>
2116
2117<sect1>Using your PDA addressbook (with Jpilot)
2118<p>
2119Sylpheed can optionally use your PDA addressbook. This option is
2120available if you have compiled Sylpheed with the support of Jpilot.
2121For more details regarding the compilation of Sylpheed with (or without)
2122optional features, see the
2123<ref id="compile_sylpheed" name="compilation section">.
2124
2125<p>
2126Sylpheed uses the Jpilot side copy of your address book, so you do
2127not need to put your PDA on the craddle to find an address (but do
2128not forget to synchronize).
2129
2130<p>
2131In order to use your PDA's addressbook in Sylpheed, open the addressbook
2132window, select the <it>JPilot</it> icon in the left tree view,
2133use the <it>File -> New Jpilot</it> menu entry and choose a name for
2134this addressbook.
2135Define the name of the Jpilot addressbook file (usually in:
2136<tt>~/.jpilot/AddressDB.pdb</tt>) and press <it>OK</it>.
2137You can use one (or more) of the custom fields to store alternate
2138Email addresses for the same person.
2139
2140<p>
2141Now you can browse your PDA addressbook. Sylpheed only has read
2142access to this addressbook, so you can't modify your PDA addressbook
2143from Sylpheed.
2144
2145</sect1>
2146
2147<sect1>LDAP server connection
2148<p>
2149
2150### FIXME: write this part.
2151
2152</sect1>
2153
2154</sect>
2155
2156<sect>Filters, actions and templates
2157<p>
2158Sylpheed offers three powerfull tools to help you automatically
2159and efficently manage you mails. These tools are:
2160
2161<itemize>
2162 <item>
2163 The <it>filters</it>, that let you sort you incoming messages and move
2164 them into your folders based on their sender, their content,
2165 using regular expressions.
2166 </item>
2167 <item>
2168 The <it>actions</it> feature is a convenient way for the user to launch
2169 external commands to process a complete message file including
2170 headers and body or just one of its parts.
2171 It allows also the use of an external command to filter the whole
2172 text or just a selected part in the message window or in the
2173 compose window.
2174 </item>
2175 <item>
2176 The <it>templates</it> that let you pre-define complete messages
2177 leaving placeholders in the text to be filled at composition time.
2178 </item>
2179</itemize>
2180
2181
2182
2183<sect1>Filters
2184<p>
2185Written by Nick Selby (sylpheed@nickselby.com)
2186<p>
2187Sylpheed provides powerful filters to allow users to automatically
2188pre-sort incoming mail based on a set of rules that the user defines.
2189As a most simple example, let's say you work at the Acme Grommet Company,
2190and you want all e-mail from your co-workers to be placed in one mailbox.
2191To accomplish this, you would set up a filter that would place all mail
2192whose "From" header includes the phrase "acmegrommet.com" into a specific
2193mailbox.
2194<p>
2195Sylpheed allows you much more control than just that simple setup;
2196you may create filters based on several variables, including an
2197"If this AND that" or "If the message contains this OR does NOT contain that"
2198etc. It's very cool.
2199
2200<sect2>Finding The Filter Setting Dialog
2201<p>
2202The filter settings dialog is located in the <it>Configuration</it> menu,
2203under the title "Filter Setting" or from the <it>Tools</it> menu, under in
2204the <it>Create filter rules</it> sub menu. You may also use establish a
2205keyboard shortcut (see Keyboard Shortcuts).
2206
2207
2208
2209
2210</sect2>
2211<sect2>Setting Up Filters<p>
2212Operator(s) and Processing instructions combine to create a Filter Rule.
2213
2214* Operators
2215The dialog's first setting option establishes the Operator, the variable
2216that will tell the filter what specific text to look for to trigger a
2217filter. Each Filter Rule may have up to two operator sets.
2218<p>
2219Each Operator variable contains three sections: <it>Header</it>,
2220<it>Keyword</it> and <it>Predicate</it>.
2221<p>
2222Header is a drop-down box which defines in which message header
2223Sylpheed's filter will search. Choices range from <it>Subject</it>
2224to <it>X-Mailer</it>.
2225
2226<it>Keyword</it> is a a text box in which you may enter the text
2227for which the filter will search.
2228
2229Predicate allows you to choose to filter based on whether the operator
2230contains, or does not contain, the text you enter in the Keyword field.
2231<p>
2232Example: Create an Operator in which the X-Mailer field of an incoming
2233message contains the word 'Eudora'.
2234
2235<itemize>
2236 <item>
2237 Step 1. Under the <it>Header</it> drop-down box, select
2238 <it>X-Mailer</it>.
2239 </item>
2240 <item>
2241 Step 2. In the <it>Keyword</it> text box, type 'eudora'
2242 (case insensitive)
2243 </item>
2244 <item>
2245 Step 3. Determine appropriate Predicate setting. Default
2246 is <it>Contains</it>.
2247 </item>
2248</itemize>
2249
2250The second Operator setting, which is set identically to the
2251first, also allows the user to select an AND/OR setting
2252declaring the relationship between the two operators.
2253<p>
2254Example: Create an Operator set which will process mail with
2255a <it>From</it> header of bob@acmegrommet.com AND a subject
2256of "2001 Spring Grommet Collection"
2257
2258<itemize>
2259 <item>
2260 Step 1. Under the first Operator set's Header drop-down
2261 box, select <it>From</it>.
2262 </item>
2263 <item>
2264 Step 2. In the <it>Keyword</it> text box, type
2265 'bob@acmegrommet.com' (case insensitive).
2266 </item>
2267 <item>
2268 Step 3. Leave <it>Predicate</it> setting on default,
2269 <it>Contains</it>
2270 </item>
2271 <item>
2272 Step 4. Leave <it>AND/OR</it> box on default setting, <it>and</it>.
2273 </item>
2274 <item>
2275 Step 5. Under the second Operator set's <it>Header</it>
2276 drop-down box, select <it>Subject</it>.
2277 </item>
2278 <item>
2279 Step 6. In the <it>Keyword</it> text box, type
2280 '2001 spring grommet collection' (case insensitive).
2281 </item>
2282 <item>
2283 Step 7. Leave <it>Predicate</it> setting on default,
2284 <it>Contains</it>.
2285 </item>
2286</itemize>
2287
2288</sect2>
2289
2290<sect2>Message Processing
2291<p>
2292Once you've established the Operator(s) that will define
2293which messages will be processed, it's time to tell
2294Sylpheed what to do with messages that match the operator(s).
2295You may choose between two radio button-selected settings:
2296<it>Destination</it> and <it>Don't Receive</it>.
2297<p>
2298Selecting <it>Destinations</it> will enable you to route
2299the mail into a mailbox which you specify.
2300<p>
2301Selecting <it>Don't Receive</it> will instruct Sylpheed
2302to not download messages with that operator. Note that with
2303<it>Don't Receive</it>, Sylpheed merely leaves the message
2304on your mailserver - it does not delete it.
2305
2306To specify a mailbox to which you want the message transfered,
2307click on the radio button to the left of the word <it>Destination</it>
2308in the dialog. (Currently, in order to specify a mailbox you
2309must have created that mailbox prior to activating the Filter
2310Setting dialog.) Clicking the <it>Select</it> button will open
2311a pop-up window containing all mail folders currently active
2312in your copy of Sylpheed. Select the mailbox you wish by either
2313
2314<itemize>
2315 <item>
2316 (a) double clicking on the mail folder name or
2317 </item>
2318 <item>
2319 (b) clicking the mail folder name and then clicking <it>OK</it>.
2320 </item>
2321</itemize>
2322
2323<p>
2324To specify that the message not be retrieved, and left
2325on your mail server, click the radio button to the left
2326of the words <it>Don't Receive</it>.
2327
2328</sect2>
2329
2330<sect2>Filter Registration
2331<p>
2332Now that you have set the Operator and the Processing Rule,
2333all that's left to do is tell Sylpheed to save the entire
2334Filter Rule. <bf>If you skip this step, the filter won't work</bf>.
2335<p>
2336The <it>Register Rules</it> configuration has three options:
2337<it>Register</it>, <it>Substitute</it> and <it>Delete</it>.
2338
2339<itemize>
2340 <item>
2341 <it>Register</it> saves the Filter Rule.
2342 </item>
2343 <item>
2344 <it>Substitute</it> modifies an existing registered
2345 Filter Rule.
2346 </item>
2347 <item>
2348 <it>Delete</it> will remove a previously registered
2349 Filter Rule.
2350 </item>
2351</itemize>
2352
2353Example of Registering A Filter Rule: Create a Filter Rule
2354that moves all mail with the subject of "Sylpheed Manual"
2355into the (previously created) mail folder "Sylpheed Manual Mail".
2356
2357<itemize>
2358 <item>
2359 Step 1. Under the first Operator set's <it>Header</it>
2360 drop-down box, select <it>Subject</it>.
2361 </item>
2362 <item>
2363 Step 2. In the <it>Keyword</it> text box, type
2364 'sylpheed manual' (case insensitive).
2365 </item>
2366 <item>
2367 Step 3. Leave <it>Predicate</it> setting on default,
2368 <it>Contains</it>. Leave second Operator set empty.
2369 </item>
2370 <item>
2371 Step 4. Click <it>Destinations</it> radio button;
2372 select "Sylpheed Manual Mail" folder.
2373 </item>
2374 <item>
2375 Step 5. Click <it>Register</it>.
2376 </item>
2377 <item>
2378 Step 6. Click <it>OK</it>.
2379 </item>
2380</itemize>
2381
2382Example of Substituting A Filter Rule: Modify a previously
2383created Filter Rule that moves all mail with the subject
2384of "Sylpheed Manual" to sort mail not to the mail folder
2385"Sylpheed Manual Mail" but rather the mail folder "Sylpheed Questions"
2386
2387<itemize>
2388 <item>
2389 Step 1. Under the first Operator set's <it>Header</it>
2390 drop-down box, select <it>Subject</it>.
2391 </item>
2392 <item>
2393 Step 2. In the <it>Keyword</it> text box, type
2394 'sylpheed manual' (case insensitive).
2395 </item>
2396 <item>
2397 Step 3. Leave <it>Predicate</it> setting on default,
2398 <it>Contains</it>. Leave second Operator set empty.
2399 </item>
2400 <item>
2401 Step 4. Click <it>Destinations</it> radio button;
2402 select "Sylpheed Questions" folder.
2403 </item>
2404 <item>
2405 Step 5. Click <it>Substitute</it>.
2406 </item>
2407 <item>
2408 Step 6. Click <it>OK</it>.
2409 </item>
2410</itemize>
2411
2412Example of Deleting a Filter Rule: Remove the previously
2413created Filter Rule which refers to Subject:Sylpheed Questions.
2414
2415<itemize>
2416 <item>
2417 Step 1. In the <it>Registered Rules</it> select box,
2418 highlight the filter entitled
2419 "<it>Subject:Sylpheed Manual: :::Sylpheed Questions:1:1:m</it>"
2420 </item>
2421 <item>
2422 Step 2. Click the <it>Delete</it> Button.
2423 </item>
2424 <item>
2425 Step 3. Confirm the deletion by clicking <it>Yes</it> in the
2426 confirmation pop-up that asks,
2427 <it>Do you really want to delete this rule?</it>
2428 </item>
2429 <item>
2430 Step 4. Click <it>OK</it>.
2431 </item>
2432</itemize>
2433
2434</sect2>
2435
2436<sect2>Registered Rule Order
2437<p>
2438One caveat about all this: the order in which Filter Rules
2439are created could adversely affect your intended message sorting,
2440and one needs to consider this when creating or updating Filter Rules.
2441<p>
2442For example, a Filter Rule saying, "Move anything containing 'ABC'
2443to Mailbox X" listed above another Filter Rule saying "Move anything
2444containing 'ABCDEF' to Mailbox Y" will cause the latter of these
2445filters not to process.
2446<p>
2447Think about the way Sylpheed goes down its list: first, it would say..
2448"Hmm, any messages with ABC? Ah, there's one! Move it".
2449Then it would think, "Okay, any messages with ABCDEF?"
2450To which the answer would be "no" - that ABCDEF was already
2451filtered because it contained "ABC".
2452<p>
2453Bummer.
2454<p>
2455In order to avoid this, you must ensure that the more complex
2456Filter Rule is processed first, by placing it higher than a
2457similar, conflicting Filter Rule.
2458<p>
2459To move a Registered Rule higher or lower within the Registered
2460Rule box, select the rule you would like to move, and click on
2461the <it>Up</it> or <it>Down</it> buttons. This will "move" the
2462rule up or down, above or below a potentially conflicting Filter Rule.
2463
2464</sect2>
2465</sect1>
2466
2467<sect1>How to Filter Messages
2468<p>
2469Filtering messages can be done in several ways:
2470
2471<itemize>
2472 <item>
2473 Sylpheed automatically filters incoming mail from
2474 POP servers.
2475 </item>
2476 <item>
2477 If you incorporate mail from a unix mailbox, then
2478 in the <it>Common preferences</it> (<it>Configuration</it> menu),
2479 you need to check the box called <it>Filter on incorporation</it>.
2480 You find this box in the <it>Receive</it> tab in the space
2481 <it>Local spool</it>.
2482 </item>
2483 <item>
2484 You can also select the option <it>Filter messages</it>
2485 from the Summary menu.
2486 </item>
2487</itemize>
2488
2489Please note that, at time of writing, Sylpheed does -NOT YET-
2490has filtering of IMAP messages enabled.
2491
2492</sect1>
2493
2494<sect1>Filtering mail with Procmail
2495<p>
2496If you feel that Sylpheed has not enough options to perform
2497filtering for you, then you can look at Sylpheed Claws which
2498has more options for filtering. You can find the Claws version
2499(the cutting edge, experimental version of Sylpheed)
2500sylpheed-claws.sourceforge.net.
2501<p>
2502Another option, if you do not want to work with an experimental
2503version of Sylpheed, is Procmail. Procmail is a powerful mail
2504filtering program that is triggered from the Mail Transport
2505Agent (i.e. Sendmail, Postfix, Qmail). Procmail is called by
2506default from these programs after receiving e-mail.
2507<p>
2508The trick to procmail is to tell it that mail has to be filtered
2509into MH mail folders. This is not difficult though.
2510<p>
2511Normally procmail moves mail into MBOX format, this is one large
2512file containing all mails in a folder. MH uses separate files
2513for each e-mail. All you need to do is point the destination
2514of a procmail rule to &lt;destination folder&gt;/.
2515It is the "slash dot" that does the trick.
2516
2517
2518<sect1>Actions
2519<p>
2520The following section is a copy of
2521<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/index.html" name="Melvin's page">.
2522
2523<p>
2524The "actions" feature is a convenient way for the user to
2525launch external commands to process a complete message file
2526including headers and body or just one of its parts.
2527It allows also the use of an external command to filter the
2528whole text or just a selected part in the message window or
2529in the compose window. This is a generic tool that allows
2530to do any uncommon actions on the messages, and thus extends
2531the possibilities of Sylpheed. For example, Sylpheed does not
2532include the rot13 cyphering algorithm popular in some
2533newsgroups. It does not support natively armored encryption
2534or clear signing. It does not support uuencoded messages.
2535As all these features can be handled by external programs,
2536the actions provide a convenient way to use them from the menu bar.
2537
2538<sect2>Usage
2539<p>
2540To create a new action, go to the <it>Configuration</it> menu,
2541select the <it>Actions...</it> entry. The <it>Actions setting</it>
2542dialog offers to enter the Menu name that will trigger the command.
2543The created menu will be found in the <it>Tools -> Actions</it> submenu.
2544By inserting a slash / in the menu name, you create a submenu.
2545
2546The command is entered in the Command line entry. Note that
2547Sylpheed stores every single email in a separate file. This allows
2548to use the following syntax for the command:
2549
2550<itemize>
2551 <item>
2552 <it>%f</it> denotes the file name of the selected message.
2553 If you selected more than one, then the command will be
2554 launched for each message with the appropriate file name.
2555 </item>
2556 <item>
2557 <it>%F</it> denotes the list of the file names of the
2558 selected message. If only one message is selected,
2559 this amounts to <it>%f</it>, but if more messages are
2560 selected, then the command will be launched only once
2561 with the list of the file names. (You can use both
2562 <it>%f</it> and <it>%F</it> in one command: then the
2563 command will be launched for each selected message
2564 with the name of this message and with the list of
2565 all selected messages. I did not find a practical
2566 example for this.).
2567 </item>
2568 <item>
2569 <it>%p</it> denotes the current selected message part
2570 of a multipart message. The part is decoded accordingly.
2571 If the message is not a multipart message, it denotes
2572 the message body.
2573 </item>
2574 <item>
2575 Prepending <it>&gt;</it>: this will allow you to send
2576 to the command's standard input a text that you will
2577 enter in a dialog window.
2578 </item>
2579 <item>
2580 Prepending <it>*</it>: this will allow you to send to
2581 the command's standard input a text that you will enter
2582 in a dialog window. But in contrast to prepending
2583 <it>&gt;</it>, the entered text is hidden
2584 (useful when entering passwords).
2585 </item>
2586 <item>
2587 Appending an ampersand <it>&amp;</it>: this will run
2588 the command asynchronously. That means "fire and forget".
2589 Sylpheed won't wait for the command to finish, nor will
2590 it catch its output or its error messages.
2591 </item>
2592 <item>
2593 Prepending the vertical bar <it>|</it> (pipe-in):
2594 this will send the current displayed text or the current
2595 selected text from the message view or the compose
2596 window to the command standard input. The command will
2597 silently fail if more than one message is selected.
2598 </item>
2599 <item>
2600 Appending the vertical bar <it>|</it> (pipe-out): this
2601 will replace the current displayed text or the current
2602 selected text from the message window or the compose
2603 window with the command standard output. The command
2604 will silently fail if more than one message is selected.
2605 </item>
2606 <item>
2607 Appending the "greater than" sign <it>&gt;</it> will
2608 insert the command output in the message. The difference
2609 between the trailing <it>|</it> is that no text will be
2610 deleted or replaced. Most used when composing mails to
2611 insert text.
2612 </item>
2613</itemize>
2614
2615<bf>Note</bf>: It is not possible to use actions containing
2616<it>%f</it>, <it>%F</it> or <it>%p</it> from the compose window.
2617<p>
2618When a command is run, and unless it is run asynchronously,
2619Sylpheed will be insensitive to any interaction and it will wait
2620for the command to finish. If the command takes too long
2621(5 seconds), it will popup a dialog window allowing to stop it.
2622This dialog will also be displayed as soon as the command has
2623some output: error messages or even its standard output when
2624the command is not a "pipe-out" command. When multiple commands
2625are being run, they are run in parallel and each command output
2626is separated from the outputs of the others.
2627<p>
2628<sect3>Examples
2629<p>
2630Here are some examples that are listed in the same syntax
2631as used for storing the actions list. You can copy and past
2632the definition in your <it>~/.sylpheed/actionsrc</it> file
2633(exit Sylpheed before). The syntax is very simple: one line
2634per action, each action contains the menu name and the command
2635line separated by a colon and a space ": ".
2636Alternatively, you can use <it>Configuration -> Actions...</it>
2637and for each example enter a menu name and copy&amp;paste the
2638text after the colon and space ": " in the command definition.
2639
2640
2641<table>
2642 <tabular ca="lll">
2643 <bf>Purpose</bf>
2644 <colsep>
2645 <bf>Definition</bf>
2646 <colsep>
2647 <bf>Details</bf>
2648 <rowsep>
2649
2650 Decoding uuencoded messages
2651 <colsep>
2652 UUdeview: xdeview %F&amp;
2653 <colsep>
2654 xdeview comes with uudeview. If an encoded file is split
2655 in multiple messages, just select them all and run the command.
2656 <rowsep>
2657
2658 Display uuencoded image
2659 <colsep>
2660 Display uuencoded: uudec %f&amp;
2661 <colsep>
2662 Displays uuencoded files. The uudec script is to be found here.
2663 <rowsep>
2664
2665 rot13 cyphering
2666 <colsep>
2667 Rot13: &verbar;tr a-zA-Z n-za-mN-ZA-M&verbar;
2668 <colsep>
2669 This will apply the rot13 cyphering algorithm to the (selected)
2670 text in the message/compose view.
2671 <rowsep>
2672
2673 Save MS TNEF parts
2674 <colsep>
2675 Save TNEF part: xterm -e tnef-claws %p
2676 <colsep>
2677 Select the TNEF message part then use this action to extract
2678 the attachment.
2679 <rowsep>
2680
2681 Alter messages
2682 <colsep>
2683 Edit message: gvim -f %F
2684 <colsep>
2685 Allows to edit any received message. Can be used to remove
2686 unneeded message parts etc.
2687 <rowsep>
2688
2689 Pretty format
2690 <colsep>
2691 Par: &verbar;par 72Tbgjqw74bEe B=.&lowbar;A&lowbar;a 72bgi&verbar;
2692 <colsep>
2693 par is a utility that can pretty format any text. It does a
2694 very good job in indenting quoted messages, and justify text.
2695 Used when composing a message
2696 <rowsep>
2697
2698 Browse
2699 <colsep>
2700 Part/Dillo: dillo %p&amp;
2701 <colsep>
2702 Browse the selected message part in Dillo.
2703 <rowsep>
2704
2705 Clear Sign
2706 <colsep>
2707 GnuPG/Clear Sign: &verbar;gpg-sign-syl&verbar;
2708 <colsep>
2709 Clear sign a message. The gpg-sign-syl script is responsible
2710 for asking the passphrase and for running gnupg. Make sure
2711 that you wrap your message correctly before signing, and that
2712 the resultant text will not be wrapped when sent (by disabling
2713 'wrap on send')
2714 <rowsep>
2715
2716 Verify Clear Signed
2717 <colsep>
2718 GnuPG/Verify: &verbar;gpg --no-tty --verify
2719 <colsep>
2720 Verify clear signed messages. The result is displayed in the
2721 actions output dialog.
2722 <rowsep>
2723
2724 Encrypt ASCII Armored
2725 <colsep>
2726 GnuPG/Encrypt: &verbar; gpg-enc-syl&verbar;
2727 <colsep>
2728 Encrypt message to ASCII armored. The recipient will be asked
2729 in a xterm.
2730 <rowsep>
2731
2732 Decrypt ASCII Armored
2733 <colsep>
2734 GnuPG/Decrypt: *gpg --no-tty --command-fd 0 --passphrase-fd 0 --decrypt %f&verbar;
2735 <colsep>
2736 Decrypt ASCII armored messages. The passphrase is to be entered
2737 in the opened action's input dialog.
2738 <rowsep>
2739
2740 Receive key from server
2741 <colsep>
2742 GnuPG/Receive Selected Key: &verbar;gpg --recv-key `cat`
2743 <colsep>
2744 Select a key ID in the message view then call this action to
2745 import it from a key server. GnuPG option file must contain a
2746 reference to a keyserver. (Suggested by Bob Forsman)
2747 <rowsep>
2748
2749 Import key from mail
2750 <colsep>
2751 GnuPG/Import Key From Mail: gpg --import %p
2752 <colsep>
2753 Select the message part where the public key is then import
2754 it with this action.
2755 <rowsep>
2756
2757 Insert public key in message
2758 <colsep>
2759 GnuPG/Insert My Public Key: gpg --export -a MYKEYID&gt;
2760 <colsep>
2761 Insert your public key in the message your are composing.
2762 Replace MYKEYID with your key id. Needs 0.8.6claws66 or newer.
2763 <rowsep>
2764
2765 Reporting SPAM
2766 <colsep>
2767 Report as SPAM: spamassassin -r &gt; %f
2768 <colsep>
2769 Use spamassassin to report mail as spam. Redirection (&gt;)
2770 is possible only with version 0.7.7.
2771 <rowsep>
2772
2773 Check spelling
2774 <colsep>
2775 Check spelling: &verbar;T=`mktemp $HOME/.sXXXXXX`; cat - &gt; $T;xterm -e ispell $T;cat $T;rm $T&verbar;
2776 <colsep>
2777 Open a terminal and check the spelling with ispell
2778 <rowsep>
2779
2780 Google for message id
2781 <colsep>
2782 Google Msg ID: &verbar;google_msgid.pl
2783 <colsep>
2784 Search the web for the selected message ID. Needs the
2785 google_msgid.pl script.
2786 <rowsep>
2787
2788 </tabular>
2789</table>
2790
2791
2792The gpg-enc-syl script is to be found
2793<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/gpg-enc-syl" name="here (gpg-enc-syl)">.
2794It calls gpg with the --yes command line option that you may want
2795to remove it. See gpg manual page for info.
2796
2797The gpg-sign-syl script is to be found
2798<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/gpg-sign-syl" name="here (gpg-sign-syl)">.
2799It needs the ssh-askpass utility found in OpenSSH. It can be
2800replaced by any X11 tool that asks some (hidden) text which
2801is then sent to standard output. Another version that uses
2802an xterm is to be found
2803<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/gpg-sign-syl-xterm" name="here (gpg-sign-syl-xterm)">.
2804
2805The uudec script is to be found
2806<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/uudec" name="here (uudec)">.
2807It needs uudecode and ImageMagick's display. The latter can be
2808replaced by any image viewer that can get input from standard
2809input. The script could also be modified to use temporary
2810files instead of standard input.
2811
2812The google_msgid.pl script is to be found
2813<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/google_msgid.pl" name="here (google_msgid.pl)">.
2814Example and script by Thorsten Maerz. Edit the script to change
2815the browser (default is mozilla).
2816
2817The tnef-claws bash script was written by Shawn Lamson and is
2818to be found
2819<url url="http://melvin.hadasht.free.fr/home/sylpheed/actions/tnef-claws" name="here">.
2820The script is well commented. You need to have the tnef package
2821already installed.
2822
2823</sect1>
2824
2825<sect1>Templates
2826<p>
2827With Sylpheed you can define mail templates to use when replying
2828to messages. A template can contain raw text (that will be inserted
2829in the composed mail without any change), and placeholders that are
2830replaced at composition time by the actual value of the selected
2831fields from the original message.
2832<p>
2833A typical use of the template could be to define the legal notice
2834to be appended to your messages (the usual notice that contains a
2835text like: "here are my own words and not those of my company, my
2836boss is not liable for them, bla, bla, bla").
2837<p>
2838To define a new template, in the <it>Configuration</it> menu select
2839the <it>Templates</it> entry and fill the form:
2840
2841
2842
2843
2844<p>
2845The name parameter is used to identify each template, this name
2846will then appear in the <it>Tools/Templates</it> menu in the
2847composition window.
2848The content of the <it>To</it> field will be appended to the original
2849content of the corresponding field in the message you are composing.
2850The content of the <it>Subject</it> field will replace the orignal subject
2851of the message you are composing.
2852<p>
2853In the upper pane, type in the text you want to put in the template,
2854use the <it>Symbols</it> button to open a help window that contains
2855the description of all the placeholders you can use in a template
2856(there is one for the sender, one for the date, one for the message
2857ID, ...), then use the <it>Register</it> button to validate the
2858template. If you do not register the template, when leaving the form
2859the template will be canceled. To modify an existing template, select
2860it in the lower pane, modify its text, then use the <it>Substitute</it>
2861button. As you may guess, the <it>Delete</it> button removes the selected
2862template. Finally validate your changes with the <it>OK</it> button.
2863If you use the <it>Cancel</it> button, the form is closed and your changes
2864are lost (deleted templates are back, added templates are lost).
2865
2866<p>
2867To use a template, open the composition window and select the template
2868from the <it>Tools/Templates</it> menu. You can then choose to insert
2869the template into your message or to completely replace the text of the
2870message by the template. This only affects the body of the message.
2871If you choose to insert the template, its text will be inserted at the
2872cursor location.
2873<p>
2874The placeholders are taken from the source message when replying, so
2875they have no meaning when composing a new message.
2876
2877</sect1>
2878
2879</sect>
2880<sect>Handling MIME types
2881
2882<sect1>How Sylpheed checks for Mime types
2883
2884<p>
2885When attaching a file to a message (composing a new message), the
2886MIME type of the attached file is choosen based on the file extension
2887from the mapping list defined in the <it>mime.types</it> file(s).
2888Sylpheed defines its MIME type mapping table by loading the
2889system wide MIME types file, then the user file.
2890The systeme file is <it>SYSCONFDIR/mime.types</it> (SYSCONFDIR can
2891be defined a compile time), or if it does not exist, <it>/etc/mime.types</it>.
2892The user file is <it>$HOME/.sylpheed/mime.types</it>.
2893<p>
2894A <it>mime.types</it> file consist of one MIME type definition per line,
2895each definition line starting with the name of the MIME type, followed by
2896a space separated list of the corresponding file extensions.
2897The file can contain empty lines, and comments start with the <tt>#</tt>
2898character and close at line's end.
2899<p>
2900Following is a typical <it>mime.types</it> file (an extract of mine):
2901
2902<verb>
2903# This file controls what Internet media types are sent to the client for
2904# given file extension(s). Sending the correct media type to the client
2905# is important so they know how to handle the content of the file.
2906# The Internet media type registry is at
2907# <ftp://ftp.iana.org/in-notes/iana/assignments/media-types/>.
2908
2909# MIME type Extension
2910application/mac-binhex40 hqx
2911application/mac-compactpro cpt
2912application/msword doc
2913application/pdf pdf
2914application/postscript ai eps ps
2915application/rtf rtf
2916application/x-bcpio bcpio
2917application/x-bzip2 bz2
2918application/x-csh csh
2919application/x-gtar gtar
2920application/x-gzip gz tgz
2921application/x-kword kwd kwt
2922application/x-kspread ksp
2923application/x-kpresenter kpr kpt
2924application/x-kchart chrt
2925application/x-latex latex
2926application/x-sh sh
2927application/x-shar shar
2928application/x-shockwave-flash swf
2929application/x-tar tar
2930application/x-tcl tcl
2931application/x-tex tex
2932application/x-texinfo texinfo texi
2933application/x-troff t tr roff
2934application/x-troff-man man
2935application/zip zip
2936audio/mpeg mpga mp2 mp3
2937audio/x-aiff aif aiff aifc
2938audio/x-wav wav
2939image/gif gif
2940image/ief ief
2941image/jpeg jpeg jpg jpe
2942image/png png
2943image/tiff tiff tif
2944text/plain asc txt
2945text/rtf rtf
2946text/sgml sgml sgm
2947text/xml xml
2948video/mpeg mpeg mpg mpe
2949video/x-msvideo avi
2950text/html html htm
2951
2952</verb>
2953
2954<p>
2955If the file can be found or has the wrong format, Sylpheed will assume
2956the default MIME type for all the attachments: <it>application/octet-stream</it>.
2957In such a case, the recipients mail client may not know what application
2958to use to view the attachment.
2959
2960</sect1>
2961
2962<sect1>How Sylpheed handles attachments (reception)
2963<p>
2964When opening an attachment (select the attachment, right click and select
2965<it>Open</it>) Sylpheed uses one of the following methods to determine
2966the application to launch:
2967
2968<itemize>
2969 <item>
2970 The attachment is an image: the application is the one defined by the
2971 <it>mime_image_viewer</it> variable of the common preferences configuration
2972 file (<it>$HOME/.sylpheed/sylpheedrc</it>). If no application is defined, or
2973 if the format of the definition is not valid, the default application
2974 command is <it>display</it> (ImageMagick viewer).
2975 </item>
2976 <item>
2977 The attachment is a sound file: the application is the one defined by the
2978 <it>mime_audio_player</it> variable of the common preferences configuration
2979 file (<it>$HOME/.sylpheed/sylpheedrc</it>). If no application is defined, or
2980 if the format of the definition is not valid, the default application
2981 command is <it>play</it>.
2982 </item>
2983 <item>
2984 The attachment is a HTML file: the application is the one defined by the
2985 <it>uri_cmd</it> variable of the common preferences configuration
2986 file (<it>$HOME/.sylpheed/sylpheedrc</it>). This can also be changed in the
2987 <it>Common preferences</it>, by changing the <it>Web browser</it> defined
2988 in the <it>Other</it> tab.
2989 </item>
2990 <item>
2991 Any other attachment type: Sylpheed relies on <it>metamail</it> to use
2992 the correct application (Sylpheed starts <it>metamail</it> giving it
2993 the attachment file and the MIME type taken from the mail).
2994 </item>
2995</itemize>
2996
2997<p>
2998The binding of the applications to each MIME type is defined in the
2999<it>mailcap</it> file. The systeme wide file is <it>/etc/mailcap</it>,
3000while the user file is <it>$HOME/.mailcap</it>.
3001
3002<p>
3003In the mailcap file, there is one definition per line, big lines
3004can be broken by escaping the newline with a <it>\</it> character,
3005the first element of the line is the MIME type, then a semi-colon,
3006(<it>;</it>), and finally the application to launch.
3007The application part (right side of the semi-colon) can contain several
3008shell commands separated by an escaped semi-colon (<it>\;</it>) and
3009the <it>%s</it> string is replaced by the name of the file when
3010launching the command.
3011
3012<p>
3013Following is a typical <it>mailcap</it> file (an extract of mine):
3014
3015<verb>
3016
3017image/*; ee %s
3018
3019video/mpeg; gtv %s
3020video/*; xanim %s
3021
3022application/pdf; xpdf %s
3023
3024text/html; dillo %s
3025
3026</verb>
3027
3028
3029</sect1>
3030</sect>
3031
3032<sect>Conversion of Other Mail Format into Sylpheed (MH Format)
3033
3034<sect1>Importing Messages of mbox Format<p>
3035<!-- added 2001/07/20 -->
3036Sylpheed lets you import messages of the Mbox format from the File menu. First you create
3037the mail folder where you want the messages to end up in, then you select File->import
3038Mbox file. Use the browse function to select the Mbox file and the Sylpheed mail folder,
3039and press Ok. And voila, there is your mail, imported.
3040<p>
3041That was easy, wasn't it?
3042</sect1>
3043
3044<sect1>Importing from Windows Mailers (Becky!, AL-Mail, Outlook Express4, etc.)
3045<p>
3046For import possibilities of the mail folders of these and more mail programs you
3047can download the program mbx2mbox at sourceforge.net. The project is located at
3048<url url="http://mbx2mbox.sourceforge.net" name ="http://mbx2mbox.sourceforge.net.">
3049</sect1>
3050<sect1>Importing dbx Format of Outlook Express 5<p>
3051For import possibilities of the mail folders of these and more mail programs you
3052can download the program mbx2mbox at sourceforge.net. The project is located at
3053<url url="http://mbx2mbox.sourceforge.net" name="http://mbx2mbox.sourceforge.net.">
3054</sect1>
3055<!-- End added 2001/07/21 -->
3056<!-- start add 2001/09/04 -->
3057<sect1>Exporting from Sylpheed MH format to mbox<p>
3058Sylpheed offers a way to export a mailbox to the standard mbox format through the
3059File menu. Just select the "Export to mbox file..." option and you can select the
3060folder to export (assisted by a browse dialog) and also select or enter the name
3061of the mbox file you wish to generate.
3062<!-- end add 2001/09/04 -->
3063</sect>
3064
3065<sect>NetNews<p>
3066What is netnews?<p>
3067Netnews, 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.<p>
3068This 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.
3069<!-- added 2001/07/20 -->
3070<sect1>Adding and Deleting Servers<p>
3071<sect2>
3072Adding a news server<p>
3073To add a news server, go to the configuration menu and select the "create new account" option.
3074There you can name the news-account to anything of your liking. This is important, so you can identify the account later.<p>
3075In 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).<p>
3076In 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.<p>
3077If 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.<p>
3078Next 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:
3079<itemize>
3080<item>If you want a date header field added to posts
3081<item>If Sylpheed should generate a Message-ID
3082<item>If you want to add user-defined headers
3083</itemize>
3084The 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.<p>
3085The next tab, Compose, allows you to select a default signature file. This will be added to each post to the newsgroups you do.<p>
3086Finally, 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.<p>
3087Now 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.<p>
3088</sect2>
3089<sect2>
3090Deleting a news-server.<p>
3091If 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.
3092</sect2>
3093</sect1>
3094<sect1>Subscribing and Unsubscribing to NewsGroups<p>
3095Okay. 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<p>
3096After 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!!<p>
3097</sect1>
3098<sect1>Reading News<p>
3099When 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.<p>
3100If 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.<p>
3101Starting 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.
3102<sect2>A note about binary files<p>
3103In 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:<p>
3104begin 666 sundown.jpg<p>
3105after which you will find nicely formatted blocks of characters that don't seem to mean anything.
3106</sect2>
3107</sect1>
3108<!-- end add 2001/07/20 -->
3109</sect>
3110
3111<sect>Reference<p>
3112<!-- Added 2001/07/21 -->
3113In 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.
3114<sect1>Short-Cut Key List<label id="shortcut"><p>
3115<sect2>One-key shortcuts:<p>
3116<itemize>
3117<item>a: create a new message
3118<item>d: delete the selected message
3119<item>f: forward the selected message#
3120<item>g: go to a specific folder through a browsing dialog
3121<item>n: jump to the next message/next part of a multipart message
3122<item>p: jump to the previous message/previous part of a multipart message
3123<item>v: switch on/off the message view
3124<item>w: same as a
3125<item>y: Opens save as... dialog
3126</itemize>
3127</sect2>
3128<sect2>Shortcuts to the File menu:<p>
3129<itemize>
3130<item>Alt-F: open FILE menu
3131<item>Alt-P: print
3132<item>Alt-W: close
3133<item>Alt-Q: exit
3134</itemize>
3135</sect2>
3136<sect2>Shortcuts to the Edit menu<p>
3137<itemize>
3138<item>Alt-E: open EDIT menu
3139<item>Ctrl-C: copy
3140<item>Ctrl-A: select all
3141<item>Ctrl-S: search
3142</itemize>
3143</sect2>
3144<sect2>Shortcuts to the View menu<p>
3145<itemize>
3146<item>Alt-V: open VIEW menu
3147</itemize>
3148<sect2>Shortcuts to the Message menu<p>
3149<itemize>
3150<item>Alt-M: open MESSAGE menu
3151<item>Alt-I: check mail for current account
3152<item>Shift-Alt-I: Check mail for all accounts
3153<item>Alt-N: compose new message
3154<item>Alt-R: reply to message
3155<item>Ctrl-Alt-R: reply to sender (contrary to reply to e.g. mailing list)
3156<item>Shift-Alt-R: reply to all (includes all addresses in To: and Cc:)
3157<item>Ctrl-F: forward message
3158<item>Shift-Ctrl-F: forward message as attachment
3159<item>Alt-O: move message
3160<item>Alt-D: delete message
3161<item>Shift-Ctrl-N: open message in new window
3162<item>Ctrl-U: view message source
3163<item>Ctrl-H: show all message headers
3164</itemize>
3165</sect2>
3166<sect2>Shortcuts to the Summary menu<p>
3167<itemize>
3168<item>Alt-S: open SUMMARY menu<p>
3169<item>Alt-X: execute (pending commands, only useful when commands are not executed immediately)
3170<item>Alt-U: update view
3171<item>Alt-G: go to other folder
3172<item>Ctrl-T: thread view
3173<item>Shift-Ctrl-T: unthread view
3174</itemize>
3175</sect2>
3176<sect2>Shortcuts to the Tool menu<p>
3177<itemize>
3178<item>Alt-T: open tool menu
3179<item>Alt-A: open addressbook
3180<item>Alt-L: open logfile
3181</itemize>
3182</sect2>
3183</sect1>
3184
3185<sect1>Data Format of Address Book<p>
3186The addressbook is located in ~/.sylpheed. It is named addressbook.xml.
3187The general format of the addressbook is:<p>
3188
3189<code>
3190&lt addressbook &gt<p>
3191 &lt common_address &gt<p>
3192 &lt group name="Common addresses" &gt<p>
3193 &lt item &gt<p>
3194 &lt name &gt Paul &lt /name &gt<p>
3195 &lt address &gt paul@nlpagan.net &lt /address &gt<p>
3196 &lt remarks &gt Writes Sylph. manual &lt /remarks &gt<p>
3197 &lt /item &gt<p>
3198 &lt /group &gt<p>
3199 &lt /common_address &gt<p>
3200&lt /addressbook &gt
3201</code>
3202
3203</sect1>
3204<!-- end add 2001/07/21 -->
3205</sect>
3206<sect>FAQ<p>
3207You can find the latest, updated, FAQ (Frequently Asked Questions list) at
3208<url url="http://sylpheeddoc.sf.net" name="http://sylpheeddoc.sf.net">
3209
3210<sect1>Unread News Messages
3211</sect1>
3212<sect1>Using MSN Mail Accounts
3213</sect1>
3214<sect1>Changing Fonts on Menu, etc.<p>
3215If 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.<p>
3216Changing the font of the views of Sylpheed is done by selecting "Common preferences" in the Configuration menu. There you select the "Display" tab, and in the first section of the window you can browse the fonts available on your computer.
3217</sect1>
3218<sect1>Changing Key Binding of Short-Cut Key<p>
3219Sylpheed'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.<p>
3220The procedure is very simple. Suppose you want to change the key binding for getting new mail (message menu) from Alt-I to Ctrl-M.<p>
3221<itemize>
3222<item>Open the message menu with the mouse or by pressing Alt-M
3223<item>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.
3224<item>Now you press Ctrl-M. You will immediately see the new key combination appear on the menu.
3225</itemize>
3226Congratulations, 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.
3227</sect1>
3228
3229</sect>
3230<sect>Information
3231
3232<sect1>Websites on Sylpheed<p>
3233Here are some links to the Sylpheed FAQ in other languages:<p>
3234<itemize>
3235<item><url url="http://sylpheeddoc.sourceforge.net/fr/faq/sylpheed-faq.html" name="http://sylpheeddoc.sourceforge.net/fr/faq/sylpheed-faq.html">, courtesy of francois Barrière
3236<item><url url="http://silver.lacmhacarh.gr.jp/sylpheed/sylpheedfaq-ja.htm" name="http://silver.lacmhacarh.gr.jp/sylpheed/sylpheedfaq-ja.htm">, SYLPHEED FAQ in Japanese, courtesy of WAKAI "SilverRain" Kazunao
3237<item><url url="http://beatles.cselt.it/~mau/sylpheed/sylpheedfaq.html" name="http://beatles.cselt.it/~mau/sylpheed/sylpheedfaq.html">, SYLPHEED FAQ in Italian, courtesy of Maurizio Codogno
3238<item><url url="http://www.synconet.de/privhome/rs/sylpheed_faq.html" name="http://www.synconet.de/privhome/rs/sylpheed_faq.html">, SYLPHEED FAQ in German (HTML-Version)
3239<item><url url="http://www.synconet.de/privhome/rs/sylpheed_faq.txt" name="http://www.synconet.de/privhome/rs/sylpheed_faq.txt">, the german text-only version, both courtesy of Ralf Schiffers.
3240<item><url url="http://www.cs.uoi.gr/~csst9910/el_sylfaq.html" name="http://www.cs.uoi.gr/~csst9910/el_sylfaq.html">, SYLPHEED FAQ in Greek courtesy of Theofilos Intzoglou.
3241<item><url url="http://sylpheed.republika.pl" name="http://sylpheed.republika.pl">, SYLPHEED FAQ in Polish courtesy of Przemyslaw Sulek.
3242<item>A spanish version of the FAQ is written by Marcelo Ramos:
3243<url url="http://www.geocities.com/hackpando/sylpheedfaq.html" name="http://www.geocities.com/hackpando/sylpheedfaq.html">, HTML version,
3244<url url="http://www.geocities.com/hackpando/sylpheedfaq.txt" name="http://www.geocities.com/hackpando/sylpheedfaq.txt">, Text version
3245<item>In addition, the spanish FAQ is also available from Ricardo Mones Lastra:
3246<url url="http://www.aic.uniovi.es/mones/sylpheed/faq-es/" name="http://www.aic.uniovi.es/mones/sylpheed/faq-es/">, Linked HTML
3247<url url="http://www.aic.uniovi.es/mones/sylpheed/faq-es.dvi" name="http://www.aic.uniovi.es/mones/sylpheed/faq-es.dvi">, (Device independent)
3248<url url="http://www.aic.uniovi.es/mones/sylpheed/faq-es.ps" name="http://www.aic.uniovi.es/mones/sylpheed/faq-es.ps">, the Spanish FAQ as a Postscript file.
3249<item><url url="http://linux.fisek.com.tr/dfisek/sylpheed-sss.html" name="http://linux.fisek.com.tr/dfisek/sylpheed-sss.html">, the turkish FAQ for Sylpheed is available, thanks to the translating of Doruk Fisek.
3250<item><url url="http://hem.passagen.se/webplats/sylpheed-faq-se.html" name="http://hem.passagen.se/webplats/sylpheed-faq-se.html">, the Swedish FAQ, courtesy of Mattias Stergren
3251</itemize>
3252</sect1>
3253<sect1>Mailing Lists<p>
3254If 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.<p>
3255Send a mail to sylpheed-ctl@good-day.net that says<p>
3256<tt>subscribe Your Name</tt><p>
3257in the body.<p>
3258The 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).<p>
3259<tt>confirm 84682771 Anne Shirley</tt><p>
3260This is a precaution for mischief like subscribing you to the list against your wish.<p>
3261If you received the entry confirmation mail, send a mail that includes the phrase:<p>
3262<tt>confirm Password(a number) Your Name</tt><p>
3263to 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.<p>
3264The address for posting to the list is sylpheed@good-day.net.<p>
3265Notice: If you lost the mail that says<p>
3266confirm Password(a number) Your Name<p>
3267or you became confused and want to do from start, do them over from the start, in other words, send<p>
3268<tt>subscribe Anne Shirley</tt><p>
3269to sylpheed-ctl@good-day.net again.<p>
3270<sect2>How to unsubscribe.<p>
3271Send a mail to sylpheed-ctl@good-day.net that says<p>
3272<tt>unsubscribe</tt><p>
3273in the body.<p>
3274</sect2>
3275<!-- added aug. 13, 2001 -->
3276</sect1>
3277<sect1>Anonymous CVS<p>
3278This section has not been written yet.
3279</sect1>
3280
3281<!-- added 2001/09/05 -->
3282<sect1>How to tell another program to use Sylpheed as e-mail program<p>
3283If 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 <tt>sylpheed --compose</tt>.
3284</sect1>
3285</sect>
3286<sect>About This Document
3287
3288<sect1>Copyright Notice<p>
3289Copyright (C) 2001 Hiroyuki Yamamoto<p>
3290This program has been placed in the GPL.
3291</sect1>
3292<sect1>GNU General Public License<p>
3293This program is free software; you can redistribute it and/or
3294modify it under the terms of the GNU General Public License
3295as published by the Free Software Foundation; either version 2
3296of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful,
3297but WITHOUT ANY WARRANTY; without even the implied warranty of
3298MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3299GNU General Public License for more details. You should have received a copy of the GNU General Public License
3300along with this program; if not, write to the Free Software
3301Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
3302</sect1>
3303<!-- add 2001/07/21 -->
3304<sect1>Where to Get the Latest Version of This Document<p>
3305You can find the latest version of this document on the site of the Sylpheed documentation project at
3306
3307<url url="http://sylpheeddoc.sf.net" name="http://sylpheeddoc.sf.net">
3308
3309Here FAQ and manual are uploaded as HTML pages, and in form of SGML files within the CVS repository.
3310</sect1>
3311<sect1>Ending Remark<p>
3312I wish to thank everyone involved in the Sylpheed project.<p>
3313Hiroyuki Yamamoto and all the other developers for the fabulous program they have created.<p>
3314Francois Barriere who helped me become friends with the CVS system.<p>
3315All the help I received from everyone on the Sylpheed mailing list while writing the FAQ and this manual.<p>
3316Nick Selby, for offering his well appreciated assistance in writing along in this manual.<p>
3317All the people around the world who work hard on keeping the manual and FAQ up to date<p>
3318And Linus Torvald, who got us a great operating system! ;-)
3319<!-- end add 2001/07/21 -->
3320</sect1>
3321</sect>
3322
3323<appendix>
3324
3325 <sect>
3326 The Sylpheed documentation team:<label id="The Sylpheed documentation team"/>
3327
3328 <p>
3329<verb>
3330Francois Barriere fbarriere@users.sourceforge.net
3331Martin Bretschneider furbour@users.sourceforge.net
3332Olivier Delhomme dup@users.sourceforge.net
3333Doruk Fisek dobidik@users.sourceforge.net
3334Melvin Hadasht mhadasht@users.sourceforge.net
3335Nicolas Kaiser nikai@users.sourceforge.net
3336Paul Kater pkater@users.sourceforge.net
3337Ricardo Mones Lastra mones@users.sourceforge.net
3338Jens Oberender jobi@users.sourceforge.net
3339Marcelo Ramos hackpando@users.sourceforge.net
3340Guido Rudolphi malatesta@users.sourceforge.net
3341Frank Weng fweng@users.sourceforge.net
3342</verb>
3343
3344<!-- - GNU Project - Free Software Foundation (FSF) -->
3345<!-- LINK REV="made" HREF="mailto:webmasters@gnu.org" -->
3346
3347
3348 <sect>
3349 GNU Free Documentation License<label id="GNU Free Documentation License"/>
3350
3351
3352 <p>Version 1.1, March 2000</p>
3353
3354 <p>Copyright (C) 2000 Free Software Foundation, Inc.
3355 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
3356 Everyone is permitted to copy and distribute verbatim copies
3357 of this license document, but changing it is not allowed.
3358 </p>
3359
3360 <sect1>
3361 PREAMBLE
3362
3363 <p>The purpose of this License is to make a manual, textbook,
3364 or other written document "free" in the sense of freedom: to
3365 assure everyone the effective freedom to copy and redistribute it,
3366 with or without modifying it, either commercially or
3367 noncommercially. Secondarily, this License preserves for the
3368 author and publisher a way to get credit for their work, while not
3369 being considered responsible for modifications made by
3370 others.</p>
3371
3372 <p>This License is a kind of "copyleft", which means that
3373 derivative works of the document must themselves be free in the
3374 same sense. It complements the GNU General Public License, which
3375 is a copyleft license designed for free software.</p>
3376
3377 <p>We have designed this License in order to use it for manuals
3378 for free software, because free software needs free documentation:
3379 a free program should come with manuals providing the same
3380 freedoms that the software does. But this License is not limited
3381 to software manuals; it can be used for any textual work,
3382 regardless of subject matter or whether it is published as a
3383 printed book. We recommend this License principally for works
3384 whose purpose is instruction or reference.</p>
3385 </sect1>
3386
3387 <sect1>
3388 APPLICABILITY AND DEFINITIONS
3389
3390 <p>This License applies to any manual or other work that
3391 contains a notice placed by the copyright holder saying it can be
3392 distributed under the terms of this License. The "Document",
3393 below, refers to any such manual or work. Any member of the
3394 public is a licensee, and is addressed as "you".</p>
3395
3396 <p>A "Modified Version" of the Document means any work
3397 containing the Document or a portion of it, either copied
3398 verbatim, or with modifications and/or translated into another
3399 language.</p>
3400
3401 <p>A "Secondary Section" is a named appendix or a front-matter
3402 section of the Document that deals exclusively with the
3403 relationship of the publishers or authors of the Document to the
3404 Document's overall subject (or to related matters) and contains
3405 nothing that could fall directly within that overall subject.
3406 (For example, if the Document is in part a textbook of
3407 mathematics, a Secondary Section may not explain any mathematics.)
3408 The relationship could be a matter of historical connection with
3409 the subject or with related matters, or of legal, commercial,
3410 philosophical, ethical or political position regarding
3411 them.</p>
3412
3413 <p>The "Invariant Sections" are certain Secondary Sections
3414 whose titles are designated, as being those of Invariant Sections,
3415 in the notice that says that the Document is released under this
3416 License.</p>
3417
3418 <p>The "Cover Texts" are certain short passages of text that
3419 are listed, as Front-Cover Texts or Back-Cover Texts, in the
3420 notice that says that the Document is released under this
3421 License.</p>
3422
3423 <p>A "Transparent" copy of the Document means a
3424 machine-readable copy, represented in a format whose specification
3425 is available to the general public, whose contents can be viewed
3426 and edited directly and straightforwardly with generic text
3427 editors or (for images composed of pixels) generic paint programs
3428 or (for drawings) some widely available drawing editor, and that
3429 is suitable for input to text formatters or for automatic
3430 translation to a variety of formats suitable for input to text
3431 formatters. A copy made in an otherwise Transparent file format
3432 whose markup has been designed to thwart or discourage subsequent
3433 modification by readers is not Transparent. A copy that is not
3434 "Transparent" is called "Opaque".</p>
3435
3436 <p>Examples of suitable formats for Transparent copies include
3437 plain ASCII without markup, Texinfo input format, LaTeX input
3438 format, SGML or XML using a publicly available DTD, and
3439 standard-conforming simple HTML designed for human modification.
3440 Opaque formats include PostScript, PDF, proprietary formats that
3441 can be read and edited only by proprietary word processors, SGML
3442 or XML for which the DTD and/or processing tools are not generally
3443 available, and the machine-generated HTML produced by some word
3444 processors for output purposes only.</p>
3445
3446 <p>The "Title Page" means, for a printed book, the title page
3447 itself, plus such following pages as are needed to hold, legibly,
3448 the material this License requires to appear in the title page.
3449 For works in formats which do not have any title page as such,
3450 "Title Page" means the text near the most prominent appearance of
3451 the work's title, preceding the beginning of the body of the
3452 text.</p>
3453 </sect1>
3454
3455 <sect1>
3456 VERBATIM COPYING
3457
3458 <p>You may copy and distribute the Document in any medium,
3459 either commercially or noncommercially, provided that this
3460 License, the copyright notices, and the license notice saying this
3461 License applies to the Document are reproduced in all copies, and
3462 that you add no other conditions whatsoever to those of this
3463 License. You may not use technical measures to obstruct or
3464 control the reading or further copying of the copies you make or
3465 distribute. However, you may accept compensation in exchange for
3466 copies. If you distribute a large enough number of copies you
3467 must also follow the conditions in section 3.</p>
3468
3469 <p>You may also lend copies, under the same conditions stated
3470 above, and you may publicly display copies.</p>
3471 </sect1>
3472
3473 <sect1>
3474 COPYING IN QUANTITY
3475
3476 <p>If you publish printed copies of the Document numbering more
3477 than 100, and the Document's license notice requires Cover Texts,
3478 you must enclose the copies in covers that carry, clearly and
3479 legibly, all these Cover Texts: Front-Cover Texts on the front
3480 cover, and Back-Cover Texts on the back cover. Both covers must
3481 also clearly and legibly identify you as the publisher of these
3482 copies. The front cover must present the full title with all
3483 words of the title equally prominent and visible. You may add
3484 other material on the covers in addition. Copying with changes
3485 limited to the covers, as long as they preserve the title of the
3486 Document and satisfy these conditions, can be treated as verbatim
3487 copying in other respects.</p>
3488
3489 <p>If the required texts for either cover are too voluminous to
3490 fit legibly, you should put the first ones listed (as many as fit
3491 reasonably) on the actual cover, and continue the rest onto
3492 adjacent pages.</p>
3493
3494 <p>If you publish or distribute Opaque copies of the Document
3495 numbering more than 100, you must either include a
3496 machine-readable Transparent copy along with each Opaque copy, or
3497 state in or with each Opaque copy a publicly-accessible
3498 computer-network location containing a complete Transparent copy
3499 of the Document, free of added material, which the general
3500 network-using public has access to download anonymously at no
3501 charge using public-standard network protocols. If you use the
3502 latter option, you must take reasonably prudent steps, when you
3503 begin distribution of Opaque copies in quantity, to ensure that
3504 this Transparent copy will remain thus accessible at the stated
3505 location until at least one year after the last time you
3506 distribute an Opaque copy (directly or through your agents or
3507 retailers) of that edition to the public.</p>
3508
3509 <p>It is requested, but not required, that you contact the
3510 authors of the Document well before redistributing any large
3511 number of copies, to give them a chance to provide you with an
3512 updated version of the Document.</p>
3513 </sect1>
3514
3515 <sect1>
3516 MODIFICATIONS
3517
3518 <p>You may copy and distribute a Modified Version of the
3519 Document under the conditions of sections 2 and 3 above, provided
3520 that you release the Modified Version under precisely this
3521 License, with the Modified Version filling the role of the
3522 Document, thus licensing distribution and modification of the
3523 Modified Version to whoever possesses a copy of it. In addition,
3524 you must do these things in the Modified Version:</p>
3525
3526 <p><itemize>
3527 <item>Use in the Title Page
3528 (and on the covers, if any) a title distinct from that of the
3529 Document, and from those of previous versions (which should, if
3530 there were any, be listed in the History section of the
3531 Document). You may use the same title as a previous version if
3532 the original publisher of that version gives permission.
3533 </item>
3534
3535 <item>List on the Title Page,
3536 as authors, one or more persons or entities responsible for
3537 authorship of the modifications in the Modified Version,
3538 together with at least five of the principal authors of the
3539 Document (all of its principal authors, if it has less than
3540 five).
3541 </item>
3542
3543 <item>State on the Title page
3544 the name of the publisher of the Modified Version, as the
3545 publisher.
3546 </item>
3547
3548 <item>Preserve all the
3549 copyright notices of the Document.
3550 </item>
3551
3552 <item>Add an appropriate
3553 copyright notice for your modifications adjacent to the other
3554 copyright notices.
3555 </item>
3556
3557 <item>Include, immediately
3558 after the copyright notices, a license notice giving the public
3559 permission to use the Modified Version under the terms of this
3560 License, in the form shown in the Addendum below.
3561 </item>
3562
3563 <item>Preserve in that license
3564 notice the full lists of Invariant Sections and required Cover
3565 Texts given in the Document's license notice.
3566 </item>
3567
3568 <item>Include an unaltered
3569 copy of this License.
3570 </item>
3571
3572 <item>Preserve the section
3573 entitled "History", and its title, and add to it an item stating
3574 at least the title, year, new authors, and publisher of the
3575 Modified Version as given on the Title Page. If there is no
3576 section entitled "History" in the Document, create one stating
3577 the title, year, authors, and publisher of the Document as given
3578 on its Title Page, then add an item describing the Modified
3579 Version as stated in the previous sentence.
3580 </item>
3581
3582 <item>Preserve the network
3583 location, if any, given in the Document for public access to a
3584 Transparent copy of the Document, and likewise the network
3585 locations given in the Document for previous versions it was
3586 based on. These may be placed in the "History" section. You
3587 may omit a network location for a work that was published at
3588 least four years before the Document itself, or if the original
3589 publisher of the version it refers to gives permission.
3590 </item>
3591
3592 <item>In any section entitled
3593 "Acknowledgements" or "Dedications", preserve the section's
3594 title, and preserve in the section all the substance and tone of
3595 each of the contributor acknowledgements and/or dedications
3596 given therein.
3597 </item>
3598
3599 <item>Preserve all the
3600 Invariant Sections of the Document, unaltered in their text and
3601 in their titles. Section numbers or the equivalent are not
3602 considered part of the section titles.
3603 </item>
3604
3605 <item>Delete any section
3606 entitled "Endorsements". Such a section may not be included in
3607 the Modified Version.
3608 </item>
3609
3610 <item>Do not retitle any
3611 existing section as "Endorsements" or to conflict in title with
3612 any Invariant Section.
3613 </item>
3614 </itemize>
3615
3616 <p>If the Modified Version includes new front-matter sections
3617 or appendices that qualify as Secondary Sections and contain no
3618 material copied from the Document, you may at your option
3619 designate some or all of these sections as invariant. To do this,
3620 add their titles to the list of Invariant Sections in the Modified
3621 Version's license notice. These titles must be distinct from any
3622 other section titles.</p>
3623
3624 <p>You may add a section entitled "Endorsements", provided it
3625 contains nothing but endorsements of your Modified Version by
3626 various parties--for example, statements of peer review or that
3627 the text has been approved by an organization as the authoritative
3628 definition of a standard.</p>
3629
3630 <p>You may add a passage of up to five words as a Front-Cover
3631 Text, and a passage of up to 25 words as a Back-Cover Text, to the
3632 end of the list of Cover Texts in the Modified Version. Only one
3633 passage of Front-Cover Text and one of Back-Cover Text may be
3634 added by (or through arrangements made by) any one entity. If the
3635 Document already includes a cover text for the same cover,
3636 previously added by you or by arrangement made by the same entity
3637 you are acting on behalf of, you may not add another; but you may
3638 replace the old one, on explicit permission from the previous
3639 publisher that added the old one.</p>
3640
3641 <p>The author(s) and publisher(s) of the Document do not by
3642 this License give permission to use their names for publicity for
3643 or to assert or imply endorsement of any Modified Version.</p>
3644 </sect1>
3645
3646 <sect1>
3647 COMBINING DOCUMENTS
3648
3649 <p>You may combine the Document with other documents released
3650 under this License, under the terms defined in section 4 above for
3651 modified versions, provided that you include in the combination
3652 all of the Invariant Sections of all of the original documents,
3653 unmodified, and list them all as Invariant Sections of your
3654 combined work in its license notice.</p>
3655
3656 <p>The combined work need only contain one copy of this
3657 License, and multiple identical Invariant Sections may be replaced
3658 with a single copy. If there are multiple Invariant Sections with
3659 the same name but different contents, make the title of each such
3660 section unique by adding at the end of it, in parentheses, the
3661 name of the original author or publisher of that section if known,
3662 or else a unique number. Make the same adjustment to the section
3663 titles in the list of Invariant Sections in the license notice of
3664 the combined work.</p>
3665
3666 <p>In the combination, you must combine any sections entitled
3667 "History" in the various original documents, forming one section
3668 entitled "History"; likewise combine any sections entitled
3669 "Acknowledgements", and any sections entitled "Dedications". You
3670 must delete all sections entitled "Endorsements."</p>
3671 </sect1>
3672
3673 <sect1>
3674 COLLECTIONS OF DOCUMENTS
3675
3676 <p>You may make a collection consisting of the Document and
3677 other documents released under this License, and replace the
3678 individual copies of this License in the various documents with a
3679 single copy that is included in the collection, provided that you
3680 follow the rules of this License for verbatim copying of each of
3681 the documents in all other respects.</p>
3682
3683 <p>You may extract a single document from such a collection,
3684 and distribute it individually under this License, provided you
3685 insert a copy of this License into the extracted document, and
3686 follow this License in all other respects regarding verbatim
3687 copying of that document.</p>
3688 </sect1>
3689
3690 <sect1>
3691 AGGREGATION WITH INDEPENDENT WORKS
3692
3693 <p>A compilation of the Document or its derivatives with other
3694 separate and independent documents or works, in or on a volume of
3695 a storage or distribution medium, does not as a whole count as a
3696 Modified Version of the Document, provided no compilation
3697 copyright is claimed for the compilation. Such a compilation is
3698 called an "aggregate", and this License does not apply to the
3699 other self-contained works thus compiled with the Document, on
3700 account of their being thus compiled, if they are not themselves
3701 derivative works of the Document.</p>
3702
3703 <p>If the Cover Text requirement of section 3 is applicable to
3704 these copies of the Document, then if the Document is less than
3705 one quarter of the entire aggregate, the Document's Cover Texts
3706 may be placed on covers that surround only the Document within the
3707 aggregate. Otherwise they must appear on covers around the whole
3708 aggregate.</p>
3709 </sect1>
3710
3711 <sect1>
3712 TRANSLATION
3713
3714 <p>Translation is considered a kind of modification, so you may
3715 distribute translations of the Document under the terms of section
3716 4. Replacing Invariant Sections with translations requires
3717 special permission from their copyright holders, but you may
3718 include translations of some or all Invariant Sections in addition
3719 to the original versions of these Invariant Sections. You may
3720 include a translation of this License provided that you also
3721 include the original English version of this License. In case of
3722 a disagreement between the translation and the original English
3723 version of this License, the original English version will
3724 prevail.</p>
3725 </sect1>
3726
3727 <sect1>
3728 TERMINATION
3729
3730 <p>You may not copy, modify, sublicense, or distribute the
3731 Document except as expressly provided for under this License. Any
3732 other attempt to copy, modify, sublicense or distribute the
3733 Document is void, and will automatically terminate your rights
3734 under this License. However, parties who have received copies, or
3735 rights, from you under this License will not have their licenses
3736 terminated so long as such parties remain in full
3737 compliance.</p>
3738 </sect1>
3739
3740 <sect1>
3741 FUTURE REVISIONS OF THIS LICENSE
3742
3743 <p>The Free Software Foundation may publish new, revised
3744 versions of the GNU Free Documentation License from time to time.
3745 Such new versions will be similar in spirit to the present
3746 version, but may differ in detail to address new problems or
3747 concerns. See <url url="http://www.gnu.org/copyleft/" name="http://www.gnu.org/copyleft/">.</p>
3748
3749 <p>Each version of the License is given a distinguishing
3750 version number. If the Document specifies that a particular
3751 numbered version of this License "or any later version" applies to
3752 it, you have the option of following the terms and conditions
3753 either of that specified version or of any later version that has
3754 been published (not as a draft) by the Free Software Foundation.
3755 If the Document does not specify a version number of this License,
3756 you may choose any version ever published (not as a draft) by the
3757 Free Software Foundation.</p>
3758 </sect1>
3759
3760 <sect1>
3761 How to use this License for your documents
3762
3763 <p>To use this License in a document you have written, include
3764 a copy of the License in the document and put the following
3765 copyright and license notices just after the title page:</p>
3766
3767<p><tt>
3768 Copyright (c) YEAR YOUR NAME.
3769 Permission is granted to copy, distribute and/or modify this document
3770 under the terms of the GNU Free Documentation License, Version 1.1
3771 or any later version published by the Free Software Foundation;
3772 with the Invariant Sections being LIST THEIR TITLES, with the
3773 Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
3774 A copy of the license is included in the section entitled "GNU
3775 Free Documentation License".
3776</tt></p>
3777
3778 <p>If you have no Invariant Sections, write "with no Invariant
3779 Sections" instead of saying which ones are invariant. If you have
3780 no Front-Cover Texts, write "no Front-Cover Texts" instead of
3781 "Front-Cover Texts being LIST"; likewise for Back-Cover
3782 Texts.</p>
3783
3784 <p>If your document contains nontrivial examples of program
3785 code, we recommend releasing these examples in parallel under your
3786 choice of free software license, such as the GNU General Public
3787 License, to permit their use in free software.</p>
3788 </sect1>
3789
3790<!-- Keep this comment at the end of the file
3791Local variables:
3792mode: sgml
3793sgml-omittag:nil
3794sgml-shorttag:t
3795sgml-minimize-attributes:nil
3796sgml-always-quote-attributes:t
3797sgml-indent-step:2
3798sgml-parent-document: ("referenz.sgml" "appendix")
3799sgml-exposed-tags:nil
3800sgml-local-ecat-files:nil
3801sgml-local-catalogs: CATALOG
3802sgml-validate-command: "nsgmls -s referenz.sgml"
3803ispell-skip-sgml: t
3804End:
3805-->
3806</article>
generated by cgit v1.3 (git 2.53.0) at 2026-09-26 13:46:27 +0000