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