+2006-09-10 [wwp] 2.4.0cvs172
+
+ * manual/account.xml
+ * manual/addrbook.xml
+ * manual/handling.xml
+ * manual/es/handling.xml
+ * manual/fr/account.xml
+ * manual/fr/addrbook.xml
+ * manual/fr/handling.xml
+ documented addressbook matching (condition configuration):
+ addrbook.xml, en fr
+ documented per-account filtering rules (handling/filtering
+ section, account section):
+ account.xml, handling.xml, en fr
+ slightly updated the handling/searching section to tell few
+ words about the extended search ability:
+ handling.xml, en fr
+ added missing <quote></quotes> to Quick Search:
+ handling.xml, en fr es
+ fixed a typo (auomatically):
+ handling.xml, en
+ changes revisited by Paul.
+
2006-09-10 [paul] 2.4.0cvs171
* src/prefs_actions.c
( cvs diff -u -r 1.1.4.29 -r 1.1.4.30 src/gtk/gtksctree.c; cvs diff -u -r 1.1.2.7 -r 1.1.2.8 src/plugins/bogofilter/bogofilter.c; ) > 2.4.0cvs169.patchset
( cvs diff -u -r 1.395.2.246 -r 1.395.2.247 src/summaryview.c; ) > 2.4.0cvs170.patchset
( cvs diff -u -r 1.60.2.40 -r 1.60.2.41 src/prefs_actions.c; cvs diff -u -r 1.59.2.48 -r 1.59.2.49 src/prefs_filtering.c; cvs diff -u -r 1.12.2.29 -r 1.12.2.30 src/prefs_template.c; ) > 2.4.0cvs171.patchset
+( cvs diff -u -r 1.1.2.7 -r 1.1.2.8 manual/account.xml; cvs diff -u -r 1.1.2.3 -r 1.1.2.4 manual/addrbook.xml; cvs diff -u -r 1.1.2.11 -r 1.1.2.12 manual/handling.xml; cvs diff -u -r 1.1.2.2 -r 1.1.2.3 manual/es/handling.xml; cvs diff -u -r 1.1.2.6 -r 1.1.2.7 manual/fr/account.xml; cvs diff -u -r 1.1.2.3 -r 1.1.2.4 manual/fr/addrbook.xml; cvs diff -u -r 1.1.2.5 -r 1.1.2.6 manual/fr/handling.xml; ) > 2.4.0cvs172.patchset
MICRO_VERSION=0
INTERFACE_AGE=0
BINARY_AGE=0
-EXTRA_VERSION=171
+EXTRA_VERSION=172
EXTRA_RELEASE=
EXTRA_GTK2_VERSION=
<section id="account_morefilt">
<title>More filtering</title>
<para>
- The filtering rules are global. This means that mails from various
- accounts can be filtered into another account's folders, for example a
- mail received by POP3 could be filtered into an IMAP account's folder,
- and vice-versa. This is either a useful feature or an annoying one,
- depending on what you want to do. If you'd rather avoid that, but
- still want to auomatically sort your incoming mail, the best thing to
- do is to disable Filtering on the accounts, and use Processing rules in
- the various Inbox folders you specified. Processing rules are applied
- when entering the folder.
+ By default filtering rules are global, but they can also be assigned to
+ a specific account. When fetching mail, any rules that are assigned to
+ a specific account will only be applied to mails that are retrieved from
+ that account.
+ </para>
+ <para>
+ Mail from any account can be filtered into another account's folders,
+ for example, a mail received by POP3 could be filtered into an IMAP
+ account's folder, and vice-versa. This is either a useful feature or an
+ annoying one, depending on what you want to achieve. If you'd rather
+ avoid that, but still want to automatically sort your incoming mail, the
+ best thing to do is to disable Filtering on certain accounts, and use
+ Processing rules in the Inbox folders that you specified, as Processing
+ rules are applied when entering a folder.
</para>
</section>
</para>
</section>
+ <section id="addrbk_filtering">
+ <title>Filtering messages using the address book</title>
+ <para>
+ It is possible to filter messages by matching addresses found in
+ headers against the address book, use for this the match type
+ <quote>Found in addressbook</quote> when defining the condition
+ expression of a filtering rule. You have to select the address header
+ to match against a part of the address book. The address header can be
+ To, From, Cc, Reply-to and Sender (if at least one address in that
+ header matches, the rule will be applied). Some special items allow to match
+ at least one address found in <quote>Any</quote> address header, or to
+ match <quote>All</quote> addresses found in all address headers. Click
+ the <quote>Select...</quote> button to choose the address book part to
+ search in (either a book or a sub-folder), or select <quote>Any</quote>
+ to search in the whole address book.
+ </para>
+ </section>
+
<section id="addrbk_advanced">
<title>Advanced features</title>
actual...</quote> del menú <quote>Editar</quote>. Funciona igual que
la búsqueda en un documento de texto.
</para><para>
- La última manera de buscar mensaje es utilizar la búsqueda rápida, que
- puede mostrar u ocultar usando la pequeña lupa que aparece bajo la
- lista de mensajes. También se puede acceder a ella a través de la
- opción <quote>Búsqueda rápida</quote> del menú <quote>Editar</quote>.
- La búsqueda rápida es más potente que la búsqueda normal, ya que puede
- buscar en las cabeceras estándar (Desde, Para, Asunto) o en modo
- <quote>Extendido</quote> utilizando prácticamente cualquier criterio
- que pueda imaginar. En modo <quote>Extendido</quote> el botón de
+ La última manera de buscar mensaje es utilizar la
+ <quote>búsqueda rápida</quote>, que puede mostrar u ocultar usando la
+ pequeña lupa que aparece bajo la lista de mensajes. También se puede
+ acceder a ella a través de la opción <quote>Búsqueda rápida</quote>
+ del menú <quote>Editar</quote>.
+ La <quote>búsqueda rápida</quote> es más potente que la búsqueda normal,
+ ya que puede buscar en las cabeceras estándar (Desde, Para, Asunto)
+ o en modo <quote>Extendido</quote> utilizando prácticamente cualquier
+ criterio que pueda imaginar. En modo <quote>Extendido</quote> el botón de
<quote>Información</quote> es visible, lo que permite ver la sintaxis
de búsqueda. El botón <quote>Editar</quote> también esta disponible
para crear rápidamente una regla. Además se puede configurar la
- búsqueda rápida para buscar recursivamente por las subcarpetas y si
- debe o no reinicializarse por si misma cuando se cambia de carpeta.
+ <quote>búsqueda rápida</quote> para buscar recursivamente por las
+ subcarpetas y si debe o no reinicializarse por si misma cuando se
+ cambia de carpeta.
</para><para>
Cuando pulse Entrar después de haber especificado la cadena de
búsqueda, la lista de mensajes se reducirá para mostrarle sólo los
<section id="account_morefilt">
<title>Plus de filtrage</title>
<para>
- Les règles de filtrages sont globales. Cela veut dire que les courriels
- des différents comptes peuvent être filtrés dans le dossier d'un autre
- compte. Par exemple un message reçu par un compte POP3 pourra être
- filtré dans un dossier d'un compte IMAP et vice-versa. En fonction de
+ Par défaut, les règles de filtrages sont globales. Cela veut dire que
+ les courriels des différents comptes peuvent être filtrés dans le dossier
+ d'un autre compte. Par exemple un message reçu par un compte POP3 pourra
+ être filtré dans un dossier d'un compte IMAP et vice-versa. En fonction de
ce que vous voulez faire cela peut-être vous être très utile ou très
embêtant. Si vous voulez éviter cela mais souhaitez toujours trier
automatiquement votre courriel entrant, la meilleure chose à faire est
traitement dans les différentes boîtes de réception des comptes. Les
règles de traitement sont exécutées lorsque vous entrerez dans le
dossier.
+ Il est aussi possible de définir des règles de filtrages spéciques à un
+ compte particulier, pour une utilisation plus fine lors de la relève du
+ courrier ou le filtrage manuel de messages.
</para>
</section>
</para>
</section>
+ <section id="addrbk_filtering">
+ <title>Filtrage des messages à l'aide du carnet d'adressse</title>
+ <para>
+ Il est possible de filtrer les messages par correspondance des adresses
+ trouvées dans les en-têtes avec le carnet d'adresses. Pour cela, utilisez
+ le type <quote>Dans le carnet d'adresses</quote> quand vous définissez la
+ condition de filtrage d'une règle. Choisissez alors l'en-tête (From, To,
+ Cc, Reply-to, Sender) dont la ou les adresses seront comparées avec le
+ contenu du carnet d'adresses (si une adresse au moins correspond, la règle
+ est appliquée). L'emploi de <quote>Quelconque</quote> permet
+ de requérir la correspondance d'au moins une adresse dans au moins un de
+ ces en-têtes. Utilisez <quote>Tous</quote> pour requérir la correspondance
+ de toutes les adresses contenues dans tous ces en-têtes.
+ Enfin, choisissez quelle partie du carnet d'adresse servira pour la
+ vérification de la correspondance des adresses : sélectionnez
+ <quote>Carnet entier</quote> pour utiliser le carnet d'adresse entier
+ ou cliquez sur <quote>Sélection...</quote> pour choisir un carnet d'adresse
+ en particulier ou un de ses sous-dossiers.
+ </para>
+ </section>
+
<section id="addrbk_advanced">
<title>Caractéristiques avancées</title>
Une fois votre arborescence de dossiers faite, vous préférerez certainement que Sylpheed-Claws trie vos messages automatiquement, plutôt que de le faire vous-même lorsque vous recevez des messages. Pour cela, vous pouvez utiliser la fonctionnalité de filtrage.
</para>
<para>
- Vous trouverez les préférences et réglages de filtrage dans le menu <quote>Configuration</quote>. Dans ce dialogue, vous pourrez définir de nouvelles règles, en modifier, en effacer, changer leur ordre et les activer/désactiver. Les règles de filtrage sont définies en quatre parties : un état (activé/désactivé), un nom, une condition, et une action. Toute règle désactivée est tout bonnement ignorée. Le nom est optionnel, il est là pour vous aider à vous souvenir de quelle règle fait quoi. La condition est une expression définissant ce que Sylpheed-Claws doit vérifier lors du tri des messages, comme par exemple 'to matchcase sylpheed-claws-users', qui signifie "Message envoyé à une adresse contenant sylpheed-claws-users". Vous pouvez facilement définir des conditions sans vous souvenir de la syntaxe, en cliquant sur le bouton <quote>Définir...</quote> à droite du champ. La troisième partie d'une règle est l'action, qui dit à Sylpheed-Claws ce qu'il doit faire lorsque des messages correspondant à la condition ont été trouvés. Par exemple, 'mark_as_read' marque le message comme lu dès qu'il arrive, ou 'move #mh/Mailbox/Amis' déplace le message dans votre sous-dossier 'Amis'. Ici aussi, un bouton <quote>Définir...</quote> vous aidera à écrire l'action.
+ Vous trouverez les préférences et réglages de filtrage dans le menu <quote>Configuration</quote>. Dans ce dialogue, vous pourrez définir de nouvelles règles, en modifier, en effacer, changer leur ordre et les activer/désactiver. Les règles de filtrage sont définies en cinq parties : un état (activé/désactivé), un nom, un nom de compte, une condition, et une action. Toute règle désactivée est tout bonnement ignorée. Le nom est optionnel, il est là pour vous aider à vous souvenir de quelle règle fait quoi. La condition est une expression définissant ce que Sylpheed-Claws doit vérifier lors du tri des messages, comme par exemple 'to matchcase sylpheed-claws-users', qui signifie "Message envoyé à une adresse contenant sylpheed-claws-users". Vous pouvez facilement définir des conditions sans vous souvenir de la syntaxe, en cliquant sur le bouton <quote>Définir...</quote> à droite du champ. La dernière partie d'une règle est l'action, qui dit à Sylpheed-Claws ce qu'il doit faire lorsque des messages correspondant à la condition ont été trouvés. Par exemple, 'mark_as_read' marque le message comme lu dès qu'il arrive, ou 'move #mh/Mailbox/Amis' déplace le message dans votre sous-dossier 'Amis'. Ici aussi, un bouton <quote>Définir...</quote> vous aidera à écrire l'action.
+ </para>
+ <para>
+Règles de filtrage spécifiques à un compte : il est possible de faire en sorte qu'une règle de filtrage soit associée spécifiquement à un compte. Il faut pour cela sélectionner la règle, choisir un nom compte dans la liste des comptes juste en dessous du <quote>Nom</quote> de la règle puis cliquer sur le bouton <quote>Remplacer</quote> pour mettre à jour la règle existante (ou le bouton <quote>Ajouter</quote> si vous créez une nouvelle règle).
+Si vous assignez une règle de filtrage à un compte au lieu de la laisser assignée à <quote>Tous</quote>(c'est le cas par défault), cette règle ne sera prise en compte que lors de la réception de messages pour ce compte spécifiquement. Assignez là à <quote>Tous</quote> et elle sera utilisée pour filtrer tous les comptes.
+L'assignation d'une règle à un compte spécifique n'est possible que pour le filtrage (pour la réception ou l'application manuelle). Cette fonctionnalité n'est pas disponible pour le traitement des dossiers et le pré/post-traitement. Lors du filtrage manuel, si une ou plusieurs règles sont associées à des comptes spécifiques, il vous sera au préalable demandé quoi faire de ces règles. Les choix possibles sont : ignorer ces règles (elles ne seront pas appliquées), appliquer ces règles sans se préoccuper du compte auquel elles sont associées, ou utilise le compte courant. Attention : le choix retenu sera utilisé automatiquement lors de la prochaine application manuelle des filtres si vous décochez la case <quote>Afficher ce message la prochaine fois</quote> et procédez au filtrage.
</para>
<para>
Une fois la règle de filtrage définie, vous devez l'ajouter à la liste de règles existantes avec le bouton <quote>Ajouter</quote>. N'oubliez pas, l'ordre des règles est important : si Sylpheed-Claws trouve une règle qui correspond à un message et qui le déplace ou l'efface, la suite des règles n'est pas testée ni exécutée. C'est pourquoi vous pouvez ré-ordonner vos règles grâce aux boutons disponibles à droite de la liste (ou par glisser-déposer).
Il existe plusieurs méthodes pour rechercher dans vos messages.
</para>
<para>
- L'une d'entre elles est assez répandue, vous pouvez la trouver dans le menu <quote>Edition/Chercher dans le dossier...</quote>. Ceci ouvre une fenêtre de recherche où vous pouvez spécifier un ou plusieurs champs où chercher, comme De, À, Sujet, et Message. Après avoir choisi vos critères, utilisez les boutons <quote>Revenir</quote> et <quote>Avancer</quote> pour naviguer dans les messages correspondants, ou utilisez <quote>Chercher tous</quote> pour sélectionner tous les messages correspondants en une fois. Soyez conscients, toutefois, que la recherche dans le message entier est plus lente que la recherche dans les en-têtes, car les corps de messages ne sont pas dans les caches de Sylpheed-Claws.
+ L'une d'entre elles est assez répandue, vous pouvez la trouver dans le menu <quote>Edition/Chercher dans le dossier...</quote>. Ceci ouvre une fenêtre de recherche où vous pouvez spécifier un ou plusieurs champs où chercher, comme De, À, Sujet, et Message. Après avoir choisi vos critères, utilisez les boutons <quote>Revenir</quote> et <quote>Avancer</quote> pour naviguer dans les messages correspondants, ou utilisez <quote>Chercher tous</quote> pour sélectionner tous les messages correspondants en une fois. Soyez conscients, toutefois, que la recherche dans le message entier est plus lente que la recherche dans les en-têtes, car les corps de messages ne sont pas dans les caches de Sylpheed-Claws. Il est aussi possible d'utilise la <quote>Recherche avancée</quote>, qui vous permet d'utiliser des expressions du type de celles utilisées dans les règles de filtrage.
</para>
<para>
Si vous cherchez une partie spécifique dans un long message, vous pourrez utiliser le menu <quote>Edition/Recherche dans le message...</quote>. Cela fonctionne comme la recherche dans un document texte.
</para>
<para>
- La dernière méthode pour rechercher est la Recherche rapide, que vous pouvez afficher ou cacher en cliquant sur la petite loupe sous la liste de messages. Elle est aussi accessible par le menu <quote>Edition/Recherche rapide</quote>. La recherche rapide est plus puissante que la recherche normale, car elle peut, en plus de chercher dans les en-têtes normaux, rechercher avec une pseudo-condition de filtrage lorsqu'elle est en mode <quote>Avancé</quote>. Dans ce mode, le bouton <quote>Syntaxe avancée...</quote> vous permettra de voir quelle syntaxe vous pouvez utiliser, et le bouton <quote>...</quote> vous permettra de créer une règle avec l'interface usuelle. Enfin, la recherche rapide peut chercher de manière récursive, dans les sous-dossiers du dossier courant.
+ La dernière méthode pour rechercher est la <quote>Recherche rapide</quote>, que vous pouvez afficher ou cacher en cliquant sur la petite loupe sous la liste de messages. Elle est aussi accessible par le menu <quote>Edition/Recherche rapide</quote>. La <quote>recherche rapide</quote> est plus puissante que la recherche normale, car elle peut, en plus de chercher dans les en-têtes normaux, rechercher avec une pseudo-condition de filtrage lorsqu'elle est en mode <quote>Avancé</quote>. Dans ce mode, le bouton <quote>Syntaxe avancée...</quote> vous permettra de voir quelle syntaxe vous pouvez utiliser, et le bouton <quote>...</quote> vous permettra de créer une règle avec l'interface usuelle. Enfin, la <quote>recherche rapide</quote> peut chercher de manière récursive, dans les sous-dossiers du dossier courant.
</para>
<para>
- Lorsque vous appuyez sur Entrée après avoir spécifié la chaîne de recherche, la liste de messages affichée va être réduite pour ne plus vous présenter que les messages correspondants. Si la recherche était récursive, les sous-dossiers contenant un ou des messages correspondants prendront une icône de loupe. Ceci vous permettra de rechercher dans tous vos messages, d'un seul coup. Enfin, le réglage <quote>Permanent</quote> de la recherche rapide permet d'avoir une recherche qui reste active lorsque vous changez de dossier, ou non. Cela peut permettre de chercher la même chose dans plusieurs dossiers sans pour autant chercher récursivement dans leur premier parent commun.
+ Lorsque vous appuyez sur Entrée après avoir spécifié la chaîne de recherche, la liste de messages affichée va être réduite pour ne plus vous présenter que les messages correspondants. Si la recherche était récursive, les sous-dossiers contenant un ou des messages correspondants prendront une icône de loupe. Ceci vous permettra de rechercher dans tous vos messages, d'un seul coup. Enfin, le réglage <quote>Permanent</quote> de la <quote>recherche rapide</quote> permet d'avoir une recherche qui reste active lorsque vous changez de dossier, ou non. Cela peut permettre de chercher la même chose dans plusieurs dossiers sans pour autant chercher récursivement dans leur premier parent commun.
</para>
</section>
<quote>Configuration</quote> menu, <quote>Filtering</quote> item. From
this dialogue you will be able to define new rules, modify or delete
existing rules, re-order the rules, and enable/disable them. Filtering
- rules are defined by four things: the enabled status, a name, a
- condition, and an action. All disabled rules are simply ignored. The
- name format is optional, it's there to help you identify your existing
- rules. The condition format is an expression defining what
- Sylpheed-Claws should look for when filtering emails, for example:
- <quote>to matchcase sylpheed-claws-users</quote> is for messages sent to
- any address containing <quote>sylpheed-claws-users</quote>. You can
+ rules are defined by five things: the enabled status, a name, an account
+ name, a condition, and an action. All disabled rules are simply ignored.
+ The <quote>Name</quote> entry is optional, it's there to help you
+ identify your rules. An account name can be chosen, which will restrict
+ the rule to mail retrieved from the named account only, skipping it for
+ mail retrieved from all other accounts. The default value is
+ <quote>All</quote>, which means that the rule is global and will
+ be applied to all mail, reagrdless of the account from which it was
+ retireved, (see paragraph below). The condition format is an expression
+ defining what Sylpheed-Claws should look for when filtering mail, for
+ example: <quote>to matchcase sylpheed-claws-users</quote> is for messages
+ sent to any address containing <quote>sylpheed-claws-users</quote>. You can
easily define conditions by clicking the <quote>Define...</quote> button
- at the right of the field. The third part of a filtering rule is the
- action, which instructs Sylpheed-Claws what to do with emails matching
+ at the right of the field. The last part of a filtering rule is the
+ action, which instructs Sylpheed-Claws what to do with mail matching
the condition we just defined. For example, <quote>mark_as_read</quote>
marks the mail as read as soon as it arrives in your inbox, or
<quote>move #mh/Mailbox/inbox/Friends</quote> moves the mail to your
<quote>Friends</quote> subfolder. Here, too, a <quote>Define...</quote>
button is available to help you define the action to take.
</para>
+ <para>
+ Filtering rules can be assigned to a single, specific account. To do
+ this select an account from the <quote>Account</quote> combo below the
+ <quote>Name</quote> entry. When you set a specific account the filtering
+ rule will only be applied to messages retrieved from the named account.
+ The default value is <quote>All</quote>, which means that the rule will
+ be appied globally, to messages retrieved from any account. When filtering
+ messages manually, if there are any per-account filtering rules defined,
+ you will be asked what you wish to do with those rules. Possible choices
+ are to skip the rules, or apply these rules regardless of the account to
+ which they belong, or use the rules for the currently selected account.
+ Caution: if you unset the <quote>Show this message next time</quote>
+ checkbox and click <quote>Filter</quote>, on subsequent manual filtering
+ this choice will be applied without any confirmation. Account specific
+ rules are only available for filtering, (at incorporation or manually),
+ the feature is not available for folder Processing or Pre/Post-Processing.
+ </para>
<para>
Once you have defined the rule, you can add it to the list of rules with
the <quote>Add</quote> button. Don't forget that the order of the rules
<quote>Find all</quote> to select all the matching emails at once. Be
aware that searching for text in the body of emails is much slower than
searching in its headers, because the body of emails isn't cached by
- Sylpheed-Claws.
+ Sylpheed-Claws. <quote>Extended Search</quote> mode can be turned on by
+ clicking the relevant checkbox, thus allowing you to use match expressions
+ like those used in <quote>Filtering</quote> rules.
</para>
<para>
If you're looking at a large email and want to find a particular part
the <quote>Edit</quote> menu. This works like search in a text document.
</para>
<para>
- The last way of searching for emails is using Quick Search, which you
- can display or hide using the little magnifying glass under the Message
- List. It's also accessible from the <quote>Quick Search</quote> item of
- the <quote>Edit</quote> menu. Quick Search is more powerful than the
- normal search as it can search in standard headers (From, To, Subject)
- or in <quote>Extended</quote> mode using just about any criteria you can
- think of. When in <quote>Extended</quote> mode, the
+ The final way of searching for emails is using <quote>Quick Search</quote>,
+ which you can display or hide by cilicking the little magnifying glass icon
+ under the Message List. It is also accessible from the <quote>Quick Search</quote>
+ item of the <quote>Edit</quote> menu. <quote>Quick Search</quote> is more
+ powerful than the normal search as it can search in standard headers (From,
+ To, Subject) or in <quote>Extended</quote> mode using just about any
+ criteria you can think of. When in <quote>Extended</quote> mode, the
<quote>Information</quote> button is visible, enabling you to see the
search syntax. An <quote>Edit</quote> button is also available which
- allows you to quickly create a rule. You can also configure the Quick
- Search to search recursively through the subfolders, and whether it
- should reset itself when you change folders.
+ allows you to quickly create a rule. You can also configure
+ <quote>Quick Search</quote> to search recursively through subfolders,
+ and whether it should reset itself when you change folders.
</para>
<para>
When you hit Enter after having specified the search string, the Message