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>

       <sect1 id="config-prefs-mail">
         <title>Mail Settings</title>
        <para>
        To change your mail settings, select <menuchoice>
        <guimenu>Tools</guimenu> <guimenuitem>Mail
        Settings</guimenuitem></menuchoice> in the Inbox.  This
        will open the <interface>mail preferences window</interface>,
        illustrated in <xref linkend="config-prefs-mail-fig">.  Mail
        preferences are separated into several categories:
        <variablelist>
      <varlistentry>
        <term><guilabel>Accounts</guilabel></term>
        <listitem>
          <para>
        This allows you to create and alter one or more
        identities for your email.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Display</guilabel></term>
        <listitem>
          <para>
        Allows you to edit how email appears.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Composer</guilabel></term>
        <listitem>
          <para>
        Customizes the behavior of the email message composer.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><guilabel>Other</guilabel></term>
        <listitem>
          <para>
        Configures miscellanious aspects of
        <application>Evolution</application> such as character
        set and encryption tools.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
    
    </para>

      <!-- ==============Figure===================== -->
      <figure id="config-prefs-mail-fig">
    <title>Account Editor Window</title>
    <screenshot>
      <screeninfo>Account Editor Window</screeninfo>
      <mediaobject><imageobject><imagedata fileref="figures/config-mail" format="png" srccredit="Aaron Weber">
        </imageobject></mediaobject>
    </screenshot>
      </figure>
      <!-- ==============End of Figure================-->


    <sect2 id="config-prefs-mail-identity">
      <title>Working with the Accounts Tab</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. 

              <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>
            </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>
    </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 hange 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>
        Mercifully, there are only four preferences you can prefer in
        the message composer preferences dialog:
         <variablelist>
      <varlistentry>
        <term>Send mail in HTML format by default </term>
        <listitem>
          <para>
                 If you would like all email messages that you compose
                 to begin in HTML format, leave this box checked. You
                 can convert messages between HTML and plain text by
                 selecting the <menuchoice> <guimenu>Format</guimenu>
                 <guimenuitem>HTML</guimenuitem> </menuchoice> toggle
                 in the message composer.
               </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Default Forward style</term>
        <listitem>
          <para>
                  Select from: 
                  <simplelist>
                   <member><guilabel>Attachment:</guilabel> the
                  message you forward appended to the message you send
                  as a seperate file.</member>

                  <member> <guilabel>Inline:</guilabel> The message
                  you forward is included at the end of the message
                  you send.</member>

          <member> 
                     <guilabel>Quoted:</guilabel> The message
                     you forward is included at the end of the message
                     you send, and a greater-than symbol (&gt;) is
                     inserted at the beginning of each line to
                     indicate that it is quoted.
                   </member>
        </simplelist>
               </para>
        </listitem>
      </varlistentry>

      <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>
    </sect2>
     <sect2 id="config-prefs-mail-other">
    <title>Other Mail Preferences</title>
    <para>
          Not everything fits neatly into categories.  This tab
          contains some miscellaneous configuration options that
          didn't fit anywhere else.
          <variablelist>

      <varlistentry>
        <term> 
          <guilabel>PGP binary path</guilabel>
        </term>
        <listitem>
          <para>
                The complete path to your external encryption tool On
                most Linux systems, this will be
                <filename>/usr/bin/gpg</filename>.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term> 
          <guilabel>Remember PGP Passphrase until Exit</guilabel>
        </term>
        <listitem>
          <para> Check this box if you want <application>Ximian
                Evolution</application> to remember your PGP
                passphrase for as long as it is running.  You will
                still have to enter your passphrase again each time
                you start <application>Ximian Evolution</application>.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <guilabel>Default Character Encoding</guilabel>
        </term>
        <listitem> <para> Choose a default character encoding for
          your messages.
          </para>
              </listitem>
             </varlistentry>

      <varlistentry>
        <term>
          <guilabel>Empty Trash Folders on Exit</guilabel>
        </term>
        <listitem> <para> If you would like to expunge all deleted
          mail when you quit <application>Ximian
          Evolution</application>, check this box.
          </para>
              </listitem>
             </varlistentry>

      <varlistentry>
        <term>
          <guilabel>Log filter actions to:</guilabel>
        </term>
        <listitem> <para> If you like, you can have
          <application>Ximian Evolution</application> write all
          its message filter actions to a log file. Select a log
          file here.
          </para>
              </listitem>
             </varlistentry>
           </variablelist>
        </para>
      </sect2>
    </sect1>


<!-- 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 id="config-prefs-cal">
       <title>Configuring the Calendar</title>
       <para>
          To set your calendar preferences, select
          <menuchoice><guimenu>Settings</guimenu>
          <guimenuitem>Calendar
          Settings</guimenuitem></menuchoice> from the Calendar
          view.  This will open up the
          <interface>Preferences</interface> window.  It contains four
          tabs: <guilabel>General</guilabel>, <guilabel>Display</guilabel>, <guilabel>Task List</guilabel>, and <guilabel>Other</guilabel>.  The <interface>calendar
          preferences window</interface> is illustrated in <xref
          linkend="config-prefs-cal-fig">.

      <!-- ==============Figure===================== -->
      <figure id="config-prefs-cal-fig">
    <title>Calendar Preferences Dialog</title>
    <screenshot>
      <screeninfo>If this worked on my job as well as my calendar...</screeninfo>
      <mediaobject><imageobject><imagedata fileref="figures/config-cal" format="png" srccredit="Aaron Weber">
        </imageobject></mediaobject>
    </screenshot>
      </figure>
      <!-- ==============End of Figure================-->
        </para>

    <sect2 id="config-prefs-cal-general">
      <title>Calendar's General Settings</title>
      <para>
        The <guilabel>Time display</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>
    </variablelist>
       </para>
    </sect2>
    <sect2 id="config-prefs-cal-display">
      <title>Display</title>
      <para>
    The <interface>Display</interface> section lets you configure some visual properties of the 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:
        <itemizedlist>
          <listitem>
            <para>
              5 minutes
            </para>
          </listitem>
          <listitem>
            <para>
              10 minutes
            </para>
          </listitem>
          <listitem>
            <para>
              15 minutes
            </para>
          </listitem>
          <listitem>
            <para>
              30 minutes
            </para>
          </listitem>
          <listitem>
            <para>
              60 minutes
            </para>
          </listitem>
        </itemizedlist>
              </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>
    </variablelist>
      </para>
    </sect2>

    <sect2 id="config-prefs-cal-tasklist">
      <title>Task List Settings</title>
     <para>
       You can choose what information the To Do list displays and the
       way it is displayed.
       <variablelist>
     <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>
        Configures what color to set your overdue items to.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
      </para>
    </sect2>

    <sect2 id="config-prefs-cal-other">
      <title>Other Calendar Settings</title>
      <para> 
    This configures miscellaneous items for the calendar and todo list's functionality.
    <variablelist>
      <varlistentry>
        <term>Ask for confirmation when deleting items</term>
        <listitem>
          <para>
        When you delete an item in either the Task List or the Calendar, you will be prompted to confirm that you want to delete the item.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Create new appointments with a default reminder</term>
        <listitem>
          <para>
        All your appointments will be created using a default reminder enabled.  You can still change what way you are reminded though.  If enabled, you can then set the time before your appointment to be reminded.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
      </para>
    </sect2>
   </sect1>

  <sect1 id="config-prefs-contact">
    <title>Managing the Addressbook</title>
    <para>
      The addressbook does not have a large list of configuration
      settings, but those that are there can be found in the
      <guimenu>Tools</guimenu> menu.
    </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>Addressbook Sources</guimenuitem>
          </menuchoice>
          from the menu.
        </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>Base</term>
              <listitem>
                <para>
                  Searches just the Search Base.  Most of the time,
                  not very useful.
                </para>
              </listitem>
            </varlistentry>
            <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>
<!-- I gotta finish this example -->
    <example id="ldap-config-example">
      <title>LDAP Configuration</title>
      <para>
        Rich works at a large chip manufacturer.  He needs to
        access the company's LDAP server.  Their LDAP address is
        wemakechips.com.
      </para>
      <para>
        His Account Name would be: We Make Chips Employees
      </para>
      <para>
        His Server Name would be: ldap.wemakechips.com
      </para>
    </example>
      </para>
    </sect2>
  </sect1>
    

<!--
  <sect1 id="config-prefs-general">
    <title>General Preferences</title> 
    <para>
      Additional configuration options will be covered here, as
      they become available.
    </para>
  </sect1>
-->
</chapter>