[Goodies-commits] r5389 - in xfce4-mailwatch-plugin/trunk/doc/C: . images

Brian Tarricone kelnos at xfce.org
Thu Sep 11 07:42:13 CEST 2008


Author: kelnos
Date: 2008-09-11 05:42:13 +0000 (Thu, 11 Sep 2008)
New Revision: 5389

Modified:
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-gmail-settings.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-imap-advanced.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-imap-new-folders.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-imap-settings.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-log-window.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-mailbox-type.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-maildir-settings.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-mbox-settings.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-mh-settings.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-pop3-advanced.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-pop3-settings.png
   xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-properties.png
   xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.html
   xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.xml
Log:
update docs and screenshots

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-gmail-settings.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-imap-advanced.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-imap-new-folders.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-imap-settings.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-log-window.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-mailbox-type.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-maildir-settings.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-mbox-settings.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-mh-settings.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-pop3-advanced.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-pop3-settings.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/images/mailwatch-properties.png
===================================================================
(Binary files differ)

Modified: xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.html
===================================================================
--- xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.html	2008-09-11 04:58:49 UTC (rev 5388)
+++ xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.html	2008-09-11 05:42:13 UTC (rev 5389)
@@ -1,115 +1,116 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Mailwatch Plugin</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><link rel="start" href="#xfce4-mailwatch-plugin" title="Xfce 4 Mailwatch Plugin"><link rel="next" href="#mailwatch-introduction" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="xfce4-mailwatch-plugin"></a>Xfce 4 Mailwatch Plugin</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Pasi</span> <span class="surname">Orovuo</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:pasi.ov at gmail.com">pasi.ov at gmail.com</a>></code></p></div></div></div><div class="author"><h3 class="author"><span 
 class="firstname">Brian</span> <span class="surname">Tarricone</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:bjt23 at cornell.edu">bjt23 at cornell.edu</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo">This manual describes <span xmlns="" class="emphasis"><em><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong></em></span>
-    version 1.0.2svn.
-  <br></br></span></div><div><p class="copyright">Copyright © 2005-2006 Pasi Orovuo</p></div><div><p class="copyright">Copyright © 2005-2006 Brian Tarricone</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#mailwatch-introduction">Introduction</a></span></dt><dt><span class="sect1"><a href="#mailwatch-usage">Usage</a></span></dt><dt><span class="sect1"><a href="#mailwatch-properties">Properties</a></span></dt><dt><span class="sect1"><a href="#mailwatch-mailboxes">Mailbox configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="#mailwatch-mailbox-imap">IMAP</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-pop3">POP3</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-gmail">GMail</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-maildir">Maildir</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-mbox">Mbox</a></span></dt><dt><span class="
 sect2"><a href="#mailwatch-mailbox-mh">MH Maildir</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mailwatch-about">About <strong class="application"><code>Mailwatch</code></strong></a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-introduction"></a>Introduction</h2></div></div></div><p><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong> is a multi-protocol, multi-mailbox mail watcher for the
-    <a href="xfce4-panel.html" target="_top">Xfce4 panel</a>.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Mailwatch Plugin</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="#xfce4-mailwatch-plugin" title="Xfce 4 Mailwatch Plugin"><link rel="next" href="#mailwatch-introduction" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-mailwatch-plugin"></a>Xfce 4 Mailwatch Plugin</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Pasi</span> <span class="surname">Orovuo</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:pasi.ov at gmail.com">pasi.ov at gmail.com</a>></code></p></div></div></div><div class="author"><h3 class="
 author"><span class="firstname">Brian</span> <span class="surname">Tarricone</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:bjt23 at cornell.edu">bjt23 at cornell.edu</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo">This manual describes <span xmlns="" class="emphasis"><em><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong></em></span>
+    version 1.1.0svn-r5341.
+  <br></br></span></div><div><p class="copyright">Copyright © 2005-2006 Pasi Orovuo</p></div><div><p class="copyright">Copyright © 2005-2008 Brian Tarricone</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#mailwatch-introduction">Introduction</a></span></dt><dt><span class="sect1"><a href="#mailwatch-usage">Usage</a></span></dt><dt><span class="sect1"><a href="#mailwatch-properties">Properties</a></span></dt><dt><span class="sect1"><a href="#mailwatch-mailboxes">Mailbox configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="#mailwatch-mailbox-imap">IMAP</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-pop3">POP3</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-gmail">GMail</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-maildir">Maildir</a></span></dt><dt><span class="sect2"><a href="#mailwatch-mailbox-mbox">Mbox</a></span></dt><dt><span class="
 sect2"><a href="#mailwatch-mailbox-mh">MH Maildir</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mailwatch-about">About <strong class="application"><code>Mailwatch</code></strong></a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-introduction"></a>Introduction</h2></div></div></div><p><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong> is a multi-protocol, multi-mailbox mail watcher for the
+    <a class="ulink" href="xfce4-panel.html" target="_top">Xfce4 panel</a>.
     Currently, the protocols supported are:
     
     </p><div class="itemizedlist"><ul type="disc"><li><p>IMAP (SSL/TLS and cleartext)</p></li><li><p>POP3 (SSL/TLS and cleartext)</p></li><li><p>GMail mailbox (HTTPS)</p></li><li><p>Mbox mail spool (local)</p></li><li><p>Maildir mail spool (local)</p></li><li><p>MH-Maildir mail spool (local)</p></li></ul></div><p>
     
-  </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-usage"></a>Usage</h2></div></div></div><p>The <strong class="application"><code>Mailwatch</code></strong> icon remains gray (default color) as long as it does 
+  </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-usage"></a>Usage</h2></div></div></div><p>The <strong class="application"><code>Mailwatch</code></strong> icon remains grey (default color) as long as it does 
 	not detect any new mail. As soon as it checks, and there is new mail, 
 	the mail icon will turn gold (default color). By clicking on the mail 
-	icon, a command, to be defined in the properties dialog box, will be 
-	launched. A forced mail check can be obtained by middle-clicking
+	icon, a command, which can be defined in the properties dialog box,
+    will be launched. A mail check can be forced by middle-clicking
 	the <strong class="application"><code>Mailwatch</code></strong> icon in the panel. Right-clicking on the <strong class="application"><code>Mailwatch</code></strong> icon
-	shows a context menu from which you can choose <span><strong class="guimenuitem">Properties</strong></span>
-	to access the configuration options.	
+	shows a context menu from which you can choose <span class="guimenuitem"><strong>Properties</strong></span>
+	to access the configuration options.  There are also menu items
+    for forcing an update and the about box.
   </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-properties"></a>Properties</h2></div></div></div><p><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong> has a variety of configuration options. Access to the
     configuration is gained by right-clicking the panel icon, and by
-    choosing <span><strong class="guimenuitem">Properties</strong></span>.
-  </p><div class="figure"><a name="mailwatch-properties-fig"></a><p class="title"><b>Figure 1. <code class="application">Mailwatch</code> main settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-properties.png" alt="Mailwatch properties dialog"></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailboxes</span></dt><dd><p>The main controls for managing mailboxes are
-          <span><strong class="guibutton">Add</strong></span>, <span><strong class="guibutton">Edit</strong></span>,
-          and <span><strong class="guibutton">Remove</strong></span>. At later stage, we'll walk
+    choosing <span class="guimenuitem"><strong>Properties</strong></span>.
+  </p><div class="figure"><a name="mailwatch-properties-fig"></a><p class="title"><b>Figure 1. <code class="application">Mailwatch</code> main settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-properties.png" alt="Mailwatch properties dialog"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Mailboxes</span></dt><dd><p>The main controls for managing mailboxes are
+          <span class="guibutton"><strong>Add</strong></span>, <span class="guibutton"><strong>Edit</strong></span>,
+          and <span class="guibutton"><strong>Remove</strong></span>. At later stage, we'll walk
           through adding and configuring each mailbox type.
         </p></dd><dt><span class="term">External Programs</span></dt><dd><p><strong class="application"><code>Mailwatch</code></strong> can launch your mail user agent (or any other
           program) when the panel icon is clicked. The name of the
           executable together with possible startup parameters goes
-          in the <span><strong class="guilabel">Run on click</strong></span> entry field. You can
+          in the <span class="guilabel"><strong>Run on click</strong></span> entry field. You can
           also define the command to be executed when <strong class="application"><code>Mailwatch</code></strong> detects
-          new mail by typing the desired command in the <span><strong class="guilabel">Run on
+          new mail by typing the desired command in the <span class="guilabel"><strong>Run on
           new messages</strong></span> entry field. Note that the command
           is executed once for each time <strong class="application"><code>Mailwatch</code></strong> detects new mail,
           regardless of the number of new messages received.
         </p></dd><dt><span class="term">Icons</span></dt><dd><p>The icons that <strong class="application"><code>Mailwatch</code></strong> displays in the panel are configurable.
-          Both the <span><strong class="guiicon">Normal</strong></span> and <span><strong class="guiicon">New Mail</strong></span>
+          Both the <span class="guiicon"><strong>Normal</strong></span> and <span class="guiicon"><strong>New Mail</strong></span>
           buttons present a file chooser dialog, which you can use to select
           your preferred icons.
         </p></dd><dt><span class="term">Logging</span></dt><dd><p><strong class="application"><code>Mailwatch</code></strong> includes a logging mechanism as well. It provides
           information about errors and other noteworthy events that take
-          place. The log is accessible via the <span><strong class="guibutton">View Log</strong></span>
-          button. There's also a setting to <span><strong class="guilabel">Show log status
+          place. The log is accessible via the <span class="guibutton"><strong>View Log</strong></span>
+          button. There's also a setting to <span class="guilabel"><strong>Show log status
           in icon</strong></span> in the log dialog which, if enabled, provides
           a visual indication of new log events in the panel.
-        </p><div class="figure"><a name="mailwatch-log-window-fig"></a><p class="title"><b>Figure 2. Log Window</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-log-window.png" alt="Mailwatch log window"></div></div></div><div class="figure"><a name="mailwatch-panel-indicator-fig"></a><p class="title"><b>Figure 3. Panel Indicator</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-panel-indicator.png" alt="Panel indicator"></div></div></div></dd></dl></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-mailboxes"></a>Mailbox configuration</h2></div></div></div><p>In this section we walk through adding and configuring each
+        </p><div class="figure"><a name="mailwatch-log-window-fig"></a><p class="title"><b>Figure 2. Log Window</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-log-window.png" alt="Mailwatch log window"></div></div></div></div><br class="figure-break"><div class="figure"><a name="mailwatch-panel-indicator-fig"></a><p class="title"><b>Figure 3. Panel Indicator</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-panel-indicator.png" alt="Panel indicator"></div></div></div></div><br class="figure-break"></dd></dl></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-mailboxes"></a>Mailbox configuration</h2></div></div></div><p>In this section we walk through adding and configuring each
     type of mailbox.
-  </p><p>To add a new mailbox, click <span><strong class="guibutton">Add</strong></span> in the
+  </p><p>To add a new mailbox, click <span class="guibutton"><strong>Add</strong></span> in the
     main configuration dialog and a mailbox type selection dialog will
     appear. The dialog presents each supported mailbox type in the
     dropdown list, as well as an informative description of the mailbox
     in the label below.
-  </p><div class="figure"><a name="mailwatch-mailbox-type-fig"></a><p class="title"><b>Figure 4. Mailbox type selection</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-mailbox-type.png" alt="Mailbox type selection dialog"></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-imap"></a>IMAP</h3></div></div></div><p><span class="acronym">IMAP</span>, acronym for <span class="emphasis"><em>Internet Message Access
-      Protocol</em></span>, is a quite common mailbox format. An <span class="acronym">IMAP</span>
+  </p><div class="figure"><a name="mailwatch-mailbox-type-fig"></a><p class="title"><b>Figure 4. Mailbox type selection</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-mailbox-type.png" alt="Mailbox type selection dialog"></div></div></div></div><br class="figure-break"><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-imap"></a>IMAP</h3></div></div></div><p><acronym class="acronym">IMAP</acronym>, acronym for <span class="emphasis"><em>Internet Message Access
+      Protocol</em></span>, is a quite common mailbox format. An <acronym class="acronym">IMAP</acronym>
       mailbox is a remote mailbox, so it requires various configuration
-      options to be able to contact the remote <span class="acronym">IMAP</span> server and get
+      options to be able to contact the remote <acronym class="acronym">IMAP</acronym> server and get
       information on the mailbox.      
-    </p><p>To create an <span class="acronym">IMAP</span> account in <strong class="application"><code>Mailwatch</code></strong>, choose <span class="emphasis"><em>
+    </p><p>To create an <acronym class="acronym">IMAP</acronym> account in <strong class="application"><code>Mailwatch</code></strong>, choose <span class="emphasis"><em>
       Remote IMAP Mailbox</em></span> in the mailbox type chooser dialog,
-      and you will be presented with the <span class="acronym">IMAP</span> settings dialog.
-    </p><div class="figure"><a name="mailwatch-imap-settings-fig"></a><p class="title"><b>Figure 5. IMAP Settings Dialog</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-imap-settings.png" alt="Mailwatch IMAP Settings"></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
+      and you will be presented with the <acronym class="acronym">IMAP</acronym> settings dialog.
+    </p><div class="figure"><a name="mailwatch-imap-settings-fig"></a><p class="title"><b>Figure 5. IMAP Settings Dialog</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-imap-settings.png" alt="Mailwatch IMAP Settings"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
              The name entered here will appear on the <strong class="application"><code>Mailwatch</code></strong> icon
              tooltip, which indicates mailboxes that have new mail.
-             This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term"><span class="acronym">IMAP</span> Server</span></dt><dd><div class="itemizedlist"><ul type="disc"><li><p>Mail server - The hostname of the remote mail server.</p></li><li><p>Username - The username to use while accessing the mailbox.</p></li><li><p>Password - The password to use.</p></li></ul></div></dd><dt><span class="term">Interval</span></dt><dd><p>Defines how often <strong class="application"><code>Mailwatch</code></strong> accesses
+             This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term"><acronym class="acronym">IMAP</acronym> Server</span></dt><dd><div class="itemizedlist"><ul type="disc"><li><p>Mail server - The hostname of the remote mail server.</p></li><li><p>Username - The username to use while accessing the mailbox.</p></li><li><p>Password - The password to use.</p></li></ul></div></dd><dt><span class="term">Interval</span></dt><dd><p>Defines how often <strong class="application"><code>Mailwatch</code></strong> accesses
              the mailbox to see if there's new mail. You shouldn't set
              this too low, as it will create unnecessary network traffic.
              It's not recommended to set this lower than 5 minutes,
              unless you're really sure your service provider
              is okay with that.</p></dd></dl></div><p>The default setup uses unencrypted connections and the
-      default <span class="acronym">IMAP</span> folder. For most users this is enough, and everything
-      should work now. Mail server implementations differ, and this
-      setup might not work for you. For example, you service provider
-      might require encrypted connections (which you should use wherever
-      possible). For that there's the advanced settings dialog.
-    </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="mailwatch-mailbox-imap-advanced"></a>Advanced Settings</h4></div></div></div><div class="figure"><a name="mailwatch-mailbox-imap-advanced-fig"></a><p class="title"><b>Figure 6. Advanced <span class="acronym">IMAP</span> settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-imap-advanced.png" alt="Advanced IMAP settings"></div></div></div><div class="variablelist"><dl><dt><span class="term">Connection</span></dt><dd><p>If your <span class="acronym">IMAP</span> service provider supports encryption
-              for client connections, you should take advantage of that.
+      default <acronym class="acronym">IMAP</acronym> folder. It is highly recommended that you select
+      an encrypted connection type if your mail provider supports it.
+      Others may require an encrypted connection. For that there's the
+      advanced settings dialog.
+    </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="mailwatch-mailbox-imap-advanced"></a>Advanced Settings</h4></div></div></div><div class="figure"><a name="mailwatch-mailbox-imap-advanced-fig"></a><p class="title"><b>Figure 6. Advanced <acronym class="acronym">IMAP</acronym> settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-imap-advanced.png" alt="Advanced IMAP settings"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Connection</span></dt><dd><p>If your <acronym class="acronym">IMAP</acronym> service provider supports encryption
+              for client connections, you should take advantage of it.
               There are generally two implementations of encrypted
-              connections. The most common one, even though it's against
-              the <span class="acronym">IMAP</span> RFC uses the port 993 for client connections.
-              In this scheme, the connection is encrypted from the
-              beginning, as the encryption is initialized before the
-              actual <span class="acronym">IMAP</span> traffic. The other, less common method, uses
-              the ordinary <span class="acronym">IMAP</span> port for initializing
-              the connection and then, before any sensitive data is
-              transmitted, initializes the encryption with the
-              <span class="emphasis"><em>STARTTLS</em></span> command. <strong class="application"><code>Mailwatch</code></strong> provides
+              connections. The most common one uses port 993 for client
+              connections and encrypts the connection from the start.
+              The other, less common method, uses the ordinary <acronym class="acronym">IMAP</acronym> port
+              for initializing the connection and then, before any
+              sensitive data is transmitted, initializes the encryption
+              with the <span class="emphasis"><em>STARTTLS</em></span> command. <strong class="application"><code>Mailwatch</code></strong> provides
               default settings for these setups, which are
-              <span><strong class="guimenuitem">Use SSL/TLS on alternate port</strong></span> and
-              <span><strong class="guimenuitem">Use SSL/TLS via STARTTLS</strong></span>
-              respectively.
-            </p><p>There's also the possibility of using a non-standard <span class="acronym">IMAP</span>
+              <span class="guimenuitem"><strong>Use SSL/TLS on alternate port</strong></span> and
+              <span class="guimenuitem"><strong>Use SSL/TLS via STARTTLS</strong></span>
+              respectively.  If you're not sure which option your mail
+              provider supports, you can test via trial and error by using
+              each setting, and then checking the log viewer for errors.
+            </p><p>There's also the possibility of using a non-standard <acronym class="acronym">IMAP</acronym>
               port, if your service provider so requires. Just check the
               box, and type in the appropriate port.  The box will pre-fill
               the default port for the selected connection type.
             </p></dd><dt><span class="term">Folders</span></dt><dd><p>In addition of the connection related settings, you can
               set the directory on the server where your mail is stored using
-              the <span><strong class="guilabel">IMAP server directory</strong></span> text box.  This
+              the <span class="guilabel"><strong>IMAP server directory</strong></span> text box.  This
               setting may not be necessary on some systems.  If you see a large
-              number of strange folder names when looking in the <span><strong class="guilabel">New
+              number of strange folder names when looking in the <span class="guilabel"><strong>New
               mail folders</strong></span> dialog box, you may need to set this,
               often to something like "mail", "Mail", or "Maildir".
-            </p></dd></dl></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="mailwatch-mailbox-imap-folders"></a>New mail folders</h4></div></div></div><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-imap-new-folders.png" alt="IMAP new mail folders settings"></div></div><p>Since <span class="acronym">IMAP</span> supports viewing mail in multiple folders, it's
+            </p></dd></dl></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="mailwatch-mailbox-imap-folders"></a>New mail folders</h4></div></div></div><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-imap-new-folders.png" alt="IMAP new mail folders settings"></div></div><p>Since <acronym class="acronym">IMAP</acronym> supports viewing mail in multiple folders, it's
         possible that you'd receive new mail in folders other than your
-        inbox.  If that's the case, you can use the <span><strong class="guilabel">New Mail
+        inbox.  If that's the case, you can use the <span class="guilabel"><strong>New Mail
         Folders</strong></span>  dialog to instruct <strong class="application"><code>Mailwatch</code></strong> to check mail in
-        multiple folders.
-      </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-pop3"></a>POP3</h3></div></div></div><p><span class="acronym">POP3</span>, short for <span class="emphasis"><em>Post Office Protocol Version 3
-      </em></span>, is another common type of remote mailboxes. Because
-      of its remote nature, the settings for <span class="acronym">POP3</span> are almost the same
-      as <span class="acronym">IMAP</span>, with some omissions as, <span class="acronym">POP3</span> isn't as advanced a protocol
-      as <span class="acronym">IMAP</span>.
-    </p><div class="figure"><a name="mailwatch-mailbox-pop3-fig"></a><p class="title"><b>Figure 7. POP3 Settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-pop3-settings.png" alt="Mailwatch POP3 settings"></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
+        multiple folders.  The dialog will connect to your mail server
+        and fetch a list of folders for you to select.  Of course, you'll
+        need to enter the server information first.
+      </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-pop3"></a>POP3</h3></div></div></div><p><acronym class="acronym">POP3</acronym>, short for <span class="emphasis"><em>Post Office Protocol Version 3
+      </em></span>, is another common type of remote mailbox. Because
+      of its remote nature, the settings for <acronym class="acronym">POP3</acronym> are almost the same
+      as <acronym class="acronym">IMAP</acronym>, with some omissions, as <acronym class="acronym">POP3</acronym> isn't as advanced a protocol
+      as <acronym class="acronym">IMAP</acronym>.
+    </p><div class="figure"><a name="mailwatch-mailbox-pop3-fig"></a><p class="title"><b>Figure 7. POP3 Settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-pop3-settings.png" alt="Mailwatch POP3 settings"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
              The name entered here will appear on the <strong class="application"><code>Mailwatch</code></strong> icon
              tooltip, which indicates mailboxes that have new mail.
-             This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term"><span class="acronym">POP3</span> Server</span></dt><dd><div class="itemizedlist"><ul type="disc"><li><p>Mail server - Hostname of the <span class="acronym">POP3</span> server.</p></li><li><p>Username - Username to authenticate with.</p></li><li><p>Password - Password to use in authentication.</p></li></ul></div></dd><dt><span class="term">Interval</span></dt><dd><p>Defines how often <strong class="application"><code>Mailwatch</code></strong> accesses
+             This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term"><acronym class="acronym">POP3</acronym> Server</span></dt><dd><div class="itemizedlist"><ul type="disc"><li><p>Mail server - Hostname of the <acronym class="acronym">POP3</acronym> server.</p></li><li><p>Username - Username to authenticate with.</p></li><li><p>Password - Password to use in authentication.</p></li></ul></div></dd><dt><span class="term">Interval</span></dt><dd><p>Defines how often <strong class="application"><code>Mailwatch</code></strong> accesses
              the mailbox to see if there's new mail. You shouldn't set
              this too low, as it will create unnecessary network traffic.
              It's not recommended to set this lower than 5 minutes,
@@ -117,30 +118,25 @@
              is okay with that.</p></dd></dl></div><p>While for most users providing these settings should be enough,
       there are also advanced settings for those who need additional
       features.
-    </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="mailwatch-mailbox-pop3-advanced"></a>Advanced Settings</h4></div></div></div><div class="figure"><a name="mailwatch-mailbox-pop3-advanced-fig"></a><p class="title"><b>Figure 8. <span class="acronym">POP3</span> Advanced Settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-pop3-advanced.png" alt="POP3 Advanced Settings dialog"></div></div></div><div class="variablelist"><dl><dt><span class="term">Connection</span></dt><dd><p>
-              By default, due common practice, <strong class="application"><code>Mailwatch</code></strong> attempts
-              to access the mailbox without encrypting the traffic
-              between the local host and the mail server. For those,
-              whose service provider supports encrypted connections,
-              <strong class="application"><code>Mailwatch</code></strong> supports two different methods of encryption. 
-              First one, quite commonly used, is to use an alternate
-              port (default: 995) for encrypted connections. This way,
-              the connection is encrypted from the beginning. The
-              setting to choose from the dropdown list is
-              <span><strong class="guimenuitem">Use SSL/TLS on alternate port</strong></span>
-              for this method. The other, that uses the default <span class="acronym">POP3</span>
-              port 110 and takes advantage of the
-              <span class="emphasis"><em>STARTTLS</em></span> method of the protocol,
-              is chosen with
-              <span><strong class="guimenuitem">Use SSL/TLS via STARTTLS</strong></span>.
-              If your service provider requires a port that is different
-              of the defaults provided, you may define it by checking
-              the <span><strong class="guilabel">Use non-standard POP3 port</strong></span>
-              checkbox, and typing in the correct port number.
+    </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="mailwatch-mailbox-pop3-advanced"></a>Advanced Settings</h4></div></div></div><div class="figure"><a name="mailwatch-mailbox-pop3-advanced-fig"></a><p class="title"><b>Figure 8. <acronym class="acronym">POP3</acronym> Advanced Settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-pop3-advanced.png" alt="POP3 Advanced Settings dialog"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Connection</span></dt><dd><p>If your <acronym class="acronym">POP3</acronym> service provider supports encryption
+              for client connections, you should take advantage of it.
+              There are generally two implementations of encrypted
+              connections. The most common one uses port 995 for client
+              connections and encrypts the connection from the start.
+              The other, less common method, uses the ordinary <acronym class="acronym">POP3</acronym> port
+              for initializing the connection and then, before any
+              sensitive data is transmitted, initializes the encryption
+              with the <span class="emphasis"><em>STLS</em></span> command. <strong class="application"><code>Mailwatch</code></strong> provides
+              default settings for these setups, which are
+              <span class="guimenuitem"><strong>Use SSL/TLS on alternate port</strong></span> and
+              <span class="guimenuitem"><strong>Use SSL/TLS via STARTTLS</strong></span>
+              respectively.  If you're not sure which option your mail
+              provider supports, you can test via trial and error by using
+              each setting, and then checking the log viewer for errors.
             </p></dd></dl></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-gmail"></a>GMail</h3></div></div></div><p>Mailwatch can also watch your
-      <a href="http://gmail.com/" target="_top">GMail</a> mailbox.
+      <a class="ulink" href="http://gmail.com/" target="_top">GMail</a> mailbox.
       Mailwatch does this securely by using HTTPS and GMail's RSS feed.
-    </p><div class="figure"><a name="mailwatch-mailbox-gmail-fig"></a><p class="title"><b>Figure 9. GMail Settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-gmail-settings.png" alt="GMail Settings"></div></div></div><div class="variablelist"><dl><dt><span class="term">GMail Server</span></dt><dd><div class="itemizedlist"><ul type="disc"><li><p>Username - Your GMail username.</p></li><li><p>Password - Your GMail password.</p></li></ul></div></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-maildir"></a>Maildir</h3></div></div></div><p>Maildir is a mailbox format for local mailboxes and thus
+    </p><div class="figure"><a name="mailwatch-mailbox-gmail-fig"></a><p class="title"><b>Figure 9. GMail Settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-gmail-settings.png" alt="GMail Settings"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">GMail Server</span></dt><dd><div class="itemizedlist"><ul type="disc"><li><p>Username - Your GMail username.</p></li><li><p>Password - Your GMail password.</p></li></ul></div></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-maildir"></a>Maildir</h3></div></div></div><p>Maildir is a mailbox format for local mailboxes and thus
       there is no hostname, etc. to configure, but merely a directory
       where your mail is stored. A Maildir mailbox has a certain
       distinguishable hierarchy, which defines the mailbox (and which
@@ -150,7 +146,7 @@
       (<code class="filename">cur</code>,
       <code class="filename">new</code>,
       <code class="filename">tmp</code>).
-    </p><div class="figure"><a name="mailwatch-mailbox-maildir-fig"></a><p class="title"><b>Figure 10. Maildir Settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-maildir-settings.png" alt="Mailwatch Maildir Settings"></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
+    </p><div class="figure"><a name="mailwatch-mailbox-maildir-fig"></a><p class="title"><b>Figure 10. Maildir Settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-maildir-settings.png" alt="Mailwatch Maildir Settings"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
              The name entered here will appear on the <strong class="application"><code>Mailwatch</code></strong> icon
              tooltip, which indicates mailboxes that have new mail.
              This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term">Maildir Path</span></dt><dd><p>The toplevel directory of your Maildir.  (Note: This is the
@@ -162,7 +158,7 @@
       folder is a single, large file that contains all your messages.
       Because of this, Mbox expects to find a specially-formatted Mbox
       file instead of a directory tree.
-    </p><div class="figure"><a name="mailwatch-mailbox-mbox-fig"></a><p class="title"><b>Figure 11. Mbox Settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-mbox-settings.png" alt="Mbox Settings Dialog"></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
+    </p><div class="figure"><a name="mailwatch-mailbox-mbox-fig"></a><p class="title"><b>Figure 11. Mbox Settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-mbox-settings.png" alt="Mbox Settings Dialog"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
              The name entered here will appear on the <strong class="application"><code>Mailwatch</code></strong> icon
              tooltip, which indicates mailboxes that have new mail.
              This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term">Mbox Filename</span></dt><dd><p>The location of your Mbox file (often
@@ -171,29 +167,29 @@
              mailbox for new mail. It is safe to set a value as low as
              1 minute, as this is presumably on a local filesystem, or
              at least a local network.</p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-mh"></a>MH Maildir</h3></div></div></div><p>MH Maildir is a variant of the Maildir format.  For a MH
-      Maildir, <strong class="application"><code>Mailwatch</code></strong> reads your
-      <code class="envar">$HOME</code><code class="filename">/.mh_profile</code> for its
+      Maildir mailbox, <strong class="application"><code>Mailwatch</code></strong> reads your
+      <code class="envar">$HOME</code><code class="filename">/.mh_profile</code> file for its
       configuration, so there are no actual settings specific to MH
       mailboxes.
-    </p><div class="figure"><a name="mailwatch-mailbox-mh-fig"></a><p class="title"><b>Figure 12. MH Maildir Settings</b></p><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-mh-settings.png" alt="MH Settings Dialog"></div></div></div><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
+    </p><div class="figure"><a name="mailwatch-mailbox-mh-fig"></a><p class="title"><b>Figure 12. MH Maildir Settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/mailwatch-mh-settings.png" alt="MH Settings Dialog"></div></div></div></div><br class="figure-break"><div class="variablelist"><dl><dt><span class="term">Mailbox Name</span></dt><dd><p>A descriptive name for the mailbox.
              The name entered here will appear on the <strong class="application"><code>Mailwatch</code></strong> icon
              tooltip, which indicates mailboxes that have new mail.
              This setting is required, regardless of the mailbox type.</p></dd><dt><span class="term">Interval</span></dt><dd><p>Defines how often <strong class="application"><code>Mailwatch</code></strong> checks the
              mailbox for new mail. It is safe to set a value as low as
              1 minute, as this is presumably on a local filesystem, or
              at least a local network.</p></dd></dl></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mailwatch-about"></a>About <strong class="application"><code>Mailwatch</code></strong></h2></div></div></div><p><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong> is written and maintained by Brian Tarricone
-    <code class="email"><<a href="mailto:bjt23 at cornell.edu">bjt23 at cornell.edu</a>></code> and Pasi Orovuo
-    <code class="email"><<a href="mailto:pasi.ov at gmail.com">pasi.ov at gmail.com</a>></code>. For more information,
-    please visit the <a href="http://spuriousinterrupt.org/projects/mailwatch" target="_top">
+    <code class="email"><<a class="email" href="mailto:bjt23 at cornell.edu">bjt23 at cornell.edu</a>></code> and Pasi Orovuo
+    <code class="email"><<a class="email" href="mailto:pasi.ov at gmail.com">pasi.ov at gmail.com</a>></code>. For more information,
+    please visit the <a class="ulink" href="http://spuriousinterrupt.org/projects/mailwatch" target="_top">
     <strong class="application"><code>Mailwatch</code></strong> website</a>.
   </p><p>All <strong class="application"><code>Mailwatch</code></strong> related bugs should be reported on
-    <a href="http://bugzilla.xfce.org/" target="_top">Xfce
+    <a class="ulink" href="http://bugzilla.xfce.org/" target="_top">Xfce
     Bugzilla</a>, under the Xfce Panel Plugins product, mailwatch component.
   </p><p>If you have problems using <strong class="application"><code>Mailwatch</code></strong>, use the
-    <a href="http://foo-projects.org/mailman/listinfo/xfce" target="_top">
+    <a class="ulink" href="http://foo-projects.org/mailman/listinfo/xfce" target="_top">
     Xfce general discussion list</a> for questions. Development
     discussion takes place on the
-    <a href="http://foo-projects.org/mailman/listinfo/xfce4-dev" target="_top">Xfce4-dev mailing list</a>.
+    <a class="ulink" href="http://foo-projects.org/mailman/listinfo/xfce4-dev" target="_top">Xfce4-dev mailing list</a>.
   </p><p><strong class="application"><code>Xfce4 Mailwatch Plugin</code></strong> is free software; you can redistribute it and/or
     modify it under the terms of the GNU General Public License
     as published by the Free Software Foundation; either version 2

Modified: xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.xml
===================================================================
--- xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.xml	2008-09-11 04:58:49 UTC (rev 5388)
+++ xfce4-mailwatch-plugin/trunk/doc/C/xfce4-mailwatch-plugin.xml	2008-09-11 05:42:13 UTC (rev 5389)
@@ -2,7 +2,7 @@
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
           "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
 [
-    <!ENTITY date "September 2005">
+    <!ENTITY date "September 2008">
     <!ENTITY version SYSTEM "../version">
     <!ENTITY app "<application>Xfce4 Mailwatch Plugin</application>">
     <!ENTITY sapp "<application>Mailwatch</application>">
@@ -36,7 +36,7 @@
   </copyright>
 
   <copyright>
-    <year>2005-2006</year> <holder>Brian Tarricone</holder>
+    <year>2005-2008</year> <holder>Brian Tarricone</holder>
   </copyright>
 
   <authorgroup>
@@ -83,14 +83,15 @@
 <sect1 id="mailwatch-usage">
   <title>Usage</title>
 
-  <para>The &sapp; icon remains gray (default color) as long as it does 
+  <para>The &sapp; icon remains grey (default color) as long as it does 
 	not detect any new mail. As soon as it checks, and there is new mail, 
 	the mail icon will turn gold (default color). By clicking on the mail 
-	icon, a command, to be defined in the properties dialog box, will be 
-	launched. A forced mail check can be obtained by middle-clicking
+	icon, a command, which can be defined in the properties dialog box,
+    will be launched. A mail check can be forced by middle-clicking
 	the &sapp; icon in the panel. Right-clicking on the &sapp; icon
 	shows a context menu from which you can choose <guimenuitem>Properties</guimenuitem>
-	to access the configuration options.	
+	to access the configuration options.  There are also menu items
+    for forcing an update and the about box.
   </para>
 </sect1>
 
@@ -321,11 +322,10 @@
     </variablelist>
 
     <para>The default setup uses unencrypted connections and the
-      default &imap; folder. For most users this is enough, and everything
-      should work now. Mail server implementations differ, and this
-      setup might not work for you. For example, you service provider
-      might require encrypted connections (which you should use wherever
-      possible). For that there's the advanced settings dialog.
+      default &imap; folder. It is highly recommended that you select
+      an encrypted connection type if your mail provider supports it.
+      Others may require an encrypted connection. For that there's the
+      advanced settings dialog.
     </para>
 
     <sect3 id="mailwatch-mailbox-imap-advanced">
@@ -355,21 +355,20 @@
           
           <listitem>
             <para>If your &imap; service provider supports encryption
-              for client connections, you should take advantage of that.
+              for client connections, you should take advantage of it.
               There are generally two implementations of encrypted
-              connections. The most common one, even though it's against
-              the &imap; RFC uses the port 993 for client connections.
-              In this scheme, the connection is encrypted from the
-              beginning, as the encryption is initialized before the
-              actual &imap; traffic. The other, less common method, uses
-              the ordinary &imap; port for initializing
-              the connection and then, before any sensitive data is
-              transmitted, initializes the encryption with the
-              <emphasis>STARTTLS</emphasis> command. &sapp; provides
+              connections. The most common one uses port 993 for client
+              connections and encrypts the connection from the start.
+              The other, less common method, uses the ordinary &imap; port
+              for initializing the connection and then, before any
+              sensitive data is transmitted, initializes the encryption
+              with the <emphasis>STARTTLS</emphasis> command. &sapp; provides
               default settings for these setups, which are
               <guimenuitem>Use SSL/TLS on alternate port</guimenuitem> and
               <guimenuitem>Use SSL/TLS via STARTTLS</guimenuitem>
-              respectively.
+              respectively.  If you're not sure which option your mail
+              provider supports, you can test via trial and error by using
+              each setting, and then checking the log viewer for errors.
             </para>
 
             <para>There's also the possibility of using a non-standard &imap;
@@ -417,7 +416,9 @@
         possible that you'd receive new mail in folders other than your
         inbox.  If that's the case, you can use the <guilabel>New Mail
         Folders</guilabel>  dialog to instruct &sapp; to check mail in
-        multiple folders.
+        multiple folders.  The dialog will connect to your mail server
+        and fetch a list of folders for you to select.  Of course, you'll
+        need to enter the server information first.
       </para>
     </sect3>
 
@@ -427,9 +428,9 @@
     <title>POP3</title>
     
     <para>&pop;, short for <emphasis>Post Office Protocol Version 3
-      </emphasis>, is another common type of remote mailboxes. Because
+      </emphasis>, is another common type of remote mailbox. Because
       of its remote nature, the settings for &pop; are almost the same
-      as &imap;, with some omissions as, &pop; isn't as advanced a protocol
+      as &imap;, with some omissions, as &pop; isn't as advanced a protocol
       as &imap;.
     </para>
 
@@ -523,26 +524,21 @@
           <term>Connection</term>
 
           <listitem>
-            <para>
-              By default, due common practice, &sapp; attempts
-              to access the mailbox without encrypting the traffic
-              between the local host and the mail server. For those,
-              whose service provider supports encrypted connections,
-              &sapp; supports two different methods of encryption. 
-              First one, quite commonly used, is to use an alternate
-              port (default: 995) for encrypted connections. This way,
-              the connection is encrypted from the beginning. The
-              setting to choose from the dropdown list is
-              <guimenuitem>Use SSL/TLS on alternate port</guimenuitem>
-              for this method. The other, that uses the default &pop;
-              port 110 and takes advantage of the
-              <emphasis>STARTTLS</emphasis> method of the protocol,
-              is chosen with
-              <guimenuitem>Use SSL/TLS via STARTTLS</guimenuitem>.
-              If your service provider requires a port that is different
-              of the defaults provided, you may define it by checking
-              the <guilabel>Use non-standard POP3 port</guilabel>
-              checkbox, and typing in the correct port number.
+            <para>If your &pop; service provider supports encryption
+              for client connections, you should take advantage of it.
+              There are generally two implementations of encrypted
+              connections. The most common one uses port 995 for client
+              connections and encrypts the connection from the start.
+              The other, less common method, uses the ordinary &pop; port
+              for initializing the connection and then, before any
+              sensitive data is transmitted, initializes the encryption
+              with the <emphasis>STLS</emphasis> command. &sapp; provides
+              default settings for these setups, which are
+              <guimenuitem>Use SSL/TLS on alternate port</guimenuitem> and
+              <guimenuitem>Use SSL/TLS via STARTTLS</guimenuitem>
+              respectively.  If you're not sure which option your mail
+              provider supports, you can test via trial and error by using
+              each setting, and then checking the log viewer for errors.
             </para>
           </listitem>
         </varlistentry>
@@ -729,8 +725,8 @@
     <title>MH Maildir</title>
     
     <para>MH Maildir is a variant of the Maildir format.  For a MH
-      Maildir, &sapp; reads your
-      <envar>$HOME</envar><filename>/.mh_profile</filename> for its
+      Maildir mailbox, &sapp; reads your
+      <envar>$HOME</envar><filename>/.mh_profile</filename> file for its
       configuration, so there are no actual settings specific to MH
       mailboxes.
     </para>




More information about the Goodies-commits mailing list