README

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