README.claws

   1 README.claws
   2 ------------
   3 [last revision: 2005-07-22]
   4
   5 Summary:
   6
   7  1. What is Sylpheed-Claws?
   8  2. Plugins
   9  3. Switching between Sylpheed Claws and Sylpheed
  10  4. Actions
  11  5. Icon Themes
  12  6. Spell Checking
  13  7. Quick Search
  14  8. Custom toolbar
  15  9. Partial downloading of POP3 mails
  16 10. Other things that Claws does differently
  17 11. Tools
  18 12. How to contribute
  19 13. How to request features
  20 14. Installing Claws from CVS
  21 15. Release History
  22 16. Useful Links
  23
  24
  25 1. What is Sylpheed-Claws?
  26 --------------------------
  27
  28 Sylpheed-Claws is an extended version of Sylpheed, a light weight mail
  29 user agent for UNIX. Features in this branch may (or may not) end up in
  30 Sylpheed.
  31
  32 Hiroyuki's ChangeLog is also included in the Claws branch distribution,
  33 so it should be easy to spot which features were merged with Sylpheed
  34 (and which features were not).
  35
  36 For brevity Sylpheed-Claws is referred to as Claws, and Sylpheed as either
  37 Sylpheed or Main.
  38
  39
  40
  41 2. Plugins
  42 ----------
  43
  44 All plugins, except SpamAssassin, are built automatically
  45 if the required libraries are present.
  46
  47 Plugins are installed in $PREFIX/lib/sylpheed/plugins/
  48 and have a suffix of '.so'
  49 To load a plugin go to '/Configuration/Plugins' and click
  50 the 'Load Plugin' button.
  51 Select the plugin that you want and click 'OK'
  52
  53   o Clam AntiVirus
  54     Enables the scanning of message attachments in mail
  55     received from a POP, IMAP or LOCAL account using Clam
  56     AntiVirus. It can optionally delete the mail or save it
  57     to a designated folder. Preferences can be found in
  58     '/Configuration/Preferences/Filtering/Clam AntiVirus'.
  59     Clam AntiVirus is available from http://clamav.sourceforge.net/
  60
  61   o Dillo HTML Viewer
  62     Enables the viewing of html messages using the Dillo web
  63     browser, version 0.7.0 or newer. It uses Dillo's --local
  64     option by default for safe browsing. Preferences can be
  65     found in '/Configuration/Preferences/Message View/Dillo Browser'.
  66     Dillo is available from http://www.dillo.org/
  67
  68   o MathML Viewer
  69     Enables the viewing of attachments that have the
  70     Content-Type 'text/mathml' using the GtkMathView widget
  71     which is available from
  72     http://helm.cs.unibo.it/mml-widget/
  73
  74   o PGP/Core
  75     Handles core PGP functions and is required by the PGP/Inline
  76     and PGP/MIME plugins.
  77     Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
  78
  79   o PGP/inline
  80     Handles inline PGP signed and/or encrypted mails. You can
  81     decrypt mails, verify signatures or sign and encrypt your
  82     own mails. Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
  83
  84   o PGP/MIME
  85     Handles PGP/MIME signed and/or encrypted mails. You can
  86     decrypt mails, verify signatures or sign and encrypt your
  87     own mails. Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
  88
  89   o SpamAssassin
  90     Enables the scanning of incoming mail received from a POP,
  91     IMAP or LOCAL account using SpamAssassin. It can optionally
  92     delete mail identified as spam or save it to a designated
  93     folder. Preferences can be found in '/Configuration/
  94     Preferences/Filtering/SpamAssassin'.
  95     SpamAssassin is available from http://spamassassin.org
  96     Configure option:
  97         --enable-spamassassin-plugin
  98
  99   o Trayicon
 100     Places an icon in the system tray that indicates whether
 101     you have any new mail. A tooltip also shows the current
 102     new, unread and total number of messages
 103
 104 More plugins can be found here:
 105 http://sylpheed-claws.sourceforge.net/plugins.php
 106
 107
 108 3. Switching between Sylpheed Claws and Sylpheed
 109 ------------------------------------------------
 110
 111   From Sylpheed to Sylpheed Claws
 112   -------------------------------
 113
 114   From the user perspective Claws is just a fancy Sylpheed, so it uses the
 115   same Sylpheed setting files located in ~/.sylpheed. However, you may wish
 116   to use the ./configure option --with-config-dir=RCDIR, so that you can
 117   preserve your Sylpheed settings.
 118
 119   It's always a good idea to back up all files in ~/.sylpheed in case
 120   you want to switch back to Sylpheed and didn't use the --with-config-dir
 121   option. (You don't have to backup the directories.)
 122
 123   If you use a new configuration directory you will need to manually copy
 124   all of your address book files, ~/.sylpheed/addrbook*
 125
 126   There are some things that frequently come up when switching to Claws:
 127
 128
 129   * What happened to my filter rules?
 130
 131     Claws uses a new filtering system. Your old Sylpheed filter rules will not
 132     be used. In subdirectory tools/ of the distribution there is a Perl script
 133     called filter_conv.pl which converts old filter rules to the claws
 134     filtering system, see tools/README for details. This currently only supports
 135     conversion from Sylpheed's old filtering system, < 0.9.99.
 136
 137   * What happened to the compose email and compose news buttons?
 138
 139     There's a composite button for both composing mail and news. It is toggled
 140     between composing mail and news automatically when  a mail or news folder
 141     is selected.
 142
 143
 144   * And to the Preferences and Execute buttons?
 145
 146     Sorry, they're not there.
 147
 148
 149   From Sylpheed Claws to Sylpheed
 150   -------------------------------
 151
 152   Moving from Claws to Sylpheed is also simple. Sylpheed should neglect the things
 153   Claws put in the settings files. This also means that the old rules will work
 154   again.
 155
 156   If you want to switch back to Claws at a later time, and are using the same config
 157   directory for both, make sure you back up at least  ~/.sylpheed/matcherrc (the
 158   Claws filtering rules), and ~/.sylpheed/sylpheedrc (which may have some claws
 159   specific settings).
 160
 161   When switching back to Sylpheed you will not lose messages or message flags (color
 162   labels, read / unread status of messages).
 163
 164 4. Actions
 165 ----------
 166   The "actions" feature is a convenient way for the user to launch external
 167   commands to process a complete message file including headers and body or
 168   just one of its parts. It allows also the use of an external command to
 169   filter the whole text or just a selected part in the message window or in
 170   the compose window. This is a generic tool that allows to do any uncommon
 171   actions on the messages, and thus extends the possibilities of Sylpheed.
 172   For example, Sylpheed does not include the rot13 cyphering algorithm
 173   popular in some newsgroups. It does not support natively armored
 174   encryption or clear signing. It does not support uuencoded messages. As
 175   all these features can be handled by external programs, the actions
 176   provide a convenient way to use them from the menu bar.
 177
 178   a. Usage
 179   --------
 180
 181   To create a new action, go to Configuration -> Actions.... The "Action
 182   Creation" dialog offers to enter the Menu name that will trigger the
 183   command. The created menu will be found in the Tools -> Actions submenu.
 184   By inserting a slash / in the menu name, you create a submenu.
 185
 186   The command is entered in the Command line entry. Note that Sylpheed
 187   stores every single email in a separate file. This allows to use the
 188   following syntax for the command:
 189
 190     * %f denotes the file name of the selected message. If you selected more
 191          than one, then the command will be launched for each message with
 192          the appropriate file name
 193     * %F denotes the list of the file names of the selected message. If only
 194          one message is selected, this amounts to %f, but if more messages
 195          are selected, then the command will be launched only once with the
 196          list of the file names. (You can use both %f and %F in one command:
 197          then the command will be launched for each selected message with
 198          the name of this message and with the list of all selected
 199          messages. I did not find a practical example for this.)
 200     * %p denotes the current selected message part of a multipart message.
 201          The part is decoded accordingly. If the message is not a multipart
 202          message, it denotes the message body.
 203     * Prepending >: this will allow you to send to the command's standard
 204          input a text that you will enter in a dialog window.
 205     * Prepending *: this will allow you to send to the command's standard
 206          input a text that you will enter in a dialog window. But in
 207          contrast to prepending >, the entered text is hidden (useful when
 208          entering passwords).
 209     * Appending an ampersand &: this will run the command asynchronously.
 210          That means "fire and forget". Sylpheed won't wait for the command
 211          to finish, nor will it catch its output or its error messages.
 212     * Prepending the vertical bar | (pipe-in): this will send the current
 213          displayed text or the current selected text from the message view
 214          or the compose window to the command standard input. The command
 215          will silently fail if more than one message is selected.
 216     * Appending the vertical bar | (pipe-out): this will replace the current
 217          displayed text or the current selected text from the message window
 218          or the compose window by the command standard output. The command
 219          will silently fail if more than one message is selected.
 220
 221   Note: It is not possible to use actions containing %f, %F or %p from the
 222   compose window.
 223
 224   When a command is run, and unless it is run asynchronously, Sylpheed will
 225   be insensitive to any interaction and it will wait for the command to
 226   finish. If the command takes too long (5 seconds), it will popup a dialog
 227   window allowing to stop it. This dialog will also be displayed as soon as
 228   the command has some output: error messages or even its standard output
 229   when the command is not a "pipe-out" command. When multiple commands are
 230   being run, they are run in parallel and each command output is separated
 231   from the outputs of the others.
 232
 233   a. Examples
 234   -----------
 235
 236   Here are some examples that are listed in the same syntax as used for
 237   storing the actions list. You can copy and past the definition in your
 238   ~/.sylpheed/actionsrc file (exit Sylpheed before). The syntax is very
 239   simple: one line per action, each action contains the menu name and the
 240   command line separated by a colon and a space ": "
 241
 242   Purpose:      rot13 cyphering
 243   Definition:   Rot13: |tr a-zA-Z n-za-mN-ZA-M|
 244   Details:      This will apply the rot13 cyphering algorithm to the
 245                 (selected) text in the message/compose view.
 246
 247   Purpose:      Decoding uuencoded messages
 248   Definition:   UUdeview: xdeview %F&
 249   Details:      xdeview comes with uudeview. If an encoded file is split in
 250                 multiple messages, just select them all and run the command.
 251
 252   Purpose:      Display uuencoded image
 253   Definition:   Display uuencoded: uudec %f&
 254   Details:      Displays uuencoded files. The uudec[1] script can be found in
 255                 the 'tools' directory of the distribution package.
 256
 257   Purpose:      Alter messages
 258   Definition:   Edit message: gvim -f %F
 259   Details:      Allows editing of any received message. Can be used to remove
 260                 unneeded message parts, etc.
 261
 262   Purpose:      Pretty format
 263   Definition:   Par: |par 72Tbgjqw74bEe B=._A_a 72bg|
 264   Details:      par is a utility that can pretty format any text. It does a
 265                 very good job in indenting quoted messages, and justifying
 266                 text. Used when composing a message
 267
 268   Purpose:      Browse
 269   Definition:   Part/Dillo: dillo %p&
 270   Details:      Browse the selected message part in Dillo.
 271
 272   Purpose:      Clear Sign
 273   Definition:   GnuPG/Clear Sign: |gpg-sign-syl|
 274   Details:      Clear sign a message. The gpg-sign-syl[2] script is responsible
 275                 for asking the passphrase and for running gnupg.
 276
 277   Purpose:      Verify Clear Signed
 278   Definition:   GnuPG/Verify: |gpg --no-tty --verify
 279   Details:      Verify clear signed messages. The result is displayed in the
 280                 actions output dialog.
 281
 282   Purpose:      Decrypt ASCII Armored
 283   Definition:   GnuPG/Decrypt: *gpg --no-tty --command-fd 0 --passphrase-fd 0 --decrypt %f|
 284   Details:      Decrypt ASCII armored messages. The passphrase is entered
 285                 into the opened action's input dialog.
 286
 287   [1] The uudec script can be found in the 'tools' directory of the
 288   distribution package. It needs uudecode and ImageMagick's display. The
 289   latter can be replaced by any image viewer that can get input from
 290   standard input. The script could also be modified to use temporary files
 291   instead of standard input.
 292
 293   [2] The gpg-sign-syl script can be found in the 'tools' directory of the
 294   distribution package.
 295
 296
 297
 298 5. Icon Themes
 299 --------------
 300   Claws has support for different icon sets. Several icon sets can be
 301   downloaded from http://sylpheed-claws.sourceforge.net/themes.php
 302   You will need to create a directory called 'themes' in your config
 303   directory, unpack them into this directory, and then use the interface
 304   to select them, /Configuration/Preferences/Display/Themes
 305
 306   This interface can also be used to install new themes.
 307
 308
 309
 310 6. Spell Checking
 311 -----------------
 312   a. Requirements
 313   b. Configuration and installation
 314   c. Usage
 315   d. Known problems
 316
 317   a. Requirements
 318   ---------------
 319
 320   The spell checker in Sylpheed-Claws requires the GNU/aspell library
 321   (http://www.gnu.org/software/aspell), version 0.50 or newer.
 322
 323   You also need the dictionaries. Check GNU/aspell home page for how
 324   to download and install them.
 325
 326   NB: The old dictionaries used by the old aspell will not work.
 327
 328   b. Configuring Claws
 329   --------------------
 330
 331   Spell checking is enabled if you configure Claws appropriately. Add
 332   the option '--enable-aspell' when configuring, e.g.:
 333
 334   ./configure --enable-aspell
 335
 336   The configure script needs the 'aspell' executable to be in your path.
 337   If it is in unusual places, use '--with-aspell-prefix' to tell the path of
 338   the aspell executable.  E.g., if aspell's full path is
 339   /foo/bar/bin/aspell, then use:
 340
 341   ./configure --enable-aspell --with-aspell-prefix=/foo/bar
 342
 343   The '--with-aspell-prefix=PREFIX' option will let the configure
 344   script search for includes and libraries in PREFIX/include and PREFIX/lib.
 345
 346   You can also specify manually the includes and libraries path by using
 347   either following options:
 348
 349   --with-aspell-includes=/foo/bar/include
 350
 351   and/or
 352
 353   --with-aspell-libs=/rab/oof/lib
 354
 355   as appropriate.
 356
 357   The configure script summarizes the options compiled in.  Check that
 358   it lists 'GNU/aspell = yes'.
 359
 360   Then proceed as usual, with 'make' and 'make install'.
 361
 362   c. Usage
 363   --------
 364
 365   After successful compiling, you need to tell Sylpheed where your
 366   dictionaries reside. The configure script should have found it,
 367   but in case it did not, run 'aspell config dict-dir' on the
 368   shell to get the path to the dictionaries.
 369
 370   Then run Sylpheed and go to /Configuration/Preferences/Compose/Spell Checker.
 371   Check the box 'Enable spell checker' and use the file selector ('...' button)
 372   to select the path where the dictionaries reside.  Within the file selector,
 373   go to that directory and select *any* file in the file lists.  Click OK.
 374   Then, you should be able to select your default dictionary.
 375
 376   When composing, misspelled words are highlighted.  Click on any
 377   highlighted word with the right mouse button to get a list of
 378   suggestions.  The first entry of the menu just displays the unknown
 379   word.  Selecting 'Accept in this session' (or hitting MOD1-Space,
 380   where MOD1 is usually the ALT key) will ignore this word and accept
 381   it in this message.  Selecting the next entry, "Add to dictionary", which
 382   is bound to MOD1-Enter combination, will add the unknown word to your
 383   personal dictionary to learn it.  The next entries are the suggested words.
 384   The first 15 suggestions can be accessed by typing one of the first letters
 385   of Latin alphabet (if this does not suit your language, please send
 386   a mail to melvin.hadasht@free.fr).  Aspell has a 'learn from mistake'
 387   function that can be used by pressing the MOD1 key and selecting the
 388   suggestion (with the keyboard or with the mouse).  See GNU/aspell manual
 389   §6.3 for an explanation of this feature (also called 'replacement storing').
 390
 391   If you click with the right mouse button everywhere else, or if you
 392   shift-right-click even on a misspelled word, you get the
 393   configuration menu.  'Check all' highlights all misspelled words.
 394   With this menu, you can also change the dictionary while editing.
 395   Finally, you can change the suggestion mode, and the learn from
 396   misktakes feature.
 397
 398   Spell checking can also be done using keyboard shortcuts.  In the
 399   'Edit' menu of the compose window, there are two menus 'Check backwards
 400   misspelled word' and 'Forward to next misspelled word'.  Add to them
 401   appropriate keyboard shortcuts.  'Check backwards misspelled word'
 402   checks backwards from cursor position for the first misspelled word.
 403   If it finds one, it displays the suggestions lists which can be handled
 404   with the keyboard as described before. When the suggestion menu is
 405   closed, the cursor returns to its original position to be able to
 406   continue editing.  The 'Forward to next misspelled word' do the same
 407   thing in the other direction but moves the cursor at the end of the
 408   misspelled word.  This way, you can spell check easily a whole message
 409   starting from its beginning and using the 'Forward to next misspelled
 410   word' keyboard short cut.
 411
 412
 413   d. Known problems
 414   -----------------
 415
 416     No known problems as the time of this writing (0.8.2claws3).
 417
 418
 419 7. Quick Search with extended search
 420 ------------------------------------
 421     Quick Search, with its powerful Extended search function,
 422     enables searching through folder's messages.
 423
 424     Extended Search allows one to define criteria that messages must
 425     have in order to match and be displayed in the summary view pane.
 426     Search types titled From, Subject and To are self explanatory.
 427     Search type extended allows one to use Sylpheed's powerful
 428     filtering engine to select messages. Examples:
 429     from regexpcase "foo"
 430     subject regexp "Bug" & to regexp "sylpheed-claws"
 431
 432     Additionally, it is possible to use simpler yet equally
 433     powerfull patterns for message selections. Mutt users will
 434     immediately recognise most of the available patterns:
 435
 436     Pattern  Parameter  Selects
 437     ----------------------------------------------------
 438     a                   all messages
 439     ag       #          messages whose age is greater than #
 440     al       #          messages whose age is lower than #
 441     b        S          messages which contain S in the message body
 442     B        S          messages which contain S in the whole message
 443     c        S          messages carbon-copied to S
 444     C        S          message is either to: or cc: to S
 445     D                   deleted messages
 446     e        S          messages which contain S in the Sender field
 447     E        S          true if execute "S" succeeds
 448     f        S          messages originating from user S
 449     F                   forwarded messages
 450     h        S          messages which contain header S
 451     i        S          messages which contain S in Message-Id header
 452     I        S          messages which contain S in inreplyto header
 453     L                   locked messages
 454     n        S          messages which are in newsgroup S
 455     N                   new messages
 456     O                   old messages
 457     r                   messages which have been replied to
 458     R                   read messages
 459     s        S          messages which contain S in subject
 460     se       #          messages whose score is equal to #
 461     sg       #          messages whose score is greater than #
 462     sl       #          messages whose score is lower than #
 463     Se       #          messages whose size is equal to #
 464     Sg       #          messages whose size is greater than #
 465     Ss       #          messages whose size is smaller than #
 466     t        S          messages which have been sent to S
 467     T                   marked messages
 468     U                   unread messages
 469     x        S          messages which contain S in References header
 470     y        S          messages which contain S in X-Label header
 471
 472     # means number
 473     S means regexp string
 474
 475     It is possible to use logical operators AND (&), OR (|) and
 476     NOT (! or ~). Case sensitive search is achieved with %.
 477     Examples:
 478     T                  marked messages
 479     U                  unread messages
 480     f "john beavis"    messages from john beavis
 481     %f "John Beavis"   messages from John Beavis (case sensitive)
 482     ~s foo             messages which do not have foo in the subject
 483     f foo & ~s bar     messages from foo that do not have bar in thesubject
 484
 485
 486 8. Custom toolbar
 487 -----------------
 488
 489    /Configuration/Preferences/Customize Toolbars lets you define the
 490    toolbar you want. The configuration dialog enables you to set an icon,
 491    an appropriate text, and map an action to it. Actions to choose
 492    from are predefined. You can also have your "Sylpheed Actions" (refer
 493    to "Actions" above) on your toolbar.
 494
 495    Example:
 496         * Configuration->Actions
 497                 - add an entry "Dillo: dillo %p&"
 498         * Configuration->Custom toolbar
 499                 - select Sylpheed Actions Feature
 500                 - select "Dillo: dillo %p&" from drop down list
 501                 - choose an icon and click ok
 502
 503
 504
 505 9. Partial downloading of POP3 mails
 506 ------------------------------------
 507   Messages over the configured size limit, (/[Account preferences]/
 508   Receive/Message size limit), will be partially retrieved. These
 509   messages will have a Notice View displayed (above the Message View),
 510   informing of the partially retrieved state and the total size of the
 511   message. The Notice View will also contain two buttons, 'Mark for
 512   download' and 'Mark for deletion'. If the user clicks 'Mark for
 513   download', the message will be downloaded in full at the next message
 514   retrieval, (and the partial one deleted); if the user checks 'Mark for
 515   deletion' it will be removed from the server after the normal delay
 516   as specified in the POP3 account's 'Receive' preferences.
 517   If a user moves a partially retrieved message to the Trash folder
 518   it will be deleted on the server at the next retrieval after the
 519   Trash folder has been emptied.
 520
 521
 522
 523
 524 10. Other things that Claws does differently
 525 --------------------------------------------
 526   Claws does a lot of things differently. Here is a quick run-down of
 527   just a few of them:
 528
 529   * auto address replacement in summary view
 530
 531     This matches a plain email address with a person in the address book.
 532     This feature is enabled in /Configuration/Preferences/Common/Display
 533     'Display sender using addressbook'
 534
 535   * manual selection of MIME types for attachments
 536
 537     You can change the MIME type of an attachment by right-clicking in the
 538     attachment list, selecting Property in the menu. The MIME type list
 539     is a combo box with the known MIME types.
 540
 541   * sharing mail folders
 542
 543     You can also share or use shared mail folders. Right-click a folder and
 544     select Properties. Change the Folder chmod setting.
 545
 546   * simplify subject string
 547
 548     It is possible to remove parts of subject string from the displayed
 549     subject line.
 550     Example:
 551     True Subject: [Sylpheed-claws-users] This is a test
 552     Displayed Subject: This is a test
 553     Regexp: \[Sylpheed-claws-(devel|users)\]
 554
 555     This is a per folder property. Right click on a folder and select
 556     Properties, enable Simplify Subject RegExp check box.
 557
 558   * new cache
 559
 560     New cache is  a new data cache structure for sylpheed, that will
 561     solve many of the problems sylpheed currently has with updates to
 562     flags.  But you will also notice a large speed gain when you open
 563     these folders.
 564
 565     New cache uses two new configuration parameters that can be
 566     adjusted in ~/[RCDIR]/sylpheedrc (no gui for them available yet).
 567
 568     cache_max_mem_usage         (default: 4096)
 569         the maximum kB of memory sylpheed should use.
 570         It will try to keep the memory usage below this
 571         value, but it will always use the assigned
 572         amount of memory for speed gain.
 573
 574     cache_min_keep_time         (default: 15)
 575         the minimum time in minutes sylpheed will keep
 576         the folder cache in memory. If a cache is more
 577         recent than this time it will not be freed even
 578         if the memory usage is above the maximum. You
 579         should probably set this value higher than your
 580         mail check interval. Otherwise the cache will
 581         always be freed between checks even if the folder
 582         is accessed on every check, which will cause much
 583         disk IO.
 584
 585     The check if memory can be freed is currently done after the
 586     active folder has been changed or whenever a new cache is read,
 587     i.e. triggered by mail incorporation.
 588
 589     New mails in MH folders are not detected automatically like before,
 590     when you enter the folder. You have to update the folder manually,
 591     or activate the auto update setting in the options.
 592
 593   * SMTP Message Size Declaration
 594     If the server supports it, oversize messages will not be sent and
 595     the maximum allowed message size will be displayed in the log,
 596     (/Tools/Log window/).
 597
 598   * Reply-finder
 599     Clicking on the replied icon in the Status (S) column of the summary
 600     view will attempt to find and display your reply that is stored in
 601     your Outbox.
 602
 603   * pop before smtp authentication
 604
 605   * Automatic saving of message when composing
 606
 607   * signature in the message view can be coloured
 608
 609   * built-in gdb crash handler
 610
 611   * extra Font configuration
 612
 613   * message scoring
 614
 615   * 'hide read messages' feature
 616
 617   * Request Return-Receipt
 618
 619   * ability to change folder order
 620
 621   * 'ignore thread' marking
 622
 623   * message priority setting
 624
 625   * Automatic message drafting and cache saving on kill
 626
 627   * SSL certificate management and checking
 628
 629   * Indication of unread answers to marked mails:
 630     '(!)' is appended to the folder name when a marked message
 631     has a response
 632
 633   * address auto-completion includes a dynamic LDAP search
 634
 635   * address auro-completion works on nicknames and aliases
 636
 637   * Password encryption in config files is implemented using
 638     unix encrypt and setkey functions.
 639
 640   This is not an exhaustive list.
 641
 642
 643
 644 11. Tools
 645 ---------
 646   You will find all of these tools in the 'tools' directory:
 647
 648   acroread2sylpheed.pl
 649         send PDFs from Adobe Reader 7
 650   calypso_convert.pl
 651         import mbox files exported by calypso
 652   convert_mbox.pl
 653         convert mbox format to MH format
 654   eud2gc.py
 655         convert a Eudora (v.3?) addressbook to vCard
 656         (GnomeCard) format
 657   filter_conv.pl
 658         convert sylpheed main's filter rules, (< 0.9.99),
 659         into Claws' filtering format
 660   freshmeat_search.pl
 661         Actions script to lookup the selected text on
 662         Freshmeat www.freshmeat.net using the configured
 663         browser
 664   gif2xface.pl
 665         convert a gif file to an xface
 666   google_msgid.pl
 667         Actions script to lookup selected message-id on
 668         google using mozilla.
 669   google_search.pl
 670         Actions script to lookup up the selected text on
 671         google using the configured browser
 672   gpg-sign-syl
 673         GnuPG cleartext-signing script for use with
 674         Actions
 675   kmail2sylpheed.pl
 676         convert a Kmail addressbook to a Sylpheed
 677         addressbook
 678   kmail2sylpheed_v2.pl
 679         new version of the address book conversion script
 680         for newer versions of Kmail/Kaddressbook
 681   maildir2sylpheed.pl
 682         convert a maildir format mailbox into MH format
 683   multiwebsearch.pl
 684         search any searchable website for the selected text
 685   nautilus2sylpheed.sh
 686         enables sending files from the Nautilus file manager
 687         to Sylpheed
 688   OOo2sylpheed.pl
 689         enable OpenOffice to send documents through
 690         sylpheed
 691   outlook2sylpheed.pl
 692         convert an Outlook contacts list to a Sylpheed
 693         addressbook
 694   sylpheed-switcher
 695         enable quick-switching between claws and main
 696         in a non-destructive way
 697   sylprint.pl
 698         process a Sylpheed mail and print it using enscript
 699         if available or lpr if not
 700   tb2sylpheed
 701         convert an addressbook exported from The Bat! into
 702         a Sylpheed addressbook
 703   textviewer.sh
 704         attempt to view an attachment as plain text
 705   update-po
 706         translators' tool that eases the creation of
 707         *.po files
 708   uudec
 709         decode UUencoded mails, for use with Actions
 710   kdeservicemenu/*
 711         Service Menus for Konqueror to allow attaching files and
 712         compressing/attaching files/directories to a new Compose
 713         window
 714
 715
 716 12. How to contribute
 717 ---------------------
 718
 719 You are encourged to send patches via the Sylpheed-Claws sourceforge
 720 project's Patch Tracker.
 721 http://sourceforge.net/tracker/?atid=384600&group_id=25528&func=browse
 722
 723 If that's too troublesome, either contact Paul Mangan
 724 <twb@users.sourceforge.net> or consider posting to the
 725 Sylpheed-Claws-users mailing list.
 726 http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-users
 727
 728 Bugs can be reported with Claws' bugzilla at:
 729 http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/index.cgi
 730
 731 Of course, you can also post to the Sylpheed-Claws-users mailing list.
 732
 733 Also, we really try to incorporate good contributions, but sometimes we
 734 don't have enough time. If the contribution is really big, or requires
 735 a long time to stabilise, send a mail to Paul Mangan
 736 <twb@users.sourceforge.net>. We can probably arrange access to the
 737 Sylpheed-Claws CVS tree.
 738
 739
 740
 741 13. How to request features
 742 ---------------------------
 743
 744 Ask around in Sylpheed-Claws-users ML. Note that some developers may
 745 have already thought about your feature, may,perhaps, be implementing it,
 746 or the feature was already discussed and rejected for whatever reason.
 747 You might want to go ahead and hack a patch for it. (That would be very
 748 cool!) Another possibility is to use the Feature Request Tracker at the
 749 sourceforge project.
 750 http://sourceforge.net/tracker/?group_id=25528&atid=384601
 751
 752
 753
 754 14. Installing Claws from CVS
 755 -----------------------------
 756
 757   a. Downloading
 758   --------------
 759
 760   To download the latest cvs cd to the directory where you wish to download
 761   to and type the following information:
 762
 763   cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws login
 764
 765   When prompted for a password press the RETURN key.
 766   After anonymously logging in:
 767
 768   cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws co -r gtk2 sylpheed-claws
 769
 770
 771   b. Installing
 772   -------------
 773
 774   To compile and install use the following commands:
 775
 776   ./autogen.sh          [add configure options as required]
 777   make
 778   make install          [as root]
 779
 780   You will need a full set of development tools installed to be able to run
 781   autogen.sh. See also ac/README.
 782
 783
 784
 785 15. Release History
 786 -------------------
 787
 788 GTK 2 Version
 789 -------------
 790 2005-05-09      1.9.9
 791 2005-03-18      1.9.6
 792
 793 GTK 1 Version
 794 -------------
 795 2005-05-09      1.0.4a
 796 2005-03-24      1.0.4
 797 2005-03-10      1.0.3
 798 2005-02-08      1.0.1
 799 2005-01-17      1.0.0
 800 2004-12-06      0.9.13
 801 2004-09-27      0.9.12b
 802 2004-08-23      0.9.12a
 803 2004-06-28      0.9.12
 804 2004-05-31      0.9.11claws
 805 2004-03-08      0.9.10claws
 806 2004-02-06      0.9.9claws
 807 2003-12-19      0.9.8claws
 808 2003-11-26      0.9.7claws
 809 2003-10-02      0.9.6claws
 810 2003-09-10      0.9.5claws
 811 2003-08-04      0.9.4claws
 812 2003-07-12      0.9.3claws
 813 2003-05-24      0.9.0claws
 814 2003-03-12      0.8.11claws
 815 2003-02-12      0.8.10claws
 816 2003-01-24      0.8.9claws
 817 2002-12-26      0.8.8claws
 818 2002-12-23      0.8.7claws
 819 2002-11-25      0.8.6claws
 820 2002-10-07      0.8.5claws
 821 2002-09-22      0.8.3claws
 822 2002-08-28      0.8.2claws
 823 2002-07-30      0.8.1claws
 824 2002-07-23      0.8.0claws
 825 2002-06-15      0.7.8claws
 826 2002-05-18      0.7.6claws
 827 2002-04-28      0.7.5claws
 828 2002-03-11      0.7.4claws
 829 2002-02-19      0.7.2claws
 830 2002-02-14      0.7.1claws
 831 2002-01-14      0.7.0claws
 832 2001-12-16      0.6.6claws
 833 2001-10-16      0.6.5claws8
 834 2001-09-30      0.6.2claws
 835 2001-08-14      0.6.1claws
 836 2001-07-13      0.5.1claws
 837 2001-07-01      0.5.0claws3
 838 2001-06-16      0.4.99claws
 839 2001-05-29      0.4.99claws3
 840 2001-05-11      0.4.67claws1
 841
 842
 843
 844 16. Useful links
 845 ----------------
 846 Homepage
 847     http://sylpheed-claws.sourceforge.net/
 848 Sylpheed-Claws for Windows homepage
 849     http://sylpheed-claws.sourceforge.net/win32/
 850 FAQ
 851     http://sylpheed-claws.sourceforge.net/phpwiki/
 852 Project page
 853     http://sourceforge.net/projects/sylpheed-claws/
 854 Downloads
 855     http://sourceforge.net/project/showfiles.php?group_id=25528
 856 External Plugins
 857     http://sylpheed-claws.sourceforge.net/plugins.php
 858 Icon Themes
 859     http://sylpheed-claws.sourceforge.net/themes.php
 860 CVS webview
 861     http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/sylpheed-claws/sylpheed-claws/?only_with_tag=gtk2
 862 Users Mailing List subscription page
 863     http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-users/
 864 Users Mailing List archive
 865     http://sourceforge.net/mailarchive/forum.php?forum=sylpheed-claws-users/
 866 Commits Announcement List subscription page
 867     http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-commits/
 868 Commits Announcement List archive
 869     http://sourceforge.net/mailarchive/forum.php?forum=sylpheed-claws-commits/
 870 Bug Tracker
 871     http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/index.cgi
 872 Feature Request Tracker
 873     http://sourceforge.net/tracker/?group_id=25528&atid=384601
 874 Patch Tracker
 875     http://sourceforge.net/tracker/?group_id=25528&atid=384600
 876 Internationalisation Status
 877     http://sylpheed-claws.sourceforge.net/i18n.php
 878
 879
 880