test push
[claws.git] / README
1 Just testing.
2 Claws Mail - a GTK+ based, lightweight, and fast e-mail client
3
4 ---------------------------------------------------------------------
5
6    Copyright (C) 1999-2015 Hiroyuki Yamamoto <hiro-y@kcn.ne.jp> and the
7    Claws Mail Team
8
9    This program is free software: you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation, either version 3 of the License, or
12    (at your option) any later version.
13
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18
19    You should have received a copy of the GNU General Public License
20    along with this program.  If not, see <http://www.gnu.org/licenses/>.
21
22    For more details see the file COPYING.
23
24 ---------------------------------------------------------------------
25
26 Summary:
27
28  1. What is Claws Mail?
29  2. Plugins
30  3. Actions
31  4. Icon Themes
32  5. Quick Search
33  6. Custom toolbar
34  7. Partial downloading of POP3 mails
35  8. Hidden Options
36  9. Tools
37 10. How to contribute
38 11. How to request features
39 12. Installing Claws from Git
40 13. Release History
41 14. Useful Links
42
43
44 1. What is Claws Mail?
45 --------------------------
46
47 Claws Mail (previously known as Sylpheed-Claws) is a lightweight and
48 highly configurable email client and news reader based on the GTK+
49 GUI toolkit, it runs on the X Window System.
50
51 Claws Mail is free software distributed under the GNU GPL.
52
53 To run Claws Mail use 'claws-mail' on the command line.
54
55 When claws-mail is executed for the first time a configuration
56 'Wizard' will appear prompting you for the minimum information
57 necessary to create a new account.
58
59
60 2. Plugins
61 ----------
62
63 Claws Mail' capabilities are extended by plugins. It comes with
64 the following plugins included, all of which are built automatically
65 if the required libraries are present.
66
67 Plugins are installed in $PREFIX/lib/claws-mail/plugins/
68 and have a suffix of '.so'
69 To load a plugin go to '/Configuration/Plugins' and click
70 the 'Load Plugin' button.
71 Select the plugin that you want and click 'OK'
72
73 All plugin preferences can be found under
74 '/Configuration/Preferences/Plugins/'.
75
76   o ACPI Notifier
77     Notifies of new mail via the mail LED available on some laptops. The 
78     LED can be set to blinking or on states when new mail is received. 
79     Appropriate kernel modules have to be loaded first for this plugin to 
80     work. Laptops supported are from ACER (acerhk and acer_acpi modules), 
81     ASUS (asus_laptop and asus_acpi), IBM (ibm_acpi), Lenovo (tm_smapi) 
82     and Fujitsu (apanel) manufacturers.
83
84   o Address Keeper
85     Saves mail addresses typed in the 'To', 'Cc' or 'Bcc' fields of 
86     outgoing messages to a designated folder in the address book. 
87     Addresses are saved only if not already present in the address book.
88
89   o Archiver
90     Archives mail folders using libarchive library. Folders can be archived 
91     with or without compression (ZIP, GZIP or BZIP2) and also in several 
92     formats (TAR, SHAR, PAX or CPIO).
93     Libarchive is available from http://www.libarchive.org/.
94
95   o Attachment Remover
96     Selectively removes attachments from messages. Messages are permanently 
97     modified by using this feature, so be careful!
98
99   o Attachment Warning
100     Warns the user of possibly forgotten attachments when some keywords 
101     are found in the outgoing messages. False positives (being warned when 
102     no attachment is realy needed) exist, but some configuration options 
103     can help to reduce their probability.
104
105   o Bogofilter
106     Enables the scanning of incoming mail received from a POP,
107     IMAP, or LOCAL account using Bogofilter. It can optionally
108     delete mail identified as spam or save it to a designated folder.
109     Bogofilter is a pure Bayesian filter, therefore it has better
110     speed performance than SpamAssassin but might catch less spam.
111     Bogofilter is available from http://bogofilter.sourceforge.net/.
112  
113   o BSFilter
114     Checks all messages received from IMAP, POP or local accounts using 
115     BSFilter, a bayesian spam filter program, which has to be installed 
116     locally. Messages identified as spam can be deleted or saved to a 
117     designated folder. 
118     Bsfilter is available from http://sourceforge.jp/projects/bsfilter/.
119
120   o Clamd
121     Uses the Clam AntiVirus in daemon mode to scan received messages from 
122     IMAP, POP or local accounts. Scanning is done through a socket to the 
123     daemon, so it has to be previously configured to allow this. 
124     Clam AntiVirus is available from http://www.clamav.net/.
125
126   o Fetchinfo
127     Modifies downloaded messages and inserts special headers containing 
128     some download information: UIDL, Claws Mail account name, POP server, 
129     user ID and retrieval time. These headers can be used later for more 
130     elaborate filtering or processing rules.
131
132   o Fancy
133     Renders HTML mails and HTML parts of multipart messages using the GTK+ 
134     port of the WebKit library. External content is blocked by default 
135     (including images) to avoid remote tracking, but can be enabled either 
136     globally or just on the displayed message.
137     GTK+ WebKit is available from http://trac.webkit.org/wiki/WebKitGTK/.
138
139   o GData
140     Includes your Gmail account contacts in the list generated for 
141     Tab-address completion on compose window, using the GData library.
142     Gdata library is available from https://live.gnome.org/libgdata/.
143
144   o Libravatar
145     Displays sender avatars from https://www.libravatar.org/, from own
146     sender's domain if enabled or even an automatically generated one.
147
148   o MailMbox
149     Handles mailboxes in Mbox format using the libEtPan! library. Mbox 
150     files can be added to the folder tree and used like regular mailboxes.
151     LibEtPan! is available from http://www.etpan.org/.
152
153   o Managesieve
154     Manage sieve filters on a server using the ManageSieve protocol.
155
156   o Newmail
157     Writes a header summary to a log file for each mail received after 
158     sorting. The file for the summary is ~/Mail/NewLog.
159
160   o Notification
161     Provides various ways of notifying the user of new and unread email. 
162     Current methods include: a banner, a popup window, a user command, 
163     a message to a LCD daemon, a system tray icon and an indicator icon.
164     Sound notifications are also possible through libcanberra. Each method 
165     can be customized in detail through the plugin preferences.
166     Indicator library is available from https://launchpad.net/libindicator/
167     and libcanberra from http://0pointer.de/lennart/projects/libcanberra/.
168
169   o Perl
170     Extends the filtering possibilities of Claws Mail. Provides a Perl 5 
171     interface to Claws Mail's filtering mechanism, allowing the use of full 
172     Perl power in email filters. A conversion script is provided to 
173     translate user rules into perl rules suitable for this plugin. 
174     Perl is available from http://www.perl.org/.
175
176   o PDF Viewer
177     Displays Portable Document Format (PDF) and PostScript attachments 
178     within the message view using Poppler. PostScript attachments are 
179     converted to PDF on the fly by the 'gs' tool, which has to be installed 
180     first. The 'gs' tool is available from http://pages.cs.wisc.edu/~ghost/.
181     The Poppler library is available from http://poppler.freedesktop.org/.
182         
183   o PGP/Core
184     Handles core PGP functions and is required by the PGP/Inline
185     and PGP/MIME plugins.
186     Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/.
187
188   o PGP/inline
189     Handles inline PGP signed and/or encrypted mails. You can
190     decrypt mails, verify signatures or sign and encrypt your
191     own mails. Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/.
192
193   o PGP/MIME
194     Handles PGP/MIME signed and/or encrypted mails. You can
195     decrypt mails, verify signatures or sign and encrypt your
196     own mails. Uses GnuPG/GPGME, ftp://ftp.gnupg.org/gcrypt/gpgme/.
197
198   o Python
199     Provides Python scripting access to Claws Mail functions. A testing 
200     console is also featured. Scripts can be saved to specific folders 
201     for automatic loading on startup or being available as new menu items 
202     under the '/Tools/Python scripts' menu. 
203     Python is available from http://python.org/.
204
205   o RSSyl
206     Creates mailboxes where newsfeeds in RSS 1.0, RSS 2.0 or Atom format 
207     can be added. Each newsfeed will create a folder with the appropriate 
208     entries, fetched from the web. You can read them, and delete or keep 
209     old entries.
210
211   o S/MIME
212     Handles S/MIME signed and/or encrypted mails. You can decrypt mails, 
213     verify signatures or sign and encrypt your own mails.
214
215   o SpamAssassin
216     Scans incoming mail received from a POP, IMAP or LOCAL account using 
217     SpamAssassin. It can optionally delete mail identified as spam or save 
218     it to a designated folder. 
219     SpamAssassin is available from http://spamassassin.apache.org/.
220
221   o Spam Report
222     Reports spam messages to online spam harvesting sites. Sites suported 
223     are http://www.signal-spam.fr/ and http://www.spamcop.net/. The Debian 
224     mailing list spam nomination system is also supported.
225
226   o TNEF Parser
227     Decodes attachments with 'application/ms-tnef' MIME type (also known 
228     as "winmail.dat" files) in Claws Mail, using the ytnef library. 
229     Decoded parts can be saved to files.
230     The ytnef library is available from http://ytnef.sourceforge.net/.
231
232   o VCalendar
233     Displays vCalendar messages. Only the meeting subset of the vCalendar 
234     format is currently supported, which includes planning, sendding and 
235     receiving invitations and answering them. Public calendar (WebCal) 
236     subscriptions, free/busy information export/import and reminding of 
237     events is also supported.
238     
239
240 Additonal plugins can be found here:
241 http://www.claws-mail.org/plugins.php
242
243
244 3. Actions
245 ----------
246   The "actions" feature is a convenient way for the user to launch external 
247   commands to process a complete message file including headers and body or 
248   just one of its parts. It allows also the use of an external command to 
249   filter the whole text or just a selected part in the message window or in 
250   the compose window. This is a generic tool that allows to do any uncommon 
251   actions on the messages, and thus extends the possibilities of Claws Mail. 
252   For example, Claws Mail does not include the rot13 cyphering algorithm 
253   popular in some newsgroups. It does not support uuencoded messages. As 
254   all these features can be handled by external programs, the actions 
255   provide a convenient way to use them from the menu bar.
256
257   a. Usage
258   --------
259
260   To create a new action, go to Configuration -> Actions.... The "Action
261   Creation" dialog offers to enter the Menu name that will trigger the 
262   command. The created menu will be found in the Tools -> Actions submenu. 
263   By inserting a slash / in the menu name, you create a submenu.
264
265   The command is entered in the Command line entry. Note that Claws Mail
266   stores every single email in a separate file. This allows to use the 
267   following syntax for the command:
268
269     * %f denotes the file name of the selected message. If you selected more
270          than one, then the command will be launched for each message with 
271          the appropriate file name
272     * %F denotes the list of the file names of the selected message. If only
273          one message is selected, this amounts to %f, but if more messages 
274          are selected, then the command will be launched only once with the 
275          list of the file names. (You can use both %f and %F in one command: 
276          then the command will be launched for each selected message with 
277          the name of this message and with the list of all selected 
278          messages. I did not find a practical example for this.)
279     * %p denotes the current selected message part of a multipart message. 
280          The part is decoded accordingly. If the message is not a multipart 
281          message, it denotes the message body.
282     * Prepending >: this will allow you to send to the command's standard 
283          input a text that you will enter in a dialog window.
284     * Prepending *: this will allow you to send to the command's standard 
285          input a text that you will enter in a dialog window. But in 
286          contrast to prepending >, the entered text is hidden (useful when 
287          entering passwords).
288     * Appending an ampersand &: this will run the command asynchronously. 
289          That means "fire and forget". Claws Mail won't wait for the
290          command to finish, nor will it catch its output or its error
291          messages.
292     * Prepending the vertical bar | (pipe-in): this will send the current 
293          displayed text or the current selected text from the message view 
294          or the compose window to the command standard input. The command 
295          will silently fail if more than one message is selected.
296     * Appending the vertical bar | (pipe-out): this will replace the current 
297          displayed text or the current selected text from the message window
298          or the compose window by the command standard output. The command
299          will silently fail if more than one message is selected.
300
301   Note: It is not possible to use actions containing %f, %F or %p from the
302   compose window. 
303
304   When a command is run, and unless it is run asynchronously, Claws Mail
305   will be insensitive to any interaction and it will wait for the command to 
306   finish. If the command takes too long (5 seconds), it will popup a dialog 
307   window allowing to stop it. This dialog will also be displayed as soon as
308   the command has some output: error messages or even its standard output 
309   when the command is not a "pipe-out" command. When multiple commands are 
310   being run, they are run in parallel and each command output is separated 
311   from the outputs of the others.
312
313   a. Examples
314   -----------
315
316   Here are some examples that are listed in the same syntax as used for 
317   storing the actions list. You can copy and past the definition in your 
318   ~/.claws-mail/actionsrc file (exit Claws Mail before). The syntax
319   is very simple: one line per action, each action contains the menu name
320   and the command line separated by a colon and a space ": "
321
322   Purpose:      rot13 cyphering
323   Definition:   Rot13: |tr a-zA-Z n-za-mN-ZA-M|
324   Details:      This will apply the rot13 cyphering algorithm to the 
325                 (selected) text in the message/compose view.
326
327   Purpose:      Decoding uuencoded messages
328   Definition:   UUdeview: xdeview %F&
329   Details:      xdeview comes with uudeview. If an encoded file is split in 
330                 multiple messages, just select them all and run the command.
331
332   Purpose:      Display uuencoded image
333   Definition:   Display uuencoded: uudec %f&
334   Details:      Displays uuencoded files. The uudec[1] script can be found in 
335                 the 'tools' directory of the distribution package.
336  
337   Purpose:      Alter messages
338   Definition:   Edit message: gvim -f %F
339   Details:      Allows editing of any received message. Can be used to remove 
340                 unneeded message parts, etc.
341
342   Purpose:      Pretty format
343   Definition:   Par: |par 72Tbgjqw74bEe B=._A_a 72bg|
344   Details:      par is a utility that can pretty format any text. It does a 
345                 very good job in indenting quoted messages, and justifying 
346                 text. Used when composing a message
347
348   Purpose:      Browse
349   Definition:   Part/Dillo: dillo %p&
350   Details:      Browse the selected message part in Dillo.
351
352
353   [1] The uudec script can be found in the 'tools' directory of the 
354   distribution package. It needs uudecode and ImageMagick's display. The 
355   latter can be replaced by any image viewer that can get input from 
356   standard input. The script could also be modified to use temporary files 
357   instead of standard input. 
358
359
360 4. Icon Themes
361 --------------
362   Claws has support for different icon sets. Several icon sets can be
363   downloaded from http://www.claws-mail.org/themes.php
364   You will need to create a directory called 'themes' in your config
365   directory, unpack them into this directory, and then use the interface
366   to select them, /Configuration/Preferences/Display/Themes
367
368   This interface can also be used to install new themes.
369   
370
371 5. Quick Search with extended search
372 ------------------------------------
373     Quick Search, with its powerful Extended search function,
374     enables searching through folder's messages.
375
376     Extended Search allows one to define criteria that messages must
377     have in order to match and be displayed in the summary view pane.
378     Search types titled From, Subject and To are self explanatory.
379     Search type extended allows one to use Claws Mail's powerful
380     filtering engine to select messages. Examples:
381     from regexpcase "foo"
382     subject regexp "Bug" & to regexp "claws-mail"
383
384     Additionally, it is possible to use simpler yet equally
385     powerfull patterns for message selections. Mutt users will
386     immediately recognise most of the available patterns:
387
388     Pattern  Parameter  Selects
389     ----------------------------------------------------
390     a                   all messages
391     ag       #          messages whose age is greater than #
392     al       #          messages whose age is lower than #
393     b        S          messages which contain S in the message body
394     B        S          messages which contain S in the whole message
395     c        S          messages carbon-copied to S
396     C        S          message is either to: or cc: to S
397     D                   deleted messages
398     e        S          messages which contain S in the Sender field
399     E        S          true if execute "S" succeeds
400     f        S          messages originating from user S
401     F                   forwarded messages
402     h        S          messages which contain S in any header name or value
403     H        S          messages which contain S in the value of any header
404     i        S          messages which contain S in Message-Id header
405     I        S          messages which contain S in inreplyto header
406     k        #          messages which are marked with color #
407     L                   locked messages
408     n        S          messages which are in newsgroup S
409     N                   new messages
410     O                   old messages
411     r                   messages which have been replied to
412     R                   read messages
413     s        S          messages which contain S in subject
414     se       #          messages whose score is equal to #
415     sg       #          messages whose score is greater than #
416     sl       #          messages whose score is lower than #
417     Se       #          messages whose size is equal to #
418     Sg       #          messages whose size is greater than #
419     Ss       #          messages whose size is smaller than #
420     t        S          messages which have been sent to S
421     tg       S          messages with tags containing S
422     tagged              messages which are tagged
423     T                   marked messages
424     U                   unread messages
425     x        S          messages which contain S in References header
426     x        "cmd args" messages returning 0 when passed to command
427                         - %F is message file
428     y        S          messages which contain S in X-Label header
429
430     &        logical AND operator
431     |        logical OR operator
432     ! or ~   logical NOT operator
433     %        case sensitive search
434
435     all filtering expressions are allowed
436
437     # means number
438     S means regexp string
439
440     It is possible to use logical operators AND (&), OR (|) and
441     NOT (! or ~). Case sensitive search is achieved with %.
442     Examples:
443     T                  marked messages
444     U                  unread messages
445     f "john beavis"    messages from john beavis
446     %f "John Beavis"   messages from John Beavis (case sensitive)
447     ~s foo             messages which do not have foo in the subject
448     f foo & ~s bar     messages from foo that do not have bar in thesubject
449
450
451 6. Custom toolbar
452 -----------------
453
454    /Configuration/Preferences/Customize Toolbars lets you define the
455    toolbar you want. The configuration dialog enables you to set an icon,
456    an appropriate text, and map an action to it. Actions to choose
457    from are predefined. You can also have your "Claws Mail Actions"
458    (refer to "Actions" above) on your toolbar.
459
460    Example: 
461         * Configuration->Actions 
462                 - add an entry "Dillo: dillo %p&"
463         * Configuration->Custom toolbar    
464                 - select Claws Mail Actions Feature
465                 - select "Dillo: dillo %p&" from drop down list
466                 - choose an icon and click ok
467
468
469     
470 7. Partial downloading of POP3 mails
471 ------------------------------------
472   Messages over the configured size limit, (/[Account preferences]/
473   Receive/Message size limit), will be partially retrieved. These
474   messages will have a Notice View displayed (above the Message View),
475   informing of the partially retrieved state and the total size of the
476   message. The Notice View will also contain two buttons, 'Mark for
477   download' and 'Mark for deletion'. If the user clicks 'Mark for
478   download', the message will be downloaded in full at the next message
479   retrieval, (and the partial one deleted); if the user checks 'Mark for
480   deletion' it will be removed from the server after the normal delay
481   as specified in the POP3 account's 'Receive' preferences.
482   If a user moves a partially retrieved message to the Trash folder 
483   it will be deleted on the server at the next retrieval after the 
484   Trash folder has been emptied.
485
486
487 8. Hidden options
488 -----------------
489
490     It is recommended that you use Clawsker to edit these options,
491     http://www.claws-mail.org/clawsker.php
492
493     addressbook_use_editaddress_dialog  (default: 1)
494         Use a separate dialogue to edit a person's details. '0'
495         will use a form embedded in the addressbook's main window.
496         0: off  1: on
497
498     bold_unread                 (default: 1)
499         show unread messages using bold font in summary view
500         0: off  1: on
501
502     cache_max_mem_usage         (default: 4096)
503         the maximum kB of memory Claws Mail should use. It will try
504         to keep the memory usage below this value, but it will always
505         use the assigned amount of memory for speed gain.
506
507     cache_min_keep_time         (default: 15)
508         the minimum time in minutes Claws Mail will keep the folder
509         cache in memory. If a cache is more recent than this time it
510         will not be freed even if the memory usage is above the
511         maximum. You should probably set this value higher than your
512         mail check interval. Otherwise the cache will always be freed
513         between checks even if the folder is accessed on every check,
514         which will cause much disk IO.
515
516     compose_no_markup           (default: 0)
517         prevent italic and bold text in the Compose dialog account
518         selector
519         0: normal (markup) 1: no markup
520
521     diff_added_color            (default: #008b8b)
522     diff_deleted_color          (default: #6a5acd)
523     diff_hunk_color             (default: #a52a2a)
524         Colors to use when displaying attachments in unified diff 
525         format.
526
527     emphasis_color              (default: #0000CF)
528         The colour used for the X-Mailer line when its value is
529         Claws Mail.
530
531     enable_hscrollbar           (default: 1)
532         enable horizontal scroll bar in summary view
533         0: off  1: on
534
535     enable_swap_from            (default: 0)
536         display sender's email address in To column in Sent folder
537         instead of recipient's
538         0: off  1: on
539
540     folderview_vscrollbar_policy         (default: 0)
541         specify the policy of vertical scroll bar of folder view
542         0: always  1: automatic  2: never
543
544     hover_timeout                       (default: 500)
545         time in milliseconds that will cause a folder tree to expand
546         during drag n drop when the mouse cover is held over it
547
548     live_dangerously                    (default: 0)
549         Don't ask for confirmation before definitive deletion of
550         emails.
551         0: off  1: on
552
553     log_error_color                     (default: #af0000)
554     log_in_color                        (default: #000000)
555     log_msg_color                       (default: #00af00)
556     log_out_color                       (default: #0000ef)
557     log_warn_color                      (default: #af0000)
558     log_status_ok_color                 (default: #00af00)
559     log_status_nok_color                (default: #0000af)
560     log_status_skip_color               (default: #aa00aa)
561         The colours used in the Network Log window.
562
563     msgview_date_format                 (default: 0)
564         Use the same user-defined date format in the Message View as
565         is used in the Message List.
566         0: off  1: on
567
568     outgoing_fallback_to_ascii          (default: 1)
569         The outgoing encoding of a message will use 7bit US-ASCII
570         whenever it is suitable for the message content, ignoring
571         the "Outgoing encoding" option unless it is necessary.
572         Turning this option off forces the user-defined encoding to
573         be used, regardless of message content.
574         0: off  1: on
575
576     primary_paste_unselects             (default: 0)
577         Causes the primary buffer to be cleared and the insertion
578         point to be repositioned when the middle mouse button is used
579         for pasting text.
580         0: off  1: on   
581
582     respect_flowed_format               (default: 0)
583         Respect format=flowed on text/plain message parts. This will
584         cause some mails to have long lines, but will fix some URLs
585         that would otherwise be wrapped.
586         0: off  1: on
587  
588     save_parts_readwrite                (default: 0)
589         Saves temporary files when opening attachment with write bit
590         set.
591         0: off  1: on
592
593     show_compose_margin                 (default: 0)
594         Adds margins to the message text area in the Compose window.
595         0: off  1: on
596
597     show_inline_attachments             (default: 1)
598         Show inline attachments in MimeView.
599         0: off  1: on
600
601     skip_ssl_cert_check                 (default: 0)
602         Disables the verification of SSL certificates.
603         0: off  1: on
604
605     statusbar_update_step               (default: 10)
606         Update stepping in progress bars.
607
608     stripes_color_offset                (default: 4000)
609         Specify the value to use when creating alternately coloured
610         lines in GtkTreeView components. The smaller the value, the
611         less visible the difference in the alternating colours of the
612         lines. 
613
614     textview_cursor_visible             (default: 0)
615         display the cursor in the message view.
616         0: off  1: on
617
618     thread_by_subject_max_age           (default: 10)
619         number of days to include a message in a thread when using
620         'Thread using subject in addition to standard headers'.
621
622     toolbar_detachable                  (default: 0)
623         hide handles in the toolbar.
624         0: off  1: on
625
626     two_line_vertical                   (default: 1)
627         Spread message list information over two lines when using the
628         three column layout.
629         0: off  1: on
630
631     unsafe_ssl_certs                    (default: 0)
632         Allows Claws to remember multiple SSL certificates for a
633         given server/port.
634         0: off  1: on
635
636     use_networkmanager                  (default: 1)
637         Use NetworkManager to switch offline automatically.
638         0: off  1: on
639
640     use_stripes_everywhere              (default: 1)
641         Enable alternately coloured lines in GtkTreeView components.
642         0: off  1: on
643
644     use_stripes_in_summaries            (default: 1)
645         Enable alternately coloured lines in the main window
646         GtkTreeView components, (Folder List and Message List). The
647         only useful way to use this option is to set it to 0 when
648         use_stripes_everywhere is set to 1.
649         0: off  1: on
650
651     utf8_instead_of_locale_for_broken_mail      (default: 0)
652         Use UTF-8 encoding for broken mails instead of current
653         locale.
654         0: off  1: on
655
656     warn_dnd                    (default: 1)
657         Display a confirmation dialog on drag'n'drop of folders.
658         0: off  1: on
659
660     zero_replacement_char       (default: 0)
661         Character to show in Folder List counter columns when a 
662         folder doesn't contain messages.
663
664 9. Tools
665 --------- 
666   You will find all of these tools in the 'tools' directory:
667
668   acroread2claws-mail.pl 
669         send PDFs from Adobe Reader 7
670   calypso_convert.pl 
671         import mbox files exported by calypso
672   claws-mail-compose-insert-files.pl
673         insert files into a new Compose window
674   convert_mbox.pl
675         convert mbox format to MH format
676   csv2addressbook.pl
677         import Becky, Thunderbird, Kmail, Gmail and Fox Mail
678         address books
679   eud2gc.py
680         convert a Eudora (v.3?) addressbook to vCard 
681         (GnomeCard) format
682   filter_conv.pl
683         convert sylpheed main's filter rules, (< 0.9.99),
684         into Claws' filtering format
685   filter_conv_new.pl
686         convert sylpheed main's filter rules, (>= 0.9.99),
687         into Claws' filtering format
688   fix-date.sh
689         Replace/Add a message's Date field
690   freshmeat_search.pl
691         Actions script to lookup the selected text on
692         Freshmeat www.freshmeat.net using the configured
693         browser
694   gif2xface.pl
695         convert a gif file to an xface
696   google_msgid.pl
697         Actions script to lookup selected message-id on 
698         google using mozilla.
699   google_search.pl
700         Actions script to lookup up the selected text on
701         google using the configured browser
702   kdeservicemenu/*
703         Service Menus for Konqueror to allow sending
704         files to Claws Mail
705   kmail2claws-mail.pl
706         convert a Kmail addressbook to a Claws Mail
707         addressbook
708   kmail2claws-mail_v2.pl
709         new version of the address book conversion script
710         for newer versions of Kmail/Kaddressbook
711   kmail-mailbox2claws-mail.pl
712         convert a Kmail mailbox into a Claws mail mailbox
713   mairix.sh
714         a wrapper to mairix, to enable global searches in mail
715         folders
716   mew2claws-mail.pl
717         import a Mew address book
718   multiwebsearch.pl
719         search any searchable website for the selected text
720   nautilus2claws-mail.sh
721         enables sending files from the Nautilus file manager
722         to Claws Mail
723   OOo2claws-mail.pl
724         enable OpenOffice to send documents through
725         Claws Mail
726   outlook2claws-mail.pl
727         convert an Outlook contacts list to a Claws Mail
728         addressbook
729   popfile-link.sh
730         open messages in POPFile control center to edit their status
731   sylprint.pl
732         process a Claws Mail message and print it using enscript
733         if available or lpr if not
734   tb2claws-mail
735         convert an addressbook exported from The Bat! into 
736         a Claws Mail addressbook
737   tbird2claws.py
738         integrate a Thunderbird folder tree into Claws Mail
739   textviewer.pl
740         Display various attachments as text
741   textviewer.sh
742         attempt to view an attachment as plain text
743   thunderbird-filters-convertor.pl
744         convert Thunderbird filtering rules
745   update-po 
746         translators' tool that eases the creation of 
747         *.po files
748   uudec
749         decode UUencoded mails, for use with Actions
750   uuooffice
751         Decode uuencoded attachments and open them with OpenOffice
752   vcard2xml.py
753         import an Evolution vCard
754
755
756 10. How to contribute
757 ---------------------
758
759 You are encourged to send patches via the Claws Mail bugzilla at
760 http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
761 But please first read the patch guidelines here:
762 http://www.claws-mail.org/devel.php
763
764 If that's too troublesome, either contact Paul Mangan
765 <paul@claws-mail.org> or consider posting to the
766 Claws Mail-users mailing list.
767 http://www.claws-mail.org/MLs.php
768
769 Bugs can be reported with Claws' bugzilla at:
770 http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
771
772 Of course, you can also post to the Claws Mail-users mailing list.
773
774 Also, we really try to incorporate good contributions, but sometimes we
775 don't have enough time. If the contribution is really big, or requires
776 a long time to stabilise, send a mail to Paul Mangan
777 <paul@claws-mail.org>. We can probably arrange access to the
778 Claws Mail Git repository.
779
780
781
782 11. How to request features
783 ---------------------------
784
785 Ask around in Claws Mail-users ML. Note that some developers may
786 have already thought about your feature and may, perhaps, be implementing
787 it, or the feature was already discussed and rejected for whatever reason.
788 You might want to go ahead and hack a patch for it. (That would be very
789 cool!) Another possibility is to add a request to our bugzilla, (severity:
790 'enhancement'), at
791 http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
792
793
794 12. Installing Claws Mail from Git
795 --------------------------------------
796
797   a. Downloading
798   --------------
799
800   To download the latest Git, cd to the directory where you wish to download
801   to and type the following information:
802
803   git clone http://git.claws-mail.org/readonly/claws.git 
804
805   Later, when you want to update your local repository, you'll just have to
806   go back to the 'claws' directory, and type:
807
808   git pull --all
809
810   b. Installing
811   -------------
812
813   To compile and install use the following commands:
814
815   ./autogen.sh          [add configure options as required]
816   make
817   make install          [as root]
818
819   You will need a full set of development tools installed to be able to run
820   autogen.sh. See also ac/README.
821
822
823
824 13. Release History
825 -------------------
826
827 GTK 2 Version
828 -------------
829 2015-07-19      3.12.0
830 2014-10-27      3.11.1
831 2014-10-20      3.11.0
832 2014-06-09      3.10.1
833 2014-05-26      3.10.0
834 2013-12-14      3.9.3
835 2013-06-08      3.9.2
836 2013-05-06      3.9.1
837 2012-11-14      3.9.0
838 2012-06-27      3.8.1
839 2011-12-16      3.8.0
840 2011-08-27      3.7.10
841 2011-04-09      3.7.9
842 2010-12-04      3.7.8
843 2010-11-19      3.7.7
844 2010-05-01      3.7.6
845 2010-01-31      3.7.5
846 2010-01-08      3.7.4
847 2009-10-09      3.7.3
848 2009-07-03      3.7.2
849 2009-03-06      3.7.1
850 2008-12-19      3.7.0
851 2008-10-10      3.6.1
852 2008-10-03      3.6.0
853 2008-06-27      3.5.0
854 2008-04-18      3.4.0
855 2008-02-23      3.3.1
856 2008-02-08      3.3.0
857 2007-12-17      3.2.0
858 2007-11-19      3.1.0
859 2007-10-02      3.0.2
860 2007-09-17      3.0.1
861 2007-09-03      3.0.0
862 2007-07-02      2.10.0
863 2007-05-08      2.9.2
864 2007-04-19      2.9.1
865 2007-04-16      2.9.0
866 2007-03-06      2.8.1
867 2007-02-26      2.8.0
868 2007-01-26      2.7.2
869 2007-01-15      2.7.1
870 2007-01-08      2.7.0
871 2006-12-04      2.6.1 [first release as Claws Mail]
872 2006-11-06      2.6.0
873 2006-10-19      2.5.6
874 2006-10-12      2.5.5
875 2006-10-11      2.5.4
876 2006-10-04      2.5.3
877 2006-09-26      2.5.2
878 2006-09-26      2.5.1
879 2006-09-25      2.5.0
880 2006-07-31      2.4.0
881 2006-06-20      2.3.1
882 2006-06-12      2.3.0
883 2006-06-08      2.2.3
884 2006-06-06      2.2.2
885 2006-06-05      2.2.1
886 2006-05-08      2.2.0
887 2006-04-17      2.1.1
888 2006-04-05      2.1.0
889 2006-01-30      2.0.0
890 2005-11-08      1.9.100
891 2005-10-31      1.9.99
892 2005-10-03      1.9.15
893 2005-09-05      1.9.14
894 2005-07-22      1.9.13
895 2005-06-27      1.9.12
896 2005-05-19      1.9.11
897 2005-05-09      1.9.9
898 2005-03-18      1.9.6
899
900 GTK 1 Version
901 -------------
902 2005-06-27      1.0.5
903 2005-05-09      1.0.4a
904 2005-03-24      1.0.4
905 2005-03-10      1.0.3
906 2005-02-08      1.0.1
907 2005-01-17      1.0.0
908 2004-12-06      0.9.13
909 2004-09-27      0.9.12b
910 2004-08-23      0.9.12a
911 2004-06-28      0.9.12
912 2004-05-31      0.9.11claws
913 2004-03-08      0.9.10claws
914 2004-02-06      0.9.9claws
915 2003-12-19      0.9.8claws
916 2003-11-26      0.9.7claws
917 2003-10-02      0.9.6claws
918 2003-09-10      0.9.5claws
919 2003-08-04      0.9.4claws
920 2003-07-12      0.9.3claws
921 2003-05-24      0.9.0claws
922 2003-03-12      0.8.11claws
923 2003-02-12      0.8.10claws
924 2003-01-24      0.8.9claws
925 2002-12-26      0.8.8claws
926 2002-12-23      0.8.7claws
927 2002-11-25      0.8.6claws
928 2002-10-07      0.8.5claws
929 2002-09-22      0.8.3claws
930 2002-08-28      0.8.2claws
931 2002-07-30      0.8.1claws
932 2002-07-23      0.8.0claws
933 2002-06-15      0.7.8claws
934 2002-05-18      0.7.6claws
935 2002-04-28      0.7.5claws
936 2002-03-11      0.7.4claws
937 2002-02-19      0.7.2claws
938 2002-02-14      0.7.1claws
939 2002-01-14      0.7.0claws
940 2001-12-16      0.6.6claws
941 2001-10-16      0.6.5claws8
942 2001-09-30      0.6.2claws
943 2001-08-14      0.6.1claws
944 2001-07-13      0.5.1claws
945 2001-07-01      0.5.0claws3
946 2001-06-16      0.4.99claws
947 2001-05-29      0.4.99claws3
948 2001-05-11      0.4.67claws1
949
950
951
952 14. Useful links
953 ----------------
954 Homepage
955     http://www.claws-mail.org/
956 User Contributed FAQ
957     http://www.claws-mail.org/faq/
958 Project page
959     http://sourceforge.net/projects/claws-mail/
960 Downloads
961     http://www.claws-mail.org/downloads.php
962 Extra Plugins
963     http://www.claws-mail.org/plugins.php
964 Icon Themes
965     http://www.claws-mail.org/themes.php
966 Mailing Lists
967     http://www.claws-mail.org/MLs.php
968 Users Mailing List archive
969     http://lists.claws-mail.org/pipermail/users/index.html
970 Commits Announcement List archive
971     http://lists.claws-mail.org/pipermail/commits/index.html
972 Bug/Patch/Feature Request Tracker
973     http://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
974 Internationalisation Status
975     http://www.claws-mail.org/i18n.php
976 Donations
977     http://www.claws-mail.org/sponsors.php
978 Planet Claws Mail
979     http://planet.claws-mail.org/
980 Claws Mail for Windows homepage
981     http://www.claws-mail.org/win32/
982