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

    <chapter id="config-setupassist">
      <title>Easy Setup with the Setup Assistant</title>
      <para>
        The setup assistant can gather most of the information
        necessary for <application>Evolution</application>'s daily
        operation. If you prefer more detailed or advanced
        configuration, see <xref linkend="config-prefs">.
      </para>

   <sect1 id="config-setupassist-mail">
      <title>Mail Setup</title>
      <para>
        The first time you try to send or receive mail with
    <application>Evolution</application>, the <interface>mail
    setup assistant</interface> will pop up to help you with your
    email preferences.  If you don't plan to use email, or if
    you'd rather deal with your email preferences later, click
    <guibutton>Cancel</guibutton>.
      </para>
      <para>
         The setup assistant (sometimes called a
     <glossterm>Druid</glossterm>) will guide you through the
     network configuration process.  It will ask you for some
     basic information; your system administrator or ISP should
     have the answers you'll need.  The mail setup assistant is
     pictured in <xref linkend="usage-setup-fig">.

<!-- ==============Figure=================================== -->
<!-- druid-pic should eventually become assistant-pic -->

    <figure id="usage-setup-fig">
    <title>Mail Setup Assistant</title>
    <screenshot>
      <screeninfo>Evolution Main Window</screeninfo>
      <graphic fileref="fig/mail-druid-pic" format="png" srccredit="Kevin Breit">
        </graphic>
    </screenshot>
    </figure>
<!-- ==============End of Figure=================================== -->



  The assistant will ask you for the following information:
        <variablelist>

          <varlistentry>
               <term> <guilabel>Name:</guilabel> </term>
      <listitem> <para>Your
            full name: eg. Eva Lucianne Tester </para></listitem>
         </varlistentry>

       <varlistentry>
          <term><guilabel>Email address:</guilabel></term>
      <listitem><para>
                 Your email address: eg. eltester@helixcode.com
                 </para></listitem>
       </varlistentry>

       <varlistentry>
          <term> <guilabel>Organization:</guilabel></term>
      <listitem>
        <para>
              <guilabel>Organization:</guilabel> Any organization you
              represent.  Leave this blank if you wish.
            </para>
      </listitem>
      </varlistentry>

      <varlistentry>
     <term><guilabel>Signature File:</guilabel></term>
          <listitem>
            <para>
             A text file appended to any email you send.  A signature
             file typically consists of your name and email address,
             or a quotation you like.  It should be fewer than four
             lines of text.
            </para>
         </listitem>
       </varlistentry>

       <varlistentry>
           <term> <guilabel>Mail source type:</guilabel></term>
      <listitem>
        <para>
              <application>Evolution</application> supports three mail
              sources: <glossterm>POP</glossterm> servers,
              <glossterm>IMAP</glossterm> servers, and UNIX-style
              <filename>mbox</filename> files.  POP servers retrieve
              your mail and store it on your local system so you can
              refer to it even when not connected to a network;
              <glossterm>IMAP</glossterm> servers store the mail on
              the server so you can access it from multiple locations;
              UNIX-style <filename>mbox</filename> files are used by
              your computer for internal mail, and may be useful if
              you want to switch from another email client such as
              <application>spruce</application> or
              <application>mutt</application>.  Ask your system
              administrator which you should use, or keep guessing
              until one works.  You may use multiple servers if you
              wish; see <xref linkend="config-prefs-mail-network"> for
              more information.
            </para>
      </listitem>
      </varlistentry>
          
       <varlistentry>
          <term> <guilabel>Server:</guilabel></term>
      <listitem>
        <para>
              This should be the name of your mail server: it should
              look something like:
              <userinput>mailserver.organization.org</userinput>.
            </para>
      </listitem>
    </varlistentry>

     <varlistentry>
      <term><guilabel>Username:</guilabel></term>
    <listitem>
             <para>
              Normally, this is the part of your email address before
              the @ character, and
              <application>Evolution</application> has selected that
              value as the default.  If you have a different username,
              you can enter it here.
            </para>
      </listitem>
      </varlistentry>
     
       <varlistentry>
            <term><guilabel>Authentication:</guilabel></term> 
        <listitem>
        <para>
              Select the type of authentication you will use.  You can
              click <guibutton>Detect supported types</guibutton> to
              find out which authentication protocols your network
              allows.
            </para>
      </listitem>
       </varlistentry>

      <varlistentry> 
         <term><guilabel>Mail Transport:</guilabel></term>
      <listitem>
        <para>
              This is the mail sending protocol you will want to use.
              <application>Evolution</application> supports both SMTP
              and <application>sendmail</application>.
            </para>
      </listitem>
      </varlistentry>
     </variablelist>
      </para>
      <para>
        To learn how to configure <application>Evolution</application>
        in greater detail, or to change preferences once you have set
        them, see <xref linkend="config-prefs">.
      </para>
    </sect1>

</chapter>