path: root/help/C/config-prefs.sgml

<!--
<!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.
          </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 separate 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 Evolution preferences dialog by selecting
        <menuchoice> <guimenu>Tools</guimenu>
        <guimenuitem>Settings</guimenuitem> </menuchoice>.
            </para>
      </listitem>
      <listitem>
        <para>
               Select the <guilabel>Font Settings</guilabel> portion of the 
               settings dialog.
            </para>
      </listitem>
      <listitem>
        <para>Choose the font and font size you would like to use.
            </para>
      </listitem>
    </orderedlist>
     </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 also 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 then click the <guilabel>Directory
          Servers</guilabel> button in the settings dialog that appears.
        </para>
      </listitem>
      <listitem>
        <para>
          Click the <guibutton>Add</guibutton> button on the right
          side to open a Directory Server addition assistant.
        </para>
      </listitem>
      <listitem>
        <para>
          Enter the information requested by the assistant:
          <variablelist>
    
        <varlistentry>
          <term>Server name</term>
          <listitem>
            <para>
              Address of the server where the addressbook is located.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Login Method</term>
          <listitem>
            <para>
              Specify whether your login is anonymous, using
                      an email address, or a "distinguished name." If
                      the login is not anonymous, enter the login name
                      required by the server.
            </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>Use SSL/TLS</term>
          <listitem>
            <para>
                      SSL and TLS are security mechanisms. If you
                      select <guilabel>Always</guilabel>, Evolution
                    will not connect unless
                    secure connections are available. The default value is
                    <guilabel>Whenever Possible</guilabel>, which uses
                    secure connections if they are available,
                    but does not cause failure if they are not.
            </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>

                <varlistentry>
                  <term>Timeout Limit</term>
          <listitem>
            <para>
                      This is the maximum time Evolution will attempt to
                      download data from the server before giving up.
            </para>
          </listitem>
        </varlistentry>


                <varlistentry>
                  <term>Download Limit</term>
          <listitem>
            <para>
              Set the maximum number of results for a given
                      search. Most servers refuse to send more than
                      500, but you can set the number lower if you
                      want to shorten downloads for very broad
                      searches.
            </para>
          </listitem>
        </varlistentry>


                <varlistentry>
                  <term>Display name</term>
          <listitem>
            <para>
              The name that you see on the screen.  This could
              be anything you wish.
            </para>
          </listitem>
        </varlistentry>

          </variablelist>
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>OK</guibutton>.
        </para>
      </listitem>
      <listitem>
        <para>
          Click <guibutton>OK</guibutton> to permanently 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>