README

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