README

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