diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/C/apx-gloss.sgml | 242 | ||||
| -rw-r--r-- | doc/C/config-prefs.sgml | 41 | ||||
| -rw-r--r-- | doc/C/config-setupassist.sgml | 3 | ||||
| -rw-r--r-- | doc/C/evolution-guide.sgml | 20 | ||||
| -rw-r--r-- | doc/C/fig/mail-druid-pic.png | bin | 0 -> 35959 bytes | |||
| -rw-r--r-- | doc/C/fig/mainwindow-pic.png | bin | 0 -> 145792 bytes | |||
| -rw-r--r-- | doc/C/preface.sgml | 36 | ||||
| -rw-r--r-- | doc/C/usage-contact.sgml | 15 | ||||
| -rw-r--r-- | doc/C/usage-mail.sgml | 253 | ||||
| -rw-r--r-- | doc/C/usage-mainwindow.sgml | 39 | ||||
| -rw-r--r-- | doc/C/usage-setup.sgml | 140 | ||||
| -rw-r--r-- | doc/ChangeLog | 31 |
12 files changed, 660 insertions, 160 deletions
diff --git a/doc/C/apx-gloss.sgml b/doc/C/apx-gloss.sgml new file mode 100644 index 0000000000..80f9b3f14b --- /dev/null +++ b/doc/C/apx-gloss.sgml @@ -0,0 +1,242 @@ + + +<glossary id="glossary"> + + <title>Glossary</title> + + <glossentry id="attachment"> + <glossterm>Attachment</glossterm> + <glossdef> + <para> + Any file sent with an e-mail for the reciever to download. + </para> + </glossdef> + </glossentry> + +<glossentry id="automatic-indexing"> + <glossterm>Automatic Indexing</glossterm> + <glossdef> + <para> + Pre-sorting procedure that allows + <application>Evolution</application> to refer to data quickly. + It enables faster searches and decreases memory usage for + data displays. + </para> + </glossdef> + </glossentry> + + <glossentry id="bcc"> + <glossterm>Bcc (Blind Carbon Copy)</glossterm> + <glossdef> + <para> + A way of addressing a message. Bcc is used to send a group of + people an e-mail, while hiding their names and addresses from each + other. + </para> + </glossdef> + </glossentry> + + <glossentry id="cc"> + <glossterm>Cc (Carbon Copy)</glossterm> + <glossdef> + <para> + Carbon-copies are used to send a 3rd party a copy of the e-mail, + so they an keep up to date on a conversation, without being in the + To: list. + </para> + </glossdef> + </glossentry> + + <glossentry id="druid"> + <glossterm>Druid</glossterm> + <glossdef> + <para> + A small program or script used to help configure or set up some + larger program. The <application>mail setup druid</application> + helps you ready your email system for use. Druids are the Linux + equivalent of "Assistants" and "Wizards." + </para> + </glossdef> + </glossentry> + + <glossentry id="evolution"> + <glossterm>Evolution</glossterm> + <glossdef> + <para> + <application>Evolution</application> is the <acronym> GNOME + </acronym> groupware application. + </para> + </glossdef> + </glossentry> + + <glossentry id="execute"> + <glossterm>Execute</glossterm> + <glossdef> + <para> + To run a program. Any file that can be run is called an + executable. In order to be execute program, a user must have + the proper permissions. + </para> + </glossdef> + </glossentry> + + <glossentry id="filter"> + <glossterm>Filter</glossterm> + <glossdef> + <para> + Within <application>Evolution</application>, a filter is a method + of sorting mail automatically. + </para> + </glossdef> + </glossentry> + + <glossentry id="forward"> + <glossterm>Forward</glossterm> + <glossdef> + <para> + By forwarding an e-mail, the user can send a third party a message + which was sent to the user originally. + </para> + </glossdef> + </glossentry> + + <glossentry id="groupware"> + <glossterm>Groupware</glossterm> + <glossdef> + <para> + Groupware is a term describing an application who has many + productivity features built into one program. + </para> + </glossdef> + </glossentry> + + <glossentry id="haiku"> + <glossterm>Haiku</glossterm> + <glossdef> + <para> + A Japanese form of poetry. Haiku are unrhymed, and + three lines long. The first and last lines should have five + syllables, and the second line seven syllables. The subject + matter is traditionally related to the seasons. + </para> + </glossdef> + </glossentry> + + <glossentry id="html"> + <glossterm>HTML</glossterm> + <glossdef> + <para> + Hyper-text Markup Language(<acronym>HTML</acronym>) is the layout + language which all webpages are written in. HTML can be used + inside of e-mails to insert images, justfiy text different ways, + and even include webpages inside the e-mail itself. + </para> + </glossdef> + </glossentry> + + <glossentry id="hot-key"> + <glossterm>Hot Key</glossterm> + <glossdef> + <para> + Hot-keys are keyboard combinations used to do actions on a + computer instead of using the mouse to do the same action. + Hot-keys can speed up computer usage. + </para> + </glossdef> + </glossentry> + + <glossentry id="ical"> + <glossterm>iCal</glossterm> + <glossdef> + <para> + <application>iCal</application> is the program which + <application>Evolution</application> uses to manage the calendar + section. + </para> + </glossdef> + </glossentry> + + <glossentry id="live-doc"> + <glossterm>Live Document</glossterm> + <glossdef> + <para> + A document embedded in or attached an email message that + contains scripting or other active contents. For example, a + <application>Gnumeric</application> spreadsheet page could be + included in a message, and the recipient could alter some of the + data from within <application>Evolution</application> without + having to start another program. + </para> + </glossdef> + </glossentry> + + <glossentry id="mail-client"> + <glossterm>Mail Client</glossterm> + <glossdef> + <para> + A mail client is the application which a user reads and sends + their e-mail with. + </para> + </glossdef> + </glossentry> + + <glossentry id="nautilus"> + <glossterm>Nautilus</glossterm> + <glossdef> + <para> + <application>Nautilus</application> is the next generation file + manager for <acronym>GNOME</acronym> being written by Eazel. + </para> + </glossdef> + </glossentry> + + <glossentry id="nickname"> + <glossterm>Nickname</glossterm> + <glossdef> + <para> + An alias for an e-mail address. + </para> + </glossdef> + </glossentry> + + <glossentry id="script"> + <glossterm>Script</glossterm> + <glossdef> + <para> + A program which is written in an interpreted language, which can + be executed. + </para> + </glossdef> + </glossentry> + + <glossentry id="shortcut-bar"> + <glossterm>Shortcut Bar</glossterm> + <glossdef> + <para> + The <interface>Shortcut Bar</interface> is where the user accesses + all the components of <application>Evolution</application> from. + </para> + </glossdef> + </glossentry> + + <glossentry id="spam"> + <glossterm>Spam</glossterm> + <glossdef> + <para> + Spam: useless e-mail. Spam normally comes in forms of + chain-letters and advertisements for websites or services. + </para> + </glossdef> + </glossentry> + + <glossentry id="vfolder"> + <glossterm>vFolder</glossterm> + <glossdef> + <para> + vFolders allow an e-mail to be shared among multiple folders, so + it appears that theres a copy of the e-mail in each folder. + </para> + </glossdef> + </glossentry> + +</glossary> diff --git a/doc/C/config-prefs.sgml b/doc/C/config-prefs.sgml index 67ca0e7577..8ca4dbbc7d 100644 --- a/doc/C/config-prefs.sgml +++ b/doc/C/config-prefs.sgml @@ -2,10 +2,11 @@ <chapter id="config-prefs"> <title>Advanced Configuration with the Preferences Window</title> <para> - If you prefer not to use the setup assistant, select + To change your configuration settings, select <guimenuitem>Preferences</guimenuitem> from the - <guimenu>Settings</guimenu> menu, and work your way through - the page tabs it offers you. They are: + <guimenu>Settings</guimenu> menu. This will open the + preferences window, illustrated in <xref linkend="config-prefs-fig">. + Preferences are seperated into several categories: <itemizedlist> <listitem> <para> @@ -17,37 +18,31 @@ <listitem> <para> - <guilabel>Network</guilabel>, which allows you to - specify your network settings. There are no default - values for this information. - </para> - </listitem> - - <listitem> - <para> <guilabel>Mail</guilabel>, which allows you to specify - attachment and HTML handling, forwarding behavior, - filters, and other <application>Evolution</application> - behaviors specific to email. The default behaviors are - those approved by Jamie Zawinski. + your email server and protocols, as well as attachment + and HTML handling, forwarding behavior, filters, and + other <application>Evolution</application> behaviors + specific to email. The default behaviors are those + approved by Jamie Zawinski. </para> </listitem> <listitem> <para> <guilabel>Contacts</guilabel>, which allows you to - specify behavior that is specific to your contact - manager. + control addressbook sharing as well as other funcctions + specific to your contact manager. </para> </listitem> <listitem> <para> <guilabel>Calendar</guilabel>, which allows you to set - the way that your calendar will behave and appear. The - default view is by week and the default calendar is - Western. Date format is determined by the system clock - and localization, and cannot be set here. + up calendar networking, as well as the way that your + calendar will behave and appear. The default view is by + week and the default calendar is Western. Time and + date are determined by the system clock and + localization, and cannot be set here. </para> </listitem> @@ -60,9 +55,7 @@ </listitem> </itemizedlist> - The <interface>Preferences Dialog</interface> is shown in - <xref linkend="config-prefs-fig">. - </para> + </para> <!-- ==============Figure===================== --> <figure id="config-prefs-fig"> diff --git a/doc/C/config-setupassist.sgml b/doc/C/config-setupassist.sgml index 03b85ea12c..f33cc81de2 100644 --- a/doc/C/config-setupassist.sgml +++ b/doc/C/config-setupassist.sgml @@ -14,3 +14,6 @@ screenshot or two. </para> </chapter> + + + diff --git a/doc/C/evolution-guide.sgml b/doc/C/evolution-guide.sgml index 3e6b374fca..9df4a2a170 100644 --- a/doc/C/evolution-guide.sgml +++ b/doc/C/evolution-guide.sgml @@ -13,9 +13,11 @@ <!ENTITY DEVEL-ACTION SYSTEM "devel-action.sgml"> <!ENTITY DEVEL-SCRIPT SYSTEM "devel-script.sgml"> <!ENTITY DEVEL-COMPONENT SYSTEM "devel-component.sgml"> +<!ENTITY APX-GLOSS SYSTEM "apx-gloss.sgml"> <!ENTITY APX-BUGS SYSTEM "apx-bugs.sgml"> <!ENTITY APX-AUTHORS SYSTEM "apx-authors.sgml"> <!ENTITY APX-FDL SYSTEM "apx-fdl.sgml"> + ]> @@ -65,7 +67,6 @@ standardize on second person, not 1st pers. plural. </para> </partintro> - &USAGE-SETUP; &USAGE-MAINWINDOW; &USAGE-MAIL; &USAGE-CONTACT; @@ -101,8 +102,8 @@ standardize on second person, not 1st pers. plural. There are three levels of developing for <application>Evolution</application>. You can write actions. You can write scripts. And you can write full-fledged - Evolution components. INSERT CONTENT: paragraph should describe the - differences. + Evolution components. This paragraph will eventually + desfcribe what that means. </para> </partintro> @@ -110,9 +111,20 @@ standardize on second person, not 1st pers. plural. &DEVEL-SCRIPT; &DEVEL-COMPONENT; </part> - + &APX-GLOSS; &APX-BUGS; &APX-AUTHORS; &APX-FDL; </book> + + + + + + + + + + + diff --git a/doc/C/fig/mail-druid-pic.png b/doc/C/fig/mail-druid-pic.png Binary files differnew file mode 100644 index 0000000000..f29f3e77be --- /dev/null +++ b/doc/C/fig/mail-druid-pic.png diff --git a/doc/C/fig/mainwindow-pic.png b/doc/C/fig/mainwindow-pic.png Binary files differnew file mode 100644 index 0000000000..b7c6067449 --- /dev/null +++ b/doc/C/fig/mainwindow-pic.png diff --git a/doc/C/preface.sgml b/doc/C/preface.sgml index 05129eb550..9ccb257e5e 100644 --- a/doc/C/preface.sgml +++ b/doc/C/preface.sgml @@ -82,7 +82,7 @@ by email, or to send email to a contact or appointment. <application>Evolution</application> makes displays faster and more efficient, so searches are faster and memory usage is - much lower. People who get lots of mail will appreciate + lower. People who get lots of mail will appreciate advanced features like <link linkend="usage-mail-organize-vFolders">vFolders</link>, which let you save searches as though they were ordinary mail @@ -93,16 +93,20 @@ <section id="aboutbook"> <title>About This Book</title> - <!-- ************** FOLLOWING PARAGRAPH FOR DRAFT ONLY ************* --> <para> - This is a DRAFT of the <application>Evolution</application> - User's Guide. Please send comments on it to - <email>aaron@helixcode.com</email>. Items that are known to - need action are indicated as such, often with notation like - (INSERT CONTENT HERE). If you have content to add, please - contact me. This paragraph will be removed in later versions - of the manual. + This version of the <application>Evolution</application> + User's Guide is a <emphasis>draft</emphasis>. It is missing + huge chunks of information, and many of the features it + describes are unimplemented. All the content is subject to + change, especially if you help. Please send comments on the + guide to <email>aaron@helixcode.com</email>. Items that are + known to need action are indicated as such, often with + notation like (INSERT CONTENT HERE). If you would like to + work on the guide please contact me or see the GNOME + Documentation project <ulink + url="http://www.gnome.org/gdp">web site</ulink>. This + paragraph will be removed in later versions of the manual. </para> <!-- ************* END DRAFT ONLY PARAGRAPH ************** --> @@ -138,12 +142,18 @@ It's listed below: <simplelist> <member><application>Applications</application></member> - <member><command>Commands</command></member> - <member><guilabel>Labels</guilabel>for menu items and buttons</member> + <member><command>Commands</command> typed at the command line</member> + <member><guilabel>Labels</guilabel> for menu items and buttons</member> + <member>Other text treatments</member> <member>Other text treatments</member> - <member>more info here</member> </simplelist> </para> </formalpara> </section> - </preface>
\ No newline at end of file + </preface> + + + + + + diff --git a/doc/C/usage-contact.sgml b/doc/C/usage-contact.sgml index f88a3d5791..6cc9cd605f 100644 --- a/doc/C/usage-contact.sgml +++ b/doc/C/usage-contact.sgml @@ -45,7 +45,7 @@ </para> <para> Describe the interface. Include the fact that the - whole book consists of a set of cards, organized into + whole address book consists of a set of cards, organized into folders. </para> </sect1> @@ -194,7 +194,7 @@ </sect1> <sect1 id="usage-contact-sharing"> - <title>Sharing your cards (Or Keeping them to Yourself)</title> + <title>Sharing your Cards (and keeping them to yourself)</title> <para> Cards can be shared over a network. This is the sort of feature you'll want to use if your company has a list of @@ -213,7 +213,11 @@ contacts there, so I know whom to call. Since we also share the calendars, I know that Deanna has already scheduled a meeting with them next Thursday, and I can - just ask her to bring up my concerns at the meeting. + either go to the meeting myself or ask Deanna to + discuss my concerns for me. Either way, I avoid + having to schedule yet another meeting with Company X, + which is good since everybody hates their products and + they're doomed to fail anyway. </para> </example> @@ -225,9 +229,9 @@ decide which folders you want to make accessible to others. </para> <para> - To begin sharing a folder of address cards, select <!-- + To begin sharing a folder of address cards, select (something) <!-- DESCRIBE PROCESS HERE -->. The - <interface>Sharing</interface> will pop up. It contains: + <interface>Sharing</interface> window will pop up. It contains: <!--DESCRIBE INTERFACE HERE--> </para> </sect1> @@ -241,6 +245,7 @@ mailing lists, you'll find that the contact manager is more than a mere address book. </para> + <sect2 id="contact-automation-basic"> <title>Send me a card: Adding New Cards Quickly</title> <para> diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index c81c384cfb..88e92756fe 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -1,6 +1,6 @@ <chapter id="usage-mail"> - <title>Evolution Mail: Witty Phrase to Come Later</title> + <title>Evolution Mail</title> <abstract> <title> An Overview of the Evolution Mailer</title> <para> @@ -8,7 +8,24 @@ <application>Evolution</application> mail is here to help you keep track of it. <application>Evolution</application> email is like other email programs in all the ways you would - hope: (INSERT GOOD SIMILARITIES). + hope: + <itemizedlist> + <listitem> + <para> + Item: Description + </para> + </listitem> + <listitem> + <para> + Item: Description + </para> + </listitem> + <listitem> + <para> + Item: Description + </para> + </listitem> + </itemizedlist>. </para> <para> However, <application>Evolution</application> has some @@ -28,7 +45,9 @@ <para> You can start reading email by clicking - <guibutton>Inbox</guibutton> in the shortcut bar. + <guibutton>Inbox</guibutton> in the shortcut bar. By + default, the <interface>Inbox</interface> is open when you + start <application>Evolution</application>. </para> </abstract> @@ -42,7 +61,7 @@ <guilabel>Inbox</guilabel>, you will see a window like the one in <xref linkend="usage-mail-intro-fig">, with a message from Helix Code in the<interface> message - list</interface>. A preview of the message is displayed + list</interface>. The message is displayed below that, in the <interface>view pane</interface>. If you find the<interface> view pane</interface> too small, you can double-click on the message in the @@ -69,14 +88,16 @@ <title>Evolution Mail</title> <screenshot> <screeninfo>Evolution Mail</screeninfo> - <graphic fileref="mail-intro-pic" format="png" srccredit="Aaron Weber"> + <graphic fileref="fig/mainwindow-pic" format="png" srccredit="Aaron Weber"> </graphic> </screenshot> </figure> <!-- ==============End of Figure=================================== --> </para> </sect2> - + + &USAGE-SETUP; + <sect2 id="usage-mail-getnsend-get"> <title>Getting Mail</title> <para> @@ -88,12 +109,12 @@ <interface>Inbox</interface> and also in the <interface>Today View</interface>. </para> + <para> - If you get an error message, you probably need to - change your network preferences. To do that, you can run - the setup assistant again, have a look at <xref - linkend="config-prefs-network">, or ask your system - administrator. + If you get an error message, you probably need to change + your network preferences. To learn how to do that, have a + look at <xref linkend="config-prefs-network">, or ask your + system administrator. </para> <sect3 id="usage-mail-getnsend-get-attach"> @@ -101,22 +122,24 @@ <para> If you receive a file attached to an email, <application>Evolution</application> will ask where you - want to put it. Once you've downloaded it, you can - open, move, copy, or execute those files just like any - others, using <application>Nautilus</application> or - your favorite shell or file manager. + want to put it. Once you've downloaded a file, you can + open, move, copy, or execute it just like any other, + using <application>Nautilus</application> or your + favorite shell or file manager. </para> + <para> <application>Evolution</application> can also display HTML-formatted mail, complete with graphics. HTML formatting will display automatically, although you can turn it off if you prefer. </para> + <para> It can also display <glossterm>live documents</glossterm>, which have scripted or executable contents— for example, a working - spreadsheet page or a chess game. + spreadsheet page or a chess game. </para> <tip id="badidea-attachment"> <title>Bad Idea</title> @@ -181,8 +204,9 @@ </para> <para> - There is more to sending mail, though. In the - next few sections, we'll go over additional features, + There is quite a bit more to sending mail, though. In the + next few sections, you'll see how + <application>Evolution</application> handles additional features, including mailing lists, attachments, and forwarding. </para> @@ -237,15 +261,27 @@ to send mail to several people without sharing the recipient list, you should use <guilabel>BCc:</guilabel>. "BCc" stands for "Blind - Carbon Copy", and means that addresses in the - <guilabel>BCc:</guilabel> field will receive copies of - the message, but they will not receive the list of the - other recipients' addresses, nor will other recipients - know that they have recieved the message. When I send a - generic message to all my friends and I want them to - think I've written a personalized email to every one of - them, I put them all in the <guilabel>BCc:</guilabel> - list. + Carbon Copy", and means that people listed in the + <guilabel>BCc:</guilabel> are excluded from the + recipient list, although they will receive the message + and the list of addresses from the + <guilabel>To:</guilabel> and <guilabel>Cc:</guilabel> + fields. + + <example id="ex-mail-bcc"> + <title>Using the BCc: field</title> + <para> + Let's say Tim sends an email to a client, and wants + his supervisor to know what he wrote. He doesn't, + however, want the client to start writing his + supervisor about the project— it's Tim's job + to deal with the client. So Tim puts his + supervisor's email address in the + <guilabel>BCc:</guilabel> field. That way, the + client has one contact, and the boss stays in the + loop. + </para> + </example> </para> </sect3> @@ -289,21 +325,24 @@ <guimenu>MENU</guimenu> menu. This will allow you to choose one or several of the other message recipients in addition to the person who originally sent you the - message. + message. If there are large numbers of people in the + <guilabel>Cc:</guilabel> or <guilabel>To:</guilabel> + fields, this can save substantial amounts of time. In + addition, Reply-To makes it very easy to keep off-topic + conversation away from mailing lists and newsgroups. <example> <title>Using the Reply-To feature</title> <para> - Returning to the previous example, the client can - decide whether to reply just to Susan, just to Tim, - or to both of them by selecting a menu item, rather - than by cutting and pasting the email addresses. If - there are large numbers of people in the Cc: fields, - this can save substantial amounts of time. + Returning again to the email Susan sent to Tim and + their client, you'll note that the Reply-To feature + allows the client to decide whether to reply just to + Susan, or to both Tim and Susan by selecting + a menu item, rather than by cutting and pasting the + email addresses. </para> </example> </para> </sect3> - <sect3 id="usage-mail-getnsend-send-fancy"> <title>Embellishing that email</title> @@ -315,7 +354,6 @@ spreadhseets or chess games. This section will tell you how. </para> - <sect4 id="usage-mail-getnsend-send-html"> <title>Colors, pictures, and fonts with HTML Mail</title> @@ -340,7 +378,7 @@ role="html"><BR>Bold Text</BR></markup>, the the composer will assume you meant exactly that, and not "make this text bold," as a HTML composition - tool would. For the technically inclined, that + tool would. For the very technically inclined, that means that when the text <markup role="html"><BR></markup> is sent as HTML, it will be converted to the string @@ -349,16 +387,18 @@ </note> <para> Some people do not have HTML-capable mail clients, or - prefer not to receive HTML-enhanced mail because it - is slower to download and display. Some people refer - to HTML mail as "the root of all evil" and get very - angry if you send them HTML mail, which is why the - default in <application>Evolution</application> is - plain text. If you have an address book entry for - someone who does not wish to receive HTML-enhanced - mail, you can note that preference in their address - card. The mailer will automatically strip the HTML - tags from any messages you send to that address. + prefer not to receive HTML-enhanced mail because it is + slower to download and display. + <emphasis>Some</emphasis> people refer to HTML mail as + "the root of all evil" and get very angry if you send + them HTML mail, which is why the default in + <application>Evolution</application> is plain text. + If you choose to send HTML mail, but have an address + book entry for someone who does not wish to receive + HTML-enhanced mail, you can note that preference in + their address card. The mailer will automatically + strip the HTML tags from any messages you send to that + address. </para> </sect4> @@ -369,15 +409,15 @@ you can do so by <!--describe process here-->. If your recipients can read HTML mail, you can put an image inside the mail by dragging the file into the - composer window, or by selecting (INSERT DESCRIPTION - HERE) (IS THIS CORRECT?). Still, unless you know what - email client the recipient is using, it's best to send - a message or attachment in the simplest manner - possible. + composer window, or by selecting <guimenuitem>Menu + Item</guimenuitem> from the <guimenu>Menu</guimenu> + menu. Still, unless you know what email client the + recipient is using, it's best to send a message or + attachment in the simplest manner possible. </para> </sect4> <sect4 id="usage-mail-getnsend-send-live"> - <title></title> + <title>Live Documents</title> <para> Later versions of <application>Evolution</application> will allow you to enliven your email with almost any @@ -529,7 +569,53 @@ of what those terms mean) </para> <para> - (INSERT the way one creates a search and so forth) + To create a search, enter the word or phrase you're + looking for in the form field below the toolbar, and + choose a search type: + <itemizedlist> + <listitem> + <para> + <guilabel>Body or subject contains:</guilabel> This + will search message subjects and the messages + themselves for the word or phrase you've entered in + the search field. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Body contains:</guilabel> This will search + only in message text, not the subject lines. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Subject contains:</guilabel> This will + show you messages where the search text is in the + subject line. It will not search in the message body. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Body does not contain:</guilabel> This + finds every email message that does not have the + search text in the message body. It will still show + messages that have the search text in the subject + line, if it is not also in the body. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Subject does not contain:</guilabel>This + finds every mail whose subject does not + contain the search text. + </para> + </listitem> + </itemizedlist> + </para> </sect2> @@ -611,26 +697,59 @@ <sect2 id="usage-mail-organize-filters"> <title>Staying organized: Mail Filters in Evolution</title> <para> - Filters sort your email for you as it arrives in your - Inbox, so you don't have to sort them all yourself. - People who subscribe to multiple mailing lists find - filters especially helpful to sort personal from - list-related mail. To create a filter, go to your - <interface>Inbox</interface>. Then select BLAH BLAH BLAH. - This will open the <interface>filters</interface> window. + Filters sort your email for you. People who subscribe to + multiple mailing lists, or who often need to refer to + messages they have sent, find filters especially helpful + to seperate personal from list-related mail, but they're + good for anybody who gets more than a few messages a day. + To create a filter, go to your + <interface>Inbox</interface>. Then select + <guimenuitem>Filter Druid</guimenuitem> from the + <guimenu>Tools</guimenu> menu. This will start the a + <glossterm> druid</glossterm>, which will allow you to + create filters. </para> - <para> - The <interface>filters</interface> window contains the - following items: <!--DESCRIBE INTERFACE--> + <para> The <interface>filter druid</interface> window + contains a window listing rules, and an option to create a + new rule. To start filtering your mail, click + <guibutton>Add</guibutton> to add a filtering rule. + You'll decide when it should take place: + <itemizedlist> + <listitem> + <para> + <guilabel>When mail arrives:</guilabel> new mail + arrives in the Inbox, and you can filter it from + here. + </para> + </listitem> + <listitem> + <para> + <guilabel> When mail is sent:</guilabel> When you + send mail, you can perform additional actions on + it— perhaps you keep your Outbox sorted into + subfolders. + </para> + </listitem> + </itemizedlist> </para> - + + <para> + Then, the filter druid will ask you which emails it should + act upon. You can set criteria to include words or phrases + in the subject, To:, Cc: or body of the message. Once + you've decided which messages to filter, the druid will ask + you the sort of action you wish to take. More details and + screenshots should follow here. + </para> + + <note> <title>Two Notable Filter Features</title> <para> <itemizedlist> - <listitem><para>Any email that does not meet filter - action criteria remains in the Inbox. </para> + <listitem><para>Any incoming email that does not meet + filter action criteria remains in the Inbox. </para> </listitem> <listitem><para>If you move a folder, your filters diff --git a/doc/C/usage-mainwindow.sgml b/doc/C/usage-mainwindow.sgml index 8470189977..3dc91e5a97 100644 --- a/doc/C/usage-mainwindow.sgml +++ b/doc/C/usage-mainwindow.sgml @@ -3,18 +3,23 @@ <title>The Main Window: Evolution Basics</title> <para> - After <application>Evolution</application> starts up, you will - see the <interface>main window</interface>, which looks a lot - like in <xref linkend="usage-mainwindow-fig">. On the left of - the <interface>main window</interface> are the - <interface>shortcut bar</interface> and the - <interface>tree-view</interface>. Just underneath the title - bar is a series of menus in the <interface>menu - bar</interface>, and below that, the <interface>tool - bar</interface> with buttons for different functions. The - largest part of the <interface>main window</interface> is - taken up by a welcome message. <!-- para does not end here - but after fig! --> + + Start <application>Evolution</application> by selecting + <guimenuitem>Evolution</guimenuitem> from the + <guisubmenu>Applications</guisubmenu> of the <guimenu>Main + Panel Menu</guimenu>, or by typing + <command>evolution</command> at the command-line.After + <application>Evolution</application> starts up, you will see + the <interface>main window</interface>, which looks a lot like + in <xref linkend="usage-mainwindow-fig">. On the left of the + <interface>main window</interface> are the <interface>shortcut + bar</interface> and the <interface>tree-view</interface>. + Just underneath the title bar is a series of menus in the + <interface>menu bar</interface>, and below that, the + <interface>tool bar</interface> with buttons for different + functions. The largest part of the <interface>main + window</interface> is taken up by a welcome message. <!-- + para does not end here but after fig! --> <!-- ==============Figure=================================== --> @@ -25,10 +30,10 @@ forth. Can these things be labelled with little arrows & stuff? --> <figure id="usage-mainwindow-fig"> - <title>Evolution Main Window</title> + <title>Evolution Main Window and Inbox</title> <screenshot> <screeninfo>Evolution Main Window</screeninfo> - <graphic fileref="mainwindow-pic" format="png" srccredit="Aaron Weber"> + <graphic fileref="fig/mainwindow-pic" format="png" srccredit="Aaron Weber"> </graphic> </screenshot> </figure> @@ -189,14 +194,14 @@ forth. Can these things be labelled with little arrows & stuff? </para> <para> - (CHANGE that title! THIS SECTION BELONGS SOMEWHERE ELSE!) You can drag the folders inside the tree view to change their order or put one folder inside another. To delete a folder, you can drag it into the trash folder. The same goes for individual messages, appointments, and address cards, whether they're in the <interface>tree view</interface> or not: drag them where you want them, and - they will go there. (IS THIS TRUE?) + they will go there. +<!-- ****This paragraph could use some work**** --> </para> <para> You can also use the <guimenu>right-click menu</guimenu> to @@ -211,4 +216,4 @@ forth. Can these things be labelled with little arrows & stuff? already. </para> </sect1> - </chapter>
\ No newline at end of file + </chapter> diff --git a/doc/C/usage-setup.sgml b/doc/C/usage-setup.sgml index 1290b000bb..3e793fdbcd 100644 --- a/doc/C/usage-setup.sgml +++ b/doc/C/usage-setup.sgml @@ -1,46 +1,126 @@ - <chapter id="usage-setup"> - <title>A Quick Start</title> + <sect2 id="usage-setup"> + <title>Mail Setup</title> <para> - Start <application>Evolution</application> by selecting - <guimenuitem>Evolution</guimenuitem> from the - <guisubmenu>Applications</guisubmenu> of the <guimenu>Main - Panel Menu</guimenu>, or by typing - <command>evolution</command> at the command-line. If this is - the first time you have run - <application>Evolution</application>, you'll be asked if you - want help setting up your email preferences. If you don't - plan to use email, or if you'd rather configure your email - preferences later, select <guibutton>No</guibutton>, and it - will go away. You can configure your email preferences later - by selecting SOMETHING from SOME MENU. + The first time you try to send or receive mail with + <application>Evolution</application>, the <interface>mail + setup druid</interface> will pop up to help you + set up your email preferences. If you don't plan to use + email, or if you'd rather configure your email preferences + later, click <guibutton>Cancel</guibutton>. </para> <para> - If you answer yes, it will guide you through the network - configuration process. It will ask you for the following - information: (FLESH OUT THIS LIST!) + The setup <glossterm>druid</glossterm> + 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 druid is pictured in <xref + linkend="usage-setup-fig">. + +<!-- ==============Figure=================================== --> + + <figure id="usage-setup-fig"> + <title>Mail Setup Druid</title> + <screenshot> + <screeninfo>Evolution Main Window</screeninfo> + <graphic fileref="fig/mail-druid-pic" format="png" srccredit="Aaron Weber"> + </graphic> + </screenshot> + </figure> +<!-- ==============End of Figure=================================== --> + + + + The druid will ask you for the following information: <itemizedlist> - <listitem> <para> - Name— Your full name: eg. William Blake - </para></listitem> - - <listitem><para> - UserName— Your user or account name: eg. wblake - </para></listitem> - <listitem><para> - Type of Server— POP vs. SMTP vs.... - </para></listitem> + <listitem> <para> <guilabel>Name— </guilabel> Your + full name: eg. Eva Lucianne Tester </para></listitem> + + <listitem><para> <guilabel>Email address&mdash</guilabel>; + Your email address: eg. eltester@helixcode.com + </para></listitem> + + <listitem> + <para> + <guilabel> Organization—</guilabel> Any + organization you represent. Leave this blank if you + wish. + </para> + </listitem> + + <listitem><para> <guilabel>Signature File—</guilabel> A text + file appended to any email you send, typically your name + and email address, or a quotation you like. It should be + under three lines of text.</para></listitem> <listitem> <para> - TERM— DESCRIPTION + <guilabel>Mail source type—</guilabel> + <application>Evolution</application> supports two mail + sources: POP servers, the most common email server type, + and UNIX-style MBOX files. Ask your system + administrator which one you use. </para> </listitem> <listitem> <para> - TERM— DESCRIPTION + <guilabel>Server—</guilabel> This should be the + name of your mail server, eg. + mailserver.organization.org + </para> + </listitem> + + <listitem> + <para> + <guilabel> Username— </guilabel>Usually, this is + the part of your email address before the @ character, + and <application>Evolution</application> has selected + that value as the default. If you have a different + username, you can enter it here. + </para> + </listitem> + + <listitem> + <para> + <guilabel>Authentication—</guilabel> 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> + </listitem> + + + <listitem> + <para> + <guilabel>Mail Transport—</guilabel> This is the + mail sending protocol you will want to use. Sendmail is + the default. </para> </listitem> </itemizedlist> </para> - </chapter>
\ No newline at end of file + <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> + </sect2> + + + + + + + + + + + + + + + + + + + diff --git a/doc/ChangeLog b/doc/ChangeLog index f20a7856f7..3f83d88d05 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,34 @@ +2000-05-26 Aaron Weber <aaron@helixcode.com> + + * C/fig/mainwindow-pic.png: new file + * C/fig/mail-druid-pic.png: new file + * C/fig: New directory, for figure graphics. + + * C/apx-gloss.sgml: new file. glossary. thx. to kevin from chicago. + + * C/usage-setup.sgml: More accurate description of druid, and + moved to mail section-- see usage-mail.sgml entry. This is a new + location for this entity, and it may move more later. + + + * C/usage-mainwindow.sgml: altered description of starting + evolution. added screenshot for main-window picture. + + * C/usage-mail.sgml: added screenshots, added coverage of setup + druid and put it into get-and-send section, which is probably not + where it should stay. Also started filter druid coverage and + clarified examples, esp. in Bcc: section. + + * C/usage-contact.sgml: Clarified examples. + + * C/preface.sgml: rewording of "what is" and "about book" sections. + + * C/evolution-guide.sgml: added glossary entity APX-GLOSS, altered + phrasing in part intros, changed order of Setup-assistant section. + + * C/config-prefs.sgml: changed wording, removed ref. to re-running + setup assistant. + 2000-05-18 Aaron Weber <aaron@helixcode.com> * C/evo_book_0.1.sgml: removed. |
