2006-08-26 [mones] 2.4.0cvs94
authorRicardo Mones <mones@claws-mail.org>
Sat, 26 Aug 2006 17:04:05 +0000 (17:04 +0000)
committerRicardo Mones <mones@claws-mail.org>
Sat, 26 Aug 2006 17:04:05 +0000 (17:04 +0000)
* manual/glossary.xml
2.2. + add ISP to the glossary
7.5. + Add UIDL to glossary
7.7. + Add TCP to glossary
* manual/handling.xml
7.1. + Mentions GNU/Linux distribution, what about the non...
7.2. = s/html/HTML/, quote --local option -> Dillo HTML Viewer
7.3. + Mentions .bashrc, what about the non-bash ones?
7.4. = Use appropriate quotation for commands
7.6. = change "" to <quote></quote>
* manual/plugins.xml
6.1. + Example #mh/Mailbox/Friends -> #mh/inbox/Friends
* manual/starting.xml
2.1. + local mbox file: some examples of mbox file locations...
Also reformatted files requiring it

ChangeLog
PATCHSETS
configure.ac
manual/glossary.xml
manual/handling.xml
manual/plugins.xml
manual/starting.xml

index 99c25c6..18bf02d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,21 @@
+2006-08-26 [mones]     2.4.0cvs94
+
+       * manual/glossary.xml
+               2.2. + add ISP to the glossary
+               7.5. + Add UIDL to glossary
+               7.7. + Add TCP to glossary
+       * manual/handling.xml
+               7.1. + Mentions GNU/Linux distribution, what about the non...
+               7.2. = s/html/HTML/, quote --local option -> Dillo HTML Viewer
+               7.3. + Mentions .bashrc, what about the non-bash ones? 
+               7.4. = Use appropriate quotation for commands
+               7.6. = change "" to <quote></quote>
+       * manual/plugins.xml
+               6.1. + Example #mh/Mailbox/Friends -> #mh/inbox/Friends         
+       * manual/starting.xml
+               2.1. + local mbox file: some examples of mbox file locations...
+               Also reformatted files requiring it
+
 2006-08-26 [wwp]       2.4.0cvs93
 
        * src/summary_search.c
 2006-08-26 [wwp]       2.4.0cvs93
 
        * src/summary_search.c
index 5293e72..9dc38e2 100644 (file)
--- a/PATCHSETS
+++ b/PATCHSETS
 ( cvs diff -u -r 1.395.2.233 -r 1.395.2.234 src/summaryview.c;  ) > 2.4.0cvs91.patchset
 ( cvs diff -u -r 1.213.2.108 -r 1.213.2.109 src/folder.c;  cvs diff -u -r 1.3.2.11 -r 1.3.2.12 src/folderutils.c;  cvs diff -u -r 1.79.2.38 -r 1.79.2.39 src/mh.c;  cvs diff -u -r 1.16.2.36 -r 1.16.2.37 src/msgcache.c;  cvs diff -u -r 1.60.2.32 -r 1.60.2.33 src/procmsg.h;  cvs diff -u -r 1.395.2.234 -r 1.395.2.235 src/summaryview.c;  ) > 2.4.0cvs92.patchset
 ( cvs diff -u -r 1.15.2.30 -r 1.15.2.31 src/summary_search.c;  ) > 2.4.0cvs93.patchset
 ( cvs diff -u -r 1.395.2.233 -r 1.395.2.234 src/summaryview.c;  ) > 2.4.0cvs91.patchset
 ( cvs diff -u -r 1.213.2.108 -r 1.213.2.109 src/folder.c;  cvs diff -u -r 1.3.2.11 -r 1.3.2.12 src/folderutils.c;  cvs diff -u -r 1.79.2.38 -r 1.79.2.39 src/mh.c;  cvs diff -u -r 1.16.2.36 -r 1.16.2.37 src/msgcache.c;  cvs diff -u -r 1.60.2.32 -r 1.60.2.33 src/procmsg.h;  cvs diff -u -r 1.395.2.234 -r 1.395.2.235 src/summaryview.c;  ) > 2.4.0cvs92.patchset
 ( cvs diff -u -r 1.15.2.30 -r 1.15.2.31 src/summary_search.c;  ) > 2.4.0cvs93.patchset
+( cvs diff -u -r 1.1.2.12 -r 1.1.2.13 manual/glossary.xml;  cvs diff -u -r 1.1.2.9 -r 1.1.2.10 manual/handling.xml;  cvs diff -u -r 1.1.2.13 -r 1.1.2.14 manual/plugins.xml;  cvs diff -u -r 1.1.2.7 -r 1.1.2.8 manual/starting.xml;  ) > 2.4.0cvs94.patchset
index 5cd7f74..48cfdd3 100644 (file)
@@ -11,7 +11,7 @@ MINOR_VERSION=4
 MICRO_VERSION=0
 INTERFACE_AGE=0
 BINARY_AGE=0
 MICRO_VERSION=0
 INTERFACE_AGE=0
 BINARY_AGE=0
-EXTRA_VERSION=93
+EXTRA_VERSION=94
 EXTRA_RELEASE=
 EXTRA_GTK2_VERSION=
 
 EXTRA_RELEASE=
 EXTRA_GTK2_VERSION=
 
index e3c3358..5ee9ba9 100644 (file)
       </para>
     </listitem>
   </varlistentry>
       </para>
     </listitem>
   </varlistentry>
+  <varlistentry id="gt_isp">
+    <term>
+       <acronym>ISP</acronym>
+    </term>
+    <listitem>
+      <para>
+       Internet Service Provider. A company which provides Internet access to 
+       its customers. In the dialup access age these were the big telephony
+       companies, with the arrival of broadband access the number of companies 
+       and types of services offered has grown exponentially.
+      </para>
+    </listitem>
+  </varlistentry>
 </variablelist>
 <!-- 
 <variablelist>
 </variablelist>
 <!-- 
 <variablelist>
     
 <variablelist>
   <title>T</title>
     
 <variablelist>
   <title>T</title>
+  <varlistentry id="gt_tcp">
+    <term>
+       <acronym>TCP</acronym>
+    </term>
+    <listitem>
+      <para>
+       Transport Control Protocol. The main protocol used in the Internet.
+       Allows media-independent reliable connections between two endpoints 
+       and is supported by all modern Operating Systems in use.
+      </para>
+    </listitem>
+  </varlistentry>
   <varlistentry id="gt_themes">
     <term>
        Themes
   <varlistentry id="gt_themes">
     <term>
        Themes
   
 <variablelist>
   <title>U</title>
   
 <variablelist>
   <title>U</title>
+  <varlistentry id="gt_uidl">
+    <term>
+       <acronym>UIDL</acronym>
+    </term>
+    <listitem>
+      <para>
+       Unique IDentification Listing. A <xref linkend="gt_pop3" /> command
+       which allows single message handling by asigning a unique identifier 
+       for each message. 
+      </para>
+    </listitem>
+  </varlistentry>
   <varlistentry id="gt_url">
     <term>
        URL
   <varlistentry id="gt_url">
     <term>
        URL
index 4cb3e8c..99025ff 100644 (file)
@@ -81,7 +81,7 @@
        action, which instructs Sylpheed-Claws what to do with emails 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
        action, which instructs Sylpheed-Claws what to do with emails 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/Friends</quote> moves the mail to your
+       <quote>move #mh/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>
        <quote>Friends</quote> subfolder. Here, too, a <quote>Define...</quote>
        button is available to help you define the action to take.
     </para>
index f7841f3..6966018 100644 (file)
   <section id="plugins_default">
     <title>Provided plugins</title>
     <para>
   <section id="plugins_default">
     <title>Provided plugins</title>
     <para>
-       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.
+       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>
     </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.
+       Plugins are installed in <filename class="directory"
+       >$PREFIX/lib/sylpheed-claws/plugins/</filename> 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 <quote>Open</quote> button.
     </para><para>
     </para><para>
-       If you don't find the plugin you're looking for, it is possible that your GNU/Linux distribution provides it in a separate package. In this case, search for the plugin in your package manager.
+       If you don't find the plugin you're looking for, it is possible that 
+       your Operating System distribution provides it in a separate package. 
+       In this case, search for the plugin in your package manager.
     </para>
     <variablelist>
     </para>
     <variablelist>
-           <varlistentry><term>Clam Antivirus</term>
-           <listitem><para>Enables the scanning of message attachments in mail received from a POP, IMAP or LOCAL account using Clam AntiVirus. It can optionally delete the mail or save it to a designated folder. Preferences can be found in <quote>Configuration/Preferences/Plugins/Clam AntiVirus</quote>. Clam AntiVirus is available from <ulink url="http://clamav.sourceforge.net/">http://clamav.sourceforge.net/</ulink>.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>Dillo HTML Viewer</term>
-           <listitem><para>Enables the viewing of html messages using the Dillo web browser, version 0.7.0 or newer. It uses Dillo's --local option by default for safe browsing. Preferences can be found in <quote>/Configuration/Preferences/Plugins/Dillo Browser</quote>. Dillo is available from <ulink url="http://www.dillo.org/">http://www.dillo.org/</ulink>.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>PGP/Core, PGP/Inline and PGP/MIME</term>
-           <listitem><para>Handles PGP signed and/or encrypted mails. You can decrypt mails, verify signatures or sign and encrypt your own mails. Uses GnuPG/GPGME, <ulink url="ftp://ftp.gnupg.org/gcrypt/gpgme/">ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>SpamAssassin</term>
-           <listitem>
-                       <para>The SpamAssassin plugin comes with two major features:</para>
-                       <para>The ability to scan incoming mail received from a POP, IMAP or LOCAL account using SpamAssassin. It can optionally delete mail identified as spam or save it to a designated folder. Mail scanning can be turned off, which is useful if your email is scanned on your server.</para>
-                       <para>The ability for users to teach SpamAssassin to recognise spam or ham. You can train SpamAssassin by marking messages as spam or ham from the Message List contextual menu, or using the relevant toolbar button in the main window or the message window (see "Configuration/Preferences/Customize toolbars"). Messages marked as spam are optionally saved to a designated folder.</para>
-                       <para>Plugin preferences can be found in "Configuration/Preferences/Plugins/SpamAssassin".</para>
-                       <para>SpamAssassin is available from <ulink url="http://spamassassin.apache.org/">http://spamassassin.apache.org/</ulink>. Version 3.1.x or higher is required to use the learning feature in TCP mode.</para>
-               </listitem>
-    </varlistentry>
-    <varlistentry><term>Trayicon</term>
-           <listitem><para>Places an icon in the system tray that indicates whether you have any new mail. A tooltip also shows the current new, unread and total number of messages.</para></listitem>
-    </varlistentry>
+      <varlistentry>
+        <term>Clam Antivirus</term>
+       <listitem>
+         <para>
+       Enables the scanning of message attachments in mail received from a 
+       POP, IMAP or LOCAL account using Clam AntiVirus. It can optionally 
+       delete the mail or save it to a designated folder. Preferences can be 
+       found in 
+       <quote>Configuration/Preferences/Plugins/Clam AntiVirus</quote>. 
+       Clam AntiVirus is available from <ulink 
+       url="http://clamav.sourceforge.net/"
+       >http://clamav.sourceforge.net/</ulink>.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>Dillo HTML Viewer</term>
+       <listitem>
+         <para>
+       Enables the viewing of HTML messages using the Dillo web browser, 
+       version 0.7.0 or newer. It uses Dillo's <literal>--local</literal> 
+       option by default for safe browsing. Preferences can be found in 
+       <quote>/Configuration/Preferences/Plugins/Dillo Browser</quote>. 
+       Dillo is available from <ulink url="http://www.dillo.org/"
+       >http://www.dillo.org/</ulink>.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>PGP/Core, PGP/Inline and PGP/MIME</term>
+       <listitem>
+         <para>
+       Handles PGP signed and/or encrypted mails. You can decrypt mails, 
+       verify signatures or sign and encrypt your own mails. Uses GnuPG/GPGME,
+       <ulink url="ftp://ftp.gnupg.org/gcrypt/gpgme/"
+       >ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>SpamAssassin</term>
+       <listitem>
+         <para>
+       The SpamAssassin plugin comes with two major features:
+         </para><para>
+       The ability to scan incoming mail received from a POP, IMAP or LOCAL 
+       account using SpamAssassin. It can optionally delete mail identified 
+       as spam or save it to a designated folder. Mail scanning can be turned 
+       off, which is useful if your email is scanned on your server.
+         </para><para>
+       The ability for users to teach SpamAssassin to recognise spam or ham. 
+       You can train SpamAssassin by marking messages as spam or ham from the 
+       Message List contextual menu, or using the relevant toolbar button in 
+       the main window or the message window (see 
+       <quote>Configuration/Preferences/Customize toolbars</quote>). Messages 
+       marked as spam are optionally saved to a designated folder.
+         </para><para>
+       Plugin preferences can be found in 
+       <quote>Configuration/Preferences/Plugins/SpamAssassin</quote>.
+         </para><para>
+       SpamAssassin is available from <ulink 
+       url="http://spamassassin.apache.org/"
+       >http://spamassassin.apache.org/</ulink>. Version 3.1.x or higher is 
+       required to use the learning feature in TCP mode.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>Trayicon</term>
+       <listitem>
+         <para>
+       Places an icon in the system tray that indicates whether you have any 
+       new mail. A tooltip also shows the current new, unread and total number
+       of messages.
+         </para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </section>
 
   <section id="plugins_external">
     <title>More plugins</title>
     <para>
     </variablelist>
   </section>
 
   <section id="plugins_external">
     <title>More plugins</title>
     <para>
-           Other plugins have been written too, which are available as separate downloads. At the time of this writing, there are a number of plugins available at <ulink url="http://www.sylpheed-claws.net/plugins.php">http://www.sylpheed-claws.net/plugins.php</ulink>:
+       Other plugins have been written too, which are available as separate 
+       downloads. At the time of this writing, there are a number of plugins 
+       available at <ulink url="http://www.sylpheed-claws.net/plugins.php"
+       >http://www.sylpheed-claws.net/plugins.php</ulink>:
     </para>
     <variablelist>
     </para>
     <variablelist>
-    <varlistentry><term>Acpi Notifier</term>
-           <listitem><para>Enables new mail notification via the LEDs found on some laptops like Acer, Asus, Fujitsu and IBM laptops.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>AttRemover</term>
-           <listitem><para> This plugin lets you remove attachments from emails.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>CacheSaver</term>
-           <listitem><para>Saves the caches every 60 seconds (or user-defined period). It helps avoiding the loss of metadata if your computer (<emphasis>or Sylpheed-Claws!</emphasis>) crashes.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>etpan! Privacy</term>
-           <listitem><para>Handles signature verification and decryption of encrypted messages in S/MIME, OpenPGP and ascii-armored PGP formats. Doesn't handle passphrases.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>Fetchinfo</term>
-           <listitem><para>Inserts headers containing some download information, like UIDL, Sylpheed-Claws' account name, POP server, user ID and retrieval time.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>GtkHtml Viewer</term>
-           <listitem><para>Like Dillo, enables the viewing of html messages, but in a nicer way (antialiased fonts).</para></listitem>
-    </varlistentry>
-    <varlistentry><term>Maildir</term>
-           <listitem><para>Provides direct support for Maildir++ mailboxes. With this plugin you can share your Maildir++ mailbox with other mailers or IMAP servers.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>mailMBOX</term>
-           <listitem><para>Handles mailboxes in mbox format. </para></listitem>
-    </varlistentry>
-    <varlistentry><term>Perl</term>
-           <listitem><para>Intended to extend the filtering possibilities of Sylpheed-Claws. It provides a Perl interface to Sylpheed-Claws' filtering mechanism, allowing the use of full Perl power in email filters.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>S/MIME</term>
-           <listitem><para>Handles S/MIME signed and/or encrypted mails. You can decrypt mails, verify signatures or sign and encrypt your own mails. Uses GnuPG/GPGME and GpgSM, <ulink url="ftp://ftp.gnupg.org/gcrypt/gpgme/">ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>SynCE</term>
-           <listitem><para>Assists in keeping the address book of a Windows CE device (Pocket PC/ iPAQ, Smartphone etc) in sync with Sylpheed-Claws' address book, with respect to email addresses.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>vCalendar</term>
-           <listitem><para>Enables vCalendar message handling like that produced by Evolution or Outlook, and Webcal subscriptions.</para></listitem>
-    </varlistentry>
-    <varlistentry><term>RSSyl</term>
-           <listitem><para>Allows you to read your favorite newsfeeds in Claws. RSS 1.0, 2.0 and Atom feeds are currently supported.</para></listitem>
-    </varlistentry>
+      <varlistentry>
+       <term>Acpi Notifier</term>
+       <listitem>
+         <para>
+       Enables new mail notification via the LEDs found on some laptops like 
+       Acer, Asus, Fujitsu and IBM laptops.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>AttRemover</term>
+       <listitem>
+         <para> 
+       This plugin lets you remove attachments from emails.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>CacheSaver</term>
+       <listitem>
+         <para>
+       Saves the caches every 60 seconds (or user-defined period). It helps 
+       avoiding the loss of metadata if your computer (<emphasis>or 
+       Sylpheed-Claws!</emphasis>) crashes.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>etpan! Privacy</term>
+       <listitem>
+         <para>
+       Handles signature verification and decryption of encrypted messages in 
+       S/MIME, OpenPGP and ascii-armored PGP formats. Doesn't handle 
+       passphrases.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>Fetchinfo</term>
+       <listitem>
+         <para>
+       Inserts headers containing some download information, like UIDL, 
+       Sylpheed-Claws' account name, POP server, user ID and retrieval time.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>GtkHtml Viewer</term>
+       <listitem>
+         <para>
+       Like Dillo, enables the viewing of HTML messages, but in a nicer way 
+       (antialiased fonts).
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>Maildir</term>
+       <listitem>
+         <para>
+       Provides direct support for Maildir++ mailboxes. With this plugin you 
+       can share your Maildir++ mailbox with other mailers or IMAP servers.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>mailMBOX</term>
+       <listitem>
+         <para>
+       Handles mailboxes in MBox format.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>Perl</term>
+       <listitem>
+         <para>
+       Intended to extend the filtering possibilities of Sylpheed-Claws. It 
+       provides a Perl interface to Sylpheed-Claws' filtering mechanism, 
+       allowing the use of full Perl power in email filters.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>S/MIME</term>
+       <listitem>
+         <para>
+       Handles S/MIME signed and/or encrypted mails. You can decrypt mails, 
+       verify signatures or sign and encrypt your own mails. Uses GnuPG/GPGME 
+       and GpgSM, <ulink url="ftp://ftp.gnupg.org/gcrypt/gpgme/"
+       >ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>SynCE</term>
+       <listitem>
+         <para>
+       Assists in keeping the address book of a Windows CE device (Pocket 
+       PC, iPAQ, Smartphone, etc.) in sync with Sylpheed-Claws' address book, 
+       with respect to email addresses.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>vCalendar</term>
+       <listitem>
+         <para>
+       Enables vCalendar message handling like that produced by Evolution or 
+       Outlook, and Webcal subscriptions.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term>RSSyl</term>
+       <listitem>
+         <para>
+       Allows you to read your favorite newsfeeds in Claws. RSS 1.0, 2.0 and 
+       Atom feeds are currently supported.
+         </para>
+       </listitem>
+      </varlistentry>
     </variablelist>
     <para>
     </variablelist>
     <para>
-       If you're a developer, writing a plugin to extend Sylpheed-Claws' capabilities is probably the best and easiest solution. We will provide hosting to your code, and will be glad to answer your questions in the mailing-list or on the IRC channels, #sylpheed-claws on Freenode or IRCnet.
+       If you're a developer, writing a plugin to extend Sylpheed-Claws' 
+       capabilities is probably the best and easiest solution. We will 
+       provide hosting to your code, and will be glad to answer your questions
+       in the mailing-list or on the IRC channels, 
+       <literal>#sylpheed-claws</literal> on Freenode or IRCnet.
     </para>
   </section>
   <section id="plugins_network">
     <title>Network access from the plugins</title>
     <para>
     </para>
   </section>
   <section id="plugins_network">
     <title>Network access from the plugins</title>
     <para>
-       Some of the external plugins, for example RSSyl, vCalendar or GtkHtml Viewer, need Internet access for their operations (retrieving feeds in the case of RSSyl or vCalendar, and fetching images in the case of GtkHtml Viewer). These plugins use the Curl library. Hence, if your Internet access is restricted by a proxy, you will need to tell libCurl to use this proxy. This is done by setting an environment variable, <emphasis>http_proxy</emphasis>. For example, <emphasis>http_proxy=http://user:passwd@myproxy.example.com:8080</emphasis> will tell libCurl to connect to port 8080 of the machine myproxy.example.com, with the user <quote>user</quote> and password <quote>passwd</quote> to connect to the Internet. 
-    </para>
-    <para>
-       You can either set this variable before starting Sylpheed-Claws, by using for example <emphasis>http_proxy=http://user:passwd@myproxy.example.com:8080 sylpheed-claws</emphasis>, or set it in your ~/.bashrc file, by adding the following line: <emphasis>export http_proxy=http://user:passwd@myproxy.example.com:8080</emphasis> (you'll have to reconnect to have it taken into account).
+       Some of the external plugins, for example RSSyl, vCalendar or GtkHtml 
+       Viewer, need Internet access for their operations (retrieving feeds in 
+       the case of RSSyl or vCalendar, and fetching images in the case of 
+       GtkHtml Viewer). These plugins use the Curl library. Hence, if your 
+       Internet access is restricted by a proxy, you will need to tell libCurl
+       to use this proxy. This is done by setting an environment variable, 
+       <emphasis>http_proxy</emphasis>. For example, 
+<literal>http_proxy=http://user:passwd@myproxy.example.com:8080</literal> 
+       will tell libCurl to connect to port 8080 of the machine 
+       myproxy.example.com, with the user <quote>user</quote> and password 
+       <quote>passwd</quote> to connect to the Internet. 
+    </para><para>
+       You can either set this variable before starting Sylpheed-Claws, by 
+       using for example 
+       <command>http_proxy=http://user:passwd@myproxy.example.com:8080 
+       sylpheed-claws</command>, or set it in your 
+       <filename>~/.bashrc</filename> file (or your shell equivalent), by 
+       adding the following line<footnote><para>Other shells may have 
+       diferent syntaxes, check your shell's manual page.</para></footnote>: 
+<command>export http_proxy=http://user:passwd@myproxy.example.com:8080</command>
+       (you'll have to reconnect to have it taken into account).
     </para>
   </section>
 </section>
     </para>
   </section>
 </section>
+
index 3421ea6..73597a1 100644 (file)
@@ -5,29 +5,74 @@
   <section id="start_wizard">
     <title>The initial wizard</title>
     <para>
   <section id="start_wizard">
     <title>The initial wizard</title>
     <para>
-       The first time that you start Sylpheed-Claws, you will be asked a few questions in order to set up an account. These questions are easy to answer and grouped in several short pages.
+       The first time that you start Sylpheed-Claws, you will be asked a few 
+       questions in order to set up an account. These questions are easy to 
+       answer and grouped in several short pages.
     </para><para>
     </para><para>
-           First you will be asked to fill in your name, (<emphasis>usually guessed from the operating system</emphasis>), your email address, and the name of your organisation, (<emphasis>optional</emphasis>).
-    </para><para>The following page will allow you to enter details of how to retrieve your mail. The format of the page will be determined by the <quote>Server type</quote>:
+       First you will be asked to fill in your name, (<emphasis>usually 
+       guessed from the operating system</emphasis>), your email address, and 
+       the name of your organisation, (<emphasis>optional</emphasis>).
+    </para><para>
+       The following page will allow you to enter details of how to retrieve 
+       your mail. The format of the page will be determined by the 
+       <quote>Server type</quote>:
     </para>
     </para>
-    <blockquote><variablelist>
-           <varlistentry><term>POP3</term>
-                   <listitem><para>If you choose POP3, you will need to enter the server address, username, and password. The password is optional, if you don't provide it here then you will be prompted for it each time it is needed.
-                   </para></listitem>
-           </varlistentry>
-           <varlistentry><term>IMAP</term>
-                   <listitem><para>If you choose IMAP, you will need to enter the server address, username, password, and IMAP server directory. The password is optional, if you don't provide it here then you will be prompted for it each time it is needed. The IMAP server directory is also optional, often it is not needed and can be left empty.
-                           </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 spool file.
-                           </para></listitem>
-           </varlistentry>
-    </variablelist></blockquote>
+    <blockquote>
+      <variablelist>
+       <varlistentry>
+         <term>POP3</term>
+         <listitem>
+           <para>
+       If you choose POP3, you will need to enter the server address, 
+       username, and password. The password is optional, if you don't provide 
+       it here then you will be prompted for it each time it is needed.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>IMAP</term>
+         <listitem>
+           <para>
+       If you choose IMAP, you will need to enter the server address, 
+       username, password, and IMAP server directory. The password is 
+       optional, if you don't provide it here then you will be prompted for it
+       each time it is needed. The IMAP server directory is also optional, 
+       often it is not needed and can be left empty.
+           </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 spool file. This location depends on your Operating
+       System, but values like <filename>/var/mail/username</filename> or
+       <filename>/var/spool/mail/username</filename> are common, where 
+       <literal>username</literal> is your system login.
+           </para>
+         </listitem>
+       </varlistentry>
+      </variablelist>
+    </blockquote>
     <para>
     <para>
-           On the next page you will enter the address of your SMTP server, (<emphasis>sometimes referred to as <quote>Outgoing server</quote></emphasis>). You will also be asked whether to authenticate when sending mail; this is often not the case if you're using an ISP to connect to Internet, and often the case if you are configuring a professional account.
-     </para><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.
+       On the next page you will enter the address of your SMTP server, 
+       (<emphasis>sometimes referred to as 
+       <quote>Outgoing server</quote></emphasis>). You will also be asked 
+       whether to authenticate when sending mail; this is often not the case 
+       if you're using an ISP to connect to Internet, and often the case if 
+       you are configuring a professional account.
+    </para><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 <filename>Mail</filename> 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.
     </para>
     </para><para>
        You can now click on the Save button, and start enjoying Sylpheed-Claws.
     </para>
   <section id="start_getting">
     <title>Getting mail</title>
     <para>
   <section id="start_getting">
     <title>Getting mail</title>
     <para>
-       Retrieving your email can be done from the toolbar button named <quote>Get mail</quote> or from the <quote>Receive</quote> submenu of the <quote>Message</quote> menu.
+       Retrieving your email can be done from the toolbar button named 
+       <quote>Get mail</quote> or from the <quote>Receive</quote> submenu of 
+       the <quote>Message</quote> menu.
     </para><para>
     </para><para>
-       If you want Sylpheed-Claws to check your mail automatically at regular intervals, you can ask it to do so from the <quote>Mail handling: Receive</quote> preference page which you'll find in the <quote>Configuration/Preferences...</quote> menu. Just click the <quote>Auto-check new mail every [...] minutes</quote> checkbox, and set the interval to your liking.
+       If you want Sylpheed-Claws to check your mail automatically at regular 
+       intervals, you can ask it to do so from the 
+       <quote>Mail handling: Receiving</quote> preference page which you'll 
+       find in the <quote>Configuration/Preferences...</quote> menu. Just 
+       click the 
+       <quote>Automatically check new mail every [...] minute(s)</quote> 
+       checkbox, and set the interval to your liking.
     </para>
   </section>
 
   <section id="start_reading">
     <title>Reading your mail</title>
     <para>
     </para>
   </section>
 
   <section id="start_reading">
     <title>Reading your mail</title>
     <para>
-       Once you have retrieved your emails, the Inbox folder will contain them. The total number of emails in a folder is shown at the right of the folder's name, along with the number of unread and new emails in it. To see them, click on the folder row in the folder list, and the list of emails in that folder will be displayed in the Message List pane. You can then select an email using the mouse, or by using the Up and Down keys to navigate through the list, and the Space bar to display and scroll emails. You can use other keys to navigate through emails, like P and N (previous and next).
+       Once you have retrieved your emails, the Inbox folder will contain 
+       them. The total number of emails in a folder is shown at the right of 
+       the folder's name, along with the number of unread and new emails in 
+       it. To see them, click on the folder row in the folder list, and the 
+       list of emails in that folder will be displayed in the Message List 
+       pane. You can then select an email using the mouse, or by using the Up 
+       and Down keys to navigate through the list, and the Space bar to 
+       display and scroll emails. You can use other keys to navigate through 
+       emails, like P and N (previous and next).
     </para>
   </section>
 
   <section id="start_writing">
     <title>Writing your first mail</title>
     <para>
     </para>
   </section>
 
   <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: if you have multiple 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.
+       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 multiple 
+       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>
     </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 without a subject, as it doesn't help in handling email.
+       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 your first mail</title>
     <para>
     </para>
   </section>
 
   <section id="start_sending">
     <title>Sending your 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 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.
+       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>
     </para><para>
-       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.
+       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>
     </para>
   </section>
 </section>