aboutsummaryrefslogtreecommitdiffstats
path: root/help/C/config-prefs.xml
blob: 03a78ab0a573993d74df52934a942fd0a2045c7a (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
<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->
<chapter id="config-prefs">

      <title>Advanced Configuration</title>
      <para>
        Perhaps your mail server has changed names.  Perhaps you've
        grown tired of a certain layout for your appointments.
        Whatever the reason, you want to change your
        <application>Evolution</application> settings.  This chapter
        will tell you how to do just that.
      </para>
      <para>
        Evolution 1.2 brings with it a redesigned comprehensive
        settings window that you can open by choosing <menuchoice>
        <guimenu>Tools</guimenu>
        <guimenuitem>Configure</guimenuitem></menuchoice>, no matter
        where you are in Evolution. On the left half of the settings
        window is a column, similar to the Evolution shortcut bar,
        which lets you choose which portion of Evolution to
        customize. The right half of the window is where you'll make
        your actual changes.
      </para>


      <!-- ==============Figure===================== -->
      <figure id="config-prefs-mail-fig">
    <title>Changing Mail Settings</title>
    <screenshot>
      <screeninfo>Changing Mail Settings</screeninfo>
      <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="PNG" srccredit="Aaron Weber"/>
        </imageobject></mediaobject>
    </screenshot>
      </figure>
      <!-- ==============End of Figure================-->

  <para>
    There are eight items you can customize. From top to bottom, they
    are:
    <variablelist>
      <varlistentry>
    <term>Mail Accounts</term>
    <listitem>
      <para>
             Here, add or change information about your email
             accounts: the servers to which you connect, the way you
             download mail, your password authentication mode, and so
             forth. This is the most complex item in the list, and is
             covered in <xref linkend="config-prefs-mail-identity"/>.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Folder Settings</term>
    <listitem>
      <para>
             Here, you can choose the default folders for various
             components of Evolution, the folders that will be cached
             locally when you go to offline mode, and the folders that
             Evolution will use when it is searching for
             autocompletion information as you address a mail.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Mail Preferences</term>
    <listitem>
      <para>
             These are overall mail reading preferences: display
             settings, notification options, security, and so
             forth. These are covered in <xref
             linkend="config-prefs-mail-display"/>.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Composer Preferences</term>
    <listitem>
      <para>
             Settings for the way that you use the mail composer:
             shortcuts, signatures, spelling, and so forth. One fun
             feature here is the ability to substitute graphical
             smiley-faces for "emoticons" such as :) that many people
             use in email. This tool is covered in <xref
             linkend="config-prefs-mail-composer"/>.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Calendar and Tasks</term>
    <listitem>
      <para>
             Here, you can set the way the calendar behaves, including
             your time zone and the length of your work-week.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Directory Servers</term>
    <listitem>
      <para>
             If you want to use a shared directory server (LDAP
             server), this is the place to set it up.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Font Preferences</term>
    <listitem>
      <para>
            Choose the fonts that Evolution will use to display email
            here.  You can choose fonts for the mail composer by
            selecting <menuchoice> <guimenu>Edit</guimenu>
            <guimenuitem>Properties</guimenuitem> </menuchoice> from
            within the composer window.
          </para>
    </listitem>
      </varlistentry>

      <varlistentry>
    <term>Summary Preferences</term>
    <listitem>
      <para>
             Set the mail folders, news feeds, schedule summary
             length, and weather locations to be displayed here. For
             news feeds, enter the web address of any RDF file.
          </para>
    </listitem>
      </varlistentry>

    </variablelist>

  </para>

  <sect1 id="config-prefs-mail">
    <title>Mail Settings</title>
    <para>
       The first few tools, with the exception of the folder tool,
       cover mail tasks:
    </para>

   <sect2 id="config-prefs-mail-identity">
      <title>Working with Mail Accounts</title> 
      <para>
         <application>Ximian Evolution</application> allows you to
         maintain multiple accounts, or identities.  This is useful
         want to keep personal and professional email separate, or if
         you wear several hats at work. When you are writing an email
         message, you can which account to use by selecting from the
         drop-down list next to the <guilabel>From</guilabel> entry in
         the message composer.
       </para>

       <para>
         Clicking <guibutton>Get Mail</guibutton> will refresh any
         IMAP, <filename>mh</filename>, or
         <filename>mbox</filename> listings
         and check and download mail from all POP servers.  In other
         words, <guibutton>Get Mail</guibutton> gets your mail, no
         matter how many sources you have, or what types they are.  If
         you don't want to check mail for a given account, select it
         in the <guilabel>Accounts</guilabel> tab and click the
         <guibutton>Disable</guibutton> button.
       </para>
       
      <para>
         To add a new account, simply click <guibutton>Add</guibutton>
         to open the mail configuration assistant. To alter an
         existing identity, select it in the
         <interface>Preferences</interface> window, and then click
         <guibutton>Edit</guibutton> to open the account editor
         dialog.
      </para>

     <para>
         The account editor dialog has six sections:
          <variablelist>

      <varlistentry> 
        <term>Identity:</term>
           <listitem>
        <para>
              Here, enter the name,
              email address, and other identifying information for the
              account.
            </para>
      </listitem>
      </varlistentry>
      <varlistentry> 
        <term>Receiving Mail</term>
           <listitem>
        <para>
             Here, select the way you will be getting mail: you may
             download mail from a server (<glossterm
             linkend="pop">POP</glossterm>), read and keep it on the
             server (Microsoft Exchange or <glossterm
             linkend="imap">IMAP</glossterm>), or read it from files
             that already exist on your desktop computer.  If you use
             a server, it may permit or require you to use a Secure
             Socket Layer (SSL) connection.  To turn SSL connections
             on, just click the <guibutton>Use Secure Connection
             (SSL)</guibutton> button.

<note id="config-arbitrary-port">
<title>Specifying Port Numbers</title>
<para>
Your system administrator may ask you to connect to a specific port on
a mail server. To specify which port you use, just type a colon and
the port number after the server name. For example, to connect to port
143 on the server smtp.omniport.com, you would enter
as
<userinput>
smtp.omniport.com:143
</userinput> as the server name.
</para>
</note>

      </para>
      </listitem>
      </varlistentry>
      <varlistentry> 
        <term>Receiving Options</term>
           <listitem>
        <para>
              Here, decide whether you'd like to check for mail
              automatically and how often, as well as other message
              retrieval options.

              <variablelist>
                <varlistentry>
                   <term>If you chose POP:</term>
                   <listitem>
                     <para>
                   <itemizedlist>
              <listitem>
                <para>Checking for new mail: If you would
                         like <application>Evolution</application>
                         to check for new mail automatically,
                         check the box and select a frequency in
                         minutes.
                           </para>
              </listitem>

              <listitem>
                <para>
                             Message Storage: If you'd like to store
                          copies of your mail on the server, check
                          this option.
                           </para>
              </listitem>
        
            
                           <listitem>
                <para>Store Store status headers in
                Elm/Pine/Mutt format: If you would like to
                use the X-Status header format used by the
                mail clients Elm, Pine, and Mutt, select
                this option. This option is useful if you
                plan to check your mail with those clients
                from time to time.
                           </para>
              </listitem>
                   </itemizedlist>
                      </para>
            </listitem>
                  </varlistentry> 

                <varlistentry>
                   <term>If you chose Microsoft Exchange:</term>
                   <listitem>
                     <para>

        <itemizedlist> <listitem>
        <para>Checking for new mail: If you would like
        <application>Evolution</application> to check for new mail
        automatically, check the box and select a frequency in
        minutes.
        </para>
          </listitem>

          <listitem>
        <para>Exchange Server: If your active directory user name
        is different from your Exchange mail user name, check this
        box and enter your mail username here.
        </para>
          </listitem>

          <listitem>
        <para>Create a Global Address List folder: If you would
        like to have a seperate folder for the Active Directory's
        Global Address List, leave this box checked. </para>
          </listitem>

          <listitem>
        <para>
          Active Directory Server Name: In most organizations,
              the Active Directory server will be different from
              the Exchange mail server.  If so, check the box and
              enter the Active Directory server name here.
        </para>
          </listitem>

          <listitem>
        <para>Limit number of Responses: Select a maximum number
        of results for an address search. A maximum number of
        results limits the load on your system and on your network.
          </para>
          </listitem>
        </itemizedlist>                       
                     </para>
                   </listitem>
                  </varlistentry> 

                <varlistentry>
                   <term>If you chose IMAP:</term>
                   <listitem>
                     <para>
                      
         <itemizedlist>
      <listitem>
        <para>Checking for new mail: If you would like
        <application>Evolution</application> to check for new mail
        automatically, check the box and select a frequency in
        minutes.  
            </para>
      </listitem>

      <listitem>
        <para>If you want <application>Evolution</application>
        to check for new messages in <emphasis>all</emphasis> your
        IMAP folders, make sure the <guilabel>Check for new
        messages in all folders</guilabel> box is selected.</para>
      </listitem>

      <listitem>
        <para>Show only subscribed folders: Check this box if you
        have more folders in your IMAP view than you want to
        read.</para>
      </listitem>

      <listitem>
        <para>
              Override server-supplied namespace: If you like, enter a
              specific directory where your server stores mail for
              you.  Typical values are "mail" and "Mail."  For more
              information about how to use IMAP mail, see <xref
              linkend="usage-mail-subscriptions"/>.</para>
      </listitem>

      <listitem>
        <para>Apply filters to new messages in INBOX on this
        server: If you'd like your filters to work on this account
        as well as on locally downloaded mail, check this box.</para>
      </listitem>

       <listitem>
        <para>Store Store status headers in Elm/Pine/Mutt format:
        If you would like to use the X-Status header format used
        by the mail clients Elm, Pine, and Mutt, select this
        option. This option is useful if you plan to check your
        mail with those clients from time to time.
       </para>
      </listitem>

    </itemizedlist>
                     </para>
                   </listitem>
                  </varlistentry> 

             
                  </variablelist>  
     </para>
      </listitem>
      </varlistentry>
      <varlistentry> 
        <term>Sending Mail</term>
           <listitem>
        <para>
              In this section, you will choose and configure a method
              for sending mail.  You may choose <glossterm
              linkend="smtp">SMTP</glossterm>, Microsoft Exchange (if
              you have purchased the Ximian Connector for Microsoft
              Exchange) or <glossterm
              linkend="sendmail">sendmail</glossterm>.
             </para>
      </listitem>
      </varlistentry>
      <varlistentry> 
        <term>Special Folders</term>
           <listitem>
        <para>
              Here, you can decide where this account will store the
              messages that it has sent, and the messages that you
              save as drafts.
            </para>
      </listitem>
      </varlistentry>
      <varlistentry> 
        <term>Security</term>
           <listitem>
        <para>
              In this section, you will set the security options for
              this account. Enter your PGP Key ID and decide how
              frequently to encrypt and sign your messages. You can
              learn more about PGP and encryption in <xref
              linkend="encryption"/>.
            </para>
      </listitem>
      </varlistentry>
    </variablelist>
      </para>
    </sect2>
  

    <sect2 id="config-prefs-mail-display">
      <title>Mail Display Options</title>
      <para>
        In this tab you can decide how you would like
        <application>Ximian Evolution</application> to display your
        mail: how to display citations, how long to wait before
        marking a message as read, and so forth.
      </para>
     <para>
        This is also where you can decide how you would like
        <application>Ximian Evolution</application> to handle inline
        images in HTML mail that you get. There is a detailed
        discussion of the issues surrounding these options in <xref
        linkend="usage-mail-getnsend-get-attach-html"/>.
     </para>
     <para>
       To change the font which <application>Ximian
        Evolution</application> uses to display mail, do the
        following:
       <orderedlist numeration="arabic">
      <listitem>
            <para>
              Open the Control Center by selecting <menuchoice>
        <guimenu>System</guimenu>
        <guimenuitem>Settings</guimenuitem> </menuchoice> from
        the menu panel.
            </para>
      </listitem>
      <listitem>
        <para>
               Select the HTML Viewer settings tool.
            </para>
      </listitem>
      <listitem>
        <para>Choose the font and font size you would like to use.
            </para>
      </listitem>
    </orderedlist>

       Alternately, open a terminal and run the
       <command>gtkhtml-properties-capplet</command> command. This
       will open the GNOME HTML Display Properties tool, and you can
       select a font and other attributes of your HTML display,
       including that in <application>Ximian Evolution</application>.
     </para>
     </sect2>

    <sect2 id="config-prefs-mail-composer">
      <title>Message Composer Preferences</title>
      <para>
        There are three whole tabs of settings you can change for the
        message composer. The General tab covers shortcuts and
        assorted behavior, and the other two control signatures and
        spell checking.  In the General tab, you can set:

         <variablelist>

      <varlistentry>
        <term>Shortcuts Type</term>
        <listitem>
          <para>
                 Choose a keyboard shortcut scheme: do you prefer
                 keyboard shortcuts similar to those of Microsoft
                 Windows, XEmacs, or Emacs?
               </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Default Behavior</term>
        <listitem>
          <para>
                 Choose how you will normally forward and reply
                 messages, what character set they will use, whether
                 they will be in HTML, and whether that HTML can
                 contain smiley face images.
               </para>
        </listitem>
      </varlistentry>


      <varlistentry>
        <term>Alerts</term>
        <listitem>
          <para>
                 There are two optional alerts here:
                 <variablelist>
             <varlistentry>
            <term>Prompt when sending messages with an empty subject</term>
            <listitem>
              <para>
             The composer will warn you if you try to send a
             message without a subject.
               </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Prompt when sending messages with only Bcc recipients defined</term>
            <listitem>
              <para>
             The composer will warn you if you try to send a
             message that has only <guilabel>Bcc</guilabel>
             recipients. This is important because some mail
             servers will fail to honor blind carbon copy if you
             do not have at least one recipient that is visible to
             all readers.
               </para>
            </listitem>
          </varlistentry>
          </variablelist>
               </para>
        </listitem>
      </varlistentry>
      </variablelist>
    </para>

     <para>
         The signature editor is new for Evolution 1.2. It allows you
         to create several different signatures in plain text or in
         HTML, and to specify which of them will be added to emails
         you create in the message composer.  If you prefer to use an
         alternate signature or none at all, you can select it from
         the mail composer itself.
    </para>
    <para>
       In the spell-checking tool, you can set spelling options,
       including the language or languages you will use. Note that you
       must install the gnome-spell package, available through Red
       Carpet, for spell-checking to be available in
       Evolution. Alternate dictionaries are aslo available through
       Red Carpet and are detected automatically if you have installed
       them.
    </para>
    </sect2>


<!-- NOT FOR 1.0, see usage-mail.sgml
      <sect1 id="config-prefs-news">          
          <title>News Servers</title>
          <para>
            Newsgroups are so much like mailing lists that there's no
            reason not to keep them right next to your mail.  When you
            first select the <guilabel>News Servers</guilabel> tab,
            you will see a blank box with the three familiar buttons
            on the right: <guibutton>Add</guibutton>,
            <guibutton>Edit</guibutton>, and
            <guibutton>Delete</guibutton>.
          </para>
          <para>
            Click <guibutton>Add</guibutton> to add a news server; you
            will be prompted for its name.  Enter the name, click
            <guibutton>OK</guibutton>, and you're done.  You can have
            as many news servers as you like, of course.  News servers
            will appear next to your IMAP servers in the
            <interface>folder bar</interface>.
          </para>
     </sect2>
-->
  </sect1>

    <sect1 id="config-prefs-cal">
       <title>Calendar and Task List Settings</title>
       <para>
          The calendar configuration tool has two tabs
          <guilabel>General</guilabel> and
          <guilabel>Display</guilabel>, and is illustrated in <xref
          linkend="config-prefs-cal-fig"/>.

      <!-- ==============Figure===================== -->
      <figure id="config-prefs-cal-fig">
    <title>Calendar Preferences Dialog</title>
    <screenshot>
      <screeninfo>Calendar Configuration</screeninfo>
      <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="PNG" srccredit="Aaron Weber"/>
        </imageobject></mediaobject>
    </screenshot>
      </figure>
      <!-- ==============End of Figure================-->
        </para>

      <para>
        The <guilabel>General</guilabel> tab lets you set the
        following:
        <variablelist>
      <varlistentry>
        <term>Time zone</term>
        <listitem>
          <para>
        The city you're located in, to judge your time zone.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Time format</term>
        <listitem>
          <para>You may choose between twelve-hour (AM/PM) and
          twenty-four hour time formats here by clicking the
          appropriate radio button.
              </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Work Week</term>
        <listitem>
          <para>
                When does your work day start, and when does it end?
        In the day and week views,
        <application>Evolution</application> displays all the
        hours in the range you select here, even if there are
        no appointments for those times.  Of course, you can
        still schedule an appointment outside of these hours,
        and if you do, the display will be extended to show
        it.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>First day of the week</term>
        <listitem>
          <para>You can set weeks to start on Sunday or on Monday.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Start of day</term>
        <listitem>
          <para>
        Says what time of the day your weekday starts.  This
        will show all times till the end of the day,
        regardless of there is an appointment during the time
        period.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>End of day</term>
        <listitem>
          <para>
        Sets the time the day ends at.
          </para>
        </listitem>
      </varlistentry>


      <varlistentry>
        <term>Alerts</term>
        <listitem>
          <para>
        If you'd like to be warned before you delete any
        appointment, or to have a reminder automatically
        appear for each event, select the check boxes here.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
       </para>

      <para>
    The <interface>Display</interface> section lets you choose how
    your appointments and tasks will appear in your calendar.
      </para>
      <para>The display properties you can set are:

    <variablelist>
      <varlistentry>
        <term>Time divisions</term>
        <listitem>
              <para>
        Sets the increments shown on the daily view in the
        calendar.  You can set this to be anywhere from five
        minutes to an hour, in five minute increments.</para>
            </listitem>
      </varlistentry>

      <varlistentry>
        <term>Show appointment end times in week and month views</term>
        <listitem>
          <para>
        If there is space,
        <application>Evolution</application> will show the end
        times in the week and month views for each
        appointment.
              </para>
            </listitem>
      </varlistentry>
      <varlistentry>
        <term>Compress weekends in month view</term>
        <listitem>
          <para>
        If checked, your weekends will be shown in one box,
        instead of one for each day in the month view.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Show week numbers in date navigator</term>
        <listitem>
              <para>
        This will show the week numbers next to the respective
        weeks in the calendar.
          </para>
            </listitem>
      </varlistentry>

     <varlistentry>
       <term>Tasks due today</term>
        <listitem>
          <para>
        Configures what color to set your tasks that are due
        today to.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Overdue tasks</term>
        <listitem>
          <para>
        Choose the color for overdue tasks.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
      </para>
  </sect1>
  <sect1 id="config-prefs-contact">
    <title>Managing the Addressbook</title>
    <para>
        Addressbook settings are limited to the usage and
        configuration of directory servers (LDAP and
        Exchange). Contact folders for the mailer's autocompletion
        feature are set in the Folders tool above, and all other
        addressbook controls are available in the addressbook window
        itself.
    </para>
      
    <sect2 id="config-prefs-contact-ldap-add">
      <title>Adding Directory Servers</title>
      <para>
    To add a new <glossterm linkend="ldap">LDAP</glossterm> server
    to your available contact folders:
    <orderedlist numeration="arabic">
      <listitem>
        <para>
          Select 
          <menuchoice>
        <guimenu>Tools</guimenu>
        <guimenuitem>Settings</guimenuitem>
          </menuchoice>
          and click the <guibutton>Directory Servers</guibutton>
          shortcut button.
        </para>
      </listitem>
      <listitem>
        <para>
          Click the <guibutton>Add</guibutton> button on the right
          side.
        </para>
      </listitem>
      <listitem>
        <para>
          Enter the server information:
          <variablelist>
        <varlistentry>
          <term>Account name</term>
          <listitem>
            <para>
              The name that you see on the screen.  This could
              be anything you wish.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Server name</term>
          <listitem>
            <para>
              Address of the server where the addressbook is located.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>My server requires authentication</term>
          <listitem>
            <para>
              Select this if the server requires
              <application>Evolution</application> to provide
              a server in order to access the LDAP contacts.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Port</term>
          <listitem>
            <para>
              The internet port
              <application>Evolution</application> connects to
              in order to access the LDAP database.  This is
              normally 389.
            </para>
          </listitem>
        </varlistentry>

            <varlistentry>
          <term><glossterm linkend="search-base">Search Base</glossterm></term>
          <listitem>
            <para>
                    The base entry to use for all your
                    searches. Contact your administrator for
                    information about the correct settings.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><glossterm linkend="search-scope">Search scope</glossterm></term>
          <listitem>
            <para>
              How broad the search is in the directory.  The
              following options are available:
              <variablelist>
            <varlistentry>
              <term>One</term>
              <listitem>
                <para>
                  Searches the Search Base and one entry
                  below it.
                </para>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>Sub</term>
              <listitem>
                <para>
                  Searches the Search Base and all entries
                  below it.
                </para>
              </listitem>
            </varlistentry>
              </variablelist>
            </para>
          </listitem>
        </varlistentry>
          </variablelist>
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>OK</guibutton>.
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>OK</guibutton> to permanenty make
          changes or <guibutton>Apply</guibutton> to temporarily
          set the changes.
        </para>
      </listitem>
    </orderedlist>


<!-- Finish this example:

    <example id="ldap-config-example">
      <title>LDAP Configuration</title>
      <para>
        Rich works at omniport.net and needs to access the
        company's LDAP server so that he can look up the email
        addresses of his co-workers. 
      </para>
      <para>
        He uses his email address, rich@omniport.net, 
      </para>
      <para>
        His Server Name is: ldap.wemakechips.com
      </para>
    </example>
-->
      </para>
    </sect2>
  </sect1>
</chapter>