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