README.claws

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