2. Plugins
3. Actions
4. Icon Themes
- 5. Spell Checking
- 6. Quick Search
- 7. Custom toolbar
- 8. Partial downloading of POP3 mails
- 9. Hidden Options
-10. Tools
-11. How to contribute
-12. How to request features
-13. Installing Claws from CVS
-14. Release History
-15. Useful Links
+ 5. Quick Search
+ 6. Custom toolbar
+ 7. Partial downloading of POP3 mails
+ 8. Hidden Options
+ 9. Tools
+10. How to contribute
+11. How to request features
+12. Installing Claws from CVS
+13. Release History
+14. Useful Links
1. What is Claws Mail?
To load a plugin go to '/Configuration/Plugins' and click
the 'Load Plugin' button.
Select the plugin that you want and click 'OK'
+
+ o Bogofilter
+ Enables the scanning of incoming mail received from a POP,
+ IMAP, or LOCAL account using Bogofilter. It can optionally
+ delete mail identified as spam or save it to a designated folder.
+ Bogofilter is a pure Bayesian filter, therefore it has better
+ speed performance than SpamAssassin but might catch less spam.
+ Bogofilter is available from http://bogofilter.sourceforge.net/
o Dillo HTML Viewer
Enables the viewing of html messages using the Dillo web
decrypt mails, verify signatures or sign and encrypt your
own mails. Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
+ o S/MIME
+ This plugin handles S/MIME signed and/or encrypted mails. You can
+ decrypt mails, verify signatures or sign and encrypt your own mails.
+
o SpamAssassin
Enables the scanning of incoming mail received from a POP,
IMAP or LOCAL account using SpamAssassin. It can optionally
to select them, /Configuration/Preferences/Display/Themes
This interface can also be used to install new themes.
-
-
-
-5. Spell Checking
------------------
- a. Requirements
- b. Configuration and installation
- c. Usage
- d. Known problems
-
- a. Requirements
- ---------------
-
- The spell checker in Claws Mail requires the GNU/aspell library
- (http://www.gnu.org/software/aspell), version 0.50 or newer.
-
- You also need the dictionaries. Check GNU/aspell home page for how
- to download and install them.
- NB: The old dictionaries used by the old aspell will not work.
-
- b. Configuring Claws
- --------------------
-
- Spell checking is enabled automatically if the aspell executable is
- found. If it is in unusual places, use '--with-aspell-prefix' to state
- the path to the aspell executable. E.g., if aspell's full path is
- /foo/bar/bin/aspell, then use:
-
- ./configure --with-aspell-prefix=/foo/bar
-
- The '--with-aspell-prefix=PREFIX' option will let the configure
- script search for includes and libraries in PREFIX/include and PREFIX/lib.
-
- You can also manually specify the includes and libraries path by using
- either following options:
-
- --with-aspell-includes=/foo/bar/include
-
- and/or
-
- --with-aspell-libs=/rab/oof/lib
-
- as appropriate.
-
- The configure script summarizes the options compiled in. Check that
- it lists 'GNU/aspell = yes'.
- Then proceed as usual, with 'make' and 'make install'.
-
- c. Usage
- --------
-
- After successful compiling, you need to tell Claws Mail where your
- dictionaries reside. The configure script should have found it, but in
- case it did not, run 'aspell config dict-dir' on the shell to get the
- path to the dictionaries.
-
- Then run claws-mail and go to /Configuration/Preferences/Compose/Spell Checking.
- Check the box 'Enable spell checker' and use the directory selector to select
- the path where the dictionaries reside. Within the file selector, go to that
- directory and select *any* file in the file lists. Click OK. Then, you should
- be able to select your default dictionary.
-
- When composing, misspelled words are highlighted. Click on any
- highlighted word with the right mouse button to get a list of
- suggestions. The first entry of the menu just displays the unknown
- word. Selecting 'Accept in this session' (or hitting MOD1-Space,
- where MOD1 is usually the ALT key) will ignore this word and accept
- it in this message. Selecting the next entry, "Add to dictionary", which
- is bound to MOD1-Enter combination, will add the unknown word to your
- personal dictionary to learn it. The next entries are the suggested words.
- The first 15 suggestions can be accessed by typing one of the first letters
- of Latin alphabet (if this does not suit your language, please send
- a mail to melvin.hadasht@free.fr). Aspell has a 'learn from mistake'
- function that can be used by pressing the MOD1 key and selecting the
- suggestion (with the keyboard or with the mouse). See GNU/aspell manual
- ยง6.3 for an explanation of this feature (also called 'replacement storing').
-
- If you click with the right mouse button everywhere else, or if you
- shift-right-click even on a misspelled word, you get the
- configuration menu. 'Check all' highlights all misspelled words.
- With this menu, you can also change the dictionary while editing.
- Finally, you can change the suggestion mode, and the learn from
- misktakes feature.
-
- Spell checking can also be done using keyboard shortcuts. In the
- 'Edit' menu of the compose window, there are two menus 'Check backwards
- misspelled word' and 'Forward to next misspelled word'. Add to them
- appropriate keyboard shortcuts. 'Check backwards misspelled word'
- checks backwards from cursor position for the first misspelled word.
- If it finds one, it displays the suggestions lists which can be handled
- with the keyboard as described before. When the suggestion menu is
- closed, the cursor returns to its original position to be able to
- continue editing. The 'Forward to next misspelled word' do the same
- thing in the other direction but moves the cursor at the end of the
- misspelled word. This way, you can spell check easily a whole message
- starting from its beginning and using the 'Forward to next misspelled
- word' keyboard short cut.
-
-
-6. Quick Search with extended search
+5. Quick Search with extended search
------------------------------------
Quick Search, with its powerful Extended search function,
enables searching through folder's messages.
h S messages which contain header S
i S messages which contain S in Message-Id header
I S messages which contain S in inreplyto header
+ k # messages which are marked with color #
L locked messages
n S messages which are in newsgroup S
N new messages
Sg # messages whose size is greater than #
Ss # messages whose size is smaller than #
t S messages which have been sent to S
+ tg S messages with tags containing S
+ tagged messages which are tagged
T marked messages
U unread messages
x S messages which contain S in References header
+ x "cmd args" messages returning 0 when passed to command
+ - %F is message file
y S messages which contain S in X-Label header
+ & logical AND operator
+ | logical OR operator
+ ! or ~ logical NOT operator
+ % case sensitive search
+
+ all filtering expressions are allowed
+
# means number
S means regexp string
f foo & ~s bar messages from foo that do not have bar in thesubject
-7. Custom toolbar
+6. Custom toolbar
-----------------
/Configuration/Preferences/Customize Toolbars lets you define the
-8. Partial downloading of POP3 mails
+7. Partial downloading of POP3 mails
------------------------------------
Messages over the configured size limit, (/[Account preferences]/
Receive/Message size limit), will be partially retrieved. These
Trash folder has been emptied.
+8. Hidden options
+-----------------
+ It is recommnede that you use Clawsker to edit these options,
+ http://www.claws-mail.org/clawsker
-9. Hidden options
------------------
+ addressbook_use_editaddress_dialog (default: 1)
+ Use a separate dialogue to edit a person's details. '0'
+ will use a form embedded in the addressbook's main
+ window.
bold_unread (default: 1)
show unread messages using bold font in summary view
account selector
0: normal (markup) 1: no markup
+ emphasis_color (default: #0000CF)
+ The colour used for the X-Mailer line when its value is
+ Claws Mail.
+
enable_dotted_lines (default: 0)
Use the old dotted line look in the main window
GtkTreeView components, (Folder List and Message List),
log_warn_color
The colours used in the log window.
- mark_as_read_delay (default: 0)
- Number of seconds to wait before marking an opened mail
- as read.
+ outgoing_fallback_to_ascii (default: 1)
+ 0 or 1. The outgoing encoding of a message will use 7bit
+ US-ASCII whenever it is suitable for the message
+ content, ignoring the "Outgoing encoding" option unless
+ it is necessary. Turning this option off forces the
+ user-defined encoding to be used, regardless of message
+ content. Default is 1, turned on.
respect_flowed_format (default: 0)
Respect format=flowed on text/plain message parts. This will
cause some mails to have long lines, but will fix some URLs
that would otherwise be wrapped.
+ save_parts_readwrite (default: 0)
+ Saves temporary files when opening attachment with write
+ bit set.
+
skip_ssl_cert_check (default: 0)
Disables the verification of SSL certificates.
hide handles in the toolbar
0: off 1: on
+ two_line_vertical (default: 1)
+ Spread message list information over two lines when
+ using the three column layout.
+
+ unsafe_ssl_certs (default: 0)
+ Allows Claws to remember multiple SSL certificates for a
+ given server/port.
+
+ use_networkmanager (default: 1)
+ Use NetworkManager to switch offline automatically.
+
use_stripes_everywhere (default: 1)
Enable alternately coloured lines in GtkTreeView components.
display a confirmation dialog on drag n drop of folders
0: off 1: on
-10. Tools
+9. Tools
---------
You will find all of these tools in the 'tools' directory:
send PDFs from Adobe Reader 7
calypso_convert.pl
import mbox files exported by calypso
+ claws-mail-compose-insert-files.pl
+ insert files into a new Compose window
convert_mbox.pl
convert mbox format to MH format
+ csv2addressbook.pl
+ import Becky, Thunderbird, Kmail, Gmail and Fox Mail
+ address books
eud2gc.py
convert a Eudora (v.3?) addressbook to vCard
(GnomeCard) format
for newer versions of Kmail/Kaddressbook
kmail-mailbox2claws-mail.pl
convert a Kmail mailbox into a Claws mail mailbox
+ mairix.sh
+ a wrapper to mairix, to enable global searches in mail
+ folders
+ mew2claws-mail.pl
+ import a Mew address book
multiwebsearch.pl
search any searchable website for the selected text
nautilus2claws-mail.sh
outlook2claws-mail.pl
convert an Outlook contacts list to a Claws Mail
addressbook
+ popfile-link.sh
+ open messages in POPFile control center to edit their status
sylprint.pl
process a Claws Mail message and print it using enscript
if available or lpr if not
import an Evolution vCard
-11. How to contribute
+10. How to contribute
---------------------
-You are encourged to send patches via the Claws Mail sourceforge
-project's Patch Tracker.
-http://sourceforge.net/tracker/?atid=384600&group_id=25528&func=browse
+You are encourged to send patches via the Claws Mail bugzilla at
+http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
+But please first read the patch guidelines here:
+http://www.claws-mail.org/devel.php
If that's too troublesome, either contact Paul Mangan
<paul@claws-mail.org> or consider posting to the
-12. How to request features
+11. How to request features
---------------------------
Ask around in Claws Mail-users ML. Note that some developers may
-have already thought about your feature, may,perhaps, be implementing it,
-or the feature was already discussed and rejected for whatever reason.
+have already thought about your feature and may, perhaps, be implementing
+it, or the feature was already discussed and rejected for whatever reason.
You might want to go ahead and hack a patch for it. (That would be very
-cool!) Another possibility is to use the Feature Request Tracker at the
-sourceforge project.
-http://sourceforge.net/tracker/?group_id=25528&atid=384601
-
+cool!) Another possibility is to add a request to our bugzilla, (severity:
+'enhancement'), at
+http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
-13. Installing Claws Mail from CVS
+12. Installing Claws Mail from CVS
--------------------------------------
a. Downloading
To download the latest cvs cd to the directory where you wish to download
to and type the following information:
- cvs -z3 -d:pserver:cvs@sunsite.dk:/pack/anoncvs login
-
- The password is cvs
-
- After logging in:
+ export CVS_RSH=ssh
+ cvs -z3 -d:ext:cvs@scm.dotsrc.org:/srv/cvs/claws-mail co -r gtk2 claws
- cvs -z3 -d:pserver:cvs@sunsite.dk:/pack/anoncvs co -r gtk2 sylpheedclaws/sylpheed-claws
+ Later, when you want to update your local repository, you'll just have to
+ go back to the 'claws' directory, and type:
+ export CVS_RSH=ssh
+ cvs -z3 update -dPR
b. Installing
-------------
-14. Release History
+13. Release History
-------------------
GTK 2 Version
-------------
+2008-10-03 3.6.0
2008-06-27 3.5.0
2008-04-18 3.4.0
2008-02-23 3.3.1
-15. Useful links
+14. Useful links
----------------
Homepage
http://www.claws-mail.org/
Icon Themes
http://www.claws-mail.org/themes.php
CVS webview
- http://cvs.sunsite.dk/viewcvs.cgi/sylpheedclaws/sylpheed-claws/?only_with_tag=gtk2
+ http://scm.dotsrc.org/viewvc.cgi/claws-mail/claws/?pathrev=gtk2
Mailing Lists
http://www.claws-mail.org/MLs.php
Users Mailing List archive
http://lists.sunsite.dk/cgi-bin/ezmlm-cgi/28
Commits Announcement List archive
http://lists.sunsite.dk/cgi-bin/ezmlm-cgi/27
-Bug Tracker
+Bug/Patch/Feature Request Tracker
http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
-Feature Request Tracker
- http://sourceforge.net/tracker/?group_id=25528&atid=384601
-Patch Tracker
- http://sourceforge.net/tracker/?group_id=25528&atid=384600
Internationalisation Status
http://www.claws-mail.org/i18n.php
Donations
Notes for this release:
~~~~~~~~~~~~~~~~~~~~~~~
-* IMAP with STARTTLS
- The certificate port on TLS was fixed, however this will trigger
- one wrong 'New certificate' warning on the first connection.
+* Claws Mail now requires libetpan 0.56 for IMAP and NNTP
+
+* Spell checking is now provided by Enchant instead of Aspell. To
+ build spell checker support, you will need the libenchant headers.
+
+* The S/MIME plugin is now part of this package.
+
+* IMAP, NNTP, and SSL are now supported in the Windows port.
New in this release:
~~~~~~~~~~~~~~~~~~~~
-* Added an option, "Use secure file deletion if possible", which
- enables shredding of temporary files and messages instead of
- just removing them. This is available on the Other preferences
- page.
+* Support for client SSL certificates.
-* Added an option, "Select the HTML part of multipart/alternative
- messages". This is available on the Message View/Text Options
- preferences page.
+* Better support of SSL certificate stores, to be able to verify
+ server certificates.
-* Added an option to the 'Create new folder' dialogue which enables
- new folders to inherit the properties of their parent folders
- during folder creation.
+* Renaming of newsgroups is possible.
-* Added a hidden option, "two_line_vertical", which toggles the
- 2-line view in the message list when using the 3-column layout.
- Defaults to '1', show 2 lines.
+* "Always open message when selected" can now have three values:
+ 'Never', 'Always' and 'When message view is visible'.
-* Added a hidden option, "outgoing_fallback_to_ascii", which allows
- the user to specify an outgoing charset/encoding, but still fall
- back to 7bit US-ASCII when possible.
- Defaults to '1', fallback when possible.
+* Unsaved server passwords can now be temporarily saved for the
+ duration of the session. They can be cleared before the session
+ expires by using '/Tools/Forget all session passwords'.
-* Added support for the Avant Window Navgator (Awn) information
- bubble. This is automatically enabled if dbus is available.
+* Auto-wrapping settings are now saved in drafted messages.
-* Face and X-Face headers can now be added globally and per-account
- from configuration files under ~/.claws-mail/autofaces/. Further
- information is provided in the manual.
+* Support for basic auto-indentation in the Compose window.
-* The SHA1 fingerprint is now shown on the SSL certificate dialogue
- and the labels are now selectable.
+* Support for animated GIFs in the message view.
-* Several GUI improvements have been made, (Address book, filtering
- dialogue, Actions dialogue, and Account preferences).
+* Type-ahead search in Filtering, Templates, Actions dialogs now
+ select the result of the search.
-* New icons have been added for 'Reply to list' and 'Cancel'. The
- 'Insert file' and 'Close' icons have been improved, as have the
- tray icons.
+* Finer granularity in POP3 accounts' Remove After delay - hours in
+ addition to days.
-* Added the Trash and Delete icons to the Custom Toolbars options.
+* Spam/Ham flag is now stored on IMAP server when possible, using
+ "Junk" and "NonJunk" keywords.
-* SMTP-only accounts are now not shown in the Receive menus and
- Account lists in filtering/processing, as they are irrelevant here.
+* Use less precise intervals when possible for auto-checking, thus
+ the CPU is woken up less frequently.
-* tools/csv2addressbook.pl
- Support for a gmail exported csv address book was added.
+* The warning icon in the main window is cleared when the error it
+ relates to is clipped from the network log.
-* Updated English, French, and Spanish manuals.
+* IMAP errors now reveal the server on which they happen.
-* Updated translations: Brazilian Portuguese, Finnish, French,
- German, and Spanish.
+* All deprecated GTK interfaces have been replaced with their
+ non-deprecated equivalents.
-* Removed unmaintained translations: Bulgarian, Croatian, Czech,
- Dutch, Greek, Hebrew, Japanese, Korean, Norwegian, Russian,
- Swedish, and Taiwanese. (New maintainers are very welcome,
- contact paul@claws-mail.org)
+* csv2addressbook.pl: Added support for FoxMail.
-* Bug fixes:
- o bug 1447, 'If user tries to close while starting up, it
- will not close ever.'
- o bug 1566, 'too short I/O timeout on OpenBSD'
- o bug 1576, 'Curly brace literals reported as error in
- message template'
- o bug 1581, 'Bad File Format during Import LDIF'
- o bug 1586, '3-pane vertical layout now and then still shows
- sender column'
- o bug 1587, 'can not replay with quote'
- o bug 1589, 'tagsdb file not removed when folder deleted'
- o bug 1597, 'In news folders, "Move Message to Wastebin" icon
- isn't grayed although ineffective'
- o bug 1598, 'Leading slash while translating "Unsubscribe"'
- o bug 1599, 'attach multiple files with the same name from
- one mail to another'
- o bug 1602, 'Crash when sending return receipt for messages
- with no subject'
- o bug 1604, 'found_in_addressbook "From" in "Any" in non
- english local'
- o bug 1608, 'Inconsistent behaviour of mark as read options'
- o bug 1610, 'claws crash after opening/closing preferences
- and window update'
- o bug 1613, 'Various memory leaks'
- o bug 1615, 'hang on FIFO when the other end's not opened'
- o bug 1616, 'strange question while emptying trash'
- o bug 1623, 'exits with segfault when logging in to certain
- imap-servers'
- o bug 1624, '[PATCH] Quick search should be disabled for
- folder view'
- o bug 1628, 'Claws Mail crashes when filtering selected
- messages'
- o bug 1635, 'Last character of message is truncated when
- changing accounts w/ sigs'
- o bug 1636, 'Can't select "properties" on "folders only"
- folders'
- o bug 1650, 'Message line too small after changing columns in
- "three columns" layout'
- o Use g_(un)setenv instead of (un)setenv which doesn't exist
- on IRIX 6.5.
- o Fix 'Delete line' and 'Delete to end of line' on the last
- line.
- o Fix double free when STARTTLS fails
- o Fix ldap deprecated calls
- o Fix debian bug 481856, 'Segmentation fault when verifying a
- GPG signature'
- o Fix cursor placing on signature change
- o tools/thunderbird-filters-convertor.pl
- Fix reading a tb rule that contains something like that:
- \"Sender\"
+* Updated translations: British English, Bulgarian, Catalan, Dutch,
+ Finnish, French, German, Hungarian, Italian, Polish, Russian,
+ Simplified Chinese, Spanish, and Swedish.
+* Bug fixes:
+ o bug 1620, 'Can't use hardware zoom buttons' (MAEMO)
+ o bug 1398, 'Change current account available even when
+ there's only one account'
+ o bug 1609, 'Icon issues'
+ o bug 1673, 'Tools/Harvest Addresses is greyed out if
+ folder is empty'
+ o bug 1681, 'GnuPG plugin doesn't compile on Solaris"
+ o bug 1684, 'View news messages with large attachments
+ segfaults'
+ o bug 1688, 'Compilation problems on MingW32'
+ o bug 1690, 'Copy/paste in edit window may break Undo'
+ o bug 1696, 'Viewing binary attachments as text over
+ 1MB' (various buglets)
+ o bug 1699, 'Separator line misplaced when printing
+ emails with long header lines'
+ o bug 1412, 'Sign reply if mail was signed'
+ o bug 1707, 'Segfault when sorting on hidden column'
+ o bug 1710, 'User misreads Discard Message as Discard
+ Changes'. Closing a modified re-edited draft will
+ now ask whether to discard changes
+ o bug 1712, 'Invalid Phishing attempt warning when linked
+ text ends with spaces'
+ o bug 1723, 'Buffer overflow crash caused by
+ preview in 'Date format help' dialog box'
+ o bug 1725, 'useless lines in clawsrc'
+ o Fixed compilation with GTK 2.14
+ o Fixed some memory leaks
+ o Fixed upgrading of themes
+ o Fixed po-headers appearing on empty templates
+ o Fixed folderview's scrollbar state when starting minimized,
+ and popping up is done via command line
+ o Fixed race condition when closing the Plugins window while a
+ plugin is loading
+ o Fixed missing localityName (l) field in LDAP
+ o Fixed wild rewrapping when adding text to start of some long
+ lines
+ o Added "Fwd" to the list of known subject prefixes
+ o Fixed nickname edition in non-LDAP address books
+ o Fixed compose window size saving, which changed when using
+ compose-related filtering actions
+ o Fixed English usage
+ o Don't go to Inbox after manual mail retrieval if there are no
+ new mails
+ o Fixed migration problems from Aspell to Enchant dictionaries
+ o Fixed double opening of file, leading to multiple signatures
+ when using signify
+ o Fixed image viewer (wrong image displayed, break of resizing
+ functionality
+ o Fixed handling of HTML parts in multipart/related parts
+ o Workaround to decode correctly mails in Windows-1252 codeset
+ advertised as ISO-8859-1
+ o Added the nb_NO locale's default charset (ISO-8859-1)
+ o IMAP: Fixed crash when error happen on session establishment
+ o Fixed a lot of Windows-only bugs (bugs 1041, 1042, 1051,
+ problems with folders that have non-ASCII characters, the
+ huge memory leak, crash on connection failures)
For further details of the numbered bugs listed above consult
http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi