2006-01-19 [paul] 1.9.100cvs172
authorPaul Mangan <paul@claws-mail.org>
Thu, 19 Jan 2006 14:14:29 +0000 (14:14 +0000)
committerPaul Mangan <paul@claws-mail.org>
Thu, 19 Jan 2006 14:14:29 +0000 (14:14 +0000)
* manual/account.xml
* manual/addrbook.xml
* manual/advanced.xml
* manual/faq.xml
* manual/handling.xml
* manual/intro.xml
* manual/plugins.xml
* manual/starting.xml
more editing

ChangeLog
PATCHSETS
configure.ac
manual/account.xml
manual/addrbook.xml
manual/advanced.xml
manual/faq.xml
manual/handling.xml
manual/intro.xml
manual/plugins.xml
manual/starting.xml

index d2706e3..2ea1024 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+2006-01-19 [paul]      1.9.100cvs172
+
+       * manual/account.xml
+       * manual/addrbook.xml
+       * manual/advanced.xml
+       * manual/faq.xml
+       * manual/handling.xml
+       * manual/intro.xml
+       * manual/plugins.xml
+       * manual/starting.xml
+               more editing
+
 2006-01-19 [paul]      1.9.100cvs171
 
        * src/toolbar.c
index f1771c6..92caa17 100644 (file)
--- a/PATCHSETS
+++ b/PATCHSETS
 ( cvs diff -u -r 1.14.2.32 -r 1.14.2.33 src/plugins/trayicon/trayicon.c;  ) > 1.9.100cvs169.patchset
 ( cvs diff -u -r 1.1.2.31 -r 1.1.2.32 src/gtk/quicksearch.c;  cvs diff -u -r 1.382.2.227 -r 1.382.2.228 src/compose.c;  ) > 1.9.100cvs170.patchset
 ( cvs diff -u -r 1.43.2.38 -r 1.43.2.39 src/toolbar.c;  ) > 1.9.100cvs171.patchset
+( cvs diff -u -r 1.1.2.3 -r 1.1.2.4 manual/account.xml;  cvs diff -u -r 1.1.2.2 -r 1.1.2.3 manual/addrbook.xml;  cvs diff -u -r 1.1.2.7 -r 1.1.2.8 manual/advanced.xml;  cvs diff -u -r 1.1.2.5 -r 1.1.2.6 manual/faq.xml;  cvs diff -u -r 1.1.2.3 -r 1.1.2.4 manual/handling.xml;  cvs diff -u -r 1.1.2.2 -r 1.1.2.3 manual/intro.xml;  cvs diff -u -r 1.1.2.4 -r 1.1.2.5 manual/plugins.xml;  cvs diff -u -r 1.1.2.2 -r 1.1.2.3 manual/starting.xml;  ) > 1.9.100cvs172.patchset
index ece80df..21d6552 100644 (file)
@@ -11,7 +11,7 @@ MINOR_VERSION=9
 MICRO_VERSION=100
 INTERFACE_AGE=0
 BINARY_AGE=0
-EXTRA_VERSION=171
+EXTRA_VERSION=172
 EXTRA_RELEASE=
 EXTRA_GTK2_VERSION=
 
index 80998ec..beef9ba 100644 (file)
@@ -5,59 +5,91 @@
   <section id="account_basic">
     <title>Basic preferences</title>
     <para>
-    The first tab of the account preferences contains, as its name indicates, basic account data. In this tab you can specify your name, email address, organization and basic connection information.  The name of the account is just the name Sylpheed-Claws will use when referring to this account, for example in the account switcher at the lower right-hand corner of the main window.  The server information lets you specify the receiving protocol to use (which is not modifiable for existing accounts), the server(s) used to receive or send your emails (usually pop.isp.com and smtp.isp.com) and your login on the receiving server.  
+    The first tab of the account preferences, Basic, contains, as its name indicates, basic account data. In this tab you can specify your name, email address, organization and basic connection information.  The name of the account is just the name Sylpheed-Claws will use when referring to this account, for example, in the account switcher at the lower right-hand corner of the main window.  The server information lets you specify the receiving protocol to use (which is not modifiable for existing accounts), the server(s) used to receive or send your emails (usually pop.isp.com and smtp.isp.com) and your login on the receiving server.  
     </para>
     <para>
-    In the Receive tab, you'll be able to change the default behaviour of Sylpheed-Claws, for example to leave messages on the server for a while, prevent downloading of too big mails, or specify whether you want the filtering rules to apply to this account's mails or not. The "Receive size limit" is used to limit the time spent downloading big emails. Whenever you receive a mail bigger than this limit, it will be partially downloaded, and you will later have the choice to either download it entirely or delete it from the server. This choice will be presented to you while viewing the email.
+    In the Receive tab you are able to change the default behaviour of Sylpheed-Claws. For example, leaving messages on the server for a while, preventing downloading of mails that are too large, or specifying whether you want the filtering rules to apply to this account's mails. The "Receive size limit" is used to limit the time spent downloading large emails. Whenever you receive a mail larger than this limit, it will be partially downloaded and you will later have the choice to either download it entirely or delete it from the server. This choice will be presented to you while viewing the email.
     </para>
     <para>
-    The Send tab contains preferences about special headers you'd want to add to your outgoing emails, like an X-Face, and authentication information for sending emails. Most of the time, your ISP allows its subscribers to send email via the SMTP server without authenticating, but in some setups, you have to identify yourself before sending. There are different possibilities for doing that. The best one, when available, is SMTP AUTH; when it isn't available, you'll usually use POP-before-SMTP, which connects to the POP server (which is authenticated), disconnects, and sends the mail. 
+    The Send tab contains preferences for special headers that you might want to add to your outgoing emails, like an X-Face, and authentication information for sending emails. Most of the time, your ISP allows its subscribers to send email via the SMTP server without authenticating, but in some setups, you have to identify yourself before sending. There are different possibilities for doing that. The best one, when available, is SMTP AUTH. When not available, you'll usually use POP-before-SMTP, which connects to the POP server, (which is authenticated), disconnects, and sends the mail.
     </para>
     <para>
-    The Compose tab allows to change the behaviour of the Composition window when used with the account. For example, you can specify a signature to use automatically, and to set default Cc, Bcc or Reply-To address.
+    The Compose tab holds options for changing the behaviour of the Composition window when used with the account. You can specify a signature to insert automatically, and set default Cc, Bcc or Reply-To addresses.
     </para>
     <para>
-    In the privacy tab, you can choose the default level of paranoia for your account. You might want all outgoing emails to be digitally signed and/or encrypted. Signing all outgoing emails, not only important ones, will for example allow you to protect yourself from faked mails sent on your behalf to coworkers. This can help solving embarrassing situations.
+    In the Privacy tab you can choose the default level of paranoia for your account. You might want all outgoing emails to be digitally signed and/or encrypted. Signing all outgoing emails, not only important ones, will for example allow you to protect yourself from faked mails sent on your behalf to coworkers. This can help solve embarrassing situations.
     </para>
     <para>
-    The SSL tab is also a security-related one, although this time its setting applies to the transport of your emails and not their storage.  Basically, using SSL encrypts the connection between you and the server, which prevents people from snooping on your connection and be able to read your mails and your password. SSL should be used if it is available.
+    The SSL tab is also security related, although this time its settings apply to the transport of your emails and not their content.  Basically, using SSL encrypts the connection between you and the server, which prevents people from snooping on your connection and being able to read your mails and your password. SSL should be used if it is available.
+    </para>
+    <para>
+    Finally, the Advanced tab allows you to specify ports and domains if the defaults are not used. Normally you can leave these empty. You can also specify folders for sent, queued, draft, and deleted messages here.
     </para>
   </section>
 
   <section id="account_types">
     <title>Account types</title>
     <para>
-    We saw earlier that once an account is created, you can't change its type (protocol) anymore. This is because preferences for these different types are quite not the same, and most of the POP3 related options have no interest on IMAP, for example.
+    We saw earlier that once an account is created, you can't change its type (protocol) anymore. This is because preferences for these different types are not quite the same, most of the POP3 related options are irrelevant for IMAP, for example.
+    </para>
+    <section id="pop3">
+    <title>POP3</title>
+    <para>
+    POP3 is one of the two most used protocols and is available at almost every ISP on Earth. Its advantage is that it allows you to download email to your computer, which means that accessing your mail will be really fast once you have it on your hard disk. The disadvantage of POP3 is that it is more difficult to keep your mail synchronised on multiple computers, (you'll have to keep the mail on the server for a few days), and you won't be able to easily keep track of which mails you have read, or which mails you have replied to, etc., when using another computer.
+    </para>
+    <para>
+     Mail received from a POP3 account will be stored in an MH mailbox in the folder tree.
     </para>
+    </section>
+    <section id="imap">
+    <title>IMAP</title>
     <para>
-    POP3 is one of the two most used protocol, and is available at almost any ISP on the earth. Its advantage is to allow you to download email locally, which means it'll be really fast to access once you have it on your hard disk. The disadvantage of POP3 is that it is more hard to receive your mail on multiple computers (you'll have to keep them on the server for a few days), and that you won't be able to keep track of which mail you read or not when using another computer.
+    IMAP is the second most used protocol and its goal is to address the shortcomings of POP3. When using IMAP your folder list and your emails are all kept on a central server. This slows down navigation a little as each mail is downloaded on demand, but when you use another computer, or email client, your emails will be in the same state that you left them, including their status (read, unread, replied, etc.).
     </para>
     <para>
-    IMAP is the second most used protocol, and its goal is to address the defaults of POP3. When using IMAP, your folder list and your emails are all kept on the server. This slows down a bit navigation as each mail is downloaded on demand, but when you use another computer or email client, you find back your emails the same way you left them, including their status (read, unread, flagged, ...).
+    When you create an IMAP account an IMAP mailbox is created for it in the folder tree.
     </para>
+    </section>
+    <section id="news">
+    <title>News</title>
     <para>
-    News (NNTP) is the other name of Usenet, a worldwide infrastructure that allow people to subscribe and post to Newsgroups. The principle is about the same as web forums: public discussions centered on different interests. Usenet exists since the beginning of Internet and can be a great tool to find help or information, as well as a great tool to waste your time!
+           News (NNTP) is the protocol for sending and receiving USENET articles. Messages are held on a central server and downloaded on demand. They cannot be deleted by the user.
     </para>
     <para>
-    Finally, the 'Local MBOX file' type of account can be used if you run an SMTP server on your computer and/or want to receive your logs easily.
+    When you create a News account a News mailbox is created for it in the folder tree.
     </para>
+    </section>
+    <section id="local">
+    <title>Local</title>
     <para>
-    The account type 'None, SMTP only' is a special type of account as it won't retrive any email, but rather will allow you to create different identities. They're used to send out emails with various aliases for example.
+    The 'Local MBOX file' type of account can be used if you run an SMTP server on your computer and/or want to receive your logs easily.
     </para>
+    <para>
+    Mail received from a Local account is stored in an MH mailbox in the folder tree.
+    </para>
+    </section>
+    <section id="smtp_only">
+    <title>SMTP only</title>
+    <para>
+    The account type 'None, (SMTP only)' is a special type of account that won't retrieve any mail, but will allow you to create different identities that can be used to send out emails with various aliases, for example.
+    </para>
+    </section>
   </section>
 
   <section id="account_multiple">
     <title>Multiple accounts</title>
     <para>
-    You can easily create multiples accounts in Sylpheed-Claws. For POP accounts, you can choose whether to receive the emails from the different accounts in the same folder(s) or not, using the Receive tab preference.  For IMAP and News accounts, each of them will get its own subtree in the folder tree.
-    You can choose which accounts get checked for new mail when using the "Get All" command (or "Get Mail" in the toolbar) by checking the relevant box in their preferences' Receive tab or in the 'G' column of your accounts' list.
+    You can easily create multiple accounts in Sylpheed-Claws. For POP accounts, you can choose to store all email from your different accounts in the same folder(s), using the Receive tab preference.  IMAP and News accounts each get their own mailbox in the folder tree.
+    </para>
+    <para>
+    You can choose which accounts get checked for new mail when using the "Get All" command (or "Get Mail" in the toolbar) by checking the relevant box in the Receive tab of their preferences or in the 'G' column of your accounts list.
     </para>
   </section>
 
   <section id="account_morefilt">
     <title>More filtering</title>
     <para>
-    The filtering rules are global. That means that mails from various accounts can get filtered in other accounts' folders, for example a mail received over POP3 could get filtered in an IMAP account. This is either an useful feature or an annoying one, depending on what you want to do.  If you'd rather avoid that, the best thing to do is to disable Filtering on the accounts, and use Processing rules in the various Inbox folders you specified.
+    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.
     </para>
   </section>
 
index 840691a..fbce173 100644 (file)
@@ -7,9 +7,9 @@
     <para>
        The address book is accessible via the <quote>Tools/Address book</quote> menu. It is arranged in different sections: the <quote>Address Book</quote> and its subsections, which contain the contacts that you added locally; the vCard sections, which contain imported vCards; and, if support for them was built into Sylpheed-Claws, the LDAP and jPilot sections, containing contacts from your LDAP servers or handheld devices.
     </para><para>
-       In the <quote>Address Book</quote> section, you can create multiple address books, each one being able to contain addresses and/or folders. This can help you organizing your contacts per category. In addition to this, you can create groups of addresses, which can then be used from the composition window to send mails to multiple people at once.
-       The menus in the address book's window allow you to do all of this. For example, you can create a <emphasis>Family</emphasis> folder inside your <quote>Personal Addresses</quote> address book, using the <quote>Book/New folder</quote> menu when <quote>Personal Addresses</quote> is selected, or by right-clicking on it. In the same way, you can add contacts to an address book or folder by using the <quote>Address</quote> menu, or by right-clicking an item in the list in the right-hand part of the window.
-       When adding a contact, a new window will popup, where you'll be able to specify the details of the contact in the first tab (<emphasis>Display Name, First Name, ...</emphasis>), and a list of email addresses in the second tab.
+       In the <quote>Address Book</quote> section, you can create multiple address books; each one is able to contain addresses and/or folders. This can help you in organising your contacts by category. In addition to this, you can create groups of addresses, which can be used from the composition window to send mails to multiple people at once.
+       The menus in the address book window allow you to do all of this. For example, you can create a <emphasis>Family</emphasis> folder inside your <quote>Personal Addresses</quote> address book, using the <quote>Book/New folder</quote> menu when <quote>Personal Addresses</quote> is selected, or by right-clicking on it. In the same way, you can add contacts to an address book or folder by using the <quote>Address</quote> menu, or by right-clicking an item in the list in the right-hand part of the window.
+       When adding a contact, a new window will appear, where you'll be able to specify the details of the contact in the first tab (<emphasis>Display Name, First Name, ...</emphasis>), and a list of email addresses in the second tab.
     </para><para>
        A simpler way to save your contacts to your address book is to save them when reading one of their emails, using the <quote>Tools/Add sender to address book</quote> menu, or by right-clicking on an email address in the message view.
     </para>
index 825adf4..f458477 100644 (file)
   <section id="adv_templates">
     <title>Templates</title>
     <para>
-    Templates are used in Composition windows, and act as a model for emails. Templates can be filled with static text and dynamic parts, such as the original sender's name ("Dear %N, ..."), the date, ... When applying a template, the dynamic fields will be replaced with the relevant values. You can configure templates via the Tools menu.
+    Templates are used in composition windows, and act as a model for emails. Templates can be filled with static text and dynamic parts, such as the original sender's name ("Dear %N, ..."), the date, etc. When applying a template, the dynamic fields will be replaced with the relevant values. You can configure templates via the Tools menu.
     </para>
   </section>
   <section id="adv_processing">
     <title>Processing</title>
     <para>
-    Processing rules are the same as Filtering rules, except that they are applied when entering a folder and apply only to this folder. You can use them to automatically move old mails into an archive folder, or for further dispatching of emails. You can set each folder's Processing rules by right-clicking on it.
+    Processing rules are the same as Filtering rules, except that they are applied when entering a folder and apply only to this folder. You can use them to automatically move old mails into an archive folder, or for further dispatching of emails, and more. You can set each folder's Processing rules by right-clicking on it.
     </para>
     <para>
-    Processing rules are accompanied by Pre-processing and Post-processing rules. Like Processing rules, they apply only when opening a folder, but like Filtering rules, they are shared accross all folders. You can configure them from the Tools menu. Pre-processing rules are executed before the folder's specific Processing rules, while Post-processing ones are executed after.
+    Processing rules are accompanied by Pre-processing and Post-processing rules. Like Processing rules, they apply only when opening a folder, but like Filtering rules, they are shared accross all folders. You can configure them from the Tools menu. Pre-processing rules are executed before the folder's specific Processing rules, while Post-processing rules are executed afterwards.
     </para>
   </section>
   <section id="adv_plugins">
     <title>Plugins</title>
     <para>
-      Plugins are the mechanism of extending Sylpheed-Claws' capabilities. Imagine that you want to store your mails in a remote <acronym>SQL</acronym> database. In most mailers out there this is simply impossible without reworking the internals of the mailer. With Sylpheed-Claws you can simply write a plugin to achieve the task.
+      Plugins are the mechanism for extending Sylpheed-Claws' capabilities. For eample, imagine that you want to store your mails in a remote <acronym>SQL</acronym> database. In most mailers out there this is simply impossible without reworking the internals of the mailer. With Sylpheed-Claws you can simply write a plugin to achieve the task.
     </para>
     <para>
            This is just an example of the possibilities. A good number of plugins developed for Sylpheed-Claws  already exist, and more are to come. The <link linkend="ch_plugins">Extending Sylpheed-Claws section</link> gives details of them.
@@ -70,9 +70,6 @@
            <varlistentry><term>bold_unread</term>
                    <listitem><para>show unread messages using bold font in summary view</para></listitem>
             </varlistentry>
-           <varlistentry><term>color_new</term>
-                   <listitem><para>colour (as hex triplet) of folder name when indicating new messages</para></listitem>
-            </varlistentry>
            <varlistentry><term>cache_max_mem_usage</term>
                    <listitem><para>the maximum amount of memory to use to cache messages, in kB.</para></listitem>
            </varlistentry>
index cc580c0..4fd7b76 100644 (file)
@@ -7,7 +7,7 @@
            Sylpheed-Claws is the <emphasis>extended</emphasis> version of Sylpheed, therefore you will find that it has all the features that Sylpheed has and a lot more besides. It also includes some modified dialogues to enhance usability. Further information can be found at <ulink url="http://claws.sylpheed.org/features.php">http://claws.sylpheed.org/features.php</ulink>.
     </para></section>
     <section>
-    <title>What does the <quote>Sylpheed</quote> mean?</title>
+    <title>What does the word <quote>Sylpheed</quote> mean?</title>
     <para>
        <quote>Sylpheed</quote> is a corruption of the word <emphasis>Sylph</emphasis>. Sylphs are invisible beings (spirits) of the air.
     </para></section>
        No. A discussion has gone on around this topic, and the outcome was that HTML mail is not wanted. If you really need to send HTML, you can of course attach a webpage to an email.
     </para></section>
     <section>
-    <title>How can I send in patches, report bugs, and talk about Sylpheed-Claws with others?</title>
+    <title>How can I submit patches, report bugs, and talk about Sylpheed-Claws with others?</title>
+    <para>
+        Patches should be submitted via the SourceForge project Patch Tracker at <ulink url='http://sourceforge.net/tracker/?group_id=25528&amp;atid=384600'>http://sourceforge.net/tracker/?group_id=25528&amp;atid=384600</ulink>, but please follow the patch guidelines at <ulink url="http://claws.sylpheed.org/devel.php">http://claws.sylpheed.org/devel.php</ulink>.
+    </para>
+    <para>
+        Bug reports should be submitted at our Bugzilla, <ulink url="http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/">http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/</ulink>.
+    </para>
     <para>
        To talk to others, you should join the Sylpheed-Claws users' mailing list at <ulink url="http://claws.sylpheed.org/MLs.php">http://claws.sylpheed.org/MLs.php</ulink>.
-    </para></section>
+    </para>
+    </section>
     <section>
     <title>Does Sylpheed-Claws have an anti-spam feature?</title>
     <para>
index 205ccb0..bcca7b7 100644 (file)
@@ -5,24 +5,24 @@
   <section id="handling_folders">
     <title>Mail folders</title>
     <para>
-       If you receive a lot of emails, you will probably soon find that your Inbox folder is growing to a 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 possibilities in organising your mails.
+       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 possibilities in organising your mails.
     </para>
     <para>
        You can create as many folders and subfolders as you need. For example, one folder for your family, one folder for friends, folders for mailing-lists, archive folders for old mails that you still want to have available, etc.
-       To create a new folder, simply right-click on its parent folder and choose <quote>New folder...</quote> from the drop-down menu. If you want to create a folder 'Friends' inside your Inbox folder, for example, just right-click on the Inbox folder, choose <quote>New folder...</quote>, and type in 'Friends' in the dialogue that pops up. Click the OK button, and the new folder is created.
+       To create a new folder, simply right-click on its parent folder and choose <quote>New folder...</quote> from the drop-down menu. If you want to create a folder 'Friends' inside your Inbox folder, for example, just right-click on the Inbox folder, choose <quote>New folder...</quote>, and type in 'Friends' in the dialogue that appears. Click the OK button, and the new folder is created.
     </para>
   </section>
 
   <section id="handling_organisation">
     <title>Folder organisation</title>
     <para>
-       Now that you have created folders, you can manipulate them and their contents using menu items or drag'n'drop. Moving a folder into another one, for example, can be done by right-clicking on the folder you want to move, choosing the <quote>Move folder...</quote> menu item, and selecting the destination folder. This will move the folder, with the mail it contains, to a subfolder of the chosen folder. Alternatively, you can drag a folder to another one by clicking on it, keeping the mouse button down, moving the mouse cursor over the destination folder and releasing the button.
+       Now that you have created folders, you can manipulate them and their contents using menu items or drag 'n' drop. Moving one folder into another, for example, can be done by right-clicking on the folder you want to move, choosing the <quote>Move folder...</quote> menu item, and selecting the destination folder. This will move the folder, with the mail it contains, to a subfolder of the chosen folder. Alternatively, you can drag a folder to another one by clicking on it, keeping the mouse pressed, moving the mouse cursor over the destination folder and releasing the button.
     </para>
     <para>
        If you want to remove a folder and the mail it contains, simply right-click on the folder and choose <quote>Delete folder...</quote>. As this is potentially harmful, (the mails in the folder will be deleted and not recoverable), you will be asked for confirmation.
     </para>
     <para>
-       In the same manner that you move a folder to another one, you can move emails from one folder to another. The same method applies for this: either drag'n'drop emails to a folder, or choose <quote>Move...</quote> after right-clicking on the mail. You can select multiple emails by using the Control or Shift key while clicking on them. You can also copy emails to another folder by pressing the Control key when drag'n'dropping, or by choosing <quote>Copy...</quote> from the email's contextual menu.
+       In the same manner that you move a folder to another one, you can move emails from one folder to another. The same method applies for this: either drag 'n' drop emails to a folder, or choose <quote>Move...</quote> after right-clicking on the mail. You can select multiple emails by using the Control or Shift key while clicking on them. You can also copy emails to another folder by pressing the Control key when drag'n'dropping, or by choosing <quote>Copy...</quote> from the email's contextual menu.
     </para>
   </section>
 
        You will find the filtering preferences via the <quote>Configuration</quote> menu, <quote>Filtering</quote> item. From this dialogue you will be able to define new rules, modify or delete existing rules, and re-order them. Filtering rules are defined by three things: a name, a condition, and an action. 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: 'to matchcase sylpheed-claws-users' is for messages sent to any address containing 'sylpheed-claws-users'. 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 the condition we just defined. For example, 'mark_as_read' marks the mail as read as soon as it arrives in your inbox, or 'move #mh/Mailbox/Friends' moves the mail to your 'Friends' subfolder. Here, too, a <quote>Define...</quote> button is available to help you define the action to take.
     </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 is important: if Sylpheed-Claws 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 also be reordered by drag'n'drop.
+       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 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 also be reordered by drag 'n' drop.
     </para>
     <para>
-       There is also a quick method of creating filtering rules based on a message. After selecting a mail of the type you want to filter, choose <quote>Create filter rule...</quote> from the <quote>Tools</quote> menu, and choose a type from the submenu: <quote>Automatically</quote> mainly helps for mailing-lists posts, <quote>by From</quote> creates a filter based on the sender of the email, <quote>by To</quote> creates a filter based on the recipient, and <quote>by Subject</quote> creates a filter based on the subject. Each one of these types of filtering has its advantages, it's up to you to find out what would be the more practical. Usually, <quote>by From</quote> is nice to sort out your regular contacts' mails, whereas <quote>by To</quote> is more useful to sort mails sent to your different accounts.
+       There is also a quick method of creating filtering rules based on the selected message. After selecting a mail of the type you want to filter, choose <quote>Create filter rule...</quote> from the <quote>Tools</quote> menu, and choose a type from the submenu: <quote>Automatically</quote> mainly helps for mailing-lists posts, <quote>by From</quote> creates a filter based on the sender of the email, <quote>by To</quote> creates a filter based on the recipient, and <quote>by Subject</quote> creates a filter based on the subject. Each one of these types of filtering has its advantages, it's up to you to find out what would be the more practical. Usually, <quote>by From</quote> is nice to sort out your regular contacts' mails, whereas <quote>by To</quote> is more useful to sort mails sent to your different accounts.
     </para>
   </section>
 
   <section id="handling_searching">
     <title>Searching for mails</title>
     <para>
-       There is more than one way to search your emails.
+       There are several methods for searching your emails.
     </para>
     <para>
-       One of them is relatively standard, and can be found in the <quote>Edit</quote> menu: it's the <quote>Search folder...</quote> item. This will open a window where you can specify one or more fields to search in: From, To, Subject, and Body. After having specified your criteria, click on the <quote>Back</quote> or <quote>Forward</quote> buttons to navigate through the matching emails, or use <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.
+       One of them is relatively standard, and can be found in the <quote>Edit</quote> menu, it's the <quote>Search folder...</quote> item. This will open a window where you can specify one or more fields to search in: From, To, Subject, and Body. After having specified your criteria, click on the <quote>Back</quote> or <quote>Forward</quote> buttons to navigate through the matching emails, or use <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.
     </para>
     <para>
        If you're looking at a large email and want to find a particular part of it, you can use the <quote>Find in current message...</quote> item of the <quote>Edit</quote> menu. This works like search in a text document.
     </para>
     <para>
-       The last way of searching for emails is using the 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. This Quick Search is more powerful than the normal search: it can search in standard headers (From, To, Subject) or in <quote>Extended</quote> mode using just about anything you could think of. When in <quote>Extended</quote> mode, an <quote>Extended symbols</quote> button is visible, enabling you to see the search syntax. A <quote>...</quote> button is also available which allows you to quickly create a rule. You can also configure the Quick Search to search recursively or not, and whether it should reset itself when you change folders.
+       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 <quote>Extended symbols</quote> button is visible, enabling you to see the search syntax. A <quote>...</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.
     </para>
     <para>
-       When you hit Enter after having specified the search string in the Quick Search, the message list will shrink to present you with only the relevant messages. If you set the search to be recursive, any subfolder of the current one that has matching emails will change its icon to a magnifying glass icon. This way, you can search in your whole mailbox at once. If the search is in Sticky mode, the filter will stay applied when you go to another folder. This can be disturbing at first, as you can forget about it, but is useful in some cases, for example if you want to search in the body of emails and are not sure of which folder contains the searched email: a recursive search on the body of emails in a whole mailbox can be really slow.
+       When you hit Enter after having specified the search string, the message list will shrink to present you with only the matching messages. If you set the search to be recursive, any subfolder of the current one that has matching emails will change its icon to a magnifying glass icon. This way, you can search in your whole mailbox at once. If the search is in Sticky mode, the filter will stay applied when you go to another folder. This can be disturbing at first, as you can forget about it, but is useful in some cases, for example if you want to search in the body of emails and are not sure of which folder contains the searched email: a recursive search on the body of emails in a whole mailbox can be really slow.
     </para>
   </section>
 
index 88e7689..cd19339 100644 (file)
@@ -3,7 +3,7 @@
 <title>Introduction</title>
 
   <section id="intro_what">
-    <title>What is Sylpheed-Claws</title>
+    <title>What is Sylpheed-Claws?</title>
     <para>
        Sylpheed-Claws is an email client aiming at being fast, easy-to-use and powerful. It is mostly desktop-independent, but tries to integrate with your desktop as best as possible. The Sylpheed-Claws developers try hard to keep it lightweight, so that it should be usable on low-end computers without much memory or CPU power.
     </para>
   <section id="intro_features"> 
     <title>Main features</title>
     <para>
-       Sylpheed-Claws sports almost everything a perfect email client needs. Mail retrieval over POP3, IMAP4, local mbox, over SSL; support for various authentication schemes. It has multiple accounts and mailboxes, powerful filtering and search functionality, import/export capabilities using a number of formats, PGP (digital signatures). It supports plugins, customisable toolbars, a number of guards to prevent any data loss, spell checking, per-folder preferences, and much more. A complete list of features can be found at <ulink url="http://claws.sylpheed.org/features.php">http://claws.sylpheed.org/features.php</ulink>.
+           Sylpheed-Claws sports almost everything a perfect email client needs. Mail retrieval over POP3, IMAP4, local mbox, over SSL; support for various authentication schemes. It has multiple accounts and mailboxes, powerful filtering and search functionality, import/export capabilities using a number of formats, support for GnuPG (digital signatures and encryption). It supports plugins, customisable toolbars, spell checking, and has a number of guards to prevent any data loss, per-folder preferences, and much more. A complete list of features can be found at <ulink url="http://claws.sylpheed.org/features.php">http://claws.sylpheed.org/features.php</ulink>.
     </para>
   </section>
 
   <section id="intro_history">
     <title>History of Sylpheed-Claws</title>
     <para>
-       Sylpheed-Claws has existed since April 2001. The primary goal of Sylpheed-Claws was to be a test-bed for potentially new features of Sylpheed (<ulink url="http://sylpheed.good-day.net">http://sylpheed.good-day.net</ulink>), so that new features can be tested thoroughly without compromising Sylpheed's stability. Sylpheed-Claws developers synced regularly their codebase with Sylpheed's, and Sylpheed's author, Hiroyuki Yamamoto, took back the new features he liked once they were stabilised.
+       Sylpheed-Claws has existed since April 2001. The primary goal of Sylpheed-Claws was to be a test-bed for potential features of Sylpheed (<ulink url="http://sylpheed.good-day.net">http://sylpheed.good-day.net</ulink>), so that new features could be tested thoroughly without compromising Sylpheed's stability. Sylpheed-Claws developers regularly synchronised their codebase with Sylpheed's codebase, and Sylpheed's author, Hiroyuki Yamamoto, took back the new features he liked once they were stabilised.
     </para><para>
-       Originally both Sylpheed and Sylpheed-Claws were based on GTK1. The work on the GTK2 versions started in early 2003, and the first modern (GTK2-based) Sylpheed-Claws was released in March 2005. Since about this time, Sylpheed and Sylpheed-Claws' goals started to diverge more, and Sylpheed-Claws is now an entity of its own.
+       Originally both Sylpheed and Sylpheed-Claws were based on GTK1. The work on the GTK2 versions started in early 2003, and the first modern (GTK2-based) Sylpheed-Claws was released in March 2005. Since about this time, Sylpheed and Sylpheed-Claws' goals started to diverge more, and Sylpheed-Claws became an entity of its own.
     </para>
   </section>
 
index a380f5c..83788f4 100644 (file)
@@ -5,7 +5,7 @@
   <section id="plugins_default">
     <title>Provided plugins</title>
     <para>
-       Sylpheed-Claws' capabilities are extended by plugins. It comes with the following plugins included, all of which are built automatically if the required libraries are present.
+       Sylpheed-Claws' capabilities are extended by plugins. It comes with the plugins listed below included, all of which are built automatically if the required libraries are present.
     </para><para>
        Plugins are installed in $PREFIX/lib/sylpheed-claws/plugins/ and have a suffix of <quote>.so</quote> To load a plugin go to <quote>Configuration/Plugins</quote> and click the <quote>Load Plugin</quote> button. Select the plugin that you want and click OK.
     </para><para>
index 33619e7..08ee7b6 100644 (file)
                            </para></listitem>
            </varlistentry>
            <varlistentry><term>Local mbox file</term>
-                   <listitem><para>If you choose Local mbox file, you will need to enter the location of your local mailbox file.
+                   <listitem><para>If you choose Local mbox file, you will need to enter the location of your local mailbox spool file.
                            </para></listitem>
            </varlistentry>
     </variablelist></blockquote>
-<para>If you chose either POP3 or Local mbox file, the next page  will ask you where to save your mail on disk. The default, <quote>Mail</quote>, is usually ok and will save your mails in a directory called <quote>Mail</quote> in your home directory.
+<para>If you chose either POP3 or Local mbox file, the next page  will ask you where you want to save your mail on disk. The default, <quote>Mail</quote>, is usually ok and will save your mails in a directory called <quote>Mail</quote> in your home directory.
     </para><para>If Sylpheed-Claws is built with support for OpenSSL, you will next see the <quote>Security</quote> page, here you will be able to choose to use SSL encryption to send and receive your emails. Most ISPs do not enable this, but many companies do; if you're unsure about it, you can leave them unselected.
     </para><para>
        You can now click on the Save button, and start enjoying Sylpheed-Claws.
   <section id="start_writing">
     <title>Writing your first mail</title>
     <para>
-       When clicking on the <quote>Compose</quote> button of the toolbar, a composition window will open. This window contains different fields which you should be able to recognise easily: the From field can be used to select which account you want to use with this email, in the case that you have multiple accounts; the To field is for recipient of the email. When you fill it up, a second To field will appear, so that you can send the email to multiple recipients. You can also change the To field to a Cc field or other types of fields, by using its dropdown menu. After that, you will be able to set the subject of your email, then type its body.
+       When clicking on the <quote>Compose</quote> button of the toolbar, a composition window will open. This window contains different fields which you should be able to recognise easily: if you have mulitple accounts, the From field can be used to select which account you want to use for this email; the To field is for recipient of the email. When you fill it in, a second To field will appear, so that you can send the email to multiple recipients. You can also change the To field to a Cc field or other types of fields, by using its dropdown menu, or by typing in the field that you require. After that, you will be able to set the subject of your email, then type its body.
     </para><para>
-       A little note about an email's subject: Sylpheed-Claws will ask you for confirmation if you attempt to send an email with an empty subject. This is because it can be annoying for the recipient to receive emails with no subjects, as it doesn't help him to quickly handle his emails.
+       A little note about an email's subject: Sylpheed-Claws will ask you for confirmation if you attempt to send an email with an empty subject. This is because it can be annoying for the recipient to receive emails without a subject, as it doesn't help in handling email.
     </para>
   </section>
 
   <section id="start_sending">
     <title>Sending the first mail</title>
     <para>
-       When you have finished writing your first email, you can either click the <quote>Send</quote> button to send your email immediately, or use the <quote>Send later</quote> button. When using <quote>Send</quote>, the composition window will close itself when the mail has been sent; it will stay open if there is an error. When using <quote>Send later</quote>, the composition window will immediately close, and your email will be stored in your Queue folder. It will then be sent when you click the <quote>Send</quote> button in the main window's toolbar.
+       When you have finished writing your first email, you can either click the <quote>Send</quote> button to send your email immediately, or use the <quote>Send later</quote> button to queue the message for later sending. When using <quote>Send</quote>, the composition window will close itself when the mail has been sent; it will stay open if there is an error. When using <quote>Send later</quote>, the composition window will immediately close, and your email will be stored in your Queue folder. It will then be sent when you click the <quote>Send</quote> button in the main window's toolbar.
     </para><para>
-       The emails you send are saved in the Sent folder of your mailbox, so that you can remember what you wrote to whom, or use an already sent email as a template to write another one.
+       The emails that you send are saved in the Sent folder of your mailbox, so that you can recall what you wrote to whom, or use an already sent email as a template to write another.
     </para>
   </section>
 </section>