aboutsummaryrefslogtreecommitdiffstats
path: root/help/C/usage-mail.sgml
blob: 6e42c4ab2fbafa9eac08c8d05c467129c7654ede (plain) (blame)
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
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->

<chapter id="usage-mail">
  <title>Using Evolution for Email</title>
  <para>
    This chapter, and <xref linkend="usage-mail-organize">, will
      provide you with an in-depth guide to the capabilities of
      Evolution as a mail client.  For information about how to set up
      your mail account, see <xref linkend="config-prefs-mail">.
  </para>
  
  <note>
    <title>If you use IMAP Mail</title>
    <para>
      If you chose IMAP mail during the setup process, you must subscribe to
      your mail folders before you can read mail in them. Read <xref
                                     linkend="usage-mail-subscriptions"> to find out how.
    </para>
  </note>
  
  
  <sect1 id="usage-mail-getnsend-read">
    <title>Reading Mail</title>    
    <para>
      Start the mail client by clicking on the
      <guibutton>Inbox</guibutton> icon in the shortcut bar, or by
      selecting a mail folder in the folder bar.  To read a message,
      select it in the message list; if you'd like to see it in its
      own window, double-click on it or press
      <keycombo action="simul">
    <keycap>Ctrl</keycap>
    <keycap>O</keycap>
      </keycombo>.
    </para>

      <tip id="spaceandbs">
    <title>Reading Mail with the Keyboard</title>
    <para>
      You can click the spacebar to page down while you're reading
      an email, and press backspace to page up in an email.  This
      may help to make reading your email faster.
    </para>
      </tip>

    <sect2 id="usage-mail-listorder">
      <title>Sorting the message list</title>
      <para>
    <application>Evolution</application> helps you work by letting you sort
    your email.  To sort by sender, subject, or date, click
    on the bars with those labels at the top of the message
    list. The direction of the arrow next to the label indicates
    the direction of the sort, and if you click again, you'll
    sort them in reverse order. For example, click once on
    <guilabel>Date</guilabel> to sort messages by date from
    oldest to newest.  Click again, and
    <application>Evolution</application> sorts the list from
    newest to oldest. You can also right-click on the message
    header bars to get a set of sorting options, and add or
    remove columns from the message list.  You can find detailed
    instructions on how to customize your message display
    columns in <xref linkend="usage-mail-organize-columns">.
      </para>

      <tip id="view-headers">
    <title>Email Headers</title>
    <para>
      To look at the complete headers for email messages, select
      <menuchoice><guimenu>View</guimenu><guisubmenu>Message
      Display</guisubmenu><guimenuitem>Show Full
      Headers</guimenuitem></menuchoice>. To see absolutely every
      bit, choose
      <menuchoice><guimenu>View</guimenu><guisubmenu>Message
      Display</guisubmenu><guimenuitem>Show Email Source
      </guimenuitem></menuchoice>.
       </para>
      </tip>

      <para>
    You can also choose a threaded message view. Select
    <menuchoice> 
      <guimenu>View</guimenu>
          <guimenuitem>Threaded</guimenuitem> 
    </menuchoice> 
    to turn the threaded view on or off.  When you select this option,
    <application>Evolution</application> groups the replies to a
    message with the original, so you can follow the thread of a
    conversation from one message to the next.
      </para>
    </sect2>
    
    <sect2 id="usage-mail-getnsend-delete">
        <title>Deleting Mail</title>
        <para>
          Once you've read your mail, you may want to get rid of
          it. 
    To delete a message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Click the message to select it
        </para>
      </listitem>
      <listitem>
        <para>
          Press delete button or right click on the message and
          choose <guilabel>Delete</guilabel>.
        </para>
        <note>
          <title>Deleted but still here?</title>
          <para>
        When you do this, your message is marked to be
        deleted.  Your email is not gone until you have
        expunged it. When you "Expunge" a folder, you remove
        all the mail that you have marked for deletion.
          </para>
        </note>
      </listitem>
      <listitem>
        <para>
          Click
          <menuchoice>
        <guimenu>Actions</guimenu>
        <guimenuitem>Expunge</guimenuitem>
          </menuchoice>
          or press
          <keycombo action="simul">
        <keycap>Ctrl</keycap>
        <keycap>E</keycap>
          </keycombo>
        </para>
      </listitem>
    </orderedlist>
      </para>
      <note>
    <title>Trash is Actually a vFolder?</title>
    <para>
      Your trash folder is actually a vFolder that displays all
          messages you have marked for later deletion.  For more
          information about vFolders, see <xref
          linkend="usage-mail-organize-vfolders">.  If you choose
          <menuchoice> <guimenu>Actions</guimenu> <guimenuitem>Empty
          Trash</guimenuitem> </menuchoice> you will expunge
          <emphasis>all</emphasis> your folders.
    </para>
      </note>
    </sect2>
    <sect2 id="usage-mail-getnsend-undelete">
      <title>Undeleting Messages</title>
      <para>
    To undelete a message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Select a message you have marked for deletion.
        </para>
      </listitem>
      <listitem>
        <para>
          Press <keycombo
          action="simul"><keycap>Ctrl</keycap><keycap>U</keycap>
          </keycombo>
          or choose
          <menuchoice>
        <guimenu>Actions</guimenu>
        <guimenuitem>Undelete</guimenuitem>
          </menuchoice>

        </para>
        <note>
          <title>What does Undelete actually do?</title>
          <para>
                If you have marked a message for deletion, undeleting
        it will unmark it, and the message will be removed
        from the Trash folder. However, it can't bring back
        messages that have been expunged.
          </para>
        </note>
      </listitem>
    </orderedlist>
      </para>
    </sect2>
  </sect1>

  <sect1 id="usage-mail-getnsend-get">
    <title>Checking Mail</title>
    <para>
      Now that you've had a look around the
      <interface>Inbox</interface>, it's time to check for new mail.
      Click <guibutton>Get Mail</guibutton> in the toolbar to check
      your mail.  If you haven't entered any mail settings yet, the
      <interface>setup assistant</interface> will ask you for the
      information it needs to check your email.
    </para>
    <para>
      The assistant will give you several dialog boxes where you configure:
      <itemizedlist>
    <listitem>
      <para>
        your personal information
      </para>
    </listitem>
    <listitem>
      <para>
        your outgoing email server information
      </para>
    </listitem>
    <listitem>
      <para>
        your mail account identity name
      </para>
    </listitem>
      </itemizedlist>
    </para>
    <para>
      To check your email, press the <guibutton>Check Mail</guibutton>
      button.  If this is your first time checking mail, or you
      haven't asked <application>Evolution</application> to store your
      password, you'll be prompted for the password.  Enter your
      password and your email will be downloaded.
    </para>
    <note id="badmailsettings">
      <title>Can't Check Mail?</title>
      <para>
    If you get an error message instead of mail, you probably need to check
    your network settings.  To learn how to do that,
     have a look at <xref linkend="config-prefs-mail-network">, or
     ask your system administrator.
       </para>
     </note>

<!-- NOT FOR 1.0
       <sect2 id="usage-mail-getnsend-get-news">
      <title>Using Evolution for News </title>
    <para>
      Newsgroups are so similar to email that there's no reason not
      to read them side by side.  If you want to do that, add a
      news source to your configuration (see <xref
      linkend="config-prefs-network-news">). The news server will
      appear as a remote server, and will look quite similar to an
      IMAP folder.  When you click <guibutton>Get Mail</guibutton>,
      <application>Evolution</application> will also check for news
      messages.
    </para>
    </sect2>
-->
       <sect2 id="usage-mail-getnsend-get-attach">
     <title>Working with Attachments and HTML Mail</title>
     <para>
       If someone sends you an <glossterm>attachment</glossterm>,
       a file attached to an email,
       <application>Evolution</application> will display the file
       at the bottom of the message to which it's attached.  Text,
       including HTML formatting and embedded images, will appear
       as part of the message, rather than at the end of the
       message as an attachment.
     </para>
     <para>
       To Save an Attachment to Disk:
       <orderedlist numeration="arabic">
     <listitem>
       <para>
         Open up the desired email
       </para>
     </listitem>
     <listitem>
       <para>
         Click on the down arrow at the bottom of the email for the desired
         attachment.
       </para>
     </listitem>
     <listitem>
       <para>
         Select <guibutton>Save to Disk</guibutton>.
       </para>
     </listitem>
     <listitem>
       <para>
         Choose the directory and filename you wish.
       </para>
     </listitem>
     <listitem>
       <para>
         Click <guibutton>OK</guibutton>
       </para>
     </listitem>
       </orderedlist>
      </para>
      <para>
         When someone sends you HTML mail, and includes an image in
         the actual mail (that is, they use the <menuchoice>
         <guimenu>Insert</guimenu> <guimenuitem>Image</guimenuitem>
         </menuchoice> tool, not the <guibutton>Attach</guibutton>
         tool), <application>Evolution</application> will display the
         image inside the message.
      </para>
      <para>
         If an HTML mail uses a link to an image, and asks
         <application>Evolution</application> to download the image
         from the Internet, <application>Evolution</application> will
         not display the image unless you ask it to. This is because
         remotely hosted images can slow down your system, and can be
         used by spammers to track who reads their email.  Having
         images not load automatically helps protect your privacy.
      </para>
      <para>
     If you want the images to load, select 
     <menuchoice>
       <guimenu>View</guimenu>
       <guisubmenu>Message Display</guisubmenu>
       <guimenuitem>Load Images</guimenuitem>
         </menuchoice>.  
         You can also set image loading behavior in the
         <guilabel>Display</guilabel> tab of the        
         <menuchoice>
       <guimenu>Tools</guimenu>
       <guimenuitem>Mail Settings</guimenuitem>
         </menuchoice> dialog.
      </para>
      <note id="http-proxy">
    <title>Loading Images from the Net through an HTTP Proxy</title>
        <para>
           If you use an HTTP proxy,
           <application>Evolution</application> must be able to find
           it through the <systemitem>gnome-vfs</systemitem> subsystem
           before it can load iamges from the net.
            <variablelist>
        <varlistentry>
          <term>Configure it with Nautilus</term>
          <listitem>
        <para>
                 <orderedlist numeration="arabic">
            <listitem>
              <para>
            Open a Nautilus window
                   </para>
            </listitem>
                <listitem>
              <para>
                     Select <menuchoice>
              <guimenu>Preferences</guimenu>
              <guimenuitem>Edit Preferences</guimenuitem>
            </menuchoice>.
                   </para>
            </listitem>
                <listitem>
              <para>
            Go to the <guilabel>Navigation</guilabel> tab.
                   </para>
            </listitem>
                <listitem>
              <para>
            Click the <guilabel>Use HTTP Proxy</guilabel>
            checkbox and enter the location of your HTTP
            proxy in the <guilabel>Location</guilabel> field.
                   </para>
            </listitem>
          </orderedlist>
                </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Configure it with the gconftool command</term>
          <listitem>
          <para>
                 <orderedlist numeration="arabic">
            <listitem>
              <para>
                        Open a terminal.
                      </para>
            </listitem>
            <listitem>
              <para>
                        Enter the command 
                        <command>
                        gconftool --type=bool --set /system/gnome-vfs/use-http-proxy "TRUE"
                        </command>
                      </para>
            </listitem>
            <listitem>
              <para>
                        Enter the command 
                        <command>
                        --type=string --set /system/gnome-vfs/http-proxy-host "your-proxy-url"
                        </command>
                      </para>
            </listitem>
            <listitem>
              <para>
                        Enter the command 
                        <command>
                        $ gconftool --type=int --set /system/gnome-vfs/http-proxy-port "8080"
                        </command>                  
                      </para>
            </listitem>
          </orderedlist>
                </para>
        <para>
                  For more information about the gconftool command,
                  read the gconftool man page.
                </para>
          </listitem>
        </varlistentry>
      </variablelist>
         </para>
      </note>

      <para>
    To Open an Attachment in a Program:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Open the mail message with the attachment you want to read.
        </para>
      </listitem>
      <listitem>
        <para>
          Click the arrow next the attachment icon.
        </para>
      </listitem>
      <listitem>
        <para>
          Select the program you'd like to use. It will start up
          and open the document.
        </para>
      </listitem>
    </orderedlist>
      </para>
    </sect2>
  </sect1>

    <sect1 id="usage-mail-getnsend-send">
      <title>Writing and Sending Mail</title>
      <para>
         You can start writing a new email message by selecting
         <menuchoice> <guimenu>File</guimenu>
         <guisubmenu>New</guisubmenu> <guimenuitem>
         Mail Message</guimenuitem></menuchoice>, or by pressing the
         <guibutton>Compose</guibutton> button in the Inbox toolbar.
         When you do so, the <interface>New Message</interface> window
         will open, as shown in <xref
         linkend="usage-mail-newmsg-fig">.
      </para>

<!--   ==============Figure=================================== -->
      <figure id="usage-mail-newmsg-fig">
        <title>New Message Window</title>
        <screenshot>
          <screeninfo>Evolution Main Window</screeninfo>
          <graphic fileref="figures/newmsg" format="png" srccredit="Aaron Weber">
        </graphic>
        </screenshot>
      </figure>
<!-- ==============End of Figure=================================== -->

      <para>
      Enter an address in the <guilabel>To:</guilabel> field.  If you wish
      enter a  subject in the <guilabel>Subject:</guilabel> and a message in
      the big empty box at the bottom of the window.  Once you have revised
      your message, press <guibutton>Send</guibutton>.
    </para>

      <sect2 id="usage-mail-getnsend-send-delay">
        <title>Saving Messages for Later</title>
        <para>
           <application>Evolution</application> will send mail immediately unless you tell it to
           do otherwise by selecting <menuchoice>
           <guimenu>File</guimenu> <guimenuitem>Send
           Later</guimenuitem></menuchoice>.  This will add your
           messages to the <guilabel>Outbox</guilabel> queue.  Then,
           when you press <guibutton>Send</guibutton> in another
           message, or <guibutton>Get Mail</guibutton> in the main
           mail window, all your unsent messages will go out at once.
           You might want to use "Send Later" becuase it gives
           you a chance to change your mind about a message before you send it.
        </para>
        <para>
           To learn more about how you can specify message queue and
           filter behavior, see <xref linkend="config-prefs-mail">.
        </para>

      <para>
    You can also choose to save messages as drafts or as text
    files. Your options are:
       <itemizedlist>
        <listitem><para>
          Choose
      <menuchoice>
       <guimenu>File</guimenu>
        <guimenuitem>Save Draft</guimenuitem>
          </menuchoice>
          to store your messages in the drafts folder for later
          revision.
       </para></listitem>

       <listitem><para>
         If you'd like to have the message sent later, you
         can choose <guimenuitem>Send Later</guimenuitem>. That way,
         the message will be added to the queue, and you can send a 
         batch of messages all at once.
        </para></listitem>
        
        <listitem><para> 
         If you prefer to save your message as a text file,
         choose <guimenuitem>Save As</guimenuitem> and then choose a
         file name.
           </para>
      </listitem>
    </itemizedlist>
      </para>
    </sect2>

    <sect2 id="usage-mail-getnsend-send-compose">
      <title>Advanced Mail Composition</title>
      <para>
        In the next few sections, you'll see how
    <application>Evolution</application> handles advanced email
    features, including large recipient lists, attachments, and
    forwarding.
      </para>
      <sect3 id="usage-mail-getnsend-send-attach">
        <title>Attachments</title>
        <para>
      To attach a file to your email:
      <orderedlist numeration="arabic">
        <listitem>
          <para>
        Push the attach button in the composer toolbar
          </para>
        </listitem>
        <listitem>
          <para>
        Select the file you want to attach
          </para>
        </listitem>
        <listitem>
          <para>
        Press <guibutton>OK</guibutton>
          </para>
        </listitem>
      </orderedlist>
    </para>
    <para>
      You can drag a file from your desktop into the composer window to
      attach it as well.
        </para>
        <para>
            To hide the display of files you've attached to the
            message, select <menuchoice>
            <guimenu>View</guimenu> <guimenuitem>Hide
            Attachments</guimenuitem> </menuchoice>; to show them
            again, choose <guimenuitem>Show Attachments</guimenuitem>.
        </para>
        <para>
            When you send the message, a copy of the attached file
            will go with it.  Be aware that big attachments can take a
            long time to download.
        </para>
       </sect3>

      <sect3 id="usage-mail-getnsend-send-to-types">
    <title>Types of Recipients</title>
        <para>
      <application>Evolution</application>, like most email
       programs, recognizes three types of addressee: primary
       recipients, secondary recipients, and hidden ("blind")
       recipients.
         </para>
         <para>
            The simplest way to direct a message is to put the email
            address or addresses in the <guilabel>To:</guilabel>
            field, which denotes primary recipients.  To send mail to
            more than one or two people, you can use the
            <guilabel>Cc:</guilabel> field.
          </para>
          <para>
            Hearkening back to the dark ages when people used
            typewriters and there were no copy machines, "Cc" stands
            for "Carbon Copy."  Use it whenever you want to share a
            message you've written to someone else.
          </para>
          <para>
            <guilabel>Bcc:</guilabel> is a little more complex.  You
            use it like <guilabel>Cc:</guilabel>, but people on the
            <guilabel>Bcc:</guilabel> list are hidden from the other
            recipients of the message. Use it to send mail to large
            groups of people, especially if they don't know each other
            or if privacy is a concern.
          </para>

            <example id="ex-mail-cc">
              <title>Using the Cc: field</title>
              <para>
                 When Susan sends an email to a client, she puts her
                 co-worker, Tim, in the in the
                 <guilabel>Cc:</guilabel> field, so that he know
                 what's going on.  The client can see that Tim also
                 received the message, and knows that he can talk to
                 Tim about the message as well.
              </para>
            </example>

          <para>

            <example id="ex-mail-bcc">
              <title>Using the Bcc: field</title>
              <para>
                 Tim is sending an email announcement to all of his
                 company's clients, some of whom are in competition
                 with each other, and all of whom value their
                 privacy. He needs to use the
                 <guilabel>Bcc:</guilabel> field here.  If he puts
                 every address from his address book's "Clients"
                 category into the <guilabel>To:</guilabel> or
                 <guilabel>Cc:</guilabel> fields, he'll make the
                 company's <emphasis>entire</emphasis> client list
                 public. But putting his "Clients" addressbook
                 into the Bcc: section, that will cause them to be hidden
                 from the competition.  It seems insignificant, but it can
                 make a huge difference in some situations.
             </para>
            </example>
          </para>
        </sect3>

        <sect3 id="usage-mail-getnsend-send-to">
        <title>Choosing Recipients Quickly</title>
        <para>
      If you have created address cards in the contact manager,
          you can also enter nicknames or other portions of address
          data, and <application>Evolution</application> will offer a
          drop down list of possible address completions from your
          address book.  If you enter a name or nickname that can go
          with more than one card, Evolution will open a dialog box to
          ask you which person you meant. Also,
          <application>Evolution</application> will add a domain to
          any unqualified addresses.  By default, this is your domain,
          but you can choose which one mail preferences dialog.
          </para>
          <para>
            Alternately, you can click on the
            <guibutton>To:</guibutton>, <guibutton>Cc:</guibutton>, or
            <guibutton>Bcc:</guibutton> buttons to get a list &mdash;
            potentially a very long one &mdash; of the email addresses
            in your contact manager.  Select addresses and click on
            the arrows to move them into the appropriate address
            columns.
          </para>
          <para>
            For more information about using email together with the
            contact manager and the calendar, see <xref
            linkend="contact-automation-basic"> and <xref
            linkend="usage-calendar-apts">.
          </para>
        </sect3>
      </sect2>

      <sect2 id="usage-mail-getnsend-send-reply">
        <title>Replying to Messages</title>
        <para>
           To reply to a message, press the
           <guibutton>Reply:</guibutton> button while it is selected,
           or choose <guimenuitem>Reply to Sender:</guimenuitem> from
           the message's right-click menu.  That will open the
           <interface>message composer</interface>.  The
           <guilabel>To:</guilabel> and <guilabel>Subject:</guilabel>
           fields will already be filled, although you can alter them
           if you wish.  In addition, the full text of the old message
           is inserted into the new message, either grey (for
           HTML display) or with the &gt; character before each line
           (in plain text mode), to indicate that it's part of the
           previous message.  People often intersperse their message
           with the quoted material as shown in <xref
           linkend="usage-mail-getnsend-reply-fig">.

<!-- note that this figure should have a reply message ready to send,
with quoted materials and the relevant replies interspersed-->
<!-- I want to wait for the formatting bugs to be fixed first -->
 <!-- ==============Figure=================================== -->
       <figure id="usage-mail-getnsend-reply-fig">
         <title>Reply Message Window</title>
         <screenshot>
          <screeninfo>Evolution Main Window</screeninfo>
          <graphic fileref="figures/replymsg" format="png" srccredit="Aaron Weber">
        </graphic>
        </screenshot>
      </figure>
<!-- ==============End of Figure=================================== -->
        </para>
        <para>
          If you're reading a message with several recipients, you may
           wish to use <guibutton>Reply to All</guibutton> instead of
           <guibutton>Reply</guibutton>.  If there are large numbers
           of people in the <guilabel>Cc:</guilabel> or
           <guilabel>To:</guilabel> fields, this can save substantial
           amounts of time.
          <example>
            <title>Using the Reply to All feature</title>
            <para>
              Susan sends an email to a client and sends copies to Tim
              and to an internal company mailing list of co-workers.
              If Tim wants to make a comment for all of them to read,
              he uses <guibutton>Reply to All</guibutton>, but if he
              just wants to tell Susan that he agrees with her, he
              uses <guibutton>Reply</guibutton>.  Note that his reply
              will not reach anyone that Susan put on her
              <guilabel>Bcc</guilabel> list, since that list is not
              shared with anyone.
            </para>
          </example>
        </para>
        <para>
          If you're subscribed to a mailing list, and want your reply
          to go just to the list, rather than to the sender, choose
          <guibutton>Reply to List</guibutton> instead of
          <guibutton>Reply</guibutton> or <guibutton>Reply to
          All</guibutton>.
          <note>
            <title>What is a Mailing List?</title>
            <para>
              Mailing Lists are one of the most popular tools for
              group collaboration on the Internet. Here's how they work: 
              <simplelist>
                <member>
                  Someone sends a message to a single address, like
                  <email>evolution@ximian.com</email>.
                </member>
                <member>
                  That address belongs to a program that distributes
                  the message to a list of recipients.
                </member>
             </simplelist>
               The mail management program lets individuals subscribe
               to or unsubscribe from the list at will, without
               requiring the message writers to remember the addresses
               of every recipient.
            </para>
            <para>
              Mailing list servers can also let network administrators
              control mail flow, list membership, and even moderate
              the content of mailing lists.
            </para>
          </note>
        </para>
      </sect2>

      <sect2 id="usage-mail-getnsend-send-find">
        <title>Searching and Replacing with the Composer</title>
        <para>
           You are probably familiar with search and replace features
           in any sort of text-editing software, and if you come from
           a Linux or Unix background, you may know what
           <guimenuitem>Find Regex</guimenuitem> does.  If you aren't
           among the lucky who already know, here's a quick rundown of
           the automated text searching features that the message
           composer makes available to you.
        </para>
        <para>
           <variablelist>
            <varlistentry>
              <term><guimenuitem>Find</guimenuitem></term>
              <listitem><para> Enter a word or phrase, and
              <application>Evolution</application> will find it
              in your message.
              </para></listitem>
            </varlistentry>

            <varlistentry>
              <term><guimenuitem>Find Regex</guimenuitem></term>
              <listitem>
                <para>
                  Find a regex, also called a
                  <glossterm linkend="regular-expression">regular
                  expression</glossterm>, in your composer window.
               </para>
             </listitem>
            </varlistentry>

            <varlistentry>
              <term><guimenuitem>Find Again</guimenuitem></term>
              <listitem><para>
                   Select this item to repeat the last search you performed.
              </para></listitem>
            </varlistentry>

            <varlistentry>
               <term><guimenuitem>Replace</guimenuitem></term>
               <listitem><para>
                 Find a word or phrase, and replace it with
                 something else.
               </para></listitem>
            </varlistentry>

          </variablelist>
        </para>

        <para>
            For all of these menu items, you can choose whether or not
            to <guilabel>Search Backwards</guilabel> in the document
            from the point where your cursor is.  For all but the
            regular expression search (which doesn't need it), you are
            offered a check box to determine whether the search is to
            be <guilabel>Case Sensitive</guilabel> when it determines
            a match.
        </para>
      </sect2>

      <sect2 id="usage-mail-getnsend-send-html">
        <title>Enhance your email with HTML</title>
        <para>
            Normally, you can't set text styles or insert pictures in
            emails, which is why you've probably seen people use far
            too many exclamation points for emphasis, or use
            text drawn facial expressions to
            convey their feelings.  However, most newer email programs
            can display images and text styles as well as basic
            alignment and paragraph formatting. They do this with
            <glossterm linkend="html">HTML</glossterm>, just like web
            pages do.
        </para>
        <note>
          <title>HTML Mail is not a Default Setting</title>
          <para>
            Some people do not have HTML-capable mail clients, or
            prefer not to receive HTML-enhanced mail because it is
            slower to download and display. Because some people may
            prefer not to get HTML mail,
            <application>Evolution</application> sends plain text
            unless you explicitly ask for HTML.  To send HTML mail,
            you will need to select <menuchoice>
            <guimenu>Format</guimenu> <guimenuitem>
            HTML</guimenuitem></menuchoice>.  To send all your mail as
            HTML, you can set your default mail format preferences in
            the mail configuration dialog.  See <xref
            linkend="config-prefs-mail-other"> for more information.
          </para>
        </note>
        <para>
           HTML formatting tools are located in the toolbar just above
           the space where you'll actually compose the message, and
           they also appear in the <guimenu>Insert</guimenu> and
           <guimenu>Format</guimenu> menus.
          </para>
          <para>
            The icons in the toolbar are explained in <glossterm
            linkend="tooltip">tool-tips</glossterm>, which appear when
            you hold your mouse over the buttons.  The buttons fall
            into four categories:
            <variablelist>
             <varlistentry>
             <term>Headers and lists</term>
              <listitem>
                <para>
                  At the left edge of the toolbar, you can choose
                  <guilabel>Normal</guilabel> for a default text style
                  or <guilabel>Header 1</guilabel> through
                  <guilabel>Header 6</guilabel> for varying sizes of
                  header from large (1) to tiny (6). Other styles
                  include <guilabel>preformat</guilabel>, to use the HTML
                  tag for preformatted blocks of text, and three types
                  of bullet points for the highly
                  organized.
                </para>
              </listitem>
           </varlistentry>
      <varlistentry>
        <term>Text style</term>
        <listitem>
          <para>
        Use these buttons to determine the way your letters
        look.  If you have text selected, the style will
        apply to the selected text.  If you do not have text
        selected, the style will apply to whatever you type
        next.  The buttons are:
        <itemizedlist mark="none">
          <listitem><para>Push <guibutton>B</guibutton> for bold text</para></listitem>
          <listitem><para>Push <guibutton>I</guibutton> for italics</para></listitem>
          <listitem><para>Push <guibutton>U</guibutton> to underline</para></listitem>
          <listitem><para>Push <guibutton>S</guibutton> for a strikethrough.</para></listitem>
        </itemizedlist>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
              <term>Alignment</term>
        <listitem>
          <para>
        Located next to the text style buttons, these three
        paragraph icons should be familiar to users of most
        word processing software.  The leftmost button will
        make your text aligned to the left, the center
        button, centered, and the right hand button,
        aligned on the right side.
          </para>
        </listitem>
      </varlistentry>

            <varlistentry>
              <term>Indentation rules</term>
              <listitem>
                <para>
                  The button with the arrow pointing left will reduce
                  a paragraph's indentation, and the right arrow will
                  increase its indentation.
               </para>
            </listitem>
          </varlistentry>

            <varlistentry>
              <term>Color Selection</term>
              <listitem>
                <para>
                  At the far right is the color section tool.  The
                  colored box displays the current text color; to
                  choose a new one, click the arrow button just to the
                  right. If you have text selected, the color will
                  apply to the selected text.  If you do not have text
                  selected, the color will apply to whatever you type
                  next.
               </para>
            </listitem>
          </varlistentry>


          </variablelist>
        </para>
        <para>
    The <guimenu>Insert</guimenu> gives you three opinions which let you
           spruce up your email to make it more interesting:
    <variablelist>
      <varlistentry>
        <term><guimenuitem>Insert Link</guimenuitem></term>
        <listitem>
          <para>
        Lets you link some text to a website.  Use this tool to put hyperlinks in your HTML
                  messages.  If you don't want special link text, you can just enter the address
                  directly, and <application>Evolution</application>
                  will recognize it as a link.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guimenuitem>Insert Image</guimenuitem></term>
        <listitem>
          <para>
        Lets you put an image alongside text.
          </para>
          <para>
        To insert an image into your email:
        <orderedlist numeration="arabic">
          <listitem>
            <para>
              Open a new email by clicking <guibutton>New Message</guibutton>
            </para>
          </listitem>
          <listitem>
            <para>
              Make the email HTML mail by clicking
              <menuchoice>
            <guimenu>Format</guimenu>
            <guimenuitem>HTML</guimenuitem>
              </menuchoice>
            </para>
          </listitem>
          <listitem>
            <para>
              Click the <guibutton>Image</guibutton> button in the <guilabel>Toolbar</guilabel>.
              </para>
          </listitem>
          <listitem>
            <para>
              Choose your image by clicking the <guibutton>Browse</guibutton> button.
            </para>
          </listitem>
          <listitem>
            <para>
              Press <guibutton>Insert</guibutton> to insert the image.
            </para>
          </listitem>
        </orderedlist>
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guimenuitem>Insert Rule</guimenuitem></term>
        <listitem>
          <para>
        Inserts a horizontal line into the text to help divide two
        sections.
          </para>
          <para>
        To insert a rule:
        <orderedlist numeration="arabic">
          <listitem>
            <para>
              Open a new email by clicking <guibutton>New Message</guibutton>
            </para>
          </listitem>
          <listitem>
            <para>
              Make the email HTML mail by clicking
              <menuchoice>
            <guimenu>Format</guimenu>
            <guimenuitem>HTML</guimenuitem>
              </menuchoice>
            </para>
          </listitem>
          <listitem>
            <para>
              Click the <guibutton>Rule</guibutton> button in the <guilabel>Toolbar</guilabel>.
            </para>
          </listitem>
          <listitem>
            <para>
              Select the template to use for the rule.
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>Insert</guibutton> to insert the rule.
            </para>
          </listitem>
        </orderedlist>
          </para>
        </listitem>
      </varlistentry>
      </variablelist>
    To add a hyperlink to your HTML message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Select the text you want to link from
        </para>
      </listitem>
      <listitem>
        <para>
          Right click on text and select
          <guimenuitem>Link</guimenuitem>
        </para>
      </listitem>
      <listitem>
        <para>
          Enter the address you wish to link to in the
          <guilabel>URL</guilabel> field.
        </para>
      </listitem>
      <listitem>
        <para>
          Press <guibutton>OK</guibutton>.
        </para>
      </listitem>
    </orderedlist>
      </para>
      <para>
    To add an image to your HTML message:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Click
          <menuchoice>
        <guimenu>Insert</guimenu>
        <guimenuitem>Image</guimenuitem>
          </menuchoice>
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>Browse</guibutton>
        </para>
      </listitem>
      <listitem>
        <para>
          Select the image you want to include in your email.
        </para>
      </listitem>
      <listitem>
        <para>
          Press <guibutton>OK</guibutton>
        </para>
      </listitem>
      <listitem>
        <para>
          Press <guibutton>Insert</guibutton>
        </para>
      </listitem>
    </orderedlist>

      </para>
      <note>
    <title>A Technical note on HTML Tags</title>
    <para>
      The composer is a <acronym>WYSIWYG</acronym>
      (What You See Is What You Get)
      editor for HTML. That means that if you enter HTML
      directly into the composer&mdash; say, 
      <markup role="html">&lt;B&gt;Bold Text&lt;/B&gt</markup>, the
      the composer will assume you meant exactly that string
      of characters, and not "make this text bold," as an HTML
      composition tool or text editor would.
    </para>
      </note>
      <sect3 id="html-templates">
    <title>HTML Templates</title>
    <para>
          <application>Evolution</application> not only allows you to 
      decorate your email with HTML text and graphics, but 
      provides you with prebuilt templates for you to use when making 
      these improvements.
        </para>
    <para>
      To include a template into your HTML based email:
      <orderedlist numeration="arabic">
        <listitem>
          <para>
        Create a new email by clicking <guibutton>New Message</guibutton>.
          </para>
        </listitem>
        <listitem>
          <para>
        Enable HTML in your email by clicking
        <menuchoice>
          <guimenu>
            Format
          </guimenu>
          <guimenuitem>
            HTML
          </guimenuitem>
        </menuchoice>
          </para>
        </listitem>
        <listitem>
          <para>
        Click the <guibutton>HTML Template</guibutton> button in the 
        <guilabel>Toolbar</guilabel>.
          </para>
        </listitem>
        <listitem>
          <para>
        Select the template in the <guilabel>Template</guilabel> 
        selection box.
          </para>
        </listitem>
        <listitem>
          <para>
        Click <guibutton>Insert</guibutton> to insert it where the 
        cursor is.
          </para>
        </listitem>
        <listitem>
          <para>
        Click in the template to edit the specific object you clicked 
        on.
          </para>
        </listitem>
      </orderedlist>
    </para>
      </sect3>
      <sect3 id="composer-tables">
    <title>Tables in Email</title>
    <para>
      <application>Evolution</application> allows you to put tables in your HTML email to help organize your thoughts.  These tables are a simplified version of what you might find in a spreadsheet program such as <application>Gnumeric</application>.
    </para>
    <para>
      To include a table in your email:
      <orderedlist numeration="arabic">
        <listitem>
          <para>
        Create a new email by clicking <guibutton>New Message</guibutton>.
          </para>
        </listitem>
        <listitem>
          <para>
        Enable HTML in your email by clicking
        <menuchoice>
          <guimenu>
            Format
          </guimenu>
          <guimenuitem>
            HTML
          </guimenuitem>
        </menuchoice>
          </para>
        </listitem>
        <listitem>
          <para>
        Select the template to use for the table.
          </para>
        </listitem>
        <listitem>
          <para>
        Set up how many rows and columns you want.
          </para>
        </listitem>
        <listitem>
          <para>
        Click the <guibutton>Insert</guibutton> button.
          </para>
        </listitem>
        <listitem>
          <para>
        Click in a cell and type to insert text into the table.
          </para>
        </listitem>
      </orderedlist>
    </para>
      </sect3>
    </sect2>
    
    <sect2 id="usage-mail-getnsend-fwd">
        <title>Forwarding Mail</title>
        <para>
          The post office forwards your mail for you when you change
          addresses, and you can forward a letter if it comes to you by mistake.
          The email <guilabel>Forward</guilabel> button
          works in much the same way.  It's particularly useful if you
          have received a message and you think someone else would
          like to see it.  You can forward a message as an attachment
          to a new message (this is the default) or
          you can send it <glossterm linkend="inline">inline</glossterm> as a quoted
          portion of the message you are sending.  Attachment
          forwarding is best if you want to send the full, unaltered
          message on to someone else.  Inline forwarding is best if
          you want to send portions of a message, or if you have a
          large number of comments on different sections of the
          message you are forwarding.  Remember to note from whom the
          message came, and where, if at all, you have removed or
          altered content.
        </para>
        <para>
          To forward a message you are reading, press
          <guibutton>Forward</guibutton> on the toolbar, or select
          <menuchoice> <guimenu>Message</guimenu>
          <guimenuitem>Forward</guimenuitem> </menuchoice>.  If you
          prefer to forward the message <glossterm linkend="inline">inline</glossterm>
          instead of attached, select <menuchoice>
          <guimenu>Message</guimenu> <guimenuitem>Forward
          Inline</guimenuitem> </menuchoice> from the menu.  Choose an
          addressee as you would when sending a new message; the
          subject will already be entered, but you can alter it.
          Enter your comments on the message in the
          <interface>composition frame</interface>, and press
          <guibutton>Send</guibutton>.
        </para>
      </sect2>

      <sect2 id="usage-mail-getnsend-ettiquette">
        <title>Seven Tips for Email Courtesy</title>
        <para>

          <itemizedlist>

            <listitem>
              <para>
                 Don't send spam or forward chain mail.  If you must,
                 watch out for hoaxes and urban legends, and make sure
                 the message doesn't have multiple layers of
                 greater-than signs, (&gt;) indicating multiple layers
                 of careless in-line forwarding.
              </para>
            </listitem>

            <listitem>
              <para>
                Always begin and close with a salutation. Say "please"
                and "thank you," just like you do in real life. You
                can keep your pleasantries short, but be pleasant!
              </para>
            </listitem>

            <listitem>
              <para>
                WRITING IN CAPITAL LETTERS MEANS YOU'RE SHOUTING!
                Don't write a whole message in capital letters.  It
                hurts people's ears.
              </para>
            </listitem>

            <listitem>
              <para>
               Check your spelling and use complete sentences.
              </para>
            </listitem>

            <listitem>
              <para>
                Don't send nasty emails (flames).  If you get one,
                don't write back.
              </para>
            </listitem>
      
      <listitem>
        <para>
          When you reply or forward, include just enough of
          the previous message to provide context: not too
          much, not too little.
        </para>
      </listitem>

      <listitem>
        <para>
          Don't send <glossterm linkend="spam">spam</glossterm>.
        </para>
      </listitem>
    </itemizedlist>
      </para>
      <para> Happy mailing! </para>
    </sect2>
  </sect1>

    <sect1 id="usage-mail-subscriptions">
      <title>Subscription Management</title>
      <para>
         Since IMAP folders exist on the server, and opening them or
         checking them takes time, you need fine-grained control over
         the way that you use IMAP folders.  That's why
         <application>Evolution</application> has an IMAP
         subscriptions manager.
     </para>
     <para>
       To use it:
      <orderedlist numeration="arabic">

    <listitem>
      <para>
       Select
       <menuchoice><guimenu>Tools</guimenu><guimenuitem>Subscribe
       to Folders</guimenuitem></menuchoice>.
      </para>
    </listitem>

    <listitem>
      <para>
        If you have accounts on multiple IMAP servers, select the
        server where you'd like to manage your
        subscriptions. <application>Evolution</application> will
        display a list of available files and folders.
      </para>
    </listitem>

    <listitem>
      <para>
            Select a file or folder by clicking on it.  You will want
            to select at least the <guilabel>INBOX</guilabel>
            folder. Depending upon the way your IMAP server is
            configured, the list of available files may include
            non-mail folders. If it does, you can ignore them.
      </para>
    </listitem>

    <listitem>
      <para>
        Click the <guibutton>Subscribe</guibutton> to add it to
        the subscribed list.
      </para>
    </listitem>
    <listitem>
      <para>
        When you have subscribed to the folders you want, close
        the window.
      </para>
    </listitem>
      </orderedlist>
    </para>
  </sect1>

  <sect1 id="encryption">
    <title>Encryption</title>
    <sect2 id="encryption-whatis">
      <title>What is Encryption?</title>
      <para>
    Encryption is an ancient method of keeping information safe
    from prying eyes. <application>Evolution</application> helps
    you you protect your privacy by using
    <application>gpg</application>, an implementation of strong
    <glossterm linkend="public-key-encryption">Public Key
    Encryption.</glossterm>
      </para>

    <note id="pub-priv">
      <title>Public Key?  Private Key?  Whats the difference?</title>
      <para>
        GPG uses two keys: public and private.  You can give your
        public key to anyone from whom you want to recieve
        encrypted messages, or put it on a public key server so
        that people can look it up before contacting you.
        <emphasis>Never give your private key to anyone,
        ever</emphasis>.  Your private key lets you decrypt any
        message encrypted with your public key.
      </para>
    </note>

      <para>
        Using encryption takes a bit of forethought.  When you send a
        message that is encrypted, you must encrypt it using your
        intended recipient's public key.  To <emphasis>get</emphasis>
        an encrypted message, you must make sure that the sender has
        your public key in advance.
      </para>

      <para>
    You can use encryption in two different ways:
        <simplelist>
          <member>
             Encrypt the entire message, so that nobody but the recipient can read it.
          </member>
          <member>
            Attach an encrypted signature to a plain text message, so
            that the recipient can read the message without decrypting it, and 
            only needs decryption to verify the sender's identity.
           </member>
         </simplelist>
      </para>

    <example> 
         <title>Sending an Encrypted Messagee</title>
      <para>
        Kevin wants to send an encrypted message to his friend
        Rachel.  He looks up her public key on a general key
        server, and then tells
        <application>Evolution</application> to encrypt the
        message.  The message now reads "@#$23ui7yr87#@!48970fsd."
        When the information gets to Rachel, she decrypts it using
        her private key, and it appears as plain text for her to
        read.
      </para>
    </example>
    </sect2>

    <sect2 id="encryption-keygen">
      <title>Making Encryption Keys</title>
      <para>
        Before you can get or send encrypted mail, you need to
    generate your public and private keys with GPG. Here's how:
      </para>
      <tip>
    <title>GPG Versions</title>
    <para>
      This manual covers version 1.0.6 of GPG.  If your version is
      different, this may not be entirely accurate.  You may find
      out your version number by typing in: <command>gpg
      --version</command>.
    </para>
      </tip>
      <para>
        <orderedlist numeration="arabic">
      <listitem>
           <para>
            Open a terminal and type <command>gpg --gen-key</command>.
      </para>
         </listitem>

      <listitem>
           <para> 
             Choose the default algorythm, "DSA and ElGamal."
      </para>
         </listitem>

      <listitem>
           <para>
            Choose a key length. The default, 1024 bits, should be
            long enough.
      </para>
         </listitem>

      <listitem>
           <para>
             Decide if you want your key to expire automatically, and if so, when.
      </para>
         </listitem>


      <listitem>
           <para>
            Enter your name, email address, and any additional
            personal information you think is appropriate. Do not
            falsify this information, because it will be needed to
            verify your identity later on.
      </para>
         </listitem>

      <listitem>
           <para>
             Next, enter your passphrase. It does not have to be the
             same as your email password or your login password. In
             fact, it probably shouldn't. Don't forget it. If you lose
             it, your keys will be useless and you will be unable to
             decrypt messages sent to you with those keys.
      </para>
         </listitem>

      <listitem>
           <para>
             Now, GPG will generate your keys.  This may take awhile,
             so feel free to do something else while it's
             happening. In fact, using your computer for something
             else actually helps to generate better keys, because it
             increases the randomness in the key generation seeds.
      </para>
         </listitem>
    </orderedlist>
      </para>
      <para>
    Once the keys are generated, you can view your key information
        by typing <command>gpg --list-keys</command>.  You should see
        something similar to this:
        <programlisting>
        /home/you/.gnupg/pubring.gpg
        ----------------------------
        pub 1024D/32j38dk2 2001-06-20 you &lt;you@your-address.com&gt;
        sub 1024g/289sklj3 2001-06-20 [expires: 2002-11-14]
    </programlisting>
      </para>
      <para>
         GPG will create one list, or keyring, for your public keys
         and one for your private keys. All the public keys you know
         are stored in the file
         <filename>~/.gnupg/pubring.gpg</filename>. If you want to
         give other people your key, send them that file.
      </para>
      <para>
          If you wish, you can upload your keys to a keyserver. Here's
          how:
        <orderedlist>
      <listitem>
        <para>
              Check your public key ID with <command>gpg
--list-keys</command>. It will be the string after 1024D on the line
beginning with "pub." In this example, it's 32j38dk2.
            </para>
      </listitem>
      <listitem>
        <para>
         Enter the command <command>gpg --send-keys --keyserver
wwwkeys.pgp.net 32j38dk2</command>.  Substitute your key ID for
32j38dk2. You will need your password to do this.
             </para>
           </listitem>
    </orderedlist>

    <note id="why-keyserver">
      <title>Why Use a Keyserver?</title>
      <para>
        Keyservers store your public keys for you so that your
        friends can decrypt your messages.  If you choose not to
        use a keyserver, you can manually send your people public
        key, include it in your signature file, or put it on your
        own web page. However, it's easier to publish them once,
        and then let people download them from the keyserver when
        they want.
      </para>
    </note>

      </para>
    </sect2>

    <sect2 id="encrypt-getting-key">
      <title>Getting and Using Public Keys</title>
      <para>
    To encrypt a message to your someone else you'll need to use
    their public key in combination with your private key.
    <application>Evolution</application> does that for you, but
    you still need to get their key and add it to your keyring.
     </para>
     <para>
        To get public keys from a public key server, enter the
        command:
    <command>
      gpg --recv-keys --keyserver wwwkeys.pgp.net keyid
    </command>, substituting "keyid" for your recipient's ID.  You
    will need to type in your password, and then their ID will
    automatically be added to your keyring. When you send mail to
    them, <application>Evolution</application> will allow you to
    encrypt your messages.
      </para>
      <para>
        If someone sends you their public key directly, save it as a
        plain text file and enter the command <command>gpg
        filename</command>. This will add it to your keyring.
      </para>
    </sect2>

    <sect2 id="encrypt-evo-integ">
      <title>Setting up Evolution's Encryption</title>
      <para>
    You'll need to open
    <menuchoice>
      <guimenu>Tools</guimenu>
      <guimenuitem>Mail Settings</guimenuitem>
    </menuchoice>
    Once there, select the account with which you'd like to send
    and recieve encrypted mail, and click the
    <guibutton>Edit</guibutton> button.  In the
    <guilabel>Security</guilabel> tab is a section labeled
    <guilabel>Pretty Good Privacy</guilabel>.  Enter your key ID
    and click <guibutton>OK</guibutton>.  Your key is now
    integrated into your identity in
    <application>Evolution</application>.
      </para>
    </sect2>

    <sect2 id="encrypt-sending">
      <title>Sending Encrypted Messages</title>
      <para>
    As you know, you can use encryption to hide the entire
    message, or just to verify your signature. Once you've
    generated your public and private keys, and have the public
    keys of the people to whom you want to send mail, here's what
    to do:
      </para>
    </sect2>
    
    <sect2 id="sign-msg">
      <title>Signing a Message</title>
      <para>
    To sign a message, choose:
    <menuchoice>
      <guimenu>Security</guimenu>
      <guimenuitem>PGP Sign</guimenuitem>
    </menuchoice>
    .  You will be prompted for your PGP password.  Once you enter it,
    click <guibutton>OK</guibutton> and your message will be signed.
      </para>
    </sect2>
      
      <sect2 id="encrypt-msg">
    <title>Encrypting a Message</title>
    <para>
      Encrypting a message is very similar to signing a message.
      Just choose the menu item
      <menuchoice>
        <guimenu>Security</guimenu>
        <guimenuitem>PGP Encrypt</guimenuitem>
      </menuchoice>
    </para>
      </sect2>
      <sect2 id="unencrypting">
    <title>Unencrypting a Recieved Message</title>
    <para>
      If you get an encrypted message, you will need to decrypt it
      before you read it. Remember, the sender has to have your
      public key before they can send you an encrypted message.
    </para>
    <para>
      When you view the message,
      <application>Evolution</application> will ask you for your
      PGP password.  Enter it, and the message will be displayed
      properly.  
       </para>
    </sect2>
  </sect1>
</chapter>