~ubuntu-branches/ubuntu/quantal/kdepim/quantal

« back to all changes in this revision

Viewing changes to doc/kmail/using-kmail.docbook

  • Committer: Package Import Robot
  • Author(s): Jonathan Kolberg
  • Date: 2011-09-03 13:01:43 UTC
  • mfrom: (0.2.14)
  • Revision ID: package-import@ubuntu.com-20110903130143-5mmx3goibh8sgt9t
Tags: 4:4.7.1-0ubuntu1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
11
11
</author>
12
12
<!-- TRANS:ROLES_OF_TRANSLATORS -->
13
13
</authorgroup>
14
 
<date>2004-09-24</date>
15
 
<releaseinfo>1.7.50</releaseinfo>
 
14
<date>2011-07-16</date>
 
15
<releaseinfo>2.1.96 (&kde; 4.7)</releaseinfo>
16
16
</chapterinfo>
17
17
 
18
18
<title>Using &kmail;</title>
65
65
depending on <menuchoice><guimenu>View</guimenu>
66
66
<guimenuitem>Attachments</guimenuitem></menuchoice>. For complex messages
67
67
the structure of the message is shown in the message structure viewer below
68
 
the preview pane. The placement of the preview pane as well as the placement
 
68
the preview pane. <!--The placement of the preview pane as well as the placement
69
69
of the structure viewer can be changed under <guilabel>Appearance</guilabel>/<guilabel>Layout</guilabel>
70
70
in the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
71
71
&kmail;...</guimenuitem></menuchoice> dialog. Moreover, you can disable the 
72
72
preview pane and you can choose when the message structure viewer should be
73
 
shown.
 
73
  shown.not in 2.1.0 lueck-->
74
74
You can scroll through the message page-by-page
75
75
using the <keycap>Page Up</keycap> and <keycap>Page down</keycap> keys, or 
76
76
line-by-line using the <keycap>up arrow</keycap> and <keycap>down arrow</keycap>
103
103
</row>
104
104
<row>
105
105
<entry><keycap>Right Arrow</keycap> or <keycap>N</keycap></entry>
106
 
<entry>Go to the next message in the current folder.</entry>
 
106
<entry>Go to the next message in the current folder and display the message preview.</entry>
107
107
</row>
108
108
<row>
109
109
<entry><keycap>Left Arrow</keycap> key or <keycap>P</keycap></entry>
110
 
<entry>Go to the previous message in the current folder.</entry>
 
110
<entry>Go to the previous message in the current folder and display the message preview.</entry>
 
111
</row>
 
112
<row>
 
113
<entry><keycombo action="simul">&Alt;<keycap>Right Arrow</keycap></keycombo></entry>
 
114
<entry>Scroll down the message list in the current folder, the message preview does not change.</entry>
 
115
</row>
 
116
<row>
 
117
<entry><keycombo action="simul">&Alt;<keycap>Left Arrow</keycap></keycombo></entry>
 
118
<entry>Scroll up the message list in the current folder, the message preview does not change.</entry>
111
119
</row>
112
120
<row>
113
121
<entry><keycap>+</keycap></entry>
126
134
<entry>Go to the previous folder with unread messages.</entry>
127
135
</row>
128
136
<row>
129
 
<entry><keycombo action="simul">&Ctrl;<keycap>Up Arrow</keycap></keycombo></entry>
 
137
<entry><keycombo action="simul">&Alt;<keycap>Up Arrow</keycap></keycombo></entry>
130
138
<entry>Go to the next folder in the folder list (if the folder list has focus.)</entry>
131
139
</row>
132
140
<row>
133
 
<entry><keycombo action="simul">&Ctrl;<keycap>Down Arrow</keycap></keycombo></entry>
 
141
<entry><keycombo action="simul">&Alt;<keycap>Down Arrow</keycap></keycombo></entry>
134
142
<entry>Go to the previous folder in the folder list (if the folder list has focus.)</entry>
135
143
</row>
 
144
<!-- wrong in 4.7 lueck
136
145
<row>
137
146
<entry><keycombo action="simul">&Ctrl;<keycap>Left Arrow</keycap></keycombo></entry>
138
147
<entry>Walk upwards in the list of folders. Use 
139
148
<keycombo action="simul">&Ctrl;<keycap>Space</keycap></keycombo> to actually
140
149
enter the folder.</entry>
141
 
<!-- TODO: or wait for timeout so the folder is selected? -->
142
150
</row>
143
151
<row>
144
152
<entry><keycombo action="simul">&Ctrl;<keycap>Right Arrow</keycap></keycombo></entry>
152
160
to using <keycombo action="simul">&Ctrl;<keycap>Left Arrow</keycap></keycombo> or
153
161
<keycombo action="simul">&Ctrl;<keycap>Right Arrow</keycap></keycombo>.</entry>
154
162
</row>
 
163
-->
155
164
<row>
156
165
<entry><keycombo action="simul">&Shift;<keycap>Left Arrow</keycap></keycombo> and
157
166
<keycombo action="simul">&Shift;<keycap>Right Arrow</keycap></keycombo></entry>
186
195
a new composer next time.</para>
187
196
 
188
197
<para>There are a variety of shortcuts to help
189
 
you with writing your messages. The <guibutton>...</guibutton> buttons next to
 
198
you with writing your messages. The <guibutton>Select...</guibutton> buttons next to
190
199
the <guilabel>To:</guilabel>, <guilabel>CC:</guilabel>, and
191
200
<guilabel>BCC:</guilabel> fields will call up the address book so that you can
192
201
select addresses from there.</para>
207
216
users, depending on your system configuration.</para>
208
217
 
209
218
<para>When you are finished with your
210
 
message, click the <guiicon>Send Now</guiicon> icon (the envelope) to send
211
 
the message now, or click the <guiicon>Send Later</guiicon> icon to put
 
219
message, click the <guiicon>Send</guiicon> icon (the envelope) to send
 
220
the message now, or click the <guiicon>Queue</guiicon> icon to put
212
221
the message in the outbox. If your message is not finished yet, select
213
222
<menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Draft</guimenuitem></menuchoice>.
214
223
</para></sect2>
244
253
handle the more advanced formats.</para></listitem>
245
254
</varlistentry>
246
255
<varlistentry>
247
 
<term><guilabel>PGP/MIME</guilabel></term>
 
256
<term><guilabel>OpenPGP/MIME</guilabel></term>
248
257
<listitem>
249
258
<para>This format is the successor of the inline OpenPGP format. If you
250
259
use this format then the message text and all attachments will be signed
254
263
<varlistentry>
255
264
<term><guilabel>S/MIME</guilabel></term>
256
265
<listitem>
257
 
<para>This format is an alternative format to PGP/MIME. If you
 
266
<para>This format is an alternative format to OpenPGP/MIME. If you
258
267
use this format then the message text and all attachments will be signed
259
268
and/or encrypted (at least by default). This format is mostly used by
260
269
corporations.</para></listitem>
318
327
 
319
328
<para>Once a file is attached to your message, it appears in the attachments
320
329
pane at the bottom of the composer window. You can use the
321
 
&RMB; on each attachment to <guimenuitem>View</guimenuitem>,
322
 
<guimenuitem>Save</guimenuitem> or <guimenuitem>Remove</guimenuitem>
 
330
&RMB; on each attachment to <guimenuitem>Open</guimenuitem>, <guimenuitem>View</guimenuitem>,
 
331
<guimenuitem>Save As...</guimenuitem> or <guimenuitem>Remove</guimenuitem>
323
332
the attachment.</para>
324
333
 
325
334
<para>Use the <guimenuitem>Properties</guimenuitem> item to
334
343
and on his settings.</para>
335
344
 
336
345
<para>You can also attach public keys to the message by using the appropriate options in the
337
 
<menuchoice><guimenu>Attach</guimenu></menuchoice> menu. <application>PGP</application>
 
346
<menuchoice><guimenu>Attach</guimenu></menuchoice> menu. <application>GnuPG</application>
338
347
key attachments are handled like file attachments.</para>
339
348
 
340
349
</sect2>
387
396
 
388
397
<sect1 id="folders">
389
398
<title>Message Folders</title>
390
 
 
391
 
<para>Message Folders are used to organize your email messages. By default,
 
399
<!-- review and adapt to kmail2/akonadi lueck 31.05.2011-->
 
400
<para>Message Folders are used to organize your email messages. <!-- By default,
392
401
if you have no existing message folders, messages are stored in the folder
393
402
<filename
394
403
class="directory">$<envar>KDEHOME</envar>/share/apps/kmail/</filename>.  If
395
404
you have existing message folders in <filename
396
 
class="directory">~/Mail</filename>, these will be used instead.  When you
 
405
  class="directory">~/Mail</filename>, these will be used instead.-->  When you
397
406
first start &kmail; the <guilabel>inbox</guilabel>,
398
407
<guilabel>outbox</guilabel>, <guilabel>sent-mail</guilabel>,
399
 
<guilabel>trash</guilabel> and <guilabel>drafts</guilabel> folders are
400
 
created.  These folders each have special functions:</para>
 
408
<guilabel>trash</guilabel>, <guilabel>drafts</guilabel> and <guilabel>templates</guilabel> 
 
409
folders are created. These folders each have special functions:</para>
401
410
 
402
411
<variablelist>
403
412
<varlistentry>
435
444
</listitem>
436
445
</varlistentry>
437
446
</variablelist>
438
 
 
 
447
<!-- missing templates folder lueck 31.05.2011-->
439
448
<para>You may find that the standard folders are fine for your
440
449
needs; eventually, though, you will probably need folders to help you organize
441
450
your messages. To create a new folder, select
442
 
<menuchoice><guimenu>Folder</guimenu><guimenuitem>New Folder...</guimenuitem></menuchoice>: 
443
 
the <link linkend="folders-properties-window">folder properties</link> dialog
 
451
<menuchoice><guimenu>Folder</guimenu><guimenuitem>Add Folder...</guimenuitem></menuchoice>. 
 
452
The <link linkend="folders-properties-window">folder properties</link> dialog
444
453
will then prompt you for the necessary information. If you ever need to change
445
454
the settings for a folder, select the folder you wish to modify in the Folders pane and select
446
 
<menuchoice><guimenu>Folder</guimenu><guimenuitem>Properties</guimenuitem>
447
 
</menuchoice>.</para>
 
455
<guimenuitem>Folder Properties</guimenuitem> from the context menu.</para>
448
456
 
449
457
<para>To move messages from one folder into another, select the message(s) you
450
458
want to move and press the <keycap>M</keycap> key or select
451
 
<menuchoice><guimenu>Message</guimenu><guimenuitem>Move
 
459
<menuchoice><guimenu>Message</guimenu><guimenuitem>Move Messages 
452
460
To</guimenuitem></menuchoice>. A list of folders will appear; select the folder
453
461
from the list that you want to move the messages to.  Messages can also be moved
454
462
by dragging them from the Message list to a folder in the Folder list.</para>
470
478
 
471
479
<sect3 id="folders-properties-general">
472
480
<title>General</title>
473
 
 
474
481
<para>Rename a folder by changing the entry in the <guilabel>Name:</guilabel> field.</para>
475
 
 
 
482
<!-- not in kmail 2.0.96 lueck 31.05.2011
476
483
<para>You can make a folder a subfolder of another folder by choosing a new parent
477
484
folder using the <guilabel>Belongs to</guilabel> selection. </para>
478
 
 
479
 
<para>The <guilabel>Folder Icons</guilabel> section lets you choose
480
 
icons that are different from the default ones in the folder list.</para>
481
 
 
482
485
<para>See the <link linkend="folders-format">Folder Format</link> section
483
486
for information about the <guilabel>Mailbox format.</guilabel></para>
484
 
 
485
 
<para>With the <guilabel>Identity</guilabel> section you can set the default
 
487
-->
 
488
<para>Check <guilabel>Act on new/unread mail in this folder</guilabel> if you 
 
489
want to be informed about new mail that arrives in this folder. Setting this option is for
 
490
example useful for the folder where you move all detected spam messages to.</para>
 
491
<para>Check <guilabel>Keep replies in this folder</guilabel> if you want
 
492
replies to messages in this folder to be filed also into this folder rather 
 
493
than into a special sent-mail folder.</para>
 
494
<para>Check <guilabel>Hide this folder in the folder selection dialog</guilabel> 
 
495
if you do not want this folder to be shown in folder "selection dialogs, 
 
496
such as the <guimenuitem>Jump to Folder</guimenuitem> dialog.</para>
 
497
<para>With the <guilabel>Sender identity</guilabel> option you can set the default
486
498
identity that should be used for new messages if this folder is selected.
487
499
Replies to messages that were sent directly
488
500
to you will still default to the message's <quote>To</quote> address if an
489
501
according identity is found.</para>
490
 
 
491
 
<para>With <guilabel>Show Sender/Receiver</guilabel> you can set the 
492
 
visible columns in the header pane. This is useful if you use a
493
 
folder to save your own sent messages.</para>
494
 
 
495
 
<para>Check <guilabel>Ignore new mail in this folder</guilabel> if you do not
496
 
want to be informed about new mail that arrives in this folder. This is for
497
 
example useful for the folder where you move all detected spam messages to.</para>
498
 
 
499
 
<para>Check <guilabel>Keep replies in this folder</guilabel> if you want
500
 
replies to messages in this folder to be filed also into this folder rather 
501
 
than into a special sent-mail folder.</para>
502
 
 
503
 
</sect3>
504
 
 
505
 
<sect3 id="folders-properties-expiry">
 
502
</sect3>
 
503
<sect3 id="folders-properties-view">
 
504
<title>View</title>
 
505
<para>The <guilabel>Use custom icons</guilabel> option lets you choose
 
506
icons that are different from the default ones in the folder list.</para>
 
507
<para>With <guilabel>Show columns</guilabel> you can set the 
 
508
visible columns in the header pane to <guilabel>Default</guilabel>,
 
509
<guilabel>Sender</guilabel> or <guilabel>Receiver</guilabel>. This is useful 
 
510
if you use a folder to save your own sent messages.</para>
 
511
<para>In the <guilabel>Message List</guilabel> section you can select and
 
512
configure an <guilabel>Aggregation</guilabel> and <guilabel>Theme</guilabel>
 
513
for this folder different from the default configured in &kmail;s settings.
 
514
For more details see the <link linkend="configure-appearance-message-list">
 
515
Message List</link> tab in the <guilabel>Appearance</guilabel> page.</para>
 
516
</sect3>
 
517
<sect3 id="folders-properties-retrieval">
 
518
<title>Retrieval</title>
 
519
<para>Deselect <guilabel>Use options from parent folder or account</guilabel> 
 
520
to set folder-specific options for synchronizing and retrieval of messages.
 
521
<!-- use case ??? where and how to set the defaults??? 
 
522
missing:
 
523
Synchronize when selecting this folder
 
524
Automatically synchronize after
 
525
Retrevial Options - Always retriew full messages, Retrieve nessage bodies on demand, Keep message bodies loacally for
 
526
--></para>
 
527
</sect3>
 
528
<sect3 id="folders-properties-templates">
 
529
<title>Templates</title>
 
530
<para>On this tab you can define folder-specific templates for your custom folders.  
 
531
For more details see the <link linkend="configure-composer-standard-templates">
 
532
Standard Templates</link> tab in the <guilabel>Composer</guilabel> page
 
533
</para>
 
534
</sect3>
 
535
<sect3 id="folders-properties-maintainance">
 
536
<title>Maintenance</title>
 
537
<para>This tab shows an overview about the folder type and its size, 
 
538
the number of read and unread messages in the folder and allows you to enable
 
539
text indexing.</para>
 
540
</sect3>
 
541
</sect2>
 
542
 
 
543
<!-- in kmail 2.0.96  Expiry action in context menu of each folder-->
 
544
<sect2 id="folders-properties-expiry">
506
545
<title>Old Message Expiry</title>
507
546
 
508
 
<para>Here you can select what should happen with old messages in this
509
 
folder. If you enable <guilabel>Expire old messages in this folder</guilabel>
 
547
<para>From the context menu of a folder select <guimenuitem>Expire</guimenuitem> 
 
548
to open the <guilabel>Mail Expiry Properties</guilabel> dialog. 
 
549
Here you can select what should happen with old messages in this
 
550
folder. If you enable to expire old read or unread messages in this folder 
510
551
then &kmail; will regularly, depending on your choice, either delete old 
511
 
messages or move old messages to another folder. You can also start
 
552
messages or move old messages to another folder. 
 
553
<!-- not in kmail 2.0.96  lueck 31.05.2011 You can also start
512
554
expiration of old messages manually via <menuchoice><guimenu>Folder</guimenu><guisubmenu>Expire</guisubmenu></menuchoice> and via
513
555
<menuchoice><guimenu>File</guimenu><guisubmenu>Expire
514
 
All Folders</guisubmenu></menuchoice></para>
 
556
  All Folders</guisubmenu></menuchoice> -->
 
557
</para>
515
558
 
516
559
<warning><para>Messages that are deleted during expiration of old messages 
517
560
cannot be restored, so be careful with this setting.</para></warning>
518
561
 
519
 
</sect3>
 
562
</sect2>
520
563
 
521
 
<sect3 id="folders-properties-mailinglist">
 
564
<sect2 id="folders-properties-mailinglist">
522
565
<title>Mailing List</title>
523
566
 
524
 
<para>If you are going to use the folder for a mailing list then you should
 
567
<para>If you are going to use the folder for a mailing list open the 
 
568
<guilabel>Mailinglist Folder Properties</guilabel> dialog with 
 
569
<menuchoice><guimenu>Folder</guimenu> <guimenuitem>Mailing List Management</guimenuitem>
 
570
</menuchoice> from the menu. Then you should
525
571
check <guilabel>Folder holds a mailing list</guilabel> to associate this folder
526
572
with the mailing list. Next you should
527
573
click on <guilabel>Detect Automatically</guilabel>. &kmail; will then try
613
659
the <mousebutton>middle</mousebutton> mousebutton on the folder in the folder
614
660
list.</para>
615
661
 
616
 
</sect3>
 
662
</sect2>
617
663
 
618
 
      <sect3 id="folders-properties-acl">
 
664
 <sect2 id="folders-properties-acl"><!-- valid for kmail 2.1.96?  lueck 31.05.2011-->
619
665
        <title>Access Control tab (&imap; only)</title>
620
666
 
621
667
        <para>
900
946
          </tgroup>
901
947
        </table>
902
948
 
903
 
      </sect3>
904
 
 
905
 
</sect2>
906
 
 
 
949
      </sect2>
 
950
 
 
951
<!-- not valid for kmail 2.0.96, adapt to akonadi lueck 31.05.2011
907
952
<sect2 id="folders-format">
908
953
<title>Folder Format</title>
909
954
 
920
965
vice-versa.</para>
921
966
 
922
967
</sect2>
923
 
 
 
968
-->
924
969
</sect1>
925
970
 
926
971
<sect1 id="filters">
932
977
to automatically perform certain actions on incoming messages and to manually
933
978
perform actions on selected messages in a folder.</para>
934
979
 
935
 
<para>Please note that the filters described in this section are
936
 
applied <emphasis>after</emphasis> the messages have been downloaded
937
 
from your account -- if you want to filter messages on the server, see
938
 
<link linkend="popfilters">Download Filters</link>.</para>
939
 
 
940
980
<para>Filters consist of: filter criteria, whose rules are used as
941
981
criteria to determine whether this filter should be applied to a given
942
982
message; and a list of filter actions, which describe what is to be
956
996
want to filter in the message list and either type <keycombo
957
997
action="simul">&Ctrl;<keycap>J</keycap> </keycombo> or select
958
998
<menuchoice><guimenu>Message</guimenu> <guimenuitem>Apply
959
 
Filters</guimenuitem></menuchoice>: this will apply all filters that
 
999
Filter</guimenuitem></menuchoice>: this will apply all filters that
960
1000
have been marked for manual filtering in the <link
961
1001
linkend="filter-dialog">filter dialog</link> to those messages.</para>
962
1002
 
965
1005
 
966
1006
<para>There are two methods for creating a filter; the quick method is
967
1007
to use <menuchoice><guimenu>Message</guimenu><guimenuitem>Create
968
 
Filter</guimenuitem></menuchoice>: this will call the filter dialog
 
1008
Filter</guimenuitem></menuchoice> and select a criteria from the submenu: this will call the filter dialog
969
1009
and present you with a new filter which has the first rule of the
970
1010
search pattern and the first action (as <guilabel>Move into Folder</guilabel>) 
971
1011
preset. In most cases, all you have to do is select the folder where the message
1000
1040
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure 
1001
1041
Filters...</guimenuitem></menuchoice>.</para>
1002
1042
 
1003
 
<para>The dialog is divided into four main sections:</para>
 
1043
<para>The dialog is divided into three main sections on the <guilabel>General</guilabel> 
 
1044
and <guilabel>Advanced</guilabel> tab:</para>
1004
1045
<variablelist>
1005
1046
<varlistentry>
1006
1047
<term><guilabel>Available Filters</guilabel></term>
1051
1092
that allow you to refine your filtering.</para>
1052
1093
 
1053
1094
<para>Using the first row of check boxes, you can toggle when the
1054
 
filter is applied: the <guilabel>to incoming messages</guilabel>
 
1095
filter is applied: the <guilabel>Apply this filter to incoming messages</guilabel>
1055
1096
option means that the filter is applied to messages when you receive
1056
 
them (&ie; on <guiicon>Check Mail</guiicon>); the <guilabel>to sent
1057
 
messages</guilabel> options means that the filter is applied to
1058
 
messages when you send them and the <guilabel>on manual
 
1097
them (&ie; on <guiicon>Check Mail</guiicon>).
 
1098
The filter can be applied to all messages, to all but online IMAP accounts and
 
1099
to a selection of incoming folders.</para>
 
1100
<para>The <guilabel>Apply this filter to sent
 
1101
messages</guilabel> option means that the filter is applied to
 
1102
messages when you send them and the <guilabel>Apply this filter on manual
1059
1103
filtering</guilabel> option controls whether to apply this filter when
1060
1104
filtering is specifically selected (&ie; via
1061
1105
<menuchoice><guimenu>Message</guimenu> <guimenuitem>Apply
1062
1106
Filters</guimenuitem></menuchoice>.)</para>
1063
 
 
 
1107
<para>If <guilabel>Apply this filter to sent messages</guilabel> is checked
 
1108
the filter will be triggered <emphasis>after</emphasis> the message is sent and it will 
 
1109
only affect the local copy of the message. If the recipient's copy 
 
1110
also needs to be modified, please use <guilabel>Apply this filter before 
 
1111
sending messages</guilabel>.
 
1112
</para>
1064
1113
<para>The <guilabel>If this filter matches, stop processing here</guilabel>
1065
 
check box in the second row controls whether or not the filters after
 
1114
check box controls whether or not the filters after
1066
1115
the current filter will be applied, if the current filter matches.</para>
1067
1116
 
1068
1117
<para>If the <guilabel>Add this filter to the Apply Filter menu</guilabel>
1069
 
check box in the third row is selected, this filter will be inserted
 
1118
check box is selected, this filter will be inserted
1070
1119
in the <menuchoice><guimenu>Message</guimenu> <guimenuitem>Apply
1071
1120
Filter</guimenuitem></menuchoice> submenu. You can then apply this
1072
1121
filter to a message. Another way of applying filters is to use
1262
1311
 
1263
1312
<variablelist>
1264
1313
<varlistentry>
1265
 
<term><guilabel>Move into Folder</guilabel></term>
 
1314
<term><guilabel>Move Into Folder</guilabel></term>
1266
1315
<listitem>
1267
1316
<para>This will file the message into another folder, removing it from
1268
1317
its current folder if necessary; you cannot, currently 
1271
1320
</listitem>
1272
1321
</varlistentry>
1273
1322
<varlistentry>
1274
 
<term><guilabel>Copy to Folder</guilabel></term>
 
1323
<term><guilabel>Copy Into Folder</guilabel></term>
1275
1324
<listitem>
1276
1325
<para>This will copy the message to another folder.</para>
1277
1326
<note><para>You currently cannot use &imap;
1449
1498
list.</para>
1450
1499
</step>
1451
1500
<step>
1452
 
<para>In the <guilabel>Filter Criteria</guilabel> area, type
1453
 
<userinput>Priority</userinput> in the text field of the first
1454
 
drop-down box, and type <userinput>urgent</userinput> in the
 
1501
<para>In the <guilabel>Filter Criteria</guilabel> area, select <guilabel>Anywhere 
 
1502
in Headers</guilabel> and <guilabel>contains</guilabel> from the drop down boxes and type
 
1503
<userinput>Priority</userinput> in the text field. Select the same criteria 
 
1504
in the next line and type <userinput>urgent</userinput> in the
1455
1505
text field of the second drop-down box.</para>
1456
1506
<para>So your filter will match all messages containing a
1457
1507
<quote>Priority: urgent</quote> header field.</para>
1515
1565
</step>
1516
1566
<step>
1517
1567
<para>In the <guilabel> Filter Criteria</guilabel> area, select
1518
 
<guilabel>&lt;recipients&gt;</guilabel> from the first drop-down box,
1519
 
<guilabel>contains</guilabel> from the second drop-down box, and type
 
1568
<guilabel>All Recipients</guilabel> from the first drop down box,
 
1569
<guilabel>contains</guilabel> from the second drop down box, and type
1520
1570
<userinput>kde@kde.org</userinput> in the text
1521
1571
field.</para>
1522
1572
</step>
1523
1573
<step>
1524
 
<para>Skip down to the <guilabel>Filter Actions</guilabel> section. Select <guilabel>file into
1525
 
folder</guilabel> from the first drop-down box. A new drop-down box
 
1574
<para>Skip down to the <guilabel>Filter Actions</guilabel> section. Select <guilabel>Move Into
 
1575
Folder</guilabel> from the first drop-down box. Click on the folder icon and a window 
1526
1576
containing a list of folders will appear. Select the folder that you
1527
1577
want the filtered messages to be transferred to. For this example, you would select
1528
 
<guilabel>KDE-General</guilabel> from the drop-down box.</para>
 
1578
<guilabel>KDE-General</guilabel>.</para>
1529
1579
</step>
1530
1580
</procedure>
1531
1581
 
1613
1663
<term>Check the order of your filters:</term>
1614
1664
<listitem>
1615
1665
<para>All the different filter actions have a different complexity. 
1616
 
The most expensive filter actions are <guilabel>pipe through</guilabel> 
1617
 
and <guilabel>execute command</guilabel>, because both need external 
 
1666
The most expensive filter actions are <guilabel>Pipe Through</guilabel> 
 
1667
and <guilabel>Execute Command</guilabel>, because both need external 
1618
1668
programs to be run. Placing filters containing these filter actions
1619
1669
behind other filters that can reduce the number of times these complex
1620
1670
actions are required is useful, if the filter logic does allow
1621
1671
this.</para> 
1622
1672
<para>An example is filtering messages from a mailing list and detecting 
1623
1673
spam messages. For the spam detection you will usually use an external 
1624
 
tool via a <guilabel>pipe through</guilabel> action. Filtering the messages 
 
1674
tool via a <guilabel>Pipe Through</guilabel> action. Filtering the messages 
1625
1675
for the mailing list is done via the List-Id header. If you do not want to 
1626
1676
check the messages from the mailing list for spam too, it is better to
1627
1677
use the filter for the mailing list messages before the filter for the 
1647
1697
</sect2>
1648
1698
</sect1>
1649
1699
 
1650
 
<!-- dnaber update 2004-02-22 -->
1651
 
<sect1 id="popfilters">
1652
 
<title>Download Filters</title>
1653
 
 
1654
 
<para>Download Filters can be used to filter mail from a POP server,
1655
 
<emphasis>before</emphasis> they are completely downloaded; you can use them
1656
 
to prevent &kmail; from downloading huge messages and save time this
1657
 
way.</para>
1658
 
 
1659
 
<para>In the configuration dialog of the POP account you can enable 
1660
 
download filtering by checking the <guilabel>Filter messages if
1661
 
they are greater than</guilabel> box; once you have done that, you can specify a size 
1662
 
which is used as a threshold: messages exceeding this size will be
1663
 
checked against the filter rules you defined -- if no filter rule
1664
 
matches, they will be shown in a confirmation dialog and you can
1665
 
decide what to do with them. The default size for filtering is 50,000
1666
 
Bytes; this is a good value as the overhead is kept to a minimum -- 
1667
 
every message that is looked at by the filter causes additional
1668
 
traffic because the header of the message is downloaded twice. The
1669
 
default action is <guilabel>Download mail</guilabel> to prevent the
1670
 
loss of messages.</para>
1671
 
 
1672
 
<warning><para>Be careful with the <guilabel>Delete mail from
1673
 
server</guilabel> option since once a mail is deleted on the server
1674
 
there is no way to get it back.</para></warning>
1675
 
 
1676
 
<para>With a really good set of filter rules, it is possible that all
1677
 
messages that exceed the threshold size are automatically tagged
1678
 
(&ie; downloaded, kept on the server or deleted) and you would never
1679
 
be bugged by the confirmation dialog. Be careful though, since once a
1680
 
message is matched by a filter rule, you have no guarantee that you
1681
 
can change the action before it is executed: the confirmation dialog will
1682
 
be displayed <emphasis>only</emphasis> if there is a message left that
1683
 
was not matched by a filter rule.</para>
1684
 
 
1685
 
<sect2 id="popfilters-dialog">
1686
 
<title>The <guilabel>Configure Pop Filter</guilabel> Dialog</title>
1687
 
 
1688
 
<para>Adding filter rules works similar as for <link
1689
 
linkend="filters">message  filters</link>. On the left hand side you
1690
 
can manage the existing filters. Use the <guiicon>New</guiicon>
1691
 
button to add a filter. On the right hand side you can configure
1692
 
under which conditions the current filter should match. Using <guilabel>Filter
1693
 
Action</guilabel> you specify what will happen to a message that is 
1694
 
matched by this rule. The available options are:</para>
1695
 
 
1696
 
<variablelist>
1697
 
 
1698
 
<varlistentry>
1699
 
<term><guilabel>Download mail</guilabel></term>
1700
 
<listitem>
1701
 
<para>Will download the messages matched by the filter, just as any other message
1702
 
that does not exceed the threshold size.</para>
1703
 
</listitem>
1704
 
</varlistentry>
1705
 
 
1706
 
<varlistentry>
1707
 
<term><guilabel>Download mail later</guilabel></term>
1708
 
<listitem>
1709
 
<para>Will tag the messages for later download. This means the messages matched
1710
 
will stay on the POP server until you choose to download them by
1711
 
changing the action manually.</para></listitem>
1712
 
</varlistentry>
1713
 
 
1714
 
<varlistentry>
1715
 
<term><guilabel>Delete mail from server</guilabel></term>
1716
 
<listitem>
1717
 
<para>Will delete the message from the server and does not download it. Once you 
1718
 
deleted a message from the server, there is <emphasis>no</emphasis> way you can undo this.
1719
 
Be careful, as rules could match messages you actually want, too.</para></listitem>
1720
 
</varlistentry>
1721
 
 
1722
 
</variablelist>
1723
 
 
1724
 
<para>The option <guilabel>Always show matched 'Download Later' messages in
1725
 
confirmation  dialog</guilabel> will cause the confirmation dialog to
1726
 
show up during mailbox check if at least one message was tagged for
1727
 
<guilabel>Download Later</guilabel> - even if all messages exceeding
1728
 
the threshold size were matched by a rule. This option is useful in the
1729
 
case you have messages matched by a rule and tagged for
1730
 
<guilabel>Download Later</guilabel>, but you do not get any message
1731
 
exceeding the size limit for a very long time. Without this option,
1732
 
the confirmation dialog would never show up and you would never have
1733
 
a chance to get the queued message by changing the action manually.</para>
1734
 
 
1735
 
</sect2>
1736
 
 
1737
 
<sect2 id="popfilters-confirmation">
1738
 
<title>The Confirmation Dialog</title>
1739
 
 
1740
 
<para>This dialog shows up whenever you have POP filtering switched
1741
 
on and  messages were found on the server that exceed the threshold
1742
 
size you defined for the POP account. Now you have the chance to
1743
 
decide what you want to do with that message. The options are
1744
 
<guilabel>Download</guilabel> (green), <guilabel>Download
1745
 
later</guilabel> (yellow with egg watch) and <guilabel>Delete from
1746
 
server</guilabel> (red <quote>X</quote>). Be cautious with the delete
1747
 
option, since once you deleted a mail from the server, there is no
1748
 
way to undelete it again.</para>
1749
 
 
1750
 
<para>In the <guilabel>Filtered Messages</guilabel> section you can
1751
 
check the box if you receive messages that were automatically tagged for
1752
 
a certain action (download, download later, delete) by a filter rule.
1753
 
The checkbox is only enabled if you receive some messages that were
1754
 
matched by a filter rule; once you check it, a list similar to the
1755
 
one for the not-automatically-tagged messages will be displayed and you 
1756
 
can change the action for every single message.</para>
1757
 
 
1758
 
<para>Please note that if there is a message exceeding the size
1759
 
limit, but all messages are matched by a filter rule the dialog will
1760
 
not be displayed. One exception occurs if you have checked 
1761
 
<guilabel>Always show matched 'Download Later' messages</guilabel> in
1762
 
the <guilabel>Global Options</guilabel> section of the POP filter
1763
 
configuration dialog; then, the dialog will also be displayed if you only
1764
 
have matched messages, but at least one message was tagged for
1765
 
<guilabel>Download later</guilabel>.</para>
1766
 
 
1767
 
</sect2>
1768
 
 
1769
 
</sect1>
1770
 
 
1771
1700
<sect1 id="multiple-accounts">
1772
1701
<title>Using Multiple Accounts</title>
1773
1702
 
1788
1717
 
1789
1718
<sect1 id="pgp">
1790
1719
<!-- This section is from Andreas Gungl, 2000-05-21, updated 2002-10-06 by Ingo Kloecker -->
1791
 
<title>Signing and Encrypting Messages with <application>PGP</application> 
1792
 
or <application>GnuPG</application></title>
 
1720
<title>Signing and Encrypting Messages with <application>GnuPG</application></title>
1793
1721
 
 
1722
<!--
1794
1723
<note><para>There have been major changes in the way &kmail; handles 
1795
1724
signing/encryption. The following introduction applies to the previous
1796
1725
version of &kmail;. You can still read the introduction to get an overview
1797
1726
about how to sign/encrypt messages, but the details, especially those of
1798
1727
the configuration, will differ.</para></note>
1799
 
 
 
1728
-->
1800
1729
<para>This is a short introduction on how to setup &kmail;'s
1801
 
<application>PGP</application> (<application>Pretty Good Privacy</application>) support; 
 
1730
<application>GnuPG</application> (<application>GNU Privacy Guard</application>) support; 
1802
1731
it gives some hints on the use of
1803
 
<application>PGP</application> too. It is written for people who are beginners in
1804
 
this area; if you are familiar with the use of <application>PGP</application>, you can
1805
 
skip most of the steps. This documentation, and the &kmail; user interface,
1806
 
generally talk only about  <quote>PGP</quote>, but it applies to 
1807
 
both <application>PGP</application> and <application>GnuPG</application> 
1808
 
(<application>GNU Privacy Guard</application>), 
1809
 
(although some <application>GnuPG</application> command-line parameters 
1810
 
may be different.)</para>
 
1732
<application>GnuPG</application> too. It is written for people who are beginners in
 
1733
this area; if you are familiar with the use of <application>GnuPG</application>, you can
 
1734
skip most of the steps.</para>
1811
1735
 
1812
1736
<para>Please
1813
1737
also check out the <link linkend="pgp-faq">&FAQ; item about
1814
 
<application>PGP</application></link>.</para>
 
1738
<application>GnuPG</application></link>.</para>
1815
1739
 
1816
1740
<warning><para>Attachments will not be signed/encrypted if you are using
1817
1741
inline OpenPGP: to sign/encrypt attachments, you have to install GnuPG and
1819
1743
then, you can decide for each attachment whether it should be signed/encrypted or not.
1820
1744
</para></warning>
1821
1745
 
1822
 
<warning><para>&kmail; has to rely on <application>PGP</application>'s
 
1746
<warning><para>&kmail; has to rely on <application>GnuPG</application>'s
1823
1747
output; this output is often different between different versions of 
1824
 
<application>PGP</application>, so it is important that you test if encryption
 
1748
<application>GnuPG</application>, so it is important that you test if encryption
1825
1749
really works with your setup before you start using it seriously. &kmail; might
1826
1750
<emphasis>not</emphasis> warn you if something fails -- enable 
1827
1751
<guilabel>Show signed/encrypted text
1828
1752
after composing</guilabel>.  </para></warning>
1829
1753
 
1830
 
<para>To setup and use <application>PGP</application> support in &kmail; it is
1831
 
necessary to have <application>PGP</application> installed and set up
 
1754
<para>To setup and use <application>GnuPG</application> support in &kmail; it is
 
1755
necessary to have <application>GnuPG</application> installed and set up
1832
1756
properly; of course, we cannot give you a full introduction of
1833
 
<application>PGP</application> here. We will only mention the steps you have to
1834
 
do to get <application>PGP</application> going. For details you should have a look at 
1835
 
the excellent  <application>PGP</application> documentation 
1836
 
or <ulink url="http://www.gnupg.org/docs.html#guides">The GNU Privacy Handbook</ulink>.</para> 
 
1757
<application>GnuPG</application> here. We will only mention the steps you have to
 
1758
do to get <application>GnuPG</application> going. For details you should have a look at 
 
1759
the <ulink url="http://www.gnupg.org/docs.html#guides">The GNU Privacy Handbook</ulink>.</para> 
1837
1760
 
1838
1761
<para>It is certainly a good idea to study this documentation as well as an
1839
 
introduction into public key cryptography (&eg; out of the
1840
 
<application>PGP</application> 6.5.x package): there you can learn a lot about
 
1762
introduction into public key cryptography: there you can learn a lot about
1841
1763
the basic concepts, which will help you to understand what is going on; also,
1842
1764
many security related issues you should know about are discussed there.</para>
1843
1765
 
1846
1768
<sect2 id="pgp-preconditions">
1847
1769
<title>Preconditions</title>
1848
1770
 
1849
 
<para>&kmail; expects that your <application>PGP</application> binary is called
1850
 
<command>pgp</command>; in the case of <application>GnuPG</application>, it expects
1851
 
the binary to be called <command>gpg</command>. If this is not the case for you,
 
1771
<para>&kmail; expects that your <application>GnuPG</application> binary is called
 
1772
<command>gpg</command>. If this is not the case for you,
1852
1773
just make a symlink.</para>
1853
1774
 
1854
1775
<para>If you have not done so, you have to generate a key pair (secret and public
1855
 
key) for your identity. You must do this at the command line: use
1856
 
<userinput><command>pgp</command> <option>-kg</option></userinput>
1857
 
or <userinput><command>gpg</command> <option>--gen-key</option></userinput>: &kmail;
1858
 
has no internal support for <application>pgp</application>'s key generation at
 
1776
key) for your identity. Either do that using &kgpg; or &kleopatra; or do this at the command line: 
 
1777
<userinput><command>gpg</command> <option>--gen-key</option></userinput>: &kmail;
 
1778
has no internal support for <application>gpg</application>'s key generation at
1859
1779
this time. The identity (normally your name followed by your email address
1860
1780
within brackets, such as <userinput>John Doe
1861
1781
&lt;john@example.com&gt;</userinput>) and your passphrase are important for the
1862
 
co-operation between &kmail; and <application>PGP</application>.</para>
 
1782
co-operation between &kmail; and <application>GnuPG</application>.</para>
1863
1783
 
1864
1784
</sect2>
1865
1785
 
1866
1786
<sect2 id="pgp-settings">
1867
 
<title><application>PGP</application>-Related Settings in &kmail;</title>
 
1787
<title><application>GnuPG</application>-Related Settings in &kmail;</title>
1868
1788
 
1869
 
<para>Select the <guilabel>OpenPGP</guilabel> tab on
 
1789
<para>Select the <guilabel>Composing</guilabel> tab on
1870
1790
the <guilabel>Security</guilabel> settings page; there you will find the
1871
1791
following options:</para>
1872
1792
 
1873
1793
<variablelist>
1874
 
 
 
1794
<!-- not in 2.0.96?
1875
1795
<varlistentry>
1876
1796
<term><guilabel>Encryption tool</guilabel></term>
1877
1797
<listitem>
1882
1802
version.)</para>
1883
1803
</listitem>
1884
1804
</varlistentry>
 
1805
-->
 
1806
<varlistentry>
 
1807
<term><guilabel>Automatically sign messages</guilabel></term>
 
1808
<listitem><para>This lets you toggle whether to automatically sign your messages
 
1809
by default; of course, it is still possible to send unsigned messages by deselecting
 
1810
the icon in the composer window.</para> 
 
1811
</listitem>
 
1812
</varlistentry>
1885
1813
 
1886
1814
<varlistentry>
1887
1815
<term><guilabel>Keep passphrase in memory</guilabel></term>
1898
1826
</varlistentry>
1899
1827
 
1900
1828
<varlistentry>
1901
 
<term><guilabel>Always encrypt to self</guilabel></term>
 
1829
<term><guilabel>When encrypting emails, always also encrypt to the certificate of my own identity</guilabel></term>
1902
1830
<listitem>
1903
1831
<para>If this option is off and you want to send an encrypted message to somebody,
1904
1832
then you cannot read this message any longer after you have composed and
1917
1845
</varlistentry>
1918
1846
 
1919
1847
<varlistentry>
 
1848
<term><guilabel>Store sent messages encrypted</guilabel></term>
 
1849
<listitem>
 
1850
<para>When this box is checked, sent messages are stored encrypted like they were 
 
1851
sent. This is not recommended, as you will not be able to read the messages 
 
1852
any longer if a necessary certificate expires.</para> 
 
1853
</listitem>
 
1854
</varlistentry>
 
1855
 
 
1856
<varlistentry>
1920
1857
<term><guilabel>Always show the encryption keys for approval</guilabel></term>
1921
1858
<listitem>
1922
1859
<para>This will always open a dialog that lets you choose the keys used for
1928
1865
</varlistentry>
1929
1866
 
1930
1867
<varlistentry>
1931
 
<term><guilabel>Automatically sign messages using OpenPGP</guilabel></term>
1932
 
<listitem><para>This lets you toggle whether to automatically sign your messages
1933
 
by default; of course, it is still possible to send unsigned messages by deselecting
1934
 
the icon in the composer window.</para> 
1935
 
</listitem>
1936
 
</varlistentry>
1937
 
 
1938
 
<varlistentry>
1939
1868
<term><guilabel>Automatically encrypt messages whenever possible</guilabel></term>
1940
1869
<listitem><para>If this option is on, &kmail; will automatically encrypt messages
1941
1870
with the built-in OpenPGP support or the PGP/MIME-Plugin provided that,
1950
1879
<para>Now that you have setup the encryption tool you have tell &kmail; which
1951
1880
OpenPGP key you want to use for signing and for encrypting messages;
1952
1881
to do this go to the <link linkend="configure-identity">Identities configuration</link>
1953
 
and set the key that should be used on the <guilabel>Advanced</guilabel> tab of the
 
1882
and set the key that should be used on the <guilabel>Cryptography</guilabel> tab of the
1954
1883
identity configuration.</para>
1955
1884
 
1956
1885
<para>Now you are able to sign outgoing messages; to let people send you
1957
1886
encrypted messages and to let them verify your signature you
1958
1887
must send them your public key or upload your public key to a public
1959
 
<application>PGP</application> key server so that they can fetch your key from there.
 
1888
<application>GnuPG</application> key server so that they can fetch your key from there.
1960
1889
To send encrypted messages to other people or to verify their signed
1961
1890
messages you will need their public keys;  you can store your public key(s) on a
1962
 
public <application>PGP</application> key server such as <ulink
1963
 
url="http://www.cam.ac.uk.pgp.net/pgpnet/">http://www.cam.ac.uk.pgp.net/pgpnet/</ulink>.</para>
 
1891
public <application>GnuPG</application> key server.</para>
1964
1892
 
1965
1893
</sect2>
1966
1894
 
1968
1896
<title>Sign your Messages</title>
1969
1897
 
1970
1898
<para>You can compose your message as usual in the composer
1971
 
window of &kmail;. Before you send the message, check the <guiicon>Sign Message</guiicon>
 
1899
window of &kmail;. Before you send the message, check the <guibutton>Sign</guibutton>
1972
1900
icon on the toolbar of the composer window; then, you can send
1973
1901
the message. The identity you are using to write the current message needs to 
1974
1902
be connected to an <guilabel>OpenPGP Key</guilabel> in the <guilabel>Identity</guilabel>
1975
1903
section of the <guilabel>Configure</guilabel> dialog.
1976
 
To sign the message, &kmail; needs to know your <application>PGP</application> 
 
1904
To sign the message, &kmail; needs to know your <application>GnuPG</application> 
1977
1905
passphrase: if you did not select <guilabel>Keep passphrase in memory</guilabel> in the
1978
1906
<guilabel>Security</guilabel> section, &kmail; will ask you for it; otherwise,
1979
1907
if you have already given the phrase to &kmail;, it will sign the
1986
1914
 
1987
1915
<para>To send an encrypted message to somebody of whom you have a
1988
1916
public key, you simply create the message in the composer window.
1989
 
Before you send the message, check the <guibutton>Encrypt
1990
 
Message</guibutton> button in the toolbar of the composer window; note
 
1917
Before you send the message, check the <guibutton>Encrypt</guibutton> 
 
1918
button in the toolbar of the composer window; note
1991
1919
that you might not have to check the button if <guilabel>Automatically
1992
1920
encrypt messages whenever possible</guilabel> is selected in
1993
1921
&kmail;'s configuration (see <link linkend="pgp-sign-your-messages">above</link>).
1994
1922
Then send the message.</para>
1995
1923
 
1996
1924
<para>
1997
 
If you checked the <guilabel>Encrypt Message</guilabel> button and &kmail;
 
1925
If you checked the <guibutton>Encrypt</guibutton> button and &kmail;
1998
1926
cannot find a matching key for a recipient, it will display a list containing
1999
1927
all available keys in the <guilabel>Encryption Key Selection</guilabel> dialog;
2000
1928
if &kmail; finds more than one trusted key for a recipient, it will
2016
1944
trusted key for each recipient.</para>
2017
1945
 
2018
1946
<para>As mentioned above, you will not be able to read your own encrypted sent
2019
 
messages if you do not check <guilabel>Always encrypt to self</guilabel> in the
 
1947
messages if you do not check <guilabel>When encrypting emails, always also encrypt 
 
1948
to the certificate of my own identity</guilabel> in the
2020
1949
settings' <guilabel>Security</guilabel> page.</para>
2021
1950
 
2022
1951
</sect2>
2035
1964
attack, as somebody can change the key and sign the message with that other
2036
1965
key. That is why the recipient should verify the attached key by checking the
2037
1966
key's fingerprint against the one he received in a secure way from you; have a look
2038
 
at the <application>PGP</application> documentation for further details.</para>
 
1967
at the <application>GnuPG</application> documentation for further details.</para>
2039
1968
 
2040
1969
</sect2>
2041
1970
 
2057
1986
Before you can use this key to encrypt a message to the owner of the
2058
1987
key, you should verify the key (check its fingerprint or look for
2059
1988
trusted signatures); then, you can add this key to your public keyring
2060
 
by typing <userinput><command>pgp</command> <option>-ka</option>
2061
 
<replaceable>filename</replaceable></userinput> at the command line (if you are using 
2062
 
<application>PGP</application>) or by typing 
2063
 
<userinput><command>gpg</command> <option>--import</option>
2064
 
<replaceable>filename</replaceable></userinput> at the command line (if you are using
2065
 
<application>GnuPG</application>). If the key is not certified with a trusted signature 
 
1989
by typing <userinput><command>gpg</command> <option>--import</option>
 
1990
<replaceable>filename</replaceable></userinput> at the command line. 
 
1991
If the key is not certified with a trusted signature 
2066
1992
you cannot use it to encrypt messages unless you have signed the key with your key.
2067
1993
</para>
2068
1994