aboutsummaryrefslogblamecommitdiffstats
path: root/doc/C/config-setupassist.sgml
blob: 966c62cfc2c92d5962f6a3450430b9b2bdde498d (plain) (tree)
1
2
3
4
5
6
7
8
9


                                                        





                                                                      
             
 




                                                                 



                                                                     

             





                                                                   

                                                                
                                                         

                                     
                                           

                                                        
                                                                                     






                                                                       
                                                           




                                                        
                                                                 
                        
 


                                                          

                                                               
                      
 

                                                          

                    



                                                                      

                     




                                                          


                                                                     


                                                                    
                   
                    
                      
 
                     
                                                               

                    
                                                                      















                                                                      

                     



                                                    

                    
                                                                    
                                  
                                                                 

                     





                                                     




                                                                      

                     




                                                              
                  



                                                                      

                     
                      
 

                                                          

                    


                                                                     

                     

                     







                                                                      
          


 





 
    <chapter id="config-setupassist">
      <title>Easy Setup with the Setup Assistant</title>
      <para>
        The first time you try to use email, the mail setup assistant
        will ask you for some basic information, so
        <application>Evolution</application> can let you use email. If
        you prefer more detailed configuration, or if you want to make
        changes to an existing email setup, 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>
              Any organization you represent; often, the company where
              you work.  Leave this blank if you wish.  One person I
              know always puts "My own bad self" in this box, so
              people know his opinions are his alone.
            </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's good form to keep your
             "sig" on the short side: four lines is plenty. Remeber,
             this is attached to every email you send.
            </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>