README

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