aboutsummaryrefslogblamecommitdiffstats
path: root/doc/C/evo_book_0.1.sgml
blob: 357da80224ac965c50ae570163c76f22baee3e20 (plain) (tree)
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
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
































































































































































































































































































































































































































































                                                                                                                                          
<!DOCTYPE book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN">

<book>
<bookinfo>
  <title>Evolution Users Guide</title>
  <author><firstname>Aaron</firstname><surname>Weber</surname></author>
  <copyright><year>2000</year><holder>Aaron Weber and Helix Code, inc.</holder></copyright>

  <legalnotice>
PUT THE RIGHT LEGALNOTICE IN HERE
 
      <para> Windows, Exchange, and Outlook are trademarks of Microsoft Corp.</para>
      <para> Lotus and Lotus Notes are trademarks of The Louts Corporation.</para>
      <para> Macintosh and Apple are  trademarks of Apple Computer, Inc.</para>
      <para> All other trademarks are property of their respective owners.</para>
    </legalnotice>

     <releaseinfo> 
          This is version 0.0 of Evolution manual.
     </releaseinfo> <!-- this is version of manual, not application --> 

</bookinfo>

<preface>
<!-- =============Introduction ============================= -->
    <title>Introduction</title> 

    <section> <title> What is Evolution?</title>
    <para>
      <application>Evolution</application> is a suite of groupware applications
      for mail, contact management, and calendaring.  It is
      included in the package <filename>Evolution</filename>, which is a
      part of the GNOME desktop environment. This document describes
      version &version; of <application>Evolution</application>
    </para>

    <para>
      What that means is that Evolution is your personal secretary.  It can keep track of 
      memos, emails,
      and appointments for you and for everyone in your office.
    </para>

    <para><application>Evolution</application> can be started by
        selecting <guimenuitem>Evolution</guimenuitem> from
        <guisubmenu>SUBMENU</guisubmenu> submenu of the <guimenu>Main
    Menu</guimenu>, or by running the command
    <command>evolution</command> on the commandline.  
    </para>


</preface>

<part id="usage">
<title>Using Evolution</title>

    <partintro>
    <para>
       As was said before, <application>Evolution</application> can be
       used to send and recieve email, manage address and other contact information,
       and maintain  This section describes basic usage of
       <application>Evolution</application> in each of those functions.  As with most of Linux, 
       there's more than one way to do things, and you should pick whichever one strikes you as most
       appropriate.
    </para>
    </partintro>


    <chapter id="basics">
    <title>Basic usage</title>
      <para>
    When you first start <application>Evolution</application>, you see
    the <interface>Main window</interface>, as shown in 
    <xref linkend="mainshot">the following figure. 
     From there, you should select which features you wish to
    use by clicking on their icons in the left-hand navigational column.
    The Mail features can be accessed by clicking on the <guibutton>Mail</guibutton>,
    and likewise for other features.
<!-- ==============Figure=================================== -->
    <figure id="mainshot">
    <title>Evolution Main Window</title>
    <screenshot>
        <screeninfo>Evolution Main Window</screeninfo>
        <graphic fileref="SCREENSHOT" format="png"
        srccredit="Aaron Weber">
        </graphic>
    </screenshot>
    </figure>
<!-- ==============End of Figure=================================== -->
      </para>

  </chapter>
 
  <chapter id="mailer"> 
     <title>The Evolution Mailer</title>
      <abstract>
       <para>
       This chapter covers the use of the Evolution Mailer. 
       Configuration of the mail client is discussed in <xref linkend="customization">.
       If you are already accustomed to other email programs, 
       you can probably skip the mail sending and checking sections. 
       The more complex functions, such as filtering, organizing, and searching mail,
        have some features that are not found in other email programs, and 
       even power users may wish to review these sections of the guide.
      <!--those function descr's should be xrefs to sections of the chapter-->
     </para>
      </abstract>

      <sect1 id="mailsending">
      <title>Sending and Recieving Mail</title>
       <para>
      You can start writing a new email message by selecting <guimenuitem>New Mail</guimenuitem> from
      the <guimenu>FilMenu</guimenu>, or by pressing <KeyCombo>NEW-MESSAGE-COMBO</KeyCombo>.  
      When you do so, the <interface>New Message</interface> window will open, as shown in 
      <xref linkend="evolution-newmsg">.


<!-- ==============Figure=================================== -->
    <figure id="evolution-newmsg">
    <title>New Message Window</title>
    <screenshot>
        <screeninfo>Evolution Main Window</screeninfo>
        <graphic fileref="evolution_newmsg" format="png"
        srccredit="Aaron Weber">
        </graphic>
    </screenshot>
    </figure>
<!-- ==============End of Figure=================================== -->

      </para>
     
     <para> 
      You can pick recipients in several ways: 
      The <guilabel>TO:</guilabel> field is for the primary recipients of the message your are going to send.
      It is considered bad form to have more than a few email addresses in this form.
      </para>
      <para>
      If you want to send a copy of the message to someone, you may also use the <guilabel>Cc:</guilabel> field.  
      "Cc" stands for "Carbon Copy"-- Those people will recieve a copy of the message.  They will see
      the rest of the message list, and are noted as secondary recipients of the message. 
      </para>
      
      <para>
      If you have a large number of recipients, or if you want to send mail to several people without
      telling them that it's gone to multiple people, you should use <guilabel>BCC.</guilabel>  BCC stands 
      for "Blind Carbon Copy".  Addresses entered into this field will recieve the message
      but the message headers will not see the rest of the recipient list.
      </para>

      <para>
      Enter a subject into the <guilabel>Subject:</guilabel> field.

      Enter the text of your message into the <guilabel>Message:</guilabel> text area.
      </para>
      
      <para>
      If you want to attach a document to your email message, you can do so by
       <!--describe process here-->.  If the people you are sending a message to
       can read HTML mail, you can embed an image into the mail.  Otherwise,
       it's best to attach images, just like other documents.  Be aware that a large
       attachment will take a long time to download.
      </para>

      
      <para>
      Click <guibutton>Send</guibutton> or press <KeyCombo>SENDCOMBO</KeyCombo> to send the mail.
      </para>
    <tip> 
      <title>Send Now, Send Later</title>
      <para>
      Evolution will send mail immediately unless you set it to do so otherwise.  It also checks for 
      new mail every time you send mail.  If you
      want, however, you can queue your messages to be sent at a later time, and also set your
      preferences to check mail on a regular basis, and alert you whenever it finds new messages.
      I like  to use "Send Later" because it gives me a chance change my mind about a message
      before it goes out, and I have Evolution set to check my mail every ten minutes, and beep
      when I get mail that it thinks isn't spam.
      Use the <interface>Mail Preferences</interface> to specify message queue and filter behavior.  
      Preferences are discussed in <xref linkend="customization">.
      </para>
    </tip>
    </sect1>

    <sect1 id="mail-sorting">
    <title>Organizing Your Mail</title>

    <para>
    If you only get a few messages a day, you probably don't need to to sort or organize them.  When you get several hundred each day,
    and when you want to refer to a message you've recieved six weeks ago, you want a real
    organizing system.  This section will cover the mail sorting and organization: folders, searches, vFolders, and filters.
    <!--those last items should be links-->

    <sect2 id="mail_folders">
    <para>
    You can create new folders by selecting <guimenuitem>ITEM</guimenuitem> from the <guimenu>MENU</guimenu>, or by
    pressing <KeyCombo>SENDCOMBO</KeyCombo>.  Move mail to them by selecting <guimenuitem>ITEM</guimenuitem> from the
    <guimenu>MENU</guimenu>, or by pressing <KeyCombo>SENDCOMBO</KeyCombo>.  An email message can be in only one folder at a time,
    just like real mail in real folders. If you forget where an email is, you can search for it. If you find that you want
    an email to be in several places at once, you should consider creating a vFolder, or virtual folder.
    <para>
    </sect2>    

    <sect2 id="mail_searching">
    <para>
    Because Evolution automatically creates an index of every email you recieve, it can search through your old
    messages and present you with the results in short order.  
    <!--describe the way one creates a search and so forth.-->    
    </para>

    <para>
    If you find yourself performing a search frequently, you can save it as vFolder.
    </para>
    </sect2>
    
    <sect2 id="mail_vFolders">
    <para>
    Virtual Folders, or vFolders, are one of the more  advanced features of <application>Evolution</application>.  If they confuse you,
    you don't have to use them.  However, if you get a lot of mail, and find yourself referring to messages, looking for old email, 
    or just living in your email client, you'll probably want to use them. 
    Basically, a vFolder is a saved search, which you can access the same way you would a normmal folder.
    There are several important differences between the two, however, which come from the fact that  a conventional
    folder actually contains a message, but a virtual folder is really a different view of all your email.  This means that
    while a  message can be in several vFolders, it can be in only one conventional folder.  Also, 
    you cannot add or delete a message from a vFolder, and when you delete a message from a conventional folder,
    it will disappear from all your vFolders--a search can't find a deleted message.  
    </para>
    </sect2>

    <example><title>Using vFolders</title>
    <para>
    I have a vFolder set up for all the mail about a project I'm
    working on, and another one for all the mail from my friend Bernie.
    If Bernie sends me mail about the project, I can see that message both in the "Bernie" folder and in the "Project" folder.
    That's because when I open up the "Bernie" folder, I'm really performing a search for all the mail from Bernie, and when you open the 
    "Project" folder you're really performing a search for all the mail about the project.  That particular message 
    actually resides in some other folder,
    maybe just in my Inbox.  I can't delete it from the vFolder, because the vFolder is really a different view of my messages.
    When I delete it from
    the Inbox, I have also removed it from all my vFolders, because no search can find a deleted message.
    <!--this could use a cool picture of the Inbox and 2 vFolders with the message in all 3-->
    </para>
    </example>
    

    <sect2 id="mail_filters">
    <para>
    Filters sort your email for you, automatically.  You can access the Filter functions of
    the email client by <!--BLAH BLAH BLAH-->.
    </para>

    <para>    
    Email starts in your Inbox.  As it arrives, it is indexed and filtered from ther.  Any email
    that does not meet filter action criteria remains in the Inbox.   To create a filter,
     <!--open the menu somehow-->f you have filters enabled,
    </para>
    </sect2>
  </chapter>

  <chapter id="calendar">
  <title>Using the Calendar</title>
  <para>To begin using the calendar, select <guibutton>Calendar</guibutton>
  from the main navigational frame.  This will cause the calendar component of 
  <application>Evolution</application> to become active.  This is illustrated in
  the figure below:  
<!-- ==============Figure=================================== -->
    <figure id="contact_picture">
      <title>Evolution Contact Manager Window</title>
      <screenshot>
        <screeninfo>Evolution Contact Manager Window</screeninfo>
        <graphic fileref="SCREENSHOT" format="png"
        srccredit="ME">
        </graphic>
      </screenshot>
    </figure>
<!-- ==============End of Figure=================================== -->
</para>



  </chapter>
  <chapter id="addressbook">

</chapter>

<chapter>
<title>Administration and Large-scale setup</title>
</chapter>

</part><!--end of part two, Administration and Large-Scale Setup-->


    <appendix> ... </appendix>
    <appendix> ... </appendix>
<index> ... </index>
</book>

    
</chapter>

<chapter>
<title>Administration and Large-scale setup</title>
</chapter>

</part><!--end of part two, Administration and Large-Scale Setup-->


    <appendix> ... </appendix>
    <appendix> ... </appendix>
<index> ... </index>
</book>



  </chapter>


</part> <!--end of part one-->
 
<part id="configuration">
<title>Configuring Evolution</title>    

<chapter>
<title>The Preferences Dialog</title>

     <para>
      To change default settings, select
      <guimenuitem>Preferences</guimenuitem> command in
      <guimenu>Settings</guimenu> menu. This launches the
      <interface>Preferences dialog</interface>, shown in <xref
      linkend="shot2">. 
     </para>
<!-- ==============Figure=================================== -->
    <figure id="shot2">
      <title>Preferences Dialog</title>
      <screenshot>
        <screeninfo>Preferences dialog</screeninfo>
        <graphic fileref="SCREENSHOT" format="png"
        srccredit="ME">
        </graphic>
      </screenshot>
    </figure>
<!-- ==============End of Figure=================================== -->
    
<!--obviously there should be more description here.-->

</chapter>

<chapter>
<title>Administration and Large-scale setup</title>
</chapter>

</part><!--end of part two, Administration and Large-Scale Setup-->



<!-- =============APPENDICES============================= -->
  <appendix id="bugs">
   
    <title>Known bugs and limitations</title>
    <abstract>
    <para>
     This appendix describes known bugs and limitations of
    <application>Evolution</application>.  Please 
    contact the appropriate people if you find one we have not listed,
    or if you have a patch to fix one.
    <para>
    </abstract>

    <para>
      The program currently does not work.  At all.
    </para>
    </appendix>



<!-- =============Another Appendix============================= -->

  <appendix id="authors">
    <title>Authors</title>
     <para>
      <application>Evolution</application> was written by:

      Seth Alves: <email>alves@helixcode.com</email>
      Anders Carlsson<email>andersca@helixcode.com</email>
      Damon Chaplin:<email>damon@helixcode.com</email>
      Clifford R. Conover <email>rusty@zootweb.com</email>
      Miguel De Icaza: <email>miguel@helixcode.com</email>
      Arturo Espinoza <email>arturo@nucleu.unam.mx</email>
      Larry Ewing: <email>lewing@helixcode.com</email>
      Bertrand Guiheneuf: <email>bertrand@helixcode.com</email>
      Tuomas Kuosmanen: <email>tigert@gimp.org</email>
      Christopher J. Lahey: <email>clahey@helixcode.com</email>
      Matthew Loper:  <email>matt@helixcode.com</email>
      Dave Mason <email>dcm@redhat.com</email>
      Federico Mena: <email>federico@helixcode.com</email>
      Eskil Heyn Olsen<email>deity@eski.dk</email>
      Nat Friedman: <email>nat@helixcode.com</email>
      Ettore Perazzoli:<email>ettore@helixcode.com</email>
      Russell Steinthal: <email>rms39@columbia.edu</email>
      Peter Teichman: <email>peter@helixcode.com</email>      
      Chris Toshok: <email>toshok@helixcode.com</email>
      Radek Doulik: <email>rodo@helixcode.com</email>
      Dan Winship: <email>winship@helixcode.com</email>
      Michael Zucchi: <email>notzed@helixcode.com</email>

and other dedicated GNOME programmers. 
</para>
    <para>
      The<application>Evolution</application> code owes a great debt to
       <application>GNOME-pim</application>, <application>KHTMLW</application>
      and the developers of <application>Evolution</application> acknowledge the efforts and contributions of its members.
    </para>

   <para>
     For more information please visit <application>Evolution</application> <ulink
      url="http://www.helixcode.com/apps/evolution.php3" type="http">Web page</ulink>.
      Please send all comments, suggestions, and bug reports to the
      <ulink url="http://bugs.gnome.org" type="http">GNOME bug
      tracking database</ulink>. Instructions for submitting bug reports
      can be found on-line at <ulink
      url="http://bugs.gnome.org/Reporting.html" type="http">
      http://bugs.gnome.org/Reporting.html</ulink>. If you are using GNOME
      1.1 or later, you can also use command
      <command>bug-buddy</command> for submitting bug reports. 
    </para>
    <para>
      This manual was written by Aaron Weber
      (<email>aaron@helixcode.com</email>) with the help of the application programmers.
       Please send all comments
      and suggestions regarding the manual to the GNOME Documentation
      Project at <email>docs@gnome.org</email>. You can also add your
      comments online by using <ulink type="http"
      url="http://www.gnome.org/gdp/doctable/">GNOME Documentation
      Status Table</ulink>. 
    </para>
    <!-- For translations: uncomment this:
      <para> Latin translation was done by ME
      (<email>MYNAME@MYADDRESS</email>). Please send all comments
      and suggestions regarding this translation to SOMEWHERE.
     </para> 
     -->
    </appendix>


    <appendix> ... </appendix>
    <appendix> ... </appendix>
<index> ... </index>
</book>