From f639972a2bc2e78eec1bb1b6f6630c0e70c7c19f Mon Sep 17 00:00:00 2001 From: Kevin Breit Date: Thu, 5 Jul 2001 18:22:34 +0000 Subject: Added orderedlists. 2001-07-05 Kevin Breit * C/usage-mail-org.sgml: Added orderedlists. svn path=/trunk/; revision=10818 --- doc/C/usage-mail-org.sgml | 874 +++++++++++++++++++++++++-------------------- doc/ChangeLog | 4 + help/C/usage-mail-org.sgml | 874 +++++++++++++++++++++++++-------------------- help/ChangeLog | 4 + 4 files changed, 968 insertions(+), 788 deletions(-) diff --git a/doc/C/usage-mail-org.sgml b/doc/C/usage-mail-org.sgml index 6668623cf0..3647b6be56 100644 --- a/doc/C/usage-mail-org.sgml +++ b/doc/C/usage-mail-org.sgml @@ -14,26 +14,42 @@ By default, the message list has columns with the following headings: an envelope icon indicating whether you have read - or replied to a message (closed for unread, open for read, - and open with an arrow on it to indicate you've sent a - reply), an exclamation point indicating priority, and the + or replied to a message, an exclamation point indicating priority, and the From, Subject, and Date fields. You can change their order - and remove them by dragging and dropping them. You can add - new ones with the Field Chooser - item in the right click menu for the column headings. + and remove them by dragging and dropping them. + + To add columns to sort by: + + + + Right click on the bar + + + + + Click Add a Column + + + + + Click and drag a column you want into the toolbar. A red arrow will + show you where the column will be placed. + + + Right-click on one of the column headers to get a list of options: - - Sort Ascending - - Sorts the messages top to bottom. - - + + Sort Ascending + + Sorts the messages top to bottom. + + Sort Descending @@ -111,7 +127,7 @@ right below the toolbar, and choose a search type: - Body or subject contains: + Body or subject contains This will search message subjects and the messages @@ -121,7 +137,7 @@ - Body contains: + Body contains This will search only in message text, not the subject @@ -130,7 +146,7 @@ - Subject contains: + Subject contains This will show you messages where the search text is @@ -140,7 +156,7 @@ - Body does not contain: + Body does not contain This finds every email message that does not have the @@ -151,7 +167,7 @@ - Subject does not contain: + Subject does not contain This finds every mail whose subject does not contain @@ -214,354 +230,289 @@ to say, it's faster and more flexible than an actual person with a pile of envelopes. - - Most often, you'll want to have - Evolution put mail into different - folders, but you can have it do almost anything you like. - People who get lots of mail, or who often need to refer to old - messages, find filters especially helpful, but they can greatly benefit - anybody who gets more than a few messages a day. To - create a filter, open the filter - assistant by selecting - - Settings - Mail Filters - . - - -
- The Filter Assistant - - The Filter Assistant - - - -
+ + Making New Filters - The filter assistant window contains a - list of your current filters, sorted by the order in which - they are used. From the drop-down box at the top of the - window, choose Incoming to display - filters for incoming mail, and Outgoing - for those which sort only 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 so it gets applied first. - - - - Down — Move the selected filter down - in the list, so it comes into play later. - - - - If you don't have any filters set up, the only one of those - buttons you can click is Add, which - will open a dialog to let you add a filter rule. If you do - have filters, you can either add a new filter rule, or select - one from your list and click Edit. - - - The filter rule editor, shown in , is where you'll - actually create your filtering rule. - -
- Creating a new Filter - - Creating a new Filter - - - -
- - - Enter a name for your filter in the Rule - Name field, and then begin choosing the criteria - you'd like to use as you sort your mail. Choose how many - criteria you'd like by pressing Add - Criterion and Remove - Criterion. If you have multiple criteria, you - should then decide whether to have the filter do its job only - if all criteria are met, or if - any criteria are met. - - - - For each filter criterion, you must first select - which of the following parts of the message you want the filter to - examine: - - - Sender - - The sender's address. - - - - - Recipients - - The recipients of the message. - - - - - Subject - - The subject line of the message. - - - - - - Specific Header - - The filter can look at any header you - want, even obscure or custom ones. Enter the header name - in the first text box, and put your search text in the - second one. - - - - - Message Body - - Search in the actual text of the message. - - - - - Expression - - - For programmers only: match a message according to an - expression you write in the Scheme language, used to - define filters in Evolution. - - - - - - - Date Sent - Filter messages according to the date on - which they were sent: First, choose the conditions you - want a message to meet — before - a given time, after it, and so forth. - Then, choose the time. The filter will compare the - message's time-stamp to the system clock when the filter - is run, or to a specific time and date you choose from a - calendar. You can even have it look for messages within a - range of time relative to the filter &mdash perhaps you're - looking for messages less than two days old. - - - - - Date Recieved - - This works the same way as the Date Sent - option, except that it compares the time you got the message - with the dates you specify. - - - - - Priority - - Emails have a standard priority range from -3 (least - important) to 3 (most important). You can have filters set the - priority of messages you recieve, and then have other filters - applied only to those messages which have a certain priority. - - - - - Regex Match - - - If you know your way around a regex, or - regular expression, put your knowledge to use here. - - - - - - Source - - - Filter messages according the server you got them from. - You can enter a URL or choose one from the drop-down - list. This ability is only relevant if you use more - than one mail source. - - - - - - - - Now, tell it what to do with those messages. If you want more - actions, click Add Action; if you want - fewer, click Remove Action. And choose - again: - - - - Copy 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. - - - - - 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, because whatever you've done with it so far - is plenty. - - - - - Assign Color - - Select this item, and Evolution - will mark the message with whatever color you please. - - - - - Assign Score - If you know that all mail with - "important" somewhere in the message body line is - important, you can give it a high priority score. In a subsequent filter you can - then arrange your messages by their priority score. - - - - + To create a new filter: + + + + Click + + Tools + Filters + + + + + + Press the Add button. + + + + + Name your filter in the Rule name field. + For each filter criterion, you must first select + which of the following parts of the message you want the filter to + examine: + + + + Sender - The sender's address. + + + + + Recipients - The recipients of the message. + + + + Subject - The subject line of the message. + + + + Specific Header - The filter can look at any header you + want, even obscure or custom ones. Enter the header name + in the first text box, and put your search text in the + second one. + + + + Message Body - Search in the actual text of the message. + + + + + Expression - For programmers only: match a message according to an + expression you write in the Scheme language, used to + define filters in Evolution. + + + + Date sent - Filter messages according to the date on + which they were sent: First, choose the conditions you + want a message to meet — before + a given time, after it, and so forth. + Then, choose the time. The filter will compare the + message's time-stamp to the system clock when the filter + is run, or to a specific time and date you choose from a + calendar. You can even have it look for messages within a + range of time relative to the filter &mdash perhaps you're + looking for messages less than two days old. + + + + Date Recieved - This works the same way as the Date Sent + option, except that it compares the time you got the message + with the dates you specify. + + + + Score - Emails have a standard priority range from -3 (least + important) to 3 (most important). You can have filters set the + priority of messages you recieve, and then have other filters + applied only to those messages which have a certain priority. + + + + + Size (kb) - Sorts based on the size of the message in kilobytes. + + + + + + Status - Filters according to the status of a message, such as + 'New'. + + + + + + Attachments - Create a filter whether or not you have an + attachment in the email. + + + + + + Mailing List - Filter based on the mailing list it came from. + + + + + + Regex Match - If you know your way around a regex, or + regular expression, put your knowledge to use here. + + + + + + Source Account - Filter messages according the server you got them from. + You can enter a URL or choose one from the drop-down + list. This ability is only relevant if you use more + than one mail source. + + + + + + + + Select the criterion for the condition. + + + + + If you want multiple criterion for this filter, press Add + criterion and repeat the previous step. + + + + + Select the actions for the filter in the Then + section. You can select any of the following options. + + + 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. + + + + Copy 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, because whatever you've done with it so far + is plenty. + + + + Assign Color - Select this item, and Evolution + will mark the message with whatever color you please. + + + + Assign Score - If you know that all mail with + "important" somewhere in the message body line is + important, you can give it a high priority score. In a subsequent filter you can + then arrange your messages by their priority score. + + + + + + + Set Status - If you want to add multiple actions for this filter, press + Add filter and repeat the previous step. + + + + + Press OK. + + + + + + + Editing Filters - You're done. Click OK to use this - filter, or Cancel to close the window - without saving any changes. - - - - - - - - Notable Filter Features + + + + Deleting Filters - - - Incoming email that your filters don't move goes into the Inbox; - outgoing mail that they don't move ends up in the Sent folder. + To delete a filter: + + + + Select + + Tools + Filters + + + + + + Select the filter and press Delete. - + - - - - Filtering by Mailing List - You can tell Evolution to filter by - mailing list. This means that Evolution - will look at the mailing list address, and find out automatically - what list this is. If you are subscribed to mailing lists, you - should use the Filter by List instead of by - sender. - - Filter by List + + Notable Filter Features - Kevin subscribes to bananas@ximian.com. However, there is also - a bananas@ximian.org address. If he used a regular - Filter by Sender, he would need to specify - one for each address. However, Filter by - List will recognize that both of them are the same - list. + + + Incoming email that your filters don't move goes into the Inbox; + outgoing mail that they don't move ends up in the Sent folder. + + + - + - + Getting Really Organized with Virtual Folders @@ -623,58 +574,193 @@ + + Creating Virtual Folders - To create a virtual folder, select - Settings Virtual Folder - Editor . This will bring up a - dialog box that looks suspiciously like the filter window - (for more information on filters, see ), and which - presents you with a list of virtual folders you have previously - created. If you have created any virtual folders, they are listed - here, and you can select, edit or remove them if you wish. - If you have not created any, there will be only one available - option: click Add to add a new - Virtual Folder. - - - You can enter a name for your virtual folder in the - 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 it is that you want to find, be it a - line of text, a score, a regular expression, or a particular date or - range of dates. - - - The second part, however, is slightly different. In the - section of the window labelled Virtual Folder 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. That way, you can have your vFolder search in - newsgroups, or just in one of your mailboxes, or just in a - select few folders you've already screened with filters. - - - The vFolder creation window is shown in + To create a virtual folder: + + + + + Tools + Virtual Folder Editor + + + + + + Click Add + + + + + Name your filter in the Rule name field. + For each filter criterion, you must first select + which of the following parts of the message you want the filter to + examine: + + + Sender - The sender's address. + + + + + Recipients - The recipients of the message. + + + + Subject - The subject line of the message. + + + + Specific Header - The filter can look at any header you + want, even obscure or custom ones. Enter the header name + in the first text box, and put your search text in the + second one. + + + + Message Body - Search in the actual text of the message. + + + + + Expression - For programmers only: match a message according to an + expression you write in the Scheme language, used to + define filters in Evolution. + + + + Date sent - Filter messages according to the date on + which they were sent: First, choose the conditions you + want a message to meet — before + a given time, after it, and so forth. + Then, choose the time. The filter will compare the + message's time-stamp to the system clock when the filter + is run, or to a specific time and date you choose from a + calendar. You can even have it look for messages within a + range of time relative to the filter &mdash perhaps you're + looking for messages less than two days old. + + + + Date Recieved - This works the same way as the Date Sent + option, except that it compares the time you got the message + with the dates you specify. + + + + Score - Emails have a standard priority range from -3 (least + important) to 3 (most important). You can have filters set the + priority of messages you recieve, and then have other filters + applied only to those messages which have a certain priority. + + + + + Size (kb) - Sorts based on the size of the message in kilobytes. + + + + + + Status - Filters according to the status of a message, such as + 'New'. + + + + + + Attachments - Create a filter whether or not you have an + attachment in the email. + + + + + + Mailing List - Filter based on the mailing list it came from. + + + + + + Regex Match - If you know your way around a regex, or + regular expression, put your knowledge to use here. + + + + + + Source Account - Filter messages according the server you got them from. + You can enter a URL or choose one from the drop-down + list. This ability is only relevant if you use more + than one mail source. + + + + + + + + + Select the criterion for the condition. + + + + + Select the folder sources. You can select: + + + + specific folders only + + + If you select specific folders only, you need to specify the + source folders in the box below. + + + + + + + all local folders + + + + + with all active remote folders + + + + + with all local and active folders + + + + + + + + + If you want multiple criterion for this filter, press Add + criterion and repeat the previous step. + + + -
- Selecting a vFolder Rule - +
+ Selecting a vFolder Rule + Creating a vFolder Rule - +
- - - - - Notable Filter Features + + + + Deleting Filters - - - Incoming email that your filters don't move goes into the Inbox; - outgoing mail that they don't move ends up in the Sent folder. + To delete a filter: + + + + Select + + Tools + Filters + + + + + + Select the filter and press Delete. - + - - - - Filtering by Mailing List - You can tell Evolution to filter by - mailing list. This means that Evolution - will look at the mailing list address, and find out automatically - what list this is. If you are subscribed to mailing lists, you - should use the Filter by List instead of by - sender. - - Filter by List + + Notable Filter Features - Kevin subscribes to bananas@ximian.com. However, there is also - a bananas@ximian.org address. If he used a regular - Filter by Sender, he would need to specify - one for each address. However, Filter by - List will recognize that both of them are the same - list. + + + Incoming email that your filters don't move goes into the Inbox; + outgoing mail that they don't move ends up in the Sent folder. + + + - + - + Getting Really Organized with Virtual Folders @@ -623,58 +574,193 @@ + + Creating Virtual Folders - To create a virtual folder, select - Settings Virtual Folder - Editor . This will bring up a - dialog box that looks suspiciously like the filter window - (for more information on filters, see ), and which - presents you with a list of virtual folders you have previously - created. If you have created any virtual folders, they are listed - here, and you can select, edit or remove them if you wish. - If you have not created any, there will be only one available - option: click Add to add a new - Virtual Folder. - - - You can enter a name for your virtual folder in the - 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 it is that you want to find, be it a - line of text, a score, a regular expression, or a particular date or - range of dates. - - - The second part, however, is slightly different. In the - section of the window labelled Virtual Folder 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. That way, you can have your vFolder search in - newsgroups, or just in one of your mailboxes, or just in a - select few folders you've already screened with filters. - - - The vFolder creation window is shown in + To create a virtual folder: + + + + + Tools + Virtual Folder Editor + + + + + + Click Add + + + + + Name your filter in the Rule name field. + For each filter criterion, you must first select + which of the following parts of the message you want the filter to + examine: + + + Sender - The sender's address. + + + + + Recipients - The recipients of the message. + + + + Subject - The subject line of the message. + + + + Specific Header - The filter can look at any header you + want, even obscure or custom ones. Enter the header name + in the first text box, and put your search text in the + second one. + + + + Message Body - Search in the actual text of the message. + + + + + Expression - For programmers only: match a message according to an + expression you write in the Scheme language, used to + define filters in Evolution. + + + + Date sent - Filter messages according to the date on + which they were sent: First, choose the conditions you + want a message to meet — before + a given time, after it, and so forth. + Then, choose the time. The filter will compare the + message's time-stamp to the system clock when the filter + is run, or to a specific time and date you choose from a + calendar. You can even have it look for messages within a + range of time relative to the filter &mdash perhaps you're + looking for messages less than two days old. + + + + Date Recieved - This works the same way as the Date Sent + option, except that it compares the time you got the message + with the dates you specify. + + + + Score - Emails have a standard priority range from -3 (least + important) to 3 (most important). You can have filters set the + priority of messages you recieve, and then have other filters + applied only to those messages which have a certain priority. + + + + + Size (kb) - Sorts based on the size of the message in kilobytes. + + + + + + Status - Filters according to the status of a message, such as + 'New'. + + + + + + Attachments - Create a filter whether or not you have an + attachment in the email. + + + + + + Mailing List - Filter based on the mailing list it came from. + + + + + + Regex Match - If you know your way around a regex, or + regular expression, put your knowledge to use here. + + + + + + Source Account - Filter messages according the server you got them from. + You can enter a URL or choose one from the drop-down + list. This ability is only relevant if you use more + than one mail source. + + + + + + + + + Select the criterion for the condition. + + + + + Select the folder sources. You can select: + + + + specific folders only + + + If you select specific folders only, you need to specify the + source folders in the box below. + + + + + + + all local folders + + + + + with all active remote folders + + + + + with all local and active folders + + + + + + + + + If you want multiple criterion for this filter, press Add + criterion and repeat the previous step. + + + -
- Selecting a vFolder Rule - +
+ Selecting a vFolder Rule + Creating a vFolder Rule - +
- -