aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C/config-setupassist.sgml
blob: d76deba0906c49e57222a58d009601e335582774 (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
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
    <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>

<!--  

        Before you get it, though, you should decide where you want to
    keep it.  Your options will vary a little depending on your
    network setup, but they come down to storing the mail on your
    hard disk (using <glossterm linkend="pop">POP</glossterm>), or
    storing it on the network (using <glossterm
    linkend="imap">IMAP</glossterm>).  If you store your mail on
    your local hard disk, you can read it whether you're online or
    not, but you can only read it from one computer.  If you store
    it on the network, you can only read it when you're online,
    but you can access it from almost any computer with a network
    connection, even if it doesn't have
    <application>Evolution</application>.


        If you choose POP, you'll be putting mail in the
        <guilabel>Inbox</guilabel> in the <guilabel>Local</guilabel>
        folder.  If you choose IMAP, it's the
        <guilabel>Inbox</guilabel> of a folder with the same name as
        your mail server.  That's so you can maintain several distinct
        IMAP servers if you want.  See <xref
        linkend="config-prefs-mail"> for more information about mail
        servers.
-->

      <para>
         The setup assistant (sometimes called a
     <glossterm>Druid</glossterm>, by analogy with the "Wizards"
     that some other programs use) 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>Full Name:</guilabel> </term> <listitem>
      <para>Your name. </para></listitem>
         </varlistentry>

       <varlistentry>
          <term><guilabel>Email address:</guilabel></term>
      <listitem><para>
                 Your complete email address.
                 </para></listitem>
       </varlistentry>

       <varlistentry>
          <term> <guilabel>Organization:</guilabel></term>
      <listitem>
        <para>
              Any organization you represent, or the company where you
              work.  Leave this blank if you wish, or type "My own bad
              self" so people know your opinions are yours 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. Remember,
             this is attached to every email you send.
            </para>
         </listitem>
       </varlistentry>

       <varlistentry>
           <term> <guilabel>Receiving Email</guilabel></term>
      <listitem>
        <para>
              <application>Evolution</application> supports several
              mail sources: <glossterm linkend="pop">POP</glossterm> and
              <glossterm linkend="imap">IMAP</glossterm> servers, UNIX-style
              <systemitem><filename>mbox</filename></systemitem> and
              <systemitem><filename>Qmail maildir-format</filename></systemitem> 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;
              <systemitem><filename>mbox</filename>></systemitem>
              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>Netscape Communicator</application>.  Qmail files
          maybe useful if you use qmail to retrieve your mail.  Ask
              your system administrator which you should use, or keep
              guessing until one works.  You may use multiple sources
              if you wish; see <xref
              linkend="config-prefs-mail-network"> for more
              information.
            </para>
            <para>
              If you decide not to have
              <application>Evolution</application> use any servers,
              the remaining items are not relevant; you only need to
              point to the location of the files you wish to access.
            </para>
      </listitem>
      </varlistentry>
          
       <varlistentry>
          <term> <guilabel>Sending Email</guilabel></term>
      <listitem>
        <para>
              This should be the name of the server where you send 
              mail.  It may (or may not) be the same as the
              server where you get your incoming mail.
            </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>
        <para>
          In the <guilabel>Username:</guilabel> input box, type your
          username for your email account (the part before the @).
        </para>
      </listitem>
       </varlistentry>

      <varlistentry> 
         <term><guilabel>Account Management</guilabel></term>
      <listitem>
        <para>
          This is where you put the name of this email account.  It
          could be "Home" or "Work".
            </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>