[Xfce4-commits] <xfce4-mailwatch-plugin:master> Remove a moved documentation
Ján SuÄan
noreply at xfce.org
Sun Sep 15 10:56:01 CEST 2013
Updating branch refs/heads/master
to ed7208d72a9a4ab44e32b4269b723a3a8a506290 (commit)
from 52bed2f3ab28b8a2161342de76ff1df09e80854b (commit)
commit ed7208d72a9a4ab44e32b4269b723a3a8a506290
Author: Ján SuÄan <sucan at runbox.com>
Date: Sun Sep 15 10:53:25 2013 +0200
Remove a moved documentation
Documentation has been moved to the goodies.xfce.org website.
configure.ac.in | 4 -
doc/C/Makefile.am | 13 -
doc/C/images/Makefile.am | 17 -
doc/C/images/mailwatch-gmail-settings.png | Bin 16933 -> 0 bytes
doc/C/images/mailwatch-imap-advanced.png | Bin 16039 -> 0 bytes
doc/C/images/mailwatch-imap-new-folders.png | Bin 20127 -> 0 bytes
doc/C/images/mailwatch-imap-settings.png | Bin 23834 -> 0 bytes
doc/C/images/mailwatch-log-window.png | Bin 20490 -> 0 bytes
doc/C/images/mailwatch-mailbox-type.png | Bin 18050 -> 0 bytes
doc/C/images/mailwatch-maildir-settings.png | Bin 15038 -> 0 bytes
doc/C/images/mailwatch-mbox-settings.png | Bin 14824 -> 0 bytes
doc/C/images/mailwatch-mh-settings.png | Bin 15048 -> 0 bytes
doc/C/images/mailwatch-panel-indicator.png | Bin 1696 -> 0 bytes
doc/C/images/mailwatch-pop3-advanced.png | Bin 13307 -> 0 bytes
doc/C/images/mailwatch-pop3-settings.png | Bin 22304 -> 0 bytes
doc/C/images/mailwatch-properties.png | Bin 28921 -> 0 bytes
doc/C/xfce4-mailwatch-plugin.html | 201 -------
doc/C/xfce4-mailwatch-plugin.xml | 808 ---------------------------
doc/Makefile.am | 11 -
doc/version.in | 1 -
doc/xfce-nochunk.xsl | 270 ---------
21 files changed, 1325 deletions(-)
diff --git a/configure.ac.in b/configure.ac.in
index 6fae290..6947d50 100644
--- a/configure.ac.in
+++ b/configure.ac.in
@@ -132,10 +132,6 @@ AC_DEFINE_UNQUOTED([WEBSITE],
AC_OUTPUT([
Makefile
-doc/Makefile
-doc/C/Makefile
-doc/C/images/Makefile
-doc/version
icons/Makefile
icons/48x48/Makefile
icons/scalable/Makefile
diff --git a/doc/C/Makefile.am b/doc/C/Makefile.am
deleted file mode 100644
index c7dca05..0000000
--- a/doc/C/Makefile.am
+++ /dev/null
@@ -1,13 +0,0 @@
-SUBDIRS = \
- images
-
-noinst_DATA = xfce4-mailwatch-plugin.xml
-
-docdir = $(datadir)/xfce4/doc/C
-doc_DATA = xfce4-mailwatch-plugin.html
-
-EXTRA_DIST = $(noinst_DATA) $(doc_DATA)
-
-html: $(srcdir)/xfce4-mailwatch-plugin.xml
- xsltproc $(top_srcdir)/doc/xfce-nochunk.xsl \
- $(srcdir)/xfce4-mailwatch-plugin.xml
diff --git a/doc/C/images/Makefile.am b/doc/C/images/Makefile.am
deleted file mode 100644
index dcbf4cc..0000000
--- a/doc/C/images/Makefile.am
+++ /dev/null
@@ -1,17 +0,0 @@
-imagesdir = $(datadir)/xfce4/doc/C/images
-images_DATA = \
- mailwatch-gmail-settings.png \
- mailwatch-imap-advanced.png \
- mailwatch-imap-new-folders.png \
- mailwatch-imap-settings.png \
- mailwatch-log-window.png \
- mailwatch-mailbox-type.png \
- mailwatch-maildir-settings.png \
- mailwatch-mbox-settings.png \
- mailwatch-mh-settings.png \
- mailwatch-panel-indicator.png \
- mailwatch-pop3-advanced.png \
- mailwatch-pop3-settings.png \
- mailwatch-properties.png
-
-EXTRA_DIST = $(images_DATA)
diff --git a/doc/C/images/mailwatch-gmail-settings.png b/doc/C/images/mailwatch-gmail-settings.png
deleted file mode 100644
index cd6ab4f..0000000
Binary files a/doc/C/images/mailwatch-gmail-settings.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-imap-advanced.png b/doc/C/images/mailwatch-imap-advanced.png
deleted file mode 100644
index 77ed225..0000000
Binary files a/doc/C/images/mailwatch-imap-advanced.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-imap-new-folders.png b/doc/C/images/mailwatch-imap-new-folders.png
deleted file mode 100644
index fe2f529..0000000
Binary files a/doc/C/images/mailwatch-imap-new-folders.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-imap-settings.png b/doc/C/images/mailwatch-imap-settings.png
deleted file mode 100644
index 406a2fe..0000000
Binary files a/doc/C/images/mailwatch-imap-settings.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-log-window.png b/doc/C/images/mailwatch-log-window.png
deleted file mode 100644
index d1f3ec3..0000000
Binary files a/doc/C/images/mailwatch-log-window.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-mailbox-type.png b/doc/C/images/mailwatch-mailbox-type.png
deleted file mode 100644
index 1cb03d6..0000000
Binary files a/doc/C/images/mailwatch-mailbox-type.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-maildir-settings.png b/doc/C/images/mailwatch-maildir-settings.png
deleted file mode 100644
index 28e8513..0000000
Binary files a/doc/C/images/mailwatch-maildir-settings.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-mbox-settings.png b/doc/C/images/mailwatch-mbox-settings.png
deleted file mode 100644
index 5a813f1..0000000
Binary files a/doc/C/images/mailwatch-mbox-settings.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-mh-settings.png b/doc/C/images/mailwatch-mh-settings.png
deleted file mode 100644
index 1dffa8b..0000000
Binary files a/doc/C/images/mailwatch-mh-settings.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-panel-indicator.png b/doc/C/images/mailwatch-panel-indicator.png
deleted file mode 100644
index 4eb1a44..0000000
Binary files a/doc/C/images/mailwatch-panel-indicator.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-pop3-advanced.png b/doc/C/images/mailwatch-pop3-advanced.png
deleted file mode 100644
index ee2b457..0000000
Binary files a/doc/C/images/mailwatch-pop3-advanced.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-pop3-settings.png b/doc/C/images/mailwatch-pop3-settings.png
deleted file mode 100644
index cc65aaf..0000000
Binary files a/doc/C/images/mailwatch-pop3-settings.png and /dev/null differ
diff --git a/doc/C/images/mailwatch-properties.png b/doc/C/images/mailwatch-properties.png
deleted file mode 100644
index 5372daf..0000000
Binary files a/doc/C/images/mailwatch-properties.png and /dev/null differ
diff --git a/doc/C/xfce4-mailwatch-plugin.html b/doc/C/xfce4-mailwatch-plugin.html
deleted file mode 100644
index e7a5e04..0000000
--- a/doc/C/xfce4-mailwatch-plugin.html
+++ /dev/null
@@ -1,201 +0,0 @@
-<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.0.
- <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 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, 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 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 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 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 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 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 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="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 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="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 <acronym class="acronym">IMAP</acronym> server and get
- information on the mailbox.
- </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 <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"><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 <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 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 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 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 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 <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 class="guilabel"><strong>New Mail
- Folders</strong></span> dialog to instruct <strong class="application"><code>Mailwatch</code></strong> to check mail in
- 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"><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,
- unless you're really sure your service provider
- 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. <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 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="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
- Mailwatch expects to find). A Maildir consists of a top level
- directory (<code class="filename">~/.maildir</code> for
- example), which contains three subdirectories
- (<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="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
- main mail folder, not any of the three subdirectories.)
- </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 class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mailwatch-mailbox-mbox"></a>Mbox</h3></div></div></div><p>Mbox is another very common local mailbox format in which each
- 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="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
- <code class="filename">/var/mail/</code><code class="envar">$USER</code>).
- </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 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 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="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 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 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 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 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
- of the License, or (at your option) any later version.
- </p><p>You should have received a copy of the GNU General Public
- License along with this program; if not, write to the Free
- Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
- Boston, MA 02110-1301, USA.
- </p></div></div></body></html>
diff --git a/doc/C/xfce4-mailwatch-plugin.xml b/doc/C/xfce4-mailwatch-plugin.xml
deleted file mode 100644
index 5f85ae1..0000000
--- a/doc/C/xfce4-mailwatch-plugin.xml
+++ /dev/null
@@ -1,808 +0,0 @@
-<?xml version="1.0"?>
-<!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 2008">
- <!ENTITY version SYSTEM "../version">
- <!ENTITY app "<application>Xfce4 Mailwatch Plugin</application>">
- <!ENTITY sapp "<application>Mailwatch</application>">
- <!ENTITY imap "<acronym>IMAP</acronym>">
- <!ENTITY pop "<acronym>POP3</acronym>">
- <!ENTITY mailbox_name_desc "A descriptive name for the mailbox.
- The name entered here will appear on the &sapp; icon
- tooltip, which indicates mailboxes that have new mail.
- This setting is required, regardless of the mailbox type.">
- <!ENTITY remote_interval_desc "Defines how often &sapp; 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.">
- <!ENTITY local_interval_desc "Defines how often &sapp; 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.">
-
-]>
-
-<article id="xfce4-mailwatch-plugin" lang="en">
-
-<articleinfo>
-
- <title>Xfce 4 Mailwatch Plugin</title>
-
- <copyright>
- <year>2005-2006</year> <holder>Pasi Orovuo</holder>
- </copyright>
-
- <copyright>
- <year>2005-2008</year> <holder>Brian Tarricone</holder>
- </copyright>
-
- <authorgroup>
- <author>
- <firstname>Pasi</firstname> <surname>Orovuo</surname>
- <affiliation>
- <address><email>pasi.ov at gmail.com</email></address>
- </affiliation>
- </author>
-
- <author>
- <firstname>Brian</firstname> <surname>Tarricone</surname>
- <affiliation>
- <address><email>bjt23 at cornell.edu</email></address>
- </affiliation>
- </author>
- </authorgroup>
-
- <releaseinfo>This manual describes <emphasis>&app;</emphasis>
- version &version;.
- </releaseinfo>
-
-</articleinfo>
-
-<sect1 id="mailwatch-introduction">
- <title>Introduction</title>
-
- <para>&app; is a multi-protocol, multi-mailbox mail watcher for the
- <ulink url="xfce4-panel.html" type="http">Xfce4 panel</ulink>.
- Currently, the protocols supported are:
-
- <itemizedlist>
- <listitem><para>IMAP (SSL/TLS and cleartext)</para></listitem>
- <listitem><para>POP3 (SSL/TLS and cleartext)</para></listitem>
- <listitem><para>GMail mailbox (HTTPS)</para></listitem>
- <listitem><para>Mbox mail spool (local)</para></listitem>
- <listitem><para>Maildir mail spool (local)</para></listitem>
- <listitem><para>MH-Maildir mail spool (local)</para></listitem>
- </itemizedlist>
-
- </para>
-</sect1>
-
-<sect1 id="mailwatch-usage">
- <title>Usage</title>
-
- <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, 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. There are also menu items
- for forcing an update and the about box.
- </para>
-</sect1>
-
-<sect1 id="mailwatch-properties">
- <title>Properties</title>
-
- <para>&app; has a variety of configuration options. Access to the
- configuration is gained by right-clicking the panel icon, and by
- choosing <guimenuitem>Properties</guimenuitem>.
- </para>
-
- <figure id="mailwatch-properties-fig">
- <title>&sapp; main settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-properties.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>&sapp; properties dialog</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <variablelist>
- <varlistentry>
- <term>Mailboxes</term>
-
- <listitem>
- <para>The main controls for managing mailboxes are
- <guibutton>Add</guibutton>, <guibutton>Edit</guibutton>,
- and <guibutton>Remove</guibutton>. At later stage, we'll walk
- through adding and configuring each mailbox type.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>External Programs</term>
-
- <listitem>
- <para>&sapp; 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 <guilabel>Run on click</guilabel> entry field. You can
- also define the command to be executed when &sapp; detects
- new mail by typing the desired command in the <guilabel>Run on
- new messages</guilabel> entry field. Note that the command
- is executed once for each time &sapp; detects new mail,
- regardless of the number of new messages received.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Icons</term>
-
- <listitem>
- <para>The icons that &sapp; displays in the panel are configurable.
- Both the <guiicon>Normal</guiicon> and <guiicon>New Mail</guiicon>
- buttons present a file chooser dialog, which you can use to select
- your preferred icons.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Logging</term>
-
- <listitem>
- <para>&sapp; includes a logging mechanism as well. It provides
- information about errors and other noteworthy events that take
- place. The log is accessible via the <guibutton>View Log</guibutton>
- button. There's also a setting to <guilabel>Show log status
- in icon</guilabel> in the log dialog which, if enabled, provides
- a visual indication of new log events in the panel.
- </para>
-
- <figure id="mailwatch-log-window-fig">
- <title>Log Window</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-log-window.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>&sapp; log window</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure id="mailwatch-panel-indicator-fig">
- <title>Panel Indicator</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-panel-indicator.png"
- format="PNG" />
- </imageobject>
-
- <textobject><phrase>Panel indicator</phrase></textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- </listitem>
- </varlistentry>
-
- </variablelist>
-
-</sect1>
-
-<sect1 id="mailwatch-mailboxes">
- <title>Mailbox configuration</title>
-
- <para>In this section we walk through adding and configuring each
- type of mailbox.
- </para>
-
- <para>To add a new mailbox, click <guibutton>Add</guibutton> 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.
- </para>
-
- <figure id="mailwatch-mailbox-type-fig">
- <title>Mailbox type selection</title>
-
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/mailwatch-mailbox-type.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>Mailbox type selection dialog</phrase>
- </textobject>
- </mediaobject>
-
- </screenshot>
- </figure>
-
- <sect2 id="mailwatch-mailbox-imap">
- <title>IMAP</title>
-
- <para>&imap;, acronym for <emphasis>Internet Message Access
- Protocol</emphasis>, is a quite common mailbox format. An &imap;
- mailbox is a remote mailbox, so it requires various configuration
- options to be able to contact the remote &imap; server and get
- information on the mailbox.
- </para>
-
- <para>To create an &imap; account in &sapp;, choose <emphasis>
- Remote IMAP Mailbox</emphasis> in the mailbox type chooser dialog,
- and you will be presented with the &imap; settings dialog.
- </para>
-
- <figure id="mailwatch-imap-settings-fig">
- <title>IMAP Settings Dialog</title>
-
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/mailwatch-imap-settings.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>&sapp; &imap; Settings</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
-
- </figure>
-
- <variablelist>
- <varlistentry>
- <term>Mailbox Name</term>
-
- <listitem>
- <para>&mailbox_name_desc;</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>&imap; Server</term>
-
- <listitem>
-
- <itemizedlist>
- <listitem>
- <para>Mail server - The hostname of the remote mail server.</para>
- </listitem>
-
- <listitem>
- <para>Username - The username to use while accessing the mailbox.</para>
- </listitem>
-
- <listitem>
- <para>Password - The password to use.</para>
- </listitem>
- </itemizedlist>
-
- </listitem>
-
- </varlistentry>
-
- <varlistentry>
- <term>Interval</term>
-
- <listitem>
- <para>&remote_interval_desc;</para>
- </listitem>
- </varlistentry>
-
- </variablelist>
-
- <para>The default setup uses unencrypted connections and the
- 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">
- <title>Advanced Settings</title>
-
- <figure id="mailwatch-mailbox-imap-advanced-fig">
- <title>Advanced &imap; settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-imap-advanced.png" format="PNG" />
- </imageobject>
-
- <textobject><phrase>Advanced &imap; settings</phrase></textobject>
-
- </mediaobject>
- </screenshot>
-
- </figure>
-
- <variablelist>
-
- <varlistentry>
- <term>Connection</term>
-
- <listitem>
- <para>If your &imap; 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 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. 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;
- 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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Folders</term>
-
- <listitem>
- <para>In addition of the connection related settings, you can
- set the directory on the server where your mail is stored using
- the <guilabel>IMAP server directory</guilabel> 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 <guilabel>New
- mail folders</guilabel> dialog box, you may need to set this,
- often to something like "mail", "Mail", or "Maildir".
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </sect3>
-
- <sect3 id="mailwatch-mailbox-imap-folders">
- <title>New mail folders</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-imap-new-folders.png" format="PNG" />
- </imageobject>
-
- <textobject><phrase>&imap; new mail folders settings</phrase></textobject>
-
- </mediaobject>
- </screenshot>
-
- <para>Since &imap; 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 <guilabel>New Mail
- Folders</guilabel> dialog to instruct &sapp; to check mail in
- 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>
-
- </sect2>
-
- <sect2 id="mailwatch-mailbox-pop3">
- <title>POP3</title>
-
- <para>&pop;, short for <emphasis>Post Office Protocol Version 3
- </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;.
- </para>
-
- <figure id="mailwatch-mailbox-pop3-fig">
- <title>POP3 Settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-pop3-settings.png" format="PNG" />
- </imageobject>
-
- <textobject><phrase>&sapp; &pop; settings</phrase></textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <variablelist>
-
- <varlistentry>
- <term>Mailbox Name</term>
-
- <listitem>
- <para>&mailbox_name_desc;</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>&pop; Server</term>
-
- <listitem>
- <itemizedlist>
-
- <listitem>
- <para>Mail server - Hostname of the &pop; server.</para>
- </listitem>
-
- <listitem>
- <para>Username - Username to authenticate with.</para>
- </listitem>
-
- <listitem>
- <para>Password - Password to use in authentication.</para>
- </listitem>
-
- </itemizedlist>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Interval</term>
-
- <listitem>
- <para>&remote_interval_desc;</para>
- </listitem>
- </varlistentry>
-
- </variablelist>
-
- <para>While for most users providing these settings should be enough,
- there are also advanced settings for those who need additional
- features.
- </para>
-
- <sect3 id="mailwatch-mailbox-pop3-advanced">
- <title>Advanced Settings</title>
-
- <figure id="mailwatch-mailbox-pop3-advanced-fig">
- <title>&pop; Advanced Settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-pop3-advanced.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>&pop; Advanced Settings dialog</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <variablelist>
-
- <varlistentry>
- <term>Connection</term>
-
- <listitem>
- <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>
-
- </variablelist>
-
- </sect3>
-
- </sect2>
-
-
- <sect2 id="mailwatch-mailbox-gmail">
- <title>GMail</title>
-
- <para>Mailwatch can also watch your
- <ulink url="http://gmail.com/" type="http">GMail</ulink> mailbox.
- Mailwatch does this securely by using HTTPS and GMail's RSS feed.
- </para>
-
- <figure id="mailwatch-mailbox-gmail-fig">
- <title>GMail Settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-gmail-settings.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>GMail Settings</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <variablelist>
- <varlistentry>
- <term>GMail Server</term>
-
- <listitem>
- <itemizedlist>
- <listitem>
- <para>Username - Your GMail username.</para>
- </listitem>
-
- <listitem>
- <para>Password - Your GMail password.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
- <sect2 id="mailwatch-mailbox-maildir">
- <title>Maildir</title>
-
- <para>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
- Mailwatch expects to find). A Maildir consists of a top level
- directory (<filename class="directory">~/.maildir</filename> for
- example), which contains three subdirectories
- (<filename class="directory">cur</filename>,
- <filename class="directory">new</filename>,
- <filename class="directory">tmp</filename>).
- </para>
-
- <figure id="mailwatch-mailbox-maildir-fig">
- <title>Maildir Settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-maildir-settings.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>&sapp; Maildir Settings</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
-
- </figure>
-
- <variablelist>
-
- <varlistentry>
- <term>Mailbox Name</term>
-
- <listitem>
- <para>&mailbox_name_desc;</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Maildir Path</term>
-
- <listitem>
- <para>The toplevel directory of your Maildir. (Note: This is the
- main mail folder, not any of the three subdirectories.)
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Interval</term>
-
- <listitem>
- <para>&local_interval_desc;</para>
- </listitem>
- </varlistentry>
-
- </variablelist>
-
- </sect2>
-
- <sect2 id="mailwatch-mailbox-mbox">
- <title>Mbox</title>
-
- <para>Mbox is another very common local mailbox format in which each
- 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.
- </para>
-
- <figure id="mailwatch-mailbox-mbox-fig">
- <title>Mbox Settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-mbox-settings.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>Mbox Settings Dialog</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
-
- </figure>
-
- <variablelist>
-
- <varlistentry>
- <term>Mailbox Name</term>
-
- <listitem>
- <para>&mailbox_name_desc;</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Mbox Filename</term>
-
- <listitem>
- <para>The location of your Mbox file (often
- <filename>/var/mail/</filename><envar>$USER</envar>).
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Interval</term>
-
- <listitem>
- <para>&local_interval_desc;</para>
- </listitem>
- </varlistentry>
-
- </variablelist>
-
- </sect2>
-
- <sect2 id="mailwatch-mailbox-mh">
- <title>MH Maildir</title>
-
- <para>MH Maildir is a variant of the Maildir format. For a MH
- 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>
-
- <figure id="mailwatch-mailbox-mh-fig">
- <title>MH Maildir Settings</title>
-
- <screenshot>
- <mediaobject>
-
- <imageobject>
- <imagedata fileref="images/mailwatch-mh-settings.png" format="PNG" />
- </imageobject>
-
- <textobject>
- <phrase>MH Settings Dialog</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <variablelist>
- <varlistentry>
- <term>Mailbox Name</term>
-
- <listitem><para>&mailbox_name_desc;</para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>Interval</term>
-
- <listitem><para>&local_interval_desc;</para></listitem>
- </varlistentry>
- </variablelist>
-
- </sect2>
-
-</sect1>
-
-<sect1 id="mailwatch-about">
- <title>About &sapp;</title>
-
- <para>&app; is written and maintained by Brian Tarricone
- <email>bjt23 at cornell.edu</email> and Pasi Orovuo
- <email>pasi.ov at gmail.com</email>. For more information,
- please visit the <ulink url="http://spuriousinterrupt.org/projects/mailwatch" type="http">
- &sapp; website</ulink>.
- </para>
-
- <para>All &sapp; related bugs should be reported on
- <ulink url="http://bugzilla.xfce.org/" type="http">Xfce
- Bugzilla</ulink>, under the Xfce Panel Plugins product, mailwatch component.
- </para>
-
- <para>If you have problems using &sapp;, use the
- <ulink url="http://foo-projects.org/mailman/listinfo/xfce" type="http">
- Xfce general discussion list</ulink> for questions. Development
- discussion takes place on the
- <ulink url="http://foo-projects.org/mailman/listinfo/xfce4-dev"
- type="http">Xfce4-dev mailing list</ulink>.
- </para>
-
- <para>&app; 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
- of the License, or (at your option) any later version.
- </para>
-
- <para>You should have received a copy of the GNU General Public
- License along with this program; if not, write to the Free
- Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
- Boston, MA 02110-1301, USA.
- </para>
-
-</sect1>
-
-</article>
-
diff --git a/doc/Makefile.am b/doc/Makefile.am
deleted file mode 100644
index a5a26b6..0000000
--- a/doc/Makefile.am
+++ /dev/null
@@ -1,11 +0,0 @@
- at SET_MAKE@
-
-SUBDIRS = \
- C
-
-noinst_DATA = xfce-nochunk.xsl
-
-EXTRA_DIST = $(noinst_DATA)
-
-html: Makefile
- $(MAKE) -C C html
diff --git a/doc/version.in b/doc/version.in
deleted file mode 100644
index 27323da..0000000
--- a/doc/version.in
+++ /dev/null
@@ -1 +0,0 @@
- at VERSION@
\ No newline at end of file
diff --git a/doc/xfce-nochunk.xsl b/doc/xfce-nochunk.xsl
deleted file mode 100644
index 3dae476..0000000
--- a/doc/xfce-nochunk.xsl
+++ /dev/null
@@ -1,270 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version='1.0'
- xmlns="http://www.w3.org/TR/xhtml1/transitional"
- exclude-result-prefixes="#default">
-
-<!-- Load onechunk.xsl stylesheet
- TODO: how can I put a location independent link here?
-This should work. The url can be translated to a local one in the catalog
-file"
--->
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/onechunk.xsl"/>
-
-<xsl:param name="suppress.navigation">1</xsl:param>
-
-<!-- Use stylesheet -->
-<xsl:param name="html.stylesheet" select="'../xfce.css'"/>
-
-<!-- labels and numbering -->
-<xsl:param name="autotoc.label.separator" select="'. '"/>
-<xsl:param name="chapter.autolabel" select="1"/>
-
-<!-- Don't force the use of index.html as root filename -->
-<xsl:param name="root.filename" select="''"/>
-
-<!-- Use element id (if present) as file name -->
-<xsl:variable name="use.id.as.filename">1</xsl:variable>
-
-<xsl:template match="releaseinfo" mode="titlepage.mode">
- <span class="{name(.)}">
- <xsl:apply-templates mode="titlepage.mode"/>
- <br/>
- </span>
-</xsl:template>
-
-<!-- Use graphics in admonitions (note, warning, etc) -->
-<xsl:variable name="admon.graphics">0</xsl:variable>
-
-<xsl:param name="admon.style">
- <xsl:text>text-align: left;</xsl:text></xsl:param>
-
-<xsl:variable name="admon.graphics.path">stylesheet-images/</xsl:variable>
-
-<xsl:variable name="admon.graphics.extension">.gif</xsl:variable>
-
-<xsl:param name="table.border.thickness" select="'0.2pt'"/>
-
-<xsl:param name="graphic.default.extension" select="png"/>
-
-<xsl:attribute-set name="shade.verbatim.style">
- <xsl:attribute name="border">0</xsl:attribute>
- <xsl:attribute name="bgcolor">#F3F4F8</xsl:attribute>
- <xsl:attribute name="width">100%</xsl:attribute>
-</xsl:attribute-set>
-
-<!-- Addition by Jasper Huijsmans to be able to set background color -->
-<!-- and cell attributes. -->
-<!-- This requires an adapted template for tgroup (see end of stylesheet) -->
-<xsl:attribute-set name="table.style">
- <xsl:attribute name="bgcolor">#F8F9FD</xsl:attribute>
- <xsl:attribute name="cellspacing">0</xsl:attribute>
- <xsl:attribute name="cellpadding">4</xsl:attribute>
-</xsl:attribute-set>
-
-
-<xsl:param name="generate.legalnotice.link" select="0"/>
-
-<xsl:param name="shade.verbatim" select="1"/>
-
-<!-- set font styles for various tags -->
-<xsl:template match="guibutton">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<xsl:template match="guiicon">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<xsl:template match="guilabel">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<xsl:template match="guimenu">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<xsl:template match="guimenuitem">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<xsl:template match="guisubmenu">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<xsl:template match="application">
-<xsl:call-template name="inline.boldmonoseq"/>
-</xsl:template>
-
-<xsl:template match="caption">
-<xsl:call-template name="inline.boldseq"/>
-</xsl:template>
-
-<!-- Adapted template for tgroup. The only change is the addition of -->
-<!-- table.style attributes -->
-<xsl:template match="tgroup">
- <table xsl:use-attribute-sets="table.style">
- <xsl:choose>
- <!-- If there's a <?dbhtml table-summary="foo"?> PI, use it for
- the HTML table summary attribute -->
- <xsl:when test="processing-instruction('dbhtml')">
- <xsl:variable name="summary">
- <xsl:call-template name="dbhtml-attribute">
- <xsl:with-param name="pis"
- select="processing-instruction('dbhtml')[1]"/>
- <xsl:with-param name="attribute" select="'table-summary'"/>
- </xsl:call-template>
- </xsl:variable>
- <xsl:if test="$summary != ''">
- <xsl:attribute name="summary">
- <xsl:value-of select="$summary"/>
- </xsl:attribute>
- </xsl:if>
- </xsl:when>
- <!-- Otherwise, if there's a title, use that -->
- <xsl:when test="../title">
- <xsl:attribute name="summary">
- <xsl:value-of select="string(../title)"/>
- </xsl:attribute>
- </xsl:when>
- <!-- Otherwise, forget the whole idea -->
- <xsl:otherwise><!-- nevermind --></xsl:otherwise>
- </xsl:choose>
-
- <xsl:if test="../@pgwide=1">
- <xsl:attribute name="width">100%</xsl:attribute>
- </xsl:if>
-
- <xsl:choose>
- <xsl:when test="../@frame='none'">
- <xsl:attribute name="border">0</xsl:attribute>
- </xsl:when>
- <xsl:when test="$table.borders.with.css != 0">
- <xsl:attribute name="border">0</xsl:attribute>
- <xsl:choose>
- <xsl:when test="../@frame='topbot' or ../@frame='top'">
- <xsl:attribute name="style">
- <xsl:call-template name="border">
- <xsl:with-param name="side" select="'top'"/>
- </xsl:call-template>
- </xsl:attribute>
- </xsl:when>
- <xsl:when test="../@frame='sides'">
- <xsl:attribute name="style">
- <xsl:call-template name="border">
- <xsl:with-param name="side" select="'left'"/>
- </xsl:call-template>
- <xsl:call-template name="border">
- <xsl:with-param name="side" select="'right'"/>
- </xsl:call-template>
- </xsl:attribute>
- </xsl:when>
- </xsl:choose>
- </xsl:when>
- <xsl:otherwise>
- <xsl:attribute name="border">1</xsl:attribute>
- </xsl:otherwise>
- </xsl:choose>
-
- <xsl:variable name="colgroup">
- <colgroup>
- <xsl:call-template name="generate.colgroup">
- <xsl:with-param name="cols" select="@cols"/>
- </xsl:call-template>
- </colgroup>
- </xsl:variable>
-
- <xsl:variable name="explicit.table.width">
- <xsl:call-template name="dbhtml-attribute">
- <xsl:with-param name="pis"
- select="../processing-instruction('dbhtml')[1]"/>
- <xsl:with-param name="attribute" select="'table-width'"/>
- </xsl:call-template>
- </xsl:variable>
-
- <xsl:variable name="table.width">
- <xsl:choose>
- <xsl:when test="$explicit.table.width != ''">
- <xsl:value-of select="$explicit.table.width"/>
- </xsl:when>
- <xsl:when test="$default.table.width = ''">
- <xsl:text>100%</xsl:text>
- </xsl:when>
- <xsl:otherwise>
- <xsl:value-of select="$default.table.width"/>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:variable>
-
- <xsl:if test="$default.table.width != ''
- or $explicit.table.width != ''">
- <xsl:attribute name="width">
- <xsl:choose>
- <xsl:when test="contains($table.width, '%')">
- <xsl:value-of select="$table.width"/>
- </xsl:when>
- <xsl:when test="$use.extensions != 0
- and $tablecolumns.extension != 0">
- <xsl:choose>
- <xsl:when test="function-available('stbl:convertLength')">
- <xsl:value-of select="stbl:convertLength($table.width)"/>
- </xsl:when>
- <xsl:when test="function-available('xtbl:convertLength')">
- <xsl:value-of select="xtbl:convertLength($table.width)"/>
- </xsl:when>
- <xsl:otherwise>
- <xsl:message terminate="yes">
- <xsl:text>No convertLength function available.</xsl:text>
- </xsl:message>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:when>
- <xsl:otherwise>
- <xsl:value-of select="$table.width"/>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:attribute>
- </xsl:if>
-
- <xsl:choose>
- <xsl:when test="$use.extensions != 0
- and $tablecolumns.extension != 0">
- <xsl:choose>
- <xsl:when test="function-available('stbl:adjustColumnWidths')">
- <xsl:copy-of select="stbl:adjustColumnWidths($colgroup)"/>
- </xsl:when>
- <xsl:when test="function-available('xtbl:adjustColumnWidths')">
- <xsl:copy-of select="xtbl:adjustColumnWidths($colgroup)"/>
- </xsl:when>
- <xsl:otherwise>
- <xsl:message terminate="yes">
- <xsl:text>No adjustColumnWidths function available.</xsl:text>
- </xsl:message>
- </xsl:otherwise>
- </xsl:choose>
- </xsl:when>
- <xsl:otherwise>
- <xsl:copy-of select="$colgroup"/>
- </xsl:otherwise>
- </xsl:choose>
-
- <xsl:apply-templates select="thead"/>
- <xsl:apply-templates select="tbody"/>
- <xsl:apply-templates select="tfoot"/>
-
- <xsl:if test=".//footnote">
- <tbody class="footnotes">
- <tr>
- <td colspan="{@cols}">
- <xsl:apply-templates select=".//footnote"
- mode="table.footnote.mode"/>
- </td>
- </tr>
- </tbody>
- </xsl:if>
- </table>
-</xsl:template>
-
-
-</xsl:stylesheet>
-
More information about the Xfce4-commits
mailing list