README.claws

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