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