+ * C/evo_book_0.1.sgml: new file (doc sgml)

+
+	* C/ : New directory for doc sgml & graphics

svn path=/trunk/; revision=2457

2 files changed, 455 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>
+
+
diff --git a/doc/ChangeLog b/doc/ChangeLog
index a2e752f9ec..8561476fd4 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2000-04-16  Aaron Weber  <aaron@helixcode.com>
+
+	* C/evo_book_0.1.sgml: new file (doc sgml)
+	
+	* C/ : New directory for doc sgml & graphics
+
 2000-03-05  Christopher James Lahey  <clahey@helixcode.com>
 
 	* white-papers/widgets/e-table.sgml: Added Miguel to the author