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