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