From 07052702e460c9739ab71fd11e3101feb012c55f Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Fri, 25 Aug 2000 07:26:52 +0000 Subject: Redid filter and vFolder assistant descriptions. 2000-08-25 Aaron Weber * C/usage-mail.sgml: Redid filter and vFolder assistant descriptions. * C/fig/filter-new-fig.png: Replaced with new assistant pic. * C/fig/filter-assist-fig.png: New file, showing only assistant. * C/apx-menuref.sgml: Finished message composer and calendar editor menus. Looked at Contact Editor menus and decided to document those features after implementation. svn path=/trunk/; revision=5033 --- doc/C/apx-gloss.sgml | 2 +- doc/C/apx-menuref.sgml | 413 ++++++++++++++++++++++++++++++++++++++++--- doc/C/fig/filter-new-fig.png | Bin 11861 -> 11735 bytes doc/C/usage-mail.sgml | 345 ++++++++++++++++++++++++------------ doc/ChangeLog | 14 ++ 5 files changed, 641 insertions(+), 133 deletions(-) (limited to 'doc') diff --git a/doc/C/apx-gloss.sgml b/doc/C/apx-gloss.sgml index 55ab3ed8a1..0f1b73ff09 100644 --- a/doc/C/apx-gloss.sgml +++ b/doc/C/apx-gloss.sgml @@ -1,4 +1,4 @@ - + Glossary diff --git a/doc/C/apx-menuref.sgml b/doc/C/apx-menuref.sgml index fd3ad4f65d..f47a921e31 100644 --- a/doc/C/apx-menuref.sgml +++ b/doc/C/apx-menuref.sgml @@ -314,7 +314,7 @@ for embedding files and other items in messages. Here's what's in them: - The Message Composer File Menu + The Message Composer's File Menu @@ -375,7 +375,7 @@ - The Message Composer Edit Menu + The Message Composer's Edit Menu The Edit menu in the message composer contains the following items. Keyboard shortcuts are listed @@ -466,36 +466,101 @@ This item brings up the Message Composer Properties Capplet, a portion of the GNOME Control Center that determines the key bindings for the message composer. Help for this capplet is - available directly from the Control Center. (FIXME: Write that help doc too). + available directly from the Control Center. + (FIXME: Write that help doc too) (FIXME: this is in the wrong place!) - - + + Image + + This tool will prompt you to select an image file to + insert into your HTML message. For text messages, this + is the same as attaching an image file. + + + + Link + + Opens the link creation window, + which lets you specify the URL and text description + for a link in your message. This only works with HTML + messages. + + + + Rule + + Opens the horizontal rule creation dialog, which lets you + create an HTML horizontal rule. For more information, + see . + This tool only works with HTML messages. + + + + Text File + + Open a text file and insert it into the current message. + This tool works with both plain text and HTML messages. + + + + + - + The Calendar Menus The Main window of the calendar has the same menus as the main @@ -584,6 +649,7 @@ + The Calendar Tools Menu @@ -602,10 +668,312 @@ The Appointment Editor Menus - Kevin might do this section. + FIXME: Insert Content Here. + + + The Appintment Editor's File Menu + + This menu contains several items, including a New + that is identical to that in the + main window's file menu. + Its other contents are: + + + + Send + + Opens a mail message with the appointment attached to it. + + + + + + Save + + Save this appointment in the existing location and name. If you have not yet + chosen a location and name, this is the same as Save As. + + + + + + Save As + + Choose a location and name for this appointment, and save it. + + + + + Delete + + Deletes the appointment. + + + + + Move to Folder + + Chose a folder, and move the appointment into it. + + + + + + Copy to Folder + + Chose a folder, and put a copy of the appointment into it. + + + + + + Page Setup Submenu + + This menu contains two items: + + + Memo Style — + FIXME: What does this do? + + + + Define Print Styles — + FIXME: What does this do? + + + + + + + Print Preview + + Shows you what your appointment will look like if you print it. + + + + + + Print + + Prints the appointment without preview. + + + + + + Properties + + FIXME: What does this do? + + + + + + Close + + Close the appointment editor window. + + + + + + + + The Appintment Editor's Edit Menu + + FIXME: this menu is copied and pasted entirely from somewhere + else. + + + + + The Appintment Editor's View Menu + + This menu allows you to look at different appointments, and + set the way you look at them, without having to move back to + the Main Window. It contains: + + + + Previous + + The items in this submenu will take you to appointments + prior to the current one. (FIXME: describe). + + + + + Next + + The items in this submenu will take you to appointments + scheduled to occur after the current one. (FIXME: describe). + + + + + Calendar + + FIXME: What does this item do? + + + + + Toolbars + + The Toolbars submenu + allows you to choose which toolbars + are displayed in the + Appointment Editor. They are: + + + Standard — + Toggle the standard toolbar on and off. + + + + Formatting — + Toggle the formatting toolbar on and off. + + + + Customize — + Select the contents of the formatting and standard toolbars. + + + + + + + + + + The Appintment Editor's Insert Menu + + This menu contains: (FIXME: Insert Content Here) + + + File + + Choose a file to append to your appointment or appointment request. + + + + + + Item + + FIXME: ? + + + + + + Object + + FIXME: ? + + + + + + + + The Appintment Editor's Format Menu + + This menu contains two items, neither of which + have any functionality yet: + + + Font + + FIXME: ? + + + + + + Paragraph + + FIXME: ? + + + + + + + + The Appintment Editor's Tools Menu + + + This menu contains four items, none of which + have any functionality yet: + + + Item + + FIXME: ? + + + + + Item + + FIXME: ? + + + + + + + + The Appintment Editor's Actions Menu + + This menu contains: + + + + Invite Attendees + + Invite the listed attendees to the current event (via email). + You may be prompted to specify an invitation message. + + + + + Cancel Invitation + + Cancels the event, notifying all attendees. You may be prompted + to specify an invitation message. + + + + + Forward as vCalendar + + Opens the message composer with the current event attached. + + + + + Forward as Text + + Opens the message composer with a text description of the current + event included in the message body. + + + + + + + + The Appintment Editor's File Menu + + This menu is empty. + + + - Contact Manager Menus @@ -676,7 +1044,10 @@ The Contact Editor Menus - Kevin might do this section. + Most, if not all, of the menu items for this section are still + inoperable, but there are vast numbers of them, especially in + the Actions menu. When available, I will + describe them. diff --git a/doc/C/fig/filter-new-fig.png b/doc/C/fig/filter-new-fig.png index 4c612ce5fc..48ac3b8a7c 100644 Binary files a/doc/C/fig/filter-new-fig.png and b/doc/C/fig/filter-new-fig.png differ diff --git a/doc/C/usage-mail.sgml b/doc/C/usage-mail.sgml index 8785231686..ed101f6884 100644 --- a/doc/C/usage-mail.sgml +++ b/doc/C/usage-mail.sgml @@ -1029,20 +1029,75 @@ possibly never will be due to security evil. --> Staying organized: Mail Filters in Evolution - Filters sort your email for you as it arrives. Most often, - you'll want to have Evolution put - mail into different folders, but you can have it do anything - you like. People who subscribe to multiple mailing lists, or - who often need to refer to messages they have sent, find - filters especially helpful to separate personal from - list-related mail, but they're good for anybody who gets more - than a few messages a day. To create a filter, select + Filters sort your email for you as you send or recieve + it. Most often, you'll want to have + Evolution put mail into different + folders, but you can have it do anything you like. People who + subscribe to multiple mailing lists, or who often need to + refer to messages they have sent, find filters especially + helpful to separate personal from list-related mail, but + they're good for anybody who gets more than a few messages a + day. To create a filter, open the filter + assistant by selecting - Tools Filter - Assistant . This will bring up a - window which will guide you through filter creation. The - filter assistant is shown in + Tools + Mail Filters + . + + +
+ The Filter Assistant + + The Filter Assistant + + + +
+ + + The filter assistant window contains a + list of your current filters, sorted by the order in which + they will be performed. From the drop-down box at the top of + the window, choose whether to display all your filters, only + those filters which are performed on incoming mail, or only + filters for outgoing mail. + + + The filter assistant also has a set of + buttons: + + + + Add — Create a new filter. + + + + Edit — Edit an existing filter. + + + + Delete — Delete the selected filter. + + + + Up — Move the selected filter up in the list. + + + + Down — Move the selected filter down + in the list. + + + + If you don't have any filters set up, the only one you can + click is Add. When you do that, (or + when you click Edit with a filter + selected), the Add Rule window appears. + + + That window, shown in , is where you'll + actually create your filtering rule.
Creating a new Filter @@ -1052,14 +1107,151 @@ possibly never will be due to security evil. -->
+ + + Enter a name for your filter in the Name + field, and then begin choosing criteria. You can use multiple + criteria by pressing More, and remove + the last one by pressing Fewer. you can + choose from five types of criteria, and you can have as many + as you like. If you have multiple criteria, you should also + decide between Match all parts, which + will make the filter affect only those messages which meet all + the criteria you're about to describe, and Match any + part, which will make the filter affect any message + that meets even one of the criteria. + + + For each of your filter criteria, you must first select what + part of the message you want the filter to look at: + + + Sender + + The author of the message. + + + + + Recipients + + The recipients of the message. + + + + + Subject + + The subject line of the message. + + + + + Message Body + + The message body. + + + + + Expression + + Enter a regular expression (see + for more information), and Evolution + will match it for you. + + + + + + Then choose a rule for matching: + + + + Contains + + If the part of the message examined contains the text you enter, + the filter will perform its selected action. + + + + + Does not contain + + If the part of the message examined does not contain + the text you enter, + the filter will perform its selected action. + + + + + + + Then, enter the text you want the filter to find, and you're + done telling Evolution what sort of + messages you want it to filter. + + + + Now, tell it what to do with those messages. If you want multiple + actions, click More; if you want fewer, + click Fewer. And choose again: + + + Move to Folder + + If you select this item, Evolution + will put the messages into a folder you specify. Click the + <click here to select a folder> button + to select a folder. + + + + + Forward to Address + + Select this, enter an address, and the addressee will + get a copy of the message. + + + + + Delete + + Marks the message for deletion. You can still get the message + back, at least until you Expunge your + mail yourself. + + + + + Stop Processing + + Select this if you want to tell all other filters to ignore + this message. + + + + Assign Color + + Select this item, and Evolution + will mark the message with whatever color you please. + + + + + + You're done. Click OK to use this + filter, or Cancel to close the window + without saving any changes. - The filter assistant window - contains a window listing rules, and an option to create a - new rule. To start filtering your mail, click - Add to add a filtering rule. - You'll decide when it should take place: + + + - - - Then, the filter assistant will ask you which emails it should - act upon. You can set criteria based on message size, the - sender, primary addressee or Cc: list, words in the subject or - body of the message, or any combination of criteria. Check the - boxes next to each criterion you would like to use. - - - Once you've decided which messages to filter, the assistant - will ask you the sort of action you wish to take. You can - file, delete, or forward the message, and you can also have it - be exempted from other filters which would otherwise have - acted upon it. - + + --> Two Notable Filter Features @@ -1200,7 +1379,7 @@ possibly never will be due to security evil. --> To create a vFolder, select VFolder - Assistant from the Tools + Editor from the Tools menu in the main window. This will bring up a dialog box that looks suspiciously like the Filter Assistant (for more information on filters, see @@ -1213,92 +1392,36 @@ possibly never will be due to security evil. --> click Add to add a new vFolder. - You'll be prompted to create a filtering rule. You can build - your own from the ground up, or select one of several base - rules to customize. Your options are: - - - For matching messages: - - - Choose this to create your own set of rules for the - vFolder. You may select one or more search criteria; - the vFolder you create will contain messages that - match all of them. - - - - - Messages from a certain person: - - - The remaining three rules are simpler. Select this - one to create a vFolder that will contain only - messages from an address you enter. - - - - - Messages to a certain address: - - - Any messages sent directly to this address will be in - the vFolder you create. This vFolder is an absolute - must for people with multiple email addresses. - - - - - Messages with a given subject: - - - Enter a subject, and the vFolder will contain messages - with that subject. - - - - - - The selection window is shown in Name. Then, tell + Evolution what messages to look + for. This process is exactly like filter creation: decide + between Match all parts and + Match any part, then choose what part of + the message to look in, what sort of matching to perform, and + specify exactly what text it is that you want to find. + + + The second part, however, is slightly different. In the + section of the window labelled vFolder Sources + is a list of folders in which + Evolution will search for the contents + of your vFolder. Click Add to add a folder, + or Remove to remove one. + + + The vFolder creation window is shown in
Selecting a vFolder Rule - Selecting a vFolder Rule + Creating a vFolder Rule
- - - Once you click Next, you'll customize - the vFolder rule. The rules for the vFolder you're creating - will appear as phrases in the bottom pane of the window. You - can click on the blue underlined text in the phrase to alter - it to your liking. For example, when I create a vFolder to - contain all messages from rupert@helixcode.com - that have the word "evolution" in the message body, the bottom - frame says: The From address matches - rupert@helixcode.com and the body contains - "evolution".. - - - - - - - - - - - - - - - - - + \ No newline at end of file diff --git a/doc/ChangeLog b/doc/ChangeLog index 4143e67b72..fc9cdc0cf1 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,17 @@ +2000-08-25 Aaron Weber + + * C/usage-mail.sgml: Redid filter and vFolder assistant + descriptions. + + * C/fig/filter-new-fig.png: Replaced with new assistant pic. + + * C/fig/filter-assist-fig.png: New file, showing only assistant. + + + * C/apx-menuref.sgml: Finished message composer and calendar + editor menus. Looked at Contact Editor menus and decided to + document those features after implementation. + 2000-08-24 Aaron Weber * C/apx-menuref.sgml: Message Composer File and Edit menus. -- cgit v1.2.3