<!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>
