aboutsummaryrefslogtreecommitdiffstats
path: root/doc/C
diff options
context:
space:
mode:
Diffstat (limited to 'doc/C')
-rw-r--r--doc/C/evo_book_0.1.sgml449
1 files changed, 449 insertions, 0 deletions
diff --git a/doc/C/evo_book_0.1.sgml b/doc/C/evo_book_0.1.sgml
new file mode 100644
index 0000000000..357da80224
--- /dev/null
+++ b/doc/C/evo_book_0.1.sgml
@@ -0,0 +1,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>
+
+