aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C/config-setupassist.sgml
blob: eb36872aa820931d8418910c68a49e3eb43531b2 (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
    <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 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>