aboutsummaryrefslogtreecommitdiff
path: root/manual/en/sylpheed-8.html
blob: 564f5a3cafd67d6b57166a0b8bb3ecd485194693 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
 <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
 <TITLE>Sylpheed User's Manual: Sylpheed configuration</TITLE>
 <LINK HREF="sylpheed-9.html" REL=next>
 <LINK HREF="sylpheed-7.html" REL=previous>
 <LINK HREF="sylpheed.html#toc8" REL=contents>
</HEAD>
<BODY>
<A HREF="sylpheed-9.html">Next</A>
<A HREF="sylpheed-7.html">Previous</A>
<A HREF="sylpheed.html#toc8">Contents</A>
<HR>
<H2><A NAME="s8">8. Sylpheed configuration</A></H2>

<P>All the configuration settings of Sylpheed are accessible from
the <I>Configuration</I> menu and consist of common settings
(<I>Common preferences</I>, <I>Filter settings</I>, 
<I>Template</I> and <I>actions</I>) and account specific
settings.
<P>With Sylpheed, there is no limit to the number of accounts
you can create. You can create new accounts for each of your
mail account, but also to change the default behaviour of 
Sylpheed. As folders can be attached to accounts, the account
specific part of the configuration automatically change based
on the current folder (you can have a different signature when
replying to messages from different folders).
<P>
<H2><A NAME="ss8.1">8.1 Common preferences</A>
</H2>

<P>The Common Preferences, found in the Configuration menu, controls
the window layout and the different options of the graphical
interface of Sylpheed. Depending on some compile time switches
(and on the availability of some extra libraries), some tabs
may be included (or not) in your version of Sylpheed. These tabs
are not listed here but are described (or will be described) in
the sections covering the optional features they control (like the
<I>Privacy</I> tab for the GnuPG interface).
<P>
<H3>Receive tab</H3>

<P>In here you can set up how to receive messages.
<P>
<P>
<P>
<P>
<UL>
<LI>You can define a special program to pick up messages from 
the default unix mailbox. Usually this is not used, but 
you can use it. Actually, this information may be wrong. 
If someone knows better, please let me know.</LI>
<LI><I>Local spool</I> lets you define where your local mailbox is 
located. You can also tell Sylpheed whether or not to 
filter the incoming messages from that mail spool file.
The spool directory defined here is used by all the accounts
of the <I>local</I> type, by default it is set to the
standard UNIX mailbox location.</LI>
<LI><I>Autocheck new mail</I>. When you check this option, Sylpheed 
will check if there is new mail on the set interval.</LI>
<LI><I>Check new mail on startup</I> means that Sylpheed will 
immediately look for new mail on all the selected accounts 
when it loads.</LI>
<LI><I>Update all local folders after incorporation</I>
Well, if you know the use of this option, feel free to
write this part...</LI>
<LI>In the news section you can specify how many articles 
should be downloaded when opening a newsgroup.</LI>
</UL>
<H3>Send tab</H3>

<P>In here you can set up how to send messages.
<P>
<P>
<P>
<P>
<UL>
<LI>You can choose to use an external program (like sendmail) for
sending mail. By default no external program is necessary
and Sylpheed can directly send the outgoing messages to a
SMTP server.</LI>
<LI>The sent messages can be saved in the outbox (<I>Sent</I> 
folder), the name of the outbox folder can be specified
for each account (see the account setting section).</LI>
<LI>The outgoing codeset selection can be changed to force
the definition of the character set used in sent mails.
The default and recommended value is <I>automatic</I>,
so Sylpheed determines the codeset when sending each
message.</LI>
</UL>
<H3>Compose tab</H3>

<P>Controls the composition window's behaviour..
<P>
<P>
<P>
<P>
<UL>
<LI>You can change the signature separator and choose to insert
it automatically (unless your signature file already contains
this separator). Leave it as it is by default (unless you really
need to change it, and are ready to face a religion war), a lot
of mail clients rely on this separator to cut the signature when
quoting mails, and this one is accepted as the standard one.</LI>
<LI>If you hate the editor that comes with Sylpheed, you can choose
to automatically start an editor of your choice when composing
new messages (the editor can be defined in the <I>Other</I> tab).</LI>
<LI>The <I>wrap</I> settings defines how Sylpheed will wrap long
lines. You can choose to wrap quoted messages, wrap as you type,
or wrap when sending. You can also change the maximum line length.</LI>
<LI>The <I>reply</I> settings let you control the way you will reply
to mails. If <I>Automatically select account(...)</I> is set,
the account used when replying to a message is automatically
selected based on the folder the original message is in (as you
where already told, accounts can be attached to folders).
If <I>Quote message when replying</I> is selected, when hiting
the <I>Reply</I> button, the composition window pops up and is
filled with either the complete message you are replying to (if
nothing is selected in the body of this message) or the selected
part of its body. When this option is not selected, the composition
window is always empty, and you must cut-and-paste the parts of
the original message you want to quote manually.</LI>
</UL>
<H3>Quote tab</H3>

<P>In here you can control the quotation of your replies and forwarded
messages.
<P>
<P>
<P>
<P>
<UL>
<LI>You can individually define the quotation mark that appears
at the beginning of each quoted line when replying and forwarding
a message.</LI>
<LI>You can also define the text that appears before and after the 
quotation. The format of the quotation contains placeholders for
parts of the original message that are explains in the window
that appears when hiting the <I>Description of symbols</I>
button.</LI>
</UL>
<H3>Display tab</H3>

<P>In here you can control the display options of Sylpheed.
<P>
<P>
<P>
<P>
<UL>
<LI>You can change the font used to display the messages. Pressing
the button next to the font name field will open the font selection
window, then you can select among all the available fonts.</LI>
<LI>Turning on the translation of the header fields will change the
content of the header summary (between the summary and the message
pane), and use the localized header fields name based on the
selected language (selected by the 'LANG' environment variable).
This setting will only take effect the next time you will start
Sylpheed.</LI>
<LI>Selecting <I>Display unread next to folder name</I> will add
the number of unread messages next to the folder name in the
folder pane (so you can minimize the width of the folder pane
and hide the unread column).</LI>
<LI>You can also control the content of the summary pane. If you choose
to display the recipient name for the mail you send, in the <I>From</I>
column, for any mail you have sent, the name of the recipient will
appear preceded by an arrow (the characters sequence: -->).
The <I>Expand threads</I> controls the initial state of the message
threads when opening a folder (expanded of collapsed).
The <I>Set display item of summary</I> button opens a selection
window that contains all the available items to display in the
left column, the currently selected items in the right column.
Items can be added or removed using the two arrows that appears
between the columns. Using the <I>up</I> and <I>down</I> buttons
on the right side of the window, you can change the display order
of the selected item in the summary window (from left to right).</LI>
</UL>
<H3>Message tab</H3>

<P>The message tab controls the message window options.
<P>
<P>
<P>
<P>
<UL>
<LI>The message text can use colours to highlight the different levels
of quotation and URIs. The colours can be changed by using the
colours selection dialog that pops up when pressing the <I>Edit</I>
button next to the <I>Enable coloration of messages</I> toggle.</LI>
<LI>The dispaly of the header summary between the summary and message
panes can also be turned on and off (<I>Display header pane above message 
view</I> dialog).</LI>
<LI><I>Display short header on message view</I> and the <I>Edit</I>
button next to it, control the inclusion of some header fields
in the message view. If the message coloration has been turned on,
the addresses that appear in the header part of the message view
are highlighted as URIs.</LI>
<LI>The <I>Line space</I> setting controls the lines spacing of the
message view.</LI>
<LI><I>Leave space on head</I>. Checking this box will make the 
start of new lines (unwrapped, where the writer has pressed 
the Enter/Return key) indent a few pixels. This can be useful 
to read larger e-mails.</LI>
<LI><I>Scroll half page</I>. When enabled, the text in the message 
view will only scroll half a page instead of a whole page when 
pressing the space bar.</LI>
<LI><I>Smooth scroll</I>. Enabling this box will make the text 
in the message view scroll in a smooth, sliding way. For the 
eye this can be pleasing, it is a personal preference.</LI>
<LI>Select the <I>Resize attached image</I> if you wnat all the
images (attachment) to be resized to fit in the message window.</LI>
</UL>
<H3>Interface tab</H3>

<P>The interface tab controls the Sylpheed's Graphical User Interface
behaviour.
<P>
<P>
<P>
<P>
<UL>
<LI>The <I>Open message when cursor keys are pressed</I> toggles controls
the opening of the messages while you go through them in the summary
pane using the cursor (up and down arrows) keys. If this toggle is on,
each time you press the <I>down</I> (or <I>up</I>) key in the the
summary window, the current message changes and the content of the
message view changes to the content of the newly selected message.
Otherwise, the content of the message view does not change unless you
press enter (then the message view contains the content of the selected
message).
This does not change the behaviour of the left mouse button (always selects
and open the pointed message).</LI>
<LI><I>Open first unread message when entering a folder</I> if selected,
when opening a folder, the message view will contain the first unread
message of this folder (or the latest message in the order the folder
uses for sorting messages). If not selected, the message view remains
empty until a message is selected (by changing the current message with
the cursor keys or with the left mouse button).</LI>
<LI><I>Only marks message  read when open in new window</I> leaves the
selected message unread (but display it in the message view) until you
open it in a new window (double click the left mouse button).</LI>
<LI>If <I>Execute immediately when moving or deleting messages</I> is not
selected, a new button appears in the button bar marked <I>Execute</I>.
When deleting or moving messages, they are first marked as deleted or
moved but Sylpheed does not move or delete them until you press the 
<I>Execute</I> button (or the <I>Execute</I> entry of the 
<I>Tools</I> menu).</LI>
<LI>The <I>Receive dialog</I> settings controls the dialog that pops
up (if you have set <I>Show receive dialog</I> to <I>always</I>)
when receiving new mails.
The default is to open a pop up window upon reception error unless
you select the <I>Dont't pop up error dialog (...)</I> toggle.</LI>
<LI><I>The Set key bindings</I> button when pressed, opens a selection
window that contains a list of pre-defined key bindings (<I>Mew</I>, 
<I>Mutt</I>, <I>Old Sylpheed</I>) to change all the key bindings
at once. The key bindings can also be changed one by one as described in</LI>
</UL>
<H3>Other tab</H3>

<P>The other tab contains the settings that does not fit the
previous categories.
<P>
<P>
<P>
<P>
<UL>
<LI><I>Web browser</I>. Here you can enter the name of your favorite 
web browser (Netscape, Opera, Mozilla, Lynx etc.). Add the %s parameter 
to the command so Sylpheed knows it has to provide the text you clicked 
on as the URL that the browser has to visit.
The arrow next to the text field can be used to display a scrolling
list of predefined URL browsing command lines.</LI>
<LI><I>Printing</I>. Here you can define the program that should be used 
to print. Default is lpr, and the %s is the name of the temporary file 
that Sylpheed creates for lpr to print.
When using the <I>File->Print</I> menu entry to print the selected
message, a text window pops up to allow you to change the command
used to print.</LI>
<LI><I>External editor</I>. You can select an external editor to write 
your e-mails with, for example vi, emacs or gedit. Note that for 
text-based editors like vi, you need to define a terminal window, 
e.g. <CODE>xterm -e vi %s</CODE>. Otherwise there is no place that the 
editor will be able to show up. Here too, the %s parameter is the 
name of a temporary file that is created by Sylpheed.</LI>
<LI><I>Add address to destination (...)</I> when selected,
double clicking an e-mail address (in the address book,
when the composition window is opened) can be used to add 
this address to the <I>To:</I> field.</LI>
<LI>Confirming if you want to exit Sylpheed (or just exit quietly).</LI>
<LI>Cleaning the trashbox when exiting Sylpheed.</LI>
<LI>Have Sylpheed ask you to clean the trash before it is done.</LI>
<LI>Warn you when exiting Sylpheed when there are still messages 
queued to be sent.</LI>
</UL>
<H2><A NAME="ss8.2">8.2 Setting up an account/changing an account</A>
</H2>

<P>In order to set up an account in Sylpheed, in the <I>Configuration</I>
menu you select <I>Create new account</I>. If you want to change the 
settings of an existing account and this account is the current
one, in the <I>Configuration</I> menu select <I>Preferences for 
current account</I>, otherwise select <I>Edit accounts...</I>.
There you select the account you want to change. After that you press 
<I>edit</I>. Then a dialog appears in which you can enter or update 
the following areas:
<P>
<P>
<H3><A NAME="Basic"></A> Basic tab</H3>

<P>
<P>
<P>
<P>
<P>In the "Basic" tab you name the account. This is to make identifying 
the account easier. The name is then used in the <I>Change current account</I>
part of the <I>Configuration</I> menu, or in menu found in the lower 
right corner of the main window (used to quickly switch to another account).
<P>Choose a name that tells something about the account, like the 
name of the ISP, mailbox or news-server you are setting up.  
You can select this account to be the default account ("Usually used").
The default account can also be defined from the <I>Edit accounts</I>
window (toggle the <I>D</I> column next to the account name).
<P>Enter your name and e-mail address, and if you have one, the 
organization that you use Sylpheed for.
In the Protocol box you select the type of service that this 
account will be using. The flavors you can choose are: <I>POP3 normal</I>, 
<I>POP3 APOP auth</I>, <I>IMAP4</I>, <I>NNTP news</I> or <I>None (local)</I>.
<P>For POP3 and IMAP services you can then specify the server where 
your mail is stored. Details about this name, and also the name 
that goes into the field for <I>SMTP server (send)</I> should be given 
to you by your ISP.
<P>For a local unix mailbox, the <I>Server for receiving</I> is disabled, 
since the mail will be received for you.
<P>The fields for <I>User ID</I> and <I>Password</I> will also be
disabled for accounts that do no deal with POP3 or IMAP services.
Otherwise you can enter the login name and password for the e-mail
server with your ISP here. Usually these are the same as your login 
name and password to access the dial-in service, but this is 
not standard. If in doubt, contact the helpdesk of your ISP.
<P>
<H3>Passwords:</H3>

<P>The password is not printed in the entry field (replaced by stars) but
is stored in plaintext in the Sylpheed configuration files. The Sylpheed
configuration directory (&nbsp;/.sylpheed) is only readable by 'owner', and
not by 'group' and 'other', do not change these access rights.
<H3><A NAME="Receive"></A> Receive tab</H3>

<P>
<P>
<P>
<P>
<P>The <I>Receive</I> tab is only used for POP3 accounts. Here you
specify if the mails that were successfully retrieved should be removed 
from the server. You can also tell Sylpheed to get all the 
messages there, not only the ones you already received (in case 
you leave your messages on the server).
You can choose to leave the messages on the server during a selectable
number of days (then remove them).
<P>You can also define a limit for the size of the messages to
download. Any message bigger than this limit will not be
downloaded.
<P>You can also choose to filter messages on receiving, if not
set, the messages are only filtered when you use the filter
entry of the Tools menu.
<P>The default inbox defines the folder that receives the incoming
(and not filtered) messages for this account.
You can define a different folder as inbox for each of your
accounts.
<P>If the <I>Get all checks for messages on this account</I> is turned
off, when using the <I>Get all</I> menu entry (or toolbar button)
this account will not be checked. To check for new mails for
this account, you must select the account, then use the <I>Get</I>
toolbar button (or menu entry).
<H3><A NAME="Send"></A> Send tab</H3>

<P>
<P>
<P>
<P>
<P>In the <I>Send</I> tab you can define the settings that apply 
to sending mails.
<P>You can choose to add the date field to the messages you send,
generate a unique message identifier, or add custom header
fields.
<P>
<H3>X-face pictures:</H3>

<P>The user defined header field should be set up to contain your
X-face picture.
Thanks to Jeff Dairiki, you can have a complete online course in this. 
Visit 
<A HREF="http://www.dairiki.org/xface/">this page</A> for the details.
<P>If your SMTP server needs authentication, define the user ID and
password to use in this tab. You can also choose to first authenticate with
POP3 before sending.
<P>
<H3><A NAME="Compose"></A> Compose tab</H3>

<P>
<P>
<P>
<P>
<P>In the <I>Compose</I> tab you can define your signature file, 
choose to always copy someone when sending mails (you can
choose to always copy your boss, or yourself), and define the
Reply-To field for the current account.
<H3><A NAME="Privacy"></A> Privacy tab</H3>

<P>This tab is only available when Sylpheed has been compiled
with GPGME and GNUPG (for signature and encryption).
<P>
<P>With this tab you can choose the keys to use when signing
or encrypting mails for this account.
<H3><A NAME="Advanced"></A> Advanced tab</H3>

<P>The Advanced tab contains some settings you normally do
not need to change (unless you really know what you are
doing).
<P>
<P>
<P>
<P>
<P>You can change the default SMTP or POP3 ports used when
connecting to your mail server, define a domain name to
use when sending a mail. Some ISP (or mail relays) reject
mails without a valid domain name.
<P>The default folders for the sent messages, drafts and
trash can be defined here. If not changed the current account
will use the default folders.
<H3>Attaching accounts to folders</H3>

<P>Pressing the right mouse button over a folder (in the folder pane), 
and selecting the <I>Properties</I> entry will open the folder properties
form. In this form, in the <I>General</I> tab you can see (but not modify)
the folder name and the corresponding directory path (relative to the mail
directory). In the <I>Compose</I> tab:
<P>
<P>
<P>
<P>you can select the account, choose to apply this setting also to
the sub-folders.
You can also force the address used when sending mail (to force a mailing
list address, for example), choose to send a copy of the sent mails
to a list of addresses different from the default one defined for the
selected account.
<H3>Using accounts in the real life</H3>

<P>Accounts can, of course be used to retrieve mails from different ISPs,
separate your personal and professional messages, but also to make your
life easier.
You can define different accounts just to change your address (as sender),
your signature, change the sent folder, etc...
Here is a summary of the account specific settings, feel free to
find your own use for them:
<P>
<UL>
<LI>Sender name, address and organization. Signature, extra header
fields.</LI>
<LI>Leave or remove message from server (usefull for debug).</LI>
<LI>Incoming mails filtering and size limit.</LI>
<LI>Default field (<I>Reply-To</I>:, <I>Cc:</I>, <I>Bcc:</I>).</LI>
<LI><I>Draft</I>, <I>Trash</I> and <I>Sent</I> folders.</LI>
</UL>
<P>By attaching accounts to folders, you can control all these settings
on a folder basis, but you can also change the <I>To:</I>, <I>Cc:</I>, 
<I>Bcc:</I>, and <I>Reply-To:</I> for each folder (overrides the account
settings).
<P>
<HR>
<A HREF="sylpheed-9.html">Next</A>
<A HREF="sylpheed-7.html">Previous</A>
<A HREF="sylpheed.html#toc8">Contents</A>
</BODY>
</HTML>