Update of /cvsroot/mahogany/M/doc/HtmlHlp
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv27193/doc/HtmlHlp
Modified Files:
Manual.hhc Manual.html
Log Message:
regenerated for 0.67
Index: Manual.hhc
===================================================================
RCS file: /cvsroot/mahogany/M/doc/HtmlHlp/Manual.hhc,v
retrieving revision 1.10
retrieving revision 1.11
diff -b -u -2 -r1.10 -r1.11
--- Manual.hhc 20 Jan 2004 12:39:37 -0000 1.10
+++ Manual.hhc 13 Jul 2004 15:06:08 -0000 1.11
@@ -147,4 +147,8 @@
<param name="Name" value="Filters">
</OBJECT>
+ <LI> <OBJECT type="text/sitemap">
+<param name="Local" value="Manual.html#SECTION00257000000000000000">
+<param name="Name" value="Spam filtering">
+</OBJECT>
</UL>
<LI> <OBJECT type="text/sitemap">
@@ -181,20 +185,24 @@
<LI> <OBJECT type="text/sitemap">
<param name="Local" value="Manual.html#SECTION00271000000000000000">
-<param name="Name" value="Automatically remembered options">
+<param name="Name" value="Hierarchical options organization">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Local" value="Manual.html#SECTION00272000000000000000">
-<param name="Name" value="Other options">
+<param name="Name" value="Automatically remembered options">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Local" value="Manual.html#SECTION00273000000000000000">
-<param name="Name" value="Remote configuration synchronisation">
+<param name="Name" value="Other options">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Local" value="Manual.html#SECTION00274000000000000000">
-<param name="Name" value="Some Other Dialogs You May Encounter">
+<param name="Name" value="Remote configuration synchronisation">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Local" value="Manual.html#SECTION00275000000000000000">
+<param name="Name" value="Some Other Dialogs You May Encounter">
+</OBJECT>
+ <LI> <OBJECT type="text/sitemap">
+<param name="Local" value="Manual.html#SECTION00276000000000000000">
<param name="Name" value="Mahogany Plugin Modules">
</OBJECT>
Index: Manual.html
===================================================================
RCS file: /cvsroot/mahogany/M/doc/HtmlHlp/Manual.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -b -u -2 -r1.22 -r1.23
--- Manual.html 20 Jun 2004 22:52:02 -0000 1.22
+++ Manual.html 13 Jul 2004 15:06:08 -0000 1.23
@@ -9,7 +9,7 @@
<HEAD>
<TITLE>Mahogany User Manual
-Version 0.66 ``Clio''</TITLE>
+Version 0.67 ``Constance''</TITLE>
<META NAME="description" CONTENT="Mahogany User Manual
-Version 0.66 ``Clio''">
+Version 0.67 ``Constance''">
<META NAME="keywords" CONTENT="Manual">
<META NAME="resource-type" CONTENT="document">
@@ -35,5 +35,5 @@
<P>
<H1 ALIGN="CENTER"><FONT SIZE="+2"><I>Mahogany User Manual</I></FONT>
-<BR><FONT SIZE="+2">Version 0.66 ``Clio''</FONT></H1>
+<BR><FONT SIZE="+2">Version 0.67 ``Constance''</FONT></H1>
<P ALIGN="CENTER"><STRONG>Copyright 1997-2004 by The Mahogany Development Team
<BR>
@@ -59,231 +59,235 @@
<UL>
-<LI><A NAME="tex2html156"
+<LI><A NAME="tex2html161"
HREF="Manual.html">Using Mahogany </A>
<UL>
-<LI><A NAME="tex2html157"
+<LI><A NAME="tex2html162"
HREF="#SECTION00210000000000000000">Release Notes</A>
<UL>
-<LI><A NAME="tex2html158"
+<LI><A NAME="tex2html163"
HREF="#SECTION00211000000000000000">Changes against the previous versions</A>
-<LI><A NAME="tex2html159"
+<LI><A NAME="tex2html164"
HREF="#SECTION00212000000000000000">Known bugs</A>
-<LI><A NAME="tex2html160"
+<LI><A NAME="tex2html165"
HREF="#SECTION00213000000000000000">TODO, features to implement</A>
-<LI><A NAME="tex2html161"
+<LI><A NAME="tex2html166"
HREF="#SECTION00214000000000000000">Help Needed</A>
-<LI><A NAME="tex2html162"
+<LI><A NAME="tex2html167"
HREF="#SECTION00215000000000000000">Copyright</A>
-<LI><A NAME="tex2html163"
+<LI><A NAME="tex2html168"
HREF="#SECTION00216000000000000000">The Mahogany ``Artistic License''</A>
-<LI><A NAME="tex2html164"
+<LI><A NAME="tex2html169"
HREF="#SECTION00217000000000000000">The License Dialog</A>
-<LI><A NAME="tex2html165"
+<LI><A NAME="tex2html170"
HREF="#SECTION00218000000000000000">Additional Credits</A>
</UL>
-<LI><A NAME="tex2html166"
+<LI><A NAME="tex2html171"
HREF="#SECTION00220000000000000000">Introduction / Tutorial</A>
<UL>
-<LI><A NAME="tex2html167"
+<LI><A NAME="tex2html172"
HREF="#SECTION00221000000000000000">Getting started</A>
-<LI><A NAME="tex2html168"
+<LI><A NAME="tex2html173"
HREF="#SECTION00222000000000000000">The main window</A>
-<LI><A NAME="tex2html169"
+<LI><A NAME="tex2html174"
HREF="#SECTION00223000000000000000">How to configure POP and IMAP folders?</A>
-<LI><A NAME="tex2html170"
+<LI><A NAME="tex2html175"
HREF="#SECTION00224000000000000000">How to set up your mail accounts</A>
</UL>
-<LI><A NAME="tex2html171"
+<LI><A NAME="tex2html176"
HREF="#SECTION00230000000000000000">Setting up Mahogany, its configuration files</A>
<UL>
-<LI><A NAME="tex2html172"
+<LI><A NAME="tex2html177"
HREF="#SECTION00231000000000000000">Mahogany command line options</A>
-<LI><A NAME="tex2html173"
+<LI><A NAME="tex2html178"
HREF="#SECTION00232000000000000000">User configuration files (Unix only)</A>
-<LI><A NAME="tex2html174"
+<LI><A NAME="tex2html179"
HREF="#SECTION00233000000000000000">Registry (Windows only)</A>
</UL>
-<LI><A NAME="tex2html175"
+<LI><A NAME="tex2html180"
HREF="#SECTION00240000000000000000">The User Interface</A>
<UL>
-<LI><A NAME="tex2html176"
+<LI><A NAME="tex2html181"
HREF="#SECTION00241000000000000000">The Main Window</A>
-<LI><A NAME="tex2html177"
+<LI><A NAME="tex2html182"
HREF="#SECTION00242000000000000000">The Folder Tree</A>
-<LI><A NAME="tex2html178"
+<LI><A NAME="tex2html183"
HREF="#SECTION00243000000000000000">Create New Folder Dialog</A>
-<LI><A NAME="tex2html179"
+<LI><A NAME="tex2html184"
HREF="#SECTION00244000000000000000">Folder Views</A>
-<LI><A NAME="tex2html180"
+<LI><A NAME="tex2html185"
HREF="#SECTION00245000000000000000">Migrating from another mail client</A>
</UL>
-<LI><A NAME="tex2html181"
+<LI><A NAME="tex2html186"
HREF="#SECTION00250000000000000000">Reading Mail</A>
<UL>
-<LI><A NAME="tex2html182"
+<LI><A NAME="tex2html187"
HREF="#SECTION00251000000000000000">The INBOX Folder</A>
-<LI><A NAME="tex2html183"
+<LI><A NAME="tex2html188"
HREF="#SECTION00252000000000000000">The ``New Mail'' Folder</A>
-<LI><A NAME="tex2html184"
+<LI><A NAME="tex2html189"
HREF="#SECTION00253000000000000000">Other Folders</A>
-<LI><A NAME="tex2html185"
+<LI><A NAME="tex2html190"
HREF="#SECTION00254000000000000000">Accessing Mail Remotely</A>
-<LI><A NAME="tex2html186"
+<LI><A NAME="tex2html191"
HREF="#SECTION00255000000000000000">Searching for Messages</A>
-<LI><A NAME="tex2html187"
+<LI><A NAME="tex2html192"
HREF="#SECTION00256000000000000000">Filters</A>
+<LI><A NAME="tex2html193"
+ HREF="#SECTION00257000000000000000">Spam filtering</A>
</UL>
-<LI><A NAME="tex2html188"
+<LI><A NAME="tex2html194"
HREF="#SECTION00260000000000000000">Sending Mail</A>
<UL>
-<LI><A NAME="tex2html189"
+<LI><A NAME="tex2html195"
HREF="#SECTION00261000000000000000">To: CC: and BCC: Settings</A>
-<LI><A NAME="tex2html190"
+<LI><A NAME="tex2html196"
HREF="#SECTION00262000000000000000">Key Bindings in the Message Editor</A>
-<LI><A NAME="tex2html191"
+<LI><A NAME="tex2html197"
HREF="#SECTION00263000000000000000">Using the address book</A>
-<LI><A NAME="tex2html192"
+<LI><A NAME="tex2html198"
HREF="#SECTION00264000000000000000">The Mail Composition Window</A>
-<LI><A NAME="tex2html193"
+<LI><A NAME="tex2html199"
HREF="#SECTION00265000000000000000">The News Article Composition Window</A>
</UL>
-<LI><A NAME="tex2html194"
+<LI><A NAME="tex2html200"
HREF="#SECTION00270000000000000000">Understanding program options</A>
<UL>
-<LI><A NAME="tex2html195"
- HREF="#SECTION00271000000000000000">Automatically remembered options</A>
-<LI><A NAME="tex2html196"
- HREF="#SECTION00272000000000000000">Other options</A>
-<LI><A NAME="tex2html197"
- HREF="#SECTION00273000000000000000">Remote configuration synchronisation</A>
-<LI><A NAME="tex2html198"
- HREF="#SECTION00274000000000000000">Some Other Dialogs You May Encounter</A>
-<LI><A NAME="tex2html199"
- HREF="#SECTION00275000000000000000">Mahogany Plugin Modules</A>
+<LI><A NAME="tex2html201"
+ HREF="#SECTION00271000000000000000">Hierarchical options organization</A>
+<LI><A NAME="tex2html202"
+ HREF="#SECTION00272000000000000000">Automatically remembered options</A>
+<LI><A NAME="tex2html203"
+ HREF="#SECTION00273000000000000000">Other options</A>
+<LI><A NAME="tex2html204"
+ HREF="#SECTION00274000000000000000">Remote configuration synchronisation</A>
+<LI><A NAME="tex2html205"
+ HREF="#SECTION00275000000000000000">Some Other Dialogs You May Encounter</A>
+<LI><A NAME="tex2html206"
+ HREF="#SECTION00276000000000000000">Mahogany Plugin Modules</A>
</UL>
-<LI><A NAME="tex2html200"
+<LI><A NAME="tex2html207"
HREF="#SECTION00280000000000000000">The Address Database</A>
<UL>
-<LI><A NAME="tex2html201"
+<LI><A NAME="tex2html208"
HREF="#SECTION00281000000000000000">The native Address Book </A>
-<LI><A NAME="tex2html202"
+<LI><A NAME="tex2html209"
HREF="#SECTION00282000000000000000">The Address Book Editor</A>
-<LI><A NAME="tex2html203"
+<LI><A NAME="tex2html210"
HREF="#SECTION00283000000000000000">Support for BBDB Address Books</A>
-<LI><A NAME="tex2html204"
+<LI><A NAME="tex2html211"
HREF="#SECTION00284000000000000000">One Address per Line File Address Books</A>
-<LI><A NAME="tex2html205"
+<LI><A NAME="tex2html212"
HREF="#SECTION00285000000000000000">Support for Palm Address Books</A>
</UL>
</UL>
<BR>
-<LI><A NAME="tex2html206"
+<LI><A NAME="tex2html213"
HREF="#SECTION00300000000000000000">Scripting and Extending Mahogany</A>
<UL>
-<LI><A NAME="tex2html207"
+<LI><A NAME="tex2html214"
HREF="#SECTION00310000000000000000">Python Scripting</A>
<UL>
-<LI><A NAME="tex2html208"
+<LI><A NAME="tex2html215"
HREF="#SECTION00311000000000000000">Introduction</A>
-<LI><A NAME="tex2html209"
+<LI><A NAME="tex2html216"
HREF="#SECTION00312000000000000000">Initialisation </A>
-<LI><A NAME="tex2html210"
+<LI><A NAME="tex2html217"
HREF="#SECTION00313000000000000000">Using Python with Filters</A>
-<LI><A NAME="tex2html211"
+<LI><A NAME="tex2html218"
HREF="#SECTION00314000000000000000">Callback Functions (Hooks)</A>
-<LI><A NAME="tex2html212"
+<LI><A NAME="tex2html219"
HREF="#SECTION00315000000000000000">Namespaces</A>
-<LI><A NAME="tex2html213"
+<LI><A NAME="tex2html220"
HREF="#SECTION00316000000000000000">List of Callbacks</A>
-<LI><A NAME="tex2html214"
+<LI><A NAME="tex2html221"
HREF="#SECTION00317000000000000000">Supported Classes</A>
</UL>
-<LI><A NAME="tex2html215"
+<LI><A NAME="tex2html222"
HREF="#SECTION00320000000000000000">Plugins</A>
<UL>
-<LI><A NAME="tex2html216"
+<LI><A NAME="tex2html223"
HREF="#SECTION00321000000000000000">Introduction</A>
-<LI><A NAME="tex2html217"
+<LI><A NAME="tex2html224"
HREF="#SECTION00322000000000000000">The Filters Module</A>
-<LI><A NAME="tex2html218"
+<LI><A NAME="tex2html225"
HREF="#SECTION00323000000000000000">The PalmOS Module</A>
</UL>
</UL>
<BR>
-<LI><A NAME="tex2html219"
+<LI><A NAME="tex2html226"
HREF="#SECTION00400000000000000000">Getting Help and Support</A>
<UL>
-<LI><A NAME="tex2html220"
+<LI><A NAME="tex2html227"
HREF="#SECTION00410000000000000000">Troubleshooting</A>
-<LI><A NAME="tex2html221"
+<LI><A NAME="tex2html228"
HREF="#SECTION00420000000000000000">WWW Support</A>
-<LI><A NAME="tex2html222"
+<LI><A NAME="tex2html229"
HREF="#SECTION00430000000000000000">Mailing Lists</A>
</UL>
<BR>
-<LI><A NAME="tex2html223"
+<LI><A NAME="tex2html230"
HREF="#SECTION00500000000000000000">Advanced Usage</A>
<UL>
-<LI><A NAME="tex2html224"
+<LI><A NAME="tex2html231"
HREF="#SECTION00510000000000000000">Compiling <I>Mahogany</I> from source</A>
-<LI><A NAME="tex2html225"
+<LI><A NAME="tex2html232"
HREF="#SECTION00520000000000000000">Using <I>Mahogany</I> more efficiently</A>
<UL>
-<LI><A NAME="tex2html226"
+<LI><A NAME="tex2html233"
HREF="#SECTION00521000000000000000">Speeding up <I>Mahogany</I> startup</A>
-<LI><A NAME="tex2html227"
+<LI><A NAME="tex2html234"
HREF="#SECTION00522000000000000000">Limiting Amount of Data Transferred</A>
</UL>
</UL>
<BR>
-<LI><A NAME="tex2html228"
+<LI><A NAME="tex2html235"
HREF="#SECTION00600000000000000000">FAQ - Frequently Asked Questions</A>
<UL>
-<LI><A NAME="tex2html229"
+<LI><A NAME="tex2html236"
HREF="#SECTION00610000000000000000">Installation Problems</A>
<UL>
-<LI><A NAME="tex2html230"
+<LI><A NAME="tex2html237"
HREF="#SECTION00611000000000000000">All Mahogany icons show a question mark</A>
-<LI><A NAME="tex2html231"
+<LI><A NAME="tex2html238"
HREF="#SECTION00612000000000000000">How do I unpack the compressed files?</A>
-<LI><A NAME="tex2html232"
+<LI><A NAME="tex2html239"
HREF="#SECTION00613000000000000000">Compiling aborts with errors</A>
-<LI><A NAME="tex2html233"
+<LI><A NAME="tex2html240"
HREF="#SECTION00614000000000000000">Mahogany fails to find wxWindows, configure
fails</A>
-<LI><A NAME="tex2html234"
+<LI><A NAME="tex2html241"
HREF="#SECTION00615000000000000000">SSL does not work</A>
</UL>
-<LI><A NAME="tex2html235"
+<LI><A NAME="tex2html242"
HREF="#SECTION00620000000000000000">Other Problems / Questions</A>
<UL>
-<LI><A NAME="tex2html236"
+<LI><A NAME="tex2html243"
HREF="#SECTION00621000000000000000">The Preferences Dialog does not show up
properly</A>
-<LI><A NAME="tex2html237"
+<LI><A NAME="tex2html244"
HREF="#SECTION00622000000000000000">How to use Mahogany with fetchmail/procmail?</A>
-<LI><A NAME="tex2html238"
+<LI><A NAME="tex2html245"
HREF="#SECTION00623000000000000000">Does Mahogany have group aliases?</A>
-<LI><A NAME="tex2html239"
+<LI><A NAME="tex2html246"
HREF="#SECTION00624000000000000000">How can I set up POP3/IMAP access?</A>
-<LI><A NAME="tex2html240"
+<LI><A NAME="tex2html247"
HREF="#SECTION00625000000000000000">How can I set up IMAP access?</A>
-<LI><A NAME="tex2html241"
+<LI><A NAME="tex2html248"
HREF="#SECTION00626000000000000000">Can I have multiple POP3 or IMAP accounts?</A>
-<LI><A NAME="tex2html242"
+<LI><A NAME="tex2html249"
HREF="#SECTION00627000000000000000">Can I have multiple identities?</A>
-<LI><A NAME="tex2html243"
+<LI><A NAME="tex2html250"
HREF="#SECTION00628000000000000000">Can I run Mahogany as root?</A>
-<LI><A NAME="tex2html244"
+<LI><A NAME="tex2html251"
HREF="#SECTION00629000000000000000">How can I set which language to use?</A>
-<LI><A NAME="tex2html245"
+<LI><A NAME="tex2html252"
HREF="#SECTION006210000000000000000">How can I delete messages?</A>
-<LI><A NAME="tex2html246"
+<LI><A NAME="tex2html253"
HREF="#SECTION006211000000000000000">How can I forward a message with
attachments?</A>
-<LI><A NAME="tex2html247"
+<LI><A NAME="tex2html254"
HREF="#SECTION006212000000000000000">How can I customize the position of folders in
the tree?</A>
-<LI><A NAME="tex2html248"
+<LI><A NAME="tex2html255"
HREF="#SECTION006213000000000000000">How can I ``leave messages on server''
(POP3)?</A>
-<LI><A NAME="tex2html249"
+<LI><A NAME="tex2html256"
HREF="#SECTION006214000000000000000">Can I have ``subfolders'' of File type (mbox)
folders?</A>
-<LI><A NAME="tex2html250"
+<LI><A NAME="tex2html257"
HREF="#SECTION006215000000000000000">Can I ``Follow-up'' to the message?</A>
</UL></UL></UL>
@@ -350,4 +354,49 @@
<H3><A NAME="SECTION00211100000000000000">
+0.67 against 0.66</A>
+</H3>
+
+<P>
+
+<UL>
+<LI>New integrated statistical spam filter (DSPAM)
+</LI>
+<LI>Folders can now be dragged in the folder tree to reorder them
+</LI>
+<LI>New <TT>-import</TT> command line option to simplify sharing
+ of Mahogany options between different installations
+</LI>
+<LI>Options with non default values are now highlighted in the
+ preferences dialog (see <A HREF="Manual.html#optionshighlight"><IMG
ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
+</LI>
+<LI>New <TT>nop()</TT> (stop filter processing) filter action added
+</LI>
+<LI>The "Set From from To" option (<A HREF="Manual.html#IdentityPage"><IMG
ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>) is more useful
+</LI>
+<LI>When replying to PGP-encrypted messages, clear text is used for
+ replies and not the original message.
+</LI>
+</UL>
+
+<P>
+By far the main new feature in this version is the integration of DSPAM
+According to http://www.nuclearelephant.com/projects/dspam/:
+
+<P>
+<BLOCKQUOTE>
+DSPAM (as in De-Spam) is an extremely scalable, open-source statistical
+anti-spam filter. While most commercial solutions only provide a mere 95%
+accuracy (1 error in 20), a majority of DSPAM users frequently see between
+99.95% (1 error in 2000) all the way up to 99.991% (2 errors in 22,786).
+
+</BLOCKQUOTE>
+
+<P>
+Please see <A HREF="Manual.html#DSPAM"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="crossref.png"></A> section for the description of how to configure and use
+DSPAM.
+
+<P>
+
+<H3><A NAME="SECTION00211200000000000000">
0.66 against 0.65</A>
</H3>
@@ -387,5 +436,5 @@
<P>
-<H3><A NAME="SECTION00211200000000000000">
+<H3><A NAME="SECTION00211300000000000000">
0.65 against 0.64</A>
</H3>
@@ -457,5 +506,5 @@
<P>
-<H3><A NAME="SECTION00211300000000000000">
+<H3><A NAME="SECTION00211400000000000000">
0.64 against 0.63</A>
</H3>
@@ -565,5 +614,5 @@
<P>
-<H3><A NAME="SECTION00211400000000000000">
+<H3><A NAME="SECTION00211500000000000000">
0.63 against 0.62</A>
</H3>
@@ -624,5 +673,5 @@
<P>
-<H3><A NAME="SECTION00211500000000000000">
+<H3><A NAME="SECTION00211600000000000000">
0.62 against 0.61</A>
</H3>
@@ -691,5 +740,5 @@
<P>
-<H3><A NAME="SECTION00211600000000000000">
+<H3><A NAME="SECTION00211700000000000000">
0.61 against 0.60 </A>
</H3>
@@ -714,5 +763,5 @@
<P>
-<H3><A NAME="SECTION00211700000000000000">
+<H3><A NAME="SECTION00211800000000000000">
0.60 against 0.50</A>
</H3>
@@ -806,5 +855,5 @@
<P>
-<H3><A NAME="SECTION00211800000000000000">
+<H3><A NAME="SECTION00211900000000000000">
0.5 against 0.23a</A>
</H3>
@@ -864,5 +913,5 @@
<P>
-<H3><A NAME="SECTION00211900000000000000">
+<H3><A NAME="SECTION002111000000000000000">
0.23a against 0.22a</A>
</H3>
@@ -909,5 +958,5 @@
<P>
-<H3><A NAME="SECTION002111000000000000000">
+<H3><A NAME="SECTION002111100000000000000">
0.22a against 0.21a</A>
</H3>
@@ -940,5 +989,5 @@
<P>
-<H3><A NAME="SECTION002111100000000000000">
+<H3><A NAME="SECTION002111200000000000000">
0.10a to 0.21a</A>
</H3>
@@ -1087,5 +1136,5 @@
provoked major flamewars in the Unix community. There is a trend to
put everything under the GPL or LGPL<A NAME="tex2html3"
- HREF="#foot143"><SUP>1.1</SUP></A>. We do not want to get involved in this highly
emotional and political
+ HREF="#foot153"><SUP>1.1</SUP></A>. We do not want to get involved in this highly
emotional and political
discussion. Our intent is to allow everyone to use and modify Mahogany
while preserving some form of control over its development. That is
@@ -2392,4 +2441,83 @@
<P>
+<H2><A NAME="SECTION00257000000000000000"></A><A NAME="spam"></A>
+<BR>
+Spam filtering
+</H2>
+
+<P>
+Mahogany supports pluggable spam filter modules. In theory it means that
+anybody can write such modules but in practice only two of them currently exist
+and are described in details below.
+
+<P>
+However independently of the spam filters used, the interface to them remains
+always the same:
+
+<UL>
+<LI>The spam filter options can be edited in
+ <TT>"Edit|Spam filters..."</TT> dialog. Mostly you can rely on the
+ default values (but see <A HREF="Manual.html#DSPAM"><IMG ALIGN="BOTTOM"
BORDER="1" ALT="[*]" SRC="crossref.png"></A>).
+</LI>
+<LI>You can check whether the currently selected messages are deemed to
+ be spam by using <TT>"Message|Spam|Check message..."</TT> command.
+ This is mainly useful for testing, see below for how to check for spam
+ automatically.
+</LI>
+<LI>If a statistical filter mistakenly recognizes a message as spam (so
+ called false positive, this should hopefully be very rare) or misses a
+ spam message, you can correct its mistake by using the two other
+ commands of <TT>"Message|Spam"</TT> submenu. Please note that you
+ should <I>not</I> use these commands for the messages not seen by the
+ spam filter at all, i.e. they don't work for training it but only for
+ correcting its errors.
+</LI>
+</UL>
+
+<P>
+To actually use the spam filters you need to configure a filter rule (see
+<A HREF="Manual.html#Filters"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="crossref.png"></A>) using them. Usually you just create a rule named "Spam" using
+the "Seems to be spam" test and "Move to some Junk folder" (you will need to
+create this junk folder too) as its action. If you feel very confident in the
+spam filters (or just have backup of your mail somewhere) you can also
+configure the rule to delete the messages recognized as spam immediately but
+this is not recommended.
+
+<P>
+
+<H3><A NAME="SECTION00257100000000000000">
+Simple header analyzer</A>
+</H3>
+
+<P>
+This is a very simple filter which looks for some common characteristics of
+spam mail in the message headers. Its accuracy is much worse than that of DSPAM
+but it is also much faster to execute and doesn't need any training. You may
+configure its options in the <TT>"Edit|Spam filters..."</TT> dialog.
+
+<P>
+
+<H3><A NAME="SECTION00257200000000000000"></A><A NAME="DSPAM"></A>
+<BR>
+DSPAM
+</H3>
+
+<P>
+DSPAM is a statistical spam filter which means that to use it in the optimal
+way you need to <I>train</I> it first. Just open the <TT>"Edit|Spam
+filters..."</TT> dialog and use the <TT>Train</TT> button on the DSPAM page. For the
+best results you should train the filter with 2500 spam and 2500 non-spam (ham)
+messages. Be warned that this can take a rather long time and also consumes
+significant amount of disk space (of order of 50Mb) - however the results are
+well worth it.
+
+<P>
+If you don't have enough messages to train it with, you can start using it
+immediately but in this case you should be ready to manually mark messages as
+spams as explained in <A HREF="Manual.html#spam"><IMG ALIGN="BOTTOM" BORDER="1"
ALT="[*]" SRC="crossref.png"></A>. Please also remember to actually create a
+spam filter rule to really use DSPAM at all.
+
+<P>
+
<H1><A NAME="SECTION00260000000000000000">
Sending Mail</A>
@@ -2607,22 +2735,37 @@
- however we hope that it doesn't make the program more difficult
to use because you have the complete liberty to ignore all options
-until you need to use them. Moreover, some program options are completely
+until you need to use them. Moreover, many program options are completely
transparent to the user because they are automatically remembered
by the program. All the other ones may be changed from the main options
-dialog which may be invoked from the main window toolbar or from the
-menu. Generally, Mahogany configuration settings are inherited in
-a logical fashion. The settings in the preferences dialog are the
-global default settings and can be overridden on a per-folder basis.
-Subfolders inherit from their parent folders. Currently there is no
-full GUI support for this, but the next release will have the full
-set of program options available on the per-folder basis. Currently
-you can already achieve this by editing the configuration file manually.
-Also, system administrators can provide other defaults in a global
-/etc/Mahogany.conf file (also found in /usr/etc, /usr/local/etc, /opt/etc,
-...).
+dialog which may be invoked from the <TT>"Edit"</TT> menu of any window.
+
+<P>
+
+<H2><A NAME="SECTION00271000000000000000"></A><A NAME="optionshighlight"></A>
+<BR>
+Hierarchical options organization
+</H2>
<P>
+Before starting to change options, it is important to understand that Mahogany
+configuration settings are inherited in a logical fashion. The settings in the
+preferences dialog are the global default settings and can be overridden on a
+per-folder basis. The top level folders in the tree use by default the same
+global options but you may also edit each folders options via
+<TT>"Folder|Properties..."</TT> menu item. Subfolders inherit from their
+parent folders and, again, you can change their options independently.
-<H2><A NAME="SECTION00271000000000000000">
+<P>
+To make visualizing this mechanism easier, the names of the options with non
+default values are highlighted in the options dialog. Those whose values are
+set at the level of the folder currently being edited are shown in bright
+blue, while those which inherit values from the parent folder are shown in
+darker shade of blue. Of coourse, this behaviour in itself is customizable and
+the colours may be changed (or disabled completely) in the ``Miscellaneous''
+page of the options dialog (<A HREF="Manual.html#miscellaneouspage"><IMG
ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>).
+
+<P>
+
+<H2><A NAME="SECTION00272000000000000000">
Automatically remembered options</A>
</H2>
@@ -2645,5 +2788,5 @@
<P>
-<H2><A NAME="SECTION00272000000000000000">
+<H2><A NAME="SECTION00273000000000000000">
Other options</A>
</H2>
@@ -2656,5 +2799,5 @@
<P>
-<H3><A NAME="SECTION00272100000000000000">
+<H3><A NAME="SECTION00273100000000000000">
Identity page</A>
</H3>
@@ -2671,26 +2814,41 @@
<UL>
-<LI><B>Username</B>
+<LI><B>Personal name</B>
+<BR>
+Your full personal name to be included in your address. This field is free
+form. It is not mandatory but should normally be set.
+</LI>
+<LI><B>Organization</B>
+<BR>
+This field is optional and may be filled with the name of the organization you
+work in. If it is non empty, an appropriate header is automatically added to
+all outgoing messages.
+</LI>
+<LI><B>User name or login</B>
<BR>
This is used as (default) login name for the accounts which require
one (POP3 or IMAP4) and also as the base for the return address unless
-it is overridden by explicit setting of the return address.
+it is overridden by explicit setting of the email address below. This field is
+mandatory and is usually a single word.
</LI>
-<LI><B>Hostname</B>
+<LI><B>E-mail address</B>
<BR>
-This is used as the default hostname for your username. If you do
-not specify a return address, this must form a valid mail address
-when used together with your username.
+Your primary address (others can be used if needed). It is used as the default
+value of "From:" header and should be set correctly if you want to get replies
+to your mail.
</LI>
<LI><B>Reply address</B>
<BR>
-Here you can specify a return mail address where you want to receive
-mail and replies to your mails from other users. By using this you
-can hide your original (possibly ``uglier'') return address.
+Here you can specify a return mail address if it is different from the email
+address above. Usually this is not needed.
</LI>
-<LI><B>Reply return address from To: field</B>
+<LI><B>Domain</B>
+<BR>
+This is used as the default domain for local addresses.
+</LI>
+<LI><B>Set "From:" header from "To:" field</B>
<BR>
If set, Mahogany will use the original <TT>To:</TT> address field
-values for the <TT>Reply-To:</TT> header entry of any message replies
+values for the <TT>From:</TT> header entry of any message replies
that you send. This makes sure that the same person sending you mail
will always see the same mail address for you. It is especially useful,
@@ -2701,19 +2859,16 @@
On the other hand, if someone sends you mail to <TT>[EMAIL PROTECTED]</TT>,
your reply will carry that as a return address, so that person will
-never know about your <TT>mycompany.com</TT> office address.
+never know about your <TT>mycompany.com</TT> office address. Notice that for
+this option to work correctly, you should enter all addresses you usually
+receive mail from in the "Addresses" options page (<A HREF="#AddressesPage"><IMG
ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>).
</LI>
-<LI><B>Personal name</B>
+<LI><B>And add personal name if needed</B>
<BR>
-Your full personal name to be included in your address.
-</LI>
-<LI><B><A NAME="UserLevel"></A>User level</B>
-<BR>
-Setting it to advance will allow you more detailed configuration of
-Mahogany, allowing you to make changes to the configuration which
-might be confusing to a novice user. It's recommended that you first
-become familiar with the program before changing the value of this
-option.
+This option only makes sense if the above one is true and if it is set, then
+your personal name will be used if the recipient address didn't contain it.
</LI>
</UL>
+
+<P>
<A NAME="NetworkPage"></A><P>
This page allows you to configure the network-related settings. Please
@@ -2791,5 +2946,5 @@
<P>
-<H3><A NAME="SECTION00272200000000000000"></A><A NAME="NewMailPage"></A>
+<H3><A NAME="SECTION00273200000000000000"></A><A NAME="NewMailPage"></A>
<BR>
New Mail Page
@@ -2881,5 +3036,5 @@
<P>
-<H3><A NAME="SECTION00272300000000000000"></A><A NAME="ComposePage"></A>
+<H3><A NAME="SECTION00273300000000000000"></A><A NAME="ComposePage"></A>
<BR>
Compose Page
@@ -2981,5 +3136,5 @@
The dialog shown will also allow you to edit the custom headers for
outgoing messages (i.e. add arbitrary additional headers) if the user
-level (<A HREF="Manual.html#UserLevel"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="crossref.png"></A>) is set to ``Advanced''.
+level (<A HREF="#UserLevel"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]"
SRC="crossref.png"></A>) is set to ``Advanced''.
</LI>
</UL>
@@ -2987,5 +3142,5 @@
<P>
-<H3><A NAME="SECTION00272400000000000000">
+<H3><A NAME="SECTION00273400000000000000">
Folders page</A>
</H3>
@@ -3050,5 +3205,5 @@
<P>
-<H3><A NAME="SECTION00272500000000000000"></A><A NAME="PythonOptions"></A>
+<H3><A NAME="SECTION00273500000000000000"></A><A NAME="PythonOptions"></A>
<BR>
Python page
@@ -3080,5 +3235,5 @@
<P>
-<H4><A NAME="SECTION00272510000000000000">
+<H4><A NAME="SECTION00273510000000000000">
Callbacks</A>
</H4>
@@ -3106,5 +3261,5 @@
<P>
-<H3><A NAME="SECTION00272600000000000000">
+<H3><A NAME="SECTION00273600000000000000">
Message Viewer</A>
</H3>
@@ -3199,6 +3354,6 @@
<P>
-<H3><A NAME="SECTION00272700000000000000">
-Addressbook page</A>
+<H3><A NAME="SECTION00273700000000000000">
+Addresses page</A>
</H3>
@@ -3216,4 +3371,17 @@
<UL>
+<LI><B>Address to replace with "To"</B>
+<BR>
+The addresses in this listbox are considered to be your own addresses. It is
+not necessary to add the primary email address here but you can add as many of
+other addresses as needed. You can use the <TT>*</TT> wildcard in the
+addresses here to stand for any number of arbitrary characters.
+</LI>
+<LI><B>Mailing list addresses</B>
+<BR>
+If the "Reply to list" command doesn't work you should enter the mailing list
+address here. Normally this is not necessary as modern mailing list software
+usually identifies itself correctly in the message headers anyhow.
+</LI>
<LI><B>Autocollect addresses</B>
<BR>
@@ -3293,5 +3461,5 @@
<P>
-<H4><A NAME="SECTION00272710000000000000">
+<H4><A NAME="SECTION00273710000000000000">
Helpers</A>
</H4>
@@ -3350,6 +3518,7 @@
<P>
-<H3><A NAME="SECTION00272800000000000000">
-Miscellaneous</A>
+<H3><A NAME="SECTION00273800000000000000"></A><A NAME="miscellaneouspage"></A>
+<BR>
+Miscellaneous
</H3>
@@ -3421,10 +3590,23 @@
client as otherwise another copy of it would have to be opened each time when
you start writing a new message.
+
+<P>
+</LI>
+<LI><B>Show option values origin</B>
+<BR>
+This item controls highlighting of the names of the options which have non
+default values. It is on by default.
+</LI>
+<LI><B>Colour for options set here</B>
+<BR>
+Only used if the option above is on and allows to choose the colour used for
+highlighting the options set at this folder level.
</LI>
-<LI><B>Format for the date</B>
+<LI><B>Colour for inherited options</B>
<BR>
-This controls how the dates are shown in the folder view window. The
-string here has the same format as an argument to strftime(), on a
-Unix system you may execute <SMALL>MAN STRFTIME</SMALL> to see them all.
+Same as the option above but for the options which have inherited their (non
+default) value from their parent folder.
+
+<P>
</LI>
<LI><B>Show new mail notification</B>
@@ -3447,5 +3629,5 @@
<P>
-<H2><A NAME="SECTION00273000000000000000">
+<H2><A NAME="SECTION00274000000000000000">
Remote configuration synchronisation</A>
</H2>
@@ -3496,5 +3678,5 @@
<P>
-<H2><A NAME="SECTION00274000000000000000">
+<H2><A NAME="SECTION00275000000000000000">
Some Other Dialogs You May Encounter</A>
</H2>
@@ -3502,5 +3684,5 @@
<P>
-<H3><A NAME="SECTION00274100000000000000">
+<H3><A NAME="SECTION00275100000000000000">
Date Format</A>
</H3>
@@ -3518,5 +3700,5 @@
<P>
-<H4><A NAME="SECTION00274110000000000000">
+<H4><A NAME="SECTION00275110000000000000">
Display time in GMT/UST</A>
</H4>
@@ -3532,5 +3714,5 @@
<P>
-<H3><A NAME="SECTION00274200000000000000">
+<H3><A NAME="SECTION00275200000000000000">
Message Sorting Dialog</A>
</H3>
@@ -3545,5 +3727,5 @@
<P>
-<H4><A NAME="SECTION00274210000000000000">
+<H4><A NAME="SECTION00275210000000000000">
Use Threading</A>
</H4>
@@ -3556,5 +3738,5 @@
<P>
-<H4><A NAME="SECTION00274220000000000000">
+<H4><A NAME="SECTION00275220000000000000">
Re-Sort on status change</A>
</H4>
@@ -3570,5 +3752,5 @@
<P>
-<H2><A NAME="SECTION00275000000000000000">
+<H2><A NAME="SECTION00276000000000000000">
Mahogany Plugin Modules</A>
</H2>
@@ -3589,5 +3771,5 @@
<P>
-<H3><A NAME="SECTION00275100000000000000">
+<H3><A NAME="SECTION00276100000000000000">
The Plugin Module Configuration Dialog</A>
</H3>
@@ -5061,5 +5243,5 @@
<BR><HR><H4>Footnotes</H4>
<DL>
-<DT><A NAME="foot143">... LGPL</A><A NAME="foot143"
+<DT><A NAME="foot153">... LGPL</A><A NAME="foot153"
HREF="Manual.html#tex2html3"><SUP>1.1</SUP></A>
<DD>which we recently felt victim of - due to some strong demand, we have
@@ -5071,5 +5253,5 @@
<ADDRESS>
Vadim Zeitlin
-2004-01-20
+2004-07-13
</ADDRESS>
</BODY>
-------------------------------------------------------
This SF.Net email sponsored by Black Hat Briefings & Training.
Attend Black Hat Briefings & Training, Las Vegas July 24-29 -
digital self defense, top technical experts, no vendor pitches,
unmatched networking opportunities. Visit www.blackhat.com
_______________________________________________
Mahogany-cvsupdates mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/mahogany-cvsupdates
