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