<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<HTML>
-<HEAD>
- <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
- <TITLE>Sylpheed User's Manual: Filtering Messages</TITLE>
- <LINK HREF="sylpheed-13.html" REL=next>
- <LINK HREF="sylpheed-11.html" REL=previous>
- <LINK HREF="sylpheed.html#toc12" REL=contents>
-</HEAD>
-<BODY>
-<A HREF="sylpheed-13.html">Next</A>
-<A HREF="sylpheed-11.html">Previous</A>
-<A HREF="sylpheed.html#toc12">Contents</A>
-<HR>
-<H2><A NAME="s12">12. Filtering Messages</A></H2>
-
-<P>Written by Nick Selby (sylpheed@nickselby.com)
-<P>
-<P>
-<H2><A NAME="ss12.1">12.1 Filtering Messages</A>
-</H2>
-
-<P>Sylpheed provides powerful filters to allow users to automatically pre-sort incoming
-mail based on a set of rules that the user defines. As a most simple example, let's
-say you work at the Acme Grommet Company, and you want all e-mail from your co-workers
-to be placed in one mailbox. To accomplish this, you would set up a filter that would
-place all mail whose "From" header includes the phrase "acmegrommet.com" into a specific mailbox.
-<P>Sylpheed allows you much more control than just that simple setup; you may create
-filters based on several variables, including an "If this AND that" or "If the message
-contains this OR does NOT contain that" etc. It's very cool.
-<H3>Finding The Filter Setting Dialog</H3>
-
-<P>The filter settings dialog is located in the Configuration menu, under the title
-"Filter Setting". You may also use establish a keyboard shortcut (see Keyboard Shortcuts).
-<H3>Setting Up Filters</H3>
-
-<P>Operator(s) and Processing instructions combine to create a Filter Rule.
-<P>* Operators
-The dialog's first setting option establishes the Operator, the variable that will
-tell the filter what specific text to look for to trigger a filter. Each Filter Rule may have up to two operator sets.
-<P>Each Operator variable contains three sections: Header, Keyword and Predicate.
-<P>Header is a drop-down box which defines in which message header Sylpheed's filter will search. Choices range from Subject to X-Mailer.
-<P>Keyword is a a text box in which you may enter the text for which the filter will search.
-<P>Predicate allows you to choose to filter based on whether the operator
-contains, or does not contain, the text you enter in the Keyword field.
-<P>Example: Create an Operator in which the X-Mailer field of an incoming message contains the word 'Eudora'.
-<UL>
-<LI>Step 1. Under the Header drop-down box, select X-Mailer.</LI>
-<LI>Step 2. In the Keyword text box, type 'eudora' (case insensitive)</LI>
-<LI>Step 3. Determine appropriate Predicate setting. Default is "Contains".</LI>
-</UL>
-
-The second Operator setting, which is set identically to the first, also allows the
-user to select an AND/OR setting declaring the relationship between the two operators.
-<P>Example: Create an Operator set which will process mail with a "From" header of
-bob@acmegrommet.com AND a subject of "2001 Spring Grommet Collection"
-<UL>
-<LI>Step 1. Under the first Operator set's Header drop-down box, select "From".</LI>
-<LI>Step 2. In the "Keyword" text box, type 'bob@acmegrommet.com' (case insensitive)</LI>
-<LI>Step 3. Leave "Predicate" setting on default, "Contains"</LI>
-<LI>Step 4. Leave "AND/OR" box on default setting, "AND"</LI>
-<LI>Step 5. Under the second Operator set's "Header" drop-down box, select "Subject".</LI>
-<LI>Step 6. In the "Keyword" text box, type '2001 spring grommet collection' (case insensitive)</LI>
-<LI>Step 7. Leave "Predicate" setting on default, "Contains"</LI>
-</UL>
-<H3>Message Processing</H3>
-
-<P>Once you've established the Operator(s) that will define which messages will be
-processed, it's time to tell Sylpheed what to do with messages that match the
-operator(s). You may choose between two radio button-selected settings: "Destination" and "Don't Receive".
-<P>Selecting "Destinations" will enable you to route the mail into
-a mailbox which you specify.
-<P>Selecting "Don't Receive" will instruct Sylpheed to not download messages with that
-operator. Note that with "Don't Receive", Sylpheed merely leaves the message on your mailserver - it does not delete it.
-<P>To specify a mailbox to which you want the message transfered, click on the radio
-button to the left of the word "Destination" in the dialog. (Currently, in order to
-specify a mailbox you must have created that mailbox prior to activating the Filter
-Setting dialog.) Clicking the "Select" button will open a pop-up window containing all
-mail folders currently active in your copy of Sylpheed. Select the mailbox you wish by
-either (a) double clicking on the mail folder name or (b) clicking the mail folder name and then clicking "OK".
-<P>To specify that the message not be retrieved, and left on your mail server, click the
-radio button to the left of the words "Don't Receive".
-<H3>Filter Registration</H3>
-
-<P>Now that you have set the Operator and the Processing Rule, all that's left to do is
-tell Sylpheed to save the entire Filter Rule. If you skip this step, the filter won't work.
-<P>The "Register Rules" configuration has three options: "Register", "Substitute" and "Delete".
-<UL>
-<LI>"Register" saves the Filter Rule.</LI>
-<LI>"Substitute" modifies an existing registered Filter Rule.</LI>
-<LI>"Delete" will remove a previously registered Filter Rule. </LI>
-</UL>
-
-Example of Registering A Filter Rule: Create a Filter Rule that moves all mail with
-the subject of "Sylpheed Manual" into the (previously created) mail folder "Sylpheed Manual Mail".
-<UL>
-<LI>Step 1. Under the first Operator set's "Header" drop-down box, select "Subject".</LI>
-<LI>Step 2. In the "Keyword" text box, type 'sylpheed manual' (case insensitive)</LI>
-<LI>Step 3. Leave "Predicate" setting on default, "Contains". Leave second Operator set empty.</LI>
-<LI>Step 4. Click "Destinations" radio button; select "Sylpheed Manual Mail" folder</LI>
-<LI>Step 5. Click "Register"</LI>
-<LI>Step 6. Click OK</LI>
-</UL>
-
-Example of Substituting A Filter Rule: Modify a previously created Filter Rule that
-moves all mail with the subject of "Sylpheed Manual" to sort mail not to the
-mail folder "Sylpheed Manual Mail" but rather the mail folder "Sylpheed Questions"
-<UL>
-<LI>Step 1. Under the first Operator set's Header drop-down box, select Subject.</LI>
-<LI>Step 2. In the Keyword text box, type 'sylpheed manual' (case insensitive)</LI>
-<LI>Step 3. Leave Predicate setting on default, "Contains". Leave second Operator set empty.</LI>
-<LI>Step 4. Click "Destinations" radio button; select "Sylpheed Questions" folder</LI>
-<LI>Step 5. Click "Substitute"</LI>
-<LI>Step 6. Click OK</LI>
-</UL>
-
-Example of Deleting a Filter Rule: Remove the previously created Filter Rule which refers to Subject:Sylpheed Questions.
-<UL>
-<LI>Step 1. In the "Registered Rules" select box, highlight the filter entitled "Subject:Sylpheed Manual: :::Sylpheed Questions:1:1:m"</LI>
-<LI>Step 2. Click the "Delete" Button</LI>
-<LI>Step 3. Confirm the deletion by clicking "Yes" in the confirmation pop-up that asks, "Do you really want to delete this rule?</LI>
-<LI>Step 4. Click "OK"</LI>
-</UL>
-<H3>Registered Rule Order</H3>
-
-<P>One caveat about all this: the order in which Filter Rules are created could adversely
-affect your intended message sorting, and one needs to consider this when creating or updating Filter Rules.
-<P>For example, a Filter Rule saying, "Move anything containing 'ABC' to Mailbox X" listed above another Filter Rule saying "Move anything containing 'ABCDEF' to Mailbox Y" will cause the latter of these filters not to process.
-<P>Think about the way Sylpheed goes down its list: first, it would say.."Hmm, any messages with ABC? Ah, there's one! Move it." Then it would think, "Okay, any messages with ABCDEF?" To which the answer would be "no" - that ABCDEF was already filtered because it contained "ABC".
-<P>Bummer.
-<P>In order to avoid this, you must ensure that the more complex Filter Rule is processed first, by placing it higher than a similar, conflicting Filter Rule.
-<P>To move a Registered Rule higher or lower within the Registered Rule box, select the rule you would like to move, and click on the "Up" or "Down" buttons. This will "move" the rule up or down, above or below a potentially conflicting Filter Rule.
-<H2><A NAME="ss12.2">12.2 How to Filter Messages</A>
-</H2>
-
-<P>Filtering messages can be done in several ways:
-<UL>
-<LI>Sylpheed automatically filters incoming mail from POP and IMAP servers.</LI>
-<LI>If you incorporate mail from a unix mailbox, then in the Common preferences (Configuration menu), you need to check the box called "Filter on incorporation". You find this box in the Receive tab in the space "Local spool".</LI>
-<LI>You can also select the option "Filter messages" from the Summary menu.</LI>
-</UL>
-<P>
-<HR>
-<A HREF="sylpheed-13.html">Next</A>
-<A HREF="sylpheed-11.html">Previous</A>
-<A HREF="sylpheed.html#toc12">Contents</A>
-</BODY>
-</HTML>
+<html>
+<head>
+ <meta name="GENERATOR" content="LinuxDoc-Tools 0.9.21">
+ <title>Sylpheed-Claws User's Manual: Address Book</title>
+ <link href="sylpheed-13.html" rel="next">
+ <link href="sylpheed-11.html" rel="previous">
+ <link href="sylpheed.html#toc12" rel="contents">
+</head>
+<body>
+<a href="sylpheed-13.html">Next</a>
+<a href="sylpheed-11.html">Previous</a>
+<a href="sylpheed.html#toc12">Contents</a>
+<hr>
+<h2><a name="s12">10.</a> <a href="sylpheed.html#toc12">Address Book</a></h2>
+<p>In the address book, accessible through Shift-Ctrl-A, the
+Addressbook button, or through the "Tools" menu, you store e-mail
+addresses of the people and places you want to write more often.</p>
+<p>If the options have been compiled into Sylpheed, the
+address book can connect to a LDAP server for address
+lookup, and you can use the address book stored on your
+Palm PDA.</p>
+<h2><a name="ss12.1">10.1</a> <a href="sylpheed.html#toc12.1">Adding
+and Deleting Addresses</a>
+</h2>
+<p>Adding an address to the address book is quite easy too. Rightclick
+the folder or group you want to add the address to, select "new
+address" and fill in the dialog that comes up. You can also directly
+click the Add button in the address book window, and the dialog comes
+up. In this case the address is moved into the folder/group that is
+selected at the moment of adding.</p>
+<p>In the "Basic data" tab, you can fill the first
+and last name and provide a nickname. The "Display name"
+will be used by the "Name" column of the address book
+window.</p>
+<p>In the "E-Mail address" tab, fill the address field
+and use the "Add" button to add the address to the list.
+An alias can also be assigned to this address and used
+when searching for an address.
+Several addresses can be assigned to the same person
+in your address book by repeating the sequence described
+above. The addresses can then be sorted by using the "Move up" and
+"Move down" buttons. The address on the top
+will be the first one listed in the address book main window.</p>
+<p>Deleting an address is equally simple. Find the address, click it
+once, and press the Delete button.</p>
+<h2><a name="ss12.2">10.2</a> <a href="sylpheed.html#toc12.2">Folders
+and Groups</a>
+</h2>
+<p>You can use groups and folders to organize your address
+book into categories, hierarchies and aliases.
+The folders are used to generate a hierarchical organization
+and contain the actual addresses, while the groups are
+used to group together addresses that lives in separate
+folders.</p>
+<p>Sounds complicated, so let's see an example: consider
+your workmates, they are arnaud (arnaud@company.com),
+sandra (sandra@company.com), xavier (xavier@company.com)
+and the chief, helene (helene@company.com). You can
+create a folder named <code>myGroup</code>, create the entries
+for all your workmates in this folder. Now you can create one
+groupe named <code>jokes</code> that includes all but the boss
+to use when sending your daily jokes, another one named
+<code>team</code> that includes everybody for the usual group
+(serious) communication, and a third group named
+<code>reports</code> that includes the boss, and the one working with
+you on some projects for the weekly reports.</p>
+<p>To generate this kind of addresses organization
+you only need to create the entries once, then when
+creating groups you can select among the existing entries
+to fill the groups.</p>
+<p>The address book, like the mail folders, can be expanded into an
+entire tree of sections. For this you right-click on the folder where
+you want to add a new folder, and select "new folder". Then you can
+enter a descriptive name for the folder, click Ok, and your folder is
+created.</p>
+<p>In this same way you can create a new group in a folder. Right-click
+on the folder, select "new group", enter a name for it, and that's it.</p>
+<p>The group settings window pops up in order to fill the group
+with addresses. Use the two arrows to add to or remove from
+the group the selected address.
+Once the group contains the list of addresses you want it to
+contain, click the "OK" button to close the window.</p>
+<h2><a name="ss12.3">10.3</a> <a href="sylpheed.html#toc12.3">Combination
+with Message Composition Window</a>
+</h2>
+<p>You can either enter the first letters of an address
+(or alias) in the <code>To:</code> or <code>Cc:</code> field
+of the composition window and press the TAB key to
+let Sylpheed-Claws do the completion or open the address book,
+select addresses from there and use the <code>To:</code>
+and <code>Cc:</code> buttons to copy the selected addresses
+into the corresponding fields of the composition window.</p>
+<p>When using the completion mode, when one or more address
+matches the start you have entered, a dropdown list appears.
+Select the correct address from this list and press enter
+to complete the composition window's field.</p>
+<p>In completion mode, the search is made on the E-mail
+address and on the alias. The other fields of the
+address book entry are not used (name, nickname,...).</p>
+<p>When the address book is opened, if you select a group,
+using the <code>To:</code> or <code>Cc:</code> buttons will
+copy all the addresses of the selected group into the
+corresponding field of the composition window.</p>
+<p>Using our previous example, you can select the <code>jokes</code>
+group when sending you morning jokes, and the <code>reports</code>
+one when sending your weekly reports...</p>
+<h2><a name="ss12.4">10.4</a> <a href="sylpheed.html#toc12.4">Using
+your PDA addressbook (with Jpilot)</a>
+</h2>
+<p>Sylpheed-Claws can optionally use your PDA addressbook. This option is
+available if you have compiled Sylpheed-Claws with the support of Jpilot.
+For more details regarding the compilation of Sylpheed-Claws with (or
+without)
+optional features, see the <a href="sylpheed-4.html#compile_sylpheed">compilation
+section</a>.</p>
+<p>Sylpheed-Claws uses the Jpilot side copy of your address book, so you do
+not need to put your PDA on the craddle to find an address (but do
+not forget to synchronize).</p>
+<p>In order to use your PDA's addressbook in Sylpheed, open the
+addressbook
+window, select the <i>JPilot</i> icon in the left tree view,
+use the <i>File -> New Jpilot</i> menu entry and choose a name for
+this addressbook.
+Define the name of the Jpilot addressbook file (usually in:
+<code>~/.jpilot/AddressDB.pdb</code>) and press <i>OK</i>.
+You can use one (or more) of the custom fields to store alternate
+Email addresses for the same person.</p>
+<p>Now you can browse your PDA addressbook. Sylpheed-Claws only has read
+access to this addressbook, so you can't modify your PDA addressbook
+from Sylpheed.</p>
+<h2><a name="ss12.5">10.5</a> <a href="sylpheed.html#toc12.5">LDAP
+server connection</a>
+</h2>
+<p>You can connect to an LDAP server by using the menu <span
+ style="font-style: italic;">Book/new Server.</span> Choose a name for
+it, put the correct hostname and port. The Search Base can often be
+automatically retrieved from the server by using the [...] button at
+the right of it. If it doesn't work, contact your sysadmin so that he
+gives you the correct search base to use. It is mandatory, a bad search
+base will cause all your search attempts to fail. If your LDAP server
+requires authentication, fill that in the Extended tab. <br>
+</p>
+<hr>
+<a href="sylpheed-13.html">Next</a>
+<a href="sylpheed-11.html">Previous</a>
+<a href="sylpheed.html#toc12">Contents</a>
+</body>
+</html>
projects / claws.git / blobdiff