README.claws

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