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