2011-08-18 [paul] 3.7.9cvs49
[claws.git] / manual / handling.xml
index 62b8fab3f84c4ffa87f39313fe390cd5ae5776f4..1db710717252ba21915ba2119e26e5856cde0131 100644 (file)
@@ -8,7 +8,7 @@
        If you receive a lot of emails, you will probably soon find that your
        Inbox folder is growing to the point where you have a hard time finding
        an email again, even if you received it just a few days ago. This is why
        If you receive a lot of emails, you will probably soon find that your
        Inbox folder is growing to the point where you have a hard time finding
        an email again, even if you received it just a few days ago. This is why
-       Sylpheed-Claws, like most good mail clients, provides you with multiple
+       Claws Mail, like most good mail clients, provides you with multiple
        possibilities in organising your mails.
     </para>
     <para>
        possibilities in organising your mails.
     </para>
     <para>
     </para>
   </section>
 
     </para>
   </section>
 
+  <section id="imap_subscriptions">
+    <title>IMAP subscriptions</title>
+    <para>
+       The IMAP protocol allows one to store a list of subscribed folders. Most
+       mail user agents hide the unsubscribed folders away from the GUI, and have
+       a little window allowing to subscribe to these unsubscribed folders. In
+       Claws Mail, subscriptions are respected by default, and only subscribed
+       folders will be displayed. If you want to see all your folders, you can just
+       uncheck <quote>Show subscribed folders only</quote> in the IMAP mailbox'
+       contextual menu or the account preferences. You'll be able to subscribe and 
+       unsubscribe folders from this contextual menu too. If the unsubscribed 
+       folders are hidden from the list, you will have two ways to subscribe to 
+       a folder: either show all folders, subscribe the ones you want, and hide 
+       unsubscribed folders again; or, if you know the folder's name, use 
+       <quote>Create new folder</quote> in its parent's contextual menu.
+    </para>
+  </section>
+
   <section id="handling_filters">
     <title>Filtering</title>
     <para>
        Once you have a nice folder hierarchy in place, you'll probably want
   <section id="handling_filters">
     <title>Filtering</title>
     <para>
        Once you have a nice folder hierarchy in place, you'll probably want
-       Sylpheed-Claws to sort your incoming emails automatically, in order to
+       Claws Mail to sort your incoming emails automatically, in order to
        avoid having to move messages manually each time they arrive. For this
        you can use the Filtering feature.
     </para>
        avoid having to move messages manually each time they arrive. For this
        you can use the Filtering feature.
     </para>
        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
        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
+       be applied  to all mail, regardless of the account from which it was
+       retrieved, (see paragraph below). The condition format is an expression
+       defining what Claws Mail should look for when filtering mail, for
+       example: <quote>to matchcase claws-mail-users</quote> is for messages
+       sent to any address containing <quote>claws-mail-users</quote>. You can
        easily define conditions by clicking the <quote>Define...</quote> button
        at the right of the field. The last part of a filtering rule is the
        easily define conditions by clicking the <quote>Define...</quote> button
        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
+       action, which instructs Claws Mail 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
        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>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
        <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
+       be applied 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
        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
     <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
     <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
-       is important: if Sylpheed-Claws finds a rule suitable for an email that
+       is important: if Claws Mail finds a rule suitable for an email that
        either moves or deletes the email, it will stop looking for further
        rules for that email. This is why, at the right of the rules list, you
        will find four buttons allowing the re-ordering of rules. The rules can
        either moves or deletes the email, it will stop looking for further
        rules for that email. This is why, at the right of the rules list, you
        will find four buttons allowing the re-ordering of rules. The rules can
        <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
        <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. <quote>Extended Search</quote> mode can be turned on by
+       Claws Mail. <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>
        clicking the relevant checkbox, thus allowing you to use match expressions
        like those used in <quote>Filtering</quote> rules.
     </para>