2005-09-29 [paul] 1.9.14cvs61
[claws.git] / README.claws
index f43a7aab9abf45180f657759706f2bd33bacb717..c3d229c0f8e7d37d6dbc291ee1920b36f9efa14d 100644 (file)
 README.claws
 ------------
+[last revision: 2005-07-22]
 
 Summary:
 
-1. What is Sylpheed Claws?
-2. Switching between Sylpheed Claws and Sylpheed
-   * From Sylpheed to Sylpheed Claws
-   * From Sylpheed Claws to Sylpheed
-3. Things Claws does different
-   * auto address replacement in summary view
-   * manual selection of MIME types for attachments
-   * sharing mail folders
-   * default to address for folders
-   * threading mode per folder
-   * simplify subject string
-   * pixmap themes
-   * user definable actions
-   * spell checking (with installation instructions)
-   * new cache
-   * selective download, delete messages on server
-4. How to contribute
-5. How to request features
-6. Installing Claws from CVS
-7. History
-
-
-
-1. What is Sylpheed Claws?
+ 1. What is Sylpheed-Claws?
+ 2. Plugins
+ 3. Switching between Sylpheed Claws and Sylpheed
+ 4. Actions
+ 5. Icon Themes
+ 6. Spell Checking
+ 7. Quick Search
+ 8. Custom toolbar
+ 9. Partial downloading of POP3 mails
+10. Other things that Claws does differently
+11. Tools
+12. How to contribute
+13. How to request features
+14. Installing Claws from CVS
+15. Release History
+16. Useful Links
+
+
+1. What is Sylpheed-Claws?
 --------------------------
 
-Sylpheed Claws is a bleeding edge branch of Sylpheed, a light weight mail 
+Sylpheed-Claws is an extended version of Sylpheed, a light weight mail
 user agent for UNIX. Features in this branch may (or may not) end up in 
 Sylpheed. 
 
-Hiroyuki's ChangeLog is also included in the claws-branch distribution, 
+Hiroyuki's ChangeLog is also included in the Claws branch distribution,
 so it should be easy to spot which features were merged with Sylpheed
 (and which features were not).
 
-For brevity Sylpheed Claws is referred to as Claws, and Sylpheed as either
+For brevity Sylpheed-Claws is referred to as Claws, and Sylpheed as either
 Sylpheed or Main.
 
 
 
-2. Switching between Sylpheed Claws and Sylpheed
+2. Plugins
+----------
+
+All plugins, except SpamAssassin, are built automatically
+if the required libraries are present.
+
+Plugins are installed in $PREFIX/lib/sylpheed/plugins/
+and have a suffix of '.so'
+To load a plugin go to '/Configuration/Plugins' and click
+the 'Load Plugin' button.
+Select the plugin that you want and click 'OK'
+  o Clam AntiVirus
+    Enables the scanning of message attachments in mail
+    received from a POP, IMAP or LOCAL account using Clam 
+    AntiVirus. It can optionally delete the mail or save it 
+    to a designated folder. Preferences can be found in 
+    '/Configuration/Preferences/Filtering/Clam AntiVirus'.
+    Clam AntiVirus is available from http://clamav.sourceforge.net/
+  
+  o Dillo HTML Viewer 
+    Enables the viewing of html messages using the Dillo web
+    browser, version 0.7.0 or newer. It uses Dillo's --local
+    option by default for safe browsing. Preferences can be 
+    found in '/Configuration/Preferences/Message View/Dillo Browser'.
+    Dillo is available from http://www.dillo.org/
+       
+  o MathML Viewer
+    Enables the viewing of attachments that have the 
+    Content-Type 'text/mathml' using the GtkMathView widget
+    which is available from 
+    http://helm.cs.unibo.it/mml-widget/
+
+  o PGP/Core
+    Handles core PGP functions and is required by the PGP/Inline
+    and PGP/MIME plugins.
+    Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
+
+  o PGP/inline
+    Handles inline PGP signed and/or encrypted mails. You can
+    decrypt mails, verify signatures or sign and encrypt your
+    own mails. Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
+
+  o PGP/MIME
+    Handles PGP/MIME signed and/or encrypted mails. You can
+    decrypt mails, verify signatures or sign and encrypt your
+    own mails. Uses GnuPG/GPGME, <ftp://ftp.gnupg.org/gcrypt/gpgme/>
+
+  o SpamAssassin
+    Enables the scanning of incoming mail received from a POP,
+    IMAP or LOCAL account using SpamAssassin. It can optionally 
+    delete mail identified as spam or save it to a designated 
+    folder. Preferences can be found in '/Configuration/
+    Preferences/Filtering/SpamAssassin'.
+    SpamAssassin is available from http://spamassassin.org
+    Configure option:
+       --enable-spamassassin-plugin
+       
+  o Trayicon 
+    Places an icon in the system tray that indicates whether
+    you have any new mail. A tooltip also shows the current
+    new, unread and total number of messages
+
+More plugins can be found here:
+http://sylpheed-claws.sourceforge.net/plugins.php
+
+
+3. Switching between Sylpheed Claws and Sylpheed
 ------------------------------------------------
 
   From Sylpheed to Sylpheed Claws      
   -------------------------------
 
   From the user perspective Claws is just a fancy Sylpheed, so it uses the
-  same Sylpheed setting files located in ~/.sylpheed.
+  same Sylpheed setting files located in ~/.sylpheed. However, you may wish
+  to use the ./configure option --with-config-dir=RCDIR, so that you can
+  preserve your Sylpheed settings.
 
   It's always a good idea to back up all files in ~/.sylpheed in case
-  you want to switch back to Sylpheed. (You don't have to backup the
-  directories.)
+  you want to switch back to Sylpheed and didn't use the --with-config-dir
+  option. (You don't have to backup the directories.)
 
+  If you use a new configuration directory you will need to manually copy
+  all of your address book files, ~/.sylpheed/addrbook*
+  
   There are some things that frequently come up when switching to Claws:
 
 
-  * Why does the advanced filtering system not work?
-
-    Claws uses the new filtering system as soon as you define a new rule for it.
-    Your old Sylpheed filter rules will not be used. In subdirectory tools/ of
-    the distribution there is a Perl script called filter_conv.pl which converts
-    old filter rules to the claws filtering system.
-  
+  * What happened to my filter rules? 
 
+    Claws uses a new filtering system. Your old Sylpheed filter rules will not 
+    be used. In subdirectory tools/ of the distribution there is a Perl script 
+    called filter_conv.pl which converts old filter rules to the claws 
+    filtering system, see tools/README for details. This currently only supports
+    conversion from Sylpheed's old filtering system, < 0.9.99.
   * What happened to the compose email and compose news buttons? 
 
-    There's a composite button for both composing mail and news. You can toggle
-    between composing mail and news by clicking on the button with the triangle.
+    There's a composite button for both composing mail and news. It is toggled
+    between composing mail and news automatically when  a mail or news folder
+    is selected.
 
 
   * And to the Preferences and Execute buttons?
@@ -84,67 +153,16 @@ Sylpheed or Main.
   Claws put in the settings files. This also means that the old rules will work
   again. 
 
-  If you want to switch back to Claws at a later time, make sure you back up at least
-  ~/.sylpheed/matcherrc (the Claws filtering rules), and ~/.sylpheed/sylpheedrc 
-  (which may have some claws specific settings).
+  If you want to switch back to Claws at a later time, and are using the same config
+  directory for both, make sure you back up at least  ~/.sylpheed/matcherrc (the
+  Claws filtering rules), and ~/.sylpheed/sylpheedrc (which may have some claws
+  specific settings).
 
   When switching back to Sylpheed you will not lose messages or message flags (color
   labels, read / unread status of messages). 
 
-  Switching between Sylpheed Claws and Sylpheed on a regular basis
-  ----------------------------------------------------------------
-
-  If you want to have both claws and main installed concurrently simply pass them
-  a different --prefix when doing ./configure. Then use the script 'sylpheed-switcher',
-  (which is provided in the tools directory), to launch the version you require without
-  fear of losing specific settings related to either claws or main. Further details can
-  be found in tools/README. 
-
-3. Things Claws does different
-------------------------------
-
-Claws does a lot of things different. Here a quick run-down of things that
-are hardly noticeable, but deserve mentioning:
-
-* auto address replacement in summary view
------------------------------------
-  This matches a plain email address with a person in the address book. This
-  feature is enabled in Common Preferences | Tab Display | SummaryView Group |
-  Display sender using addressbook
-
-* manual selection of MIME types for attachments
------------------------------------
-  You can change the MIME type of an attachment by right-clicking in the
-  attachment list, selecting Property in the menu. The MIME type list
-  is a combo box with the known MIME types.
-
-* sharing mail folders   
- -----------------------------------
- You can also share or use shared mail folders. Right-click a folder and
-  select Property. Change the Folder chmod setting.
-
-* default to address for folders
- -----------------------------------
- Most people filter mailing list mails to separate folders. Claws allows
-  you to associate a folder with a mailing list or a person. Right-click a
-  folder, select Property and change the Default To setting. When you
-  compose a new mail, when this folder is selected the recipient address
-  will be set to this address.
-
-  (NOTE: this is also a shoot-yourself-in-the-foot-setting! If you want
-   to send a private mail, don't have a folder selected with this setting
-   set.)
-
-* pixmap themes
------------------------------------
-  To use different icon sets you need to create a directory: 
-       mkdir ~/.sylpheed/themes
-  Icon sets should be placed in this directory in their own sub-directory. 
-  They are then selectable from Pixmap Theme on the Interface tab of Commmon
-  Preferences. 
-
-* user definable actions
------------------------------------
+4. Actions
+----------
   The "actions" feature is a convenient way for the user to launch external 
   commands to process a complete message file including headers and body or 
   just one of its parts. It allows also the use of an external command to 
@@ -275,8 +293,22 @@ are hardly noticeable, but deserve mentioning:
   [2] The gpg-sign-syl script can be found in the 'tools' directory of the 
   distribution package. 
 
-* Spell checker for Sylpheed-Claws
------------------------------------
+
+
+5. Icon Themes
+--------------
+  Claws has support for different icon sets. Several icon sets can be
+  downloaded from http://sylpheed-claws.sourceforge.net/themes.php
+  You will need to create a directory called 'themes' in your config
+  directory, unpack them into this directory, and then use the interface
+  to select them, /Configuration/Preferences/Display/Themes
+
+  This interface can also be used to install new themes.
+
+
+
+6. Spell Checking
+-----------------
   a. Requirements
   b. Configuration and installation
   c. Usage
@@ -285,13 +317,7 @@ are hardly noticeable, but deserve mentioning:
   a. Requirements
   ---------------
 
-  Note:
-  As for version 0.8.3 (and cvs version 0.8.2claws3), Sylpheed-Claws uses
-  the new GNU/aspell 0.50 for spell checking instead of the obsolete pspell
-  and old aspell 0.33.x.  You will need to upgrade your system.  See
-  http://www.gnu.org/software/aspell for instructions on how to do this.
-
-  The spell checker in Sylpheed requires the new GNU/aspell library
+  The spell checker in Sylpheed-Claws requires the GNU/aspell library
   (http://www.gnu.org/software/aspell), version 0.50 or newer.
 
   You also need the dictionaries. Check GNU/aspell home page for how
@@ -299,11 +325,11 @@ are hardly noticeable, but deserve mentioning:
   
   NB: The old dictionaries used by the old aspell will not work.
 
-  b. Configuring Sylpheed
-  -----------------------
+  b. Configuring Claws
+  --------------------
 
-  Spell checking is enabled if you configure Sylpheed appropriately. Add
-  the option '--enable-aspell' when configuring. E.g.:
+  Spell checking is enabled if you configure Claws appropriately. Add
+  the option '--enable-aspell' when configuring, e.g.:
 
   ./configure --enable-aspell
 
@@ -336,22 +362,16 @@ are hardly noticeable, but deserve mentioning:
   c. Usage
   --------
 
-  NOTE: if you upgraded from Sylpheed-Claws 0.8.2 (or cvs version 0.8.2claws2) 
-  or earlier, please check if the dictionary path was updated in the
-  Configuration -> Common Preferences -> Spell Checker menu.  If not, update
-  it accordingly as explained below.
-
   After successful compiling, you need to tell Sylpheed where your
   dictionaries reside. The configure script should have found it,
   but in case it did not, run 'aspell config dict-dir' on the
   shell to get the path to the dictionaries.
 
-  Then run Sylpheed and go to Configuration -> Common preferences ->
-  Spell Checker.  Check the box 'Enable spell checker' and
-  use the file selector ('...' button) to select the path where the
-  dictionaries reside.  Within the file selector, go to that directory
-  and select *any* file in the file lists.  Click OK. Then, you should 
-  be able to select your default dictionary.
+  Then run Sylpheed and go to /Configuration/Preferences/Compose/Spell Checker.
+  Check the box 'Enable spell checker' and use the file selector ('...' button)
+  to select the path where the dictionaries reside.  Within the file selector,
+  go to that directory and select *any* file in the file lists.  Click OK.
+  Then, you should be able to select your default dictionary.
 
   When composing, misspelled words are highlighted.  Click on any
   highlighted word with the right mouse button to get a list of
@@ -395,26 +415,155 @@ are hardly noticeable, but deserve mentioning:
 
     No known problems as the time of this writing (0.8.2claws3).
 
-* simplify subject string
------------------------------------
-    It is possible to remove parts of string from the subject line.
-    Example: [Sylpheed-claws-users] This is a test
-    becomes: This is a test
+
+7. Quick Search with extended search
+------------------------------------
+    Quick Search, with its powerful Extended search function,
+    enables searching through folder's messages.
+
+    Extended Search allows one to define criteria that messages must
+    have in order to match and be displayed in the summary view pane.
+    Search types titled From, Subject and To are self explanatory.
+    Search type extended allows one to use Sylpheed's powerful
+    filtering engine to select messages. Examples:
+    from regexpcase "foo"
+    subject regexp "Bug" & to regexp "sylpheed-claws"
+
+    Additionally, it is possible to use simpler yet equally
+    powerfull patterns for message selections. Mutt users will
+    immediately recognise most of the available patterns:
+
+    Pattern  Parameter  Selects
+    ----------------------------------------------------
+    a                   all messages
+    ag       #          messages whose age is greater than #
+    al       #          messages whose age is lower than #
+    b        S          messages which contain S in the message body
+    B        S          messages which contain S in the whole message
+    c        S          messages carbon-copied to S
+    C        S          message is either to: or cc: to S
+    D                   deleted messages
+    e        S          messages which contain S in the Sender field
+    E        S          true if execute "S" succeeds
+    f        S          messages originating from user S
+    F                   forwarded messages
+    h        S          messages which contain header S
+    i        S          messages which contain S in Message-Id header
+    I        S          messages which contain S in inreplyto header
+    L                   locked messages
+    n        S          messages which are in newsgroup S
+    N                   new messages
+    O                   old messages
+    r                   messages which have been replied to
+    R                   read messages
+    s        S          messages which contain S in subject
+    se       #          messages whose score is equal to #
+    sg       #          messages whose score is greater than #
+    sl       #          messages whose score is lower than #
+    Se       #          messages whose size is equal to #
+    Sg       #          messages whose size is greater than #
+    Ss       #          messages whose size is smaller than #
+    t        S          messages which have been sent to S
+    T                   marked messages
+    U                   unread messages
+    x        S          messages which contain S in References header
+    y        S          messages which contain S in X-Label header
+
+    # means number
+    S means regexp string
+
+    It is possible to use logical operators AND (&), OR (|) and
+    NOT (! or ~). Case sensitive search is achieved with %.
+    Examples:
+    T                  marked messages
+    U                  unread messages
+    f "john beavis"    messages from john beavis
+    %f "John Beavis"   messages from John Beavis (case sensitive)
+    ~s foo             messages which do not have foo in the subject
+    f foo & ~s bar     messages from foo that do not have bar in thesubject
+
+
+8. Custom toolbar
+-----------------
+
+   /Configuration/Preferences/Customize Toolbars lets you define the
+   toolbar you want. The configuration dialog enables you to set an icon,
+   an appropriate text, and map an action to it. Actions to choose
+   from are predefined. You can also have your "Sylpheed Actions" (refer
+   to "Actions" above) on your toolbar.
+
+   Example: 
+       * Configuration->Actions 
+               - add an entry "Dillo: dillo %p&"
+        * Configuration->Custom toolbar    
+               - select Sylpheed Actions Feature
+               - select "Dillo: dillo %p&" from drop down list
+               - choose an icon and click ok
+
+
+    
+9. Partial downloading of POP3 mails
+------------------------------------
+  Messages over the configured size limit, (/[Account preferences]/
+  Receive/Message size limit), will be partially retrieved. These
+  messages will have a Notice View displayed (above the Message View),
+  informing of the partially retrieved state and the total size of the
+  message. The Notice View will also contain two buttons, 'Mark for
+  download' and 'Mark for deletion'. If the user clicks 'Mark for
+  download', the message will be downloaded in full at the next message
+  retrieval, (and the partial one deleted); if the user checks 'Mark for
+  deletion' it will be removed from the server after the normal delay
+  as specified in the POP3 account's 'Receive' preferences.
+  If a user moves a partially retrieved message to the Trash folder 
+  it will be deleted on the server at the next retrieval after the 
+  Trash folder has been emptied.
+
+
+
+
+10. Other things that Claws does differently
+--------------------------------------------
+  Claws does a lot of things differently. Here is a quick run-down of
+  just a few of them:
+
+  * auto address replacement in summary view
+  
+    This matches a plain email address with a person in the address book.
+    This feature is enabled in /Configuration/Preferences/Common/Display
+    'Display sender using addressbook'
+
+  * manual selection of MIME types for attachments
+
+    You can change the MIME type of an attachment by right-clicking in the
+    attachment list, selecting Property in the menu. The MIME type list
+    is a combo box with the known MIME types.
+
+  * sharing mail folders   
+
+    You can also share or use shared mail folders. Right-click a folder and
+    select Properties. Change the Folder chmod setting.
+
+  * simplify subject string
+
+    It is possible to remove parts of subject string from the displayed
+    subject line.
+    Example:
+    True Subject: [Sylpheed-claws-users] This is a test
+    Displayed Subject: This is a test
+    Regexp: \[Sylpheed-claws-(devel|users)\]
+
     This is a per folder property. Right click on a folder and select
-    property, enable Simplify Subject RegExp check box. Example
-    regexp for the above is: \[Sylpheed-claws-(devel|users)\]
-    Another example for the Sylpheed mailing list (not claws!) is:
-    \[sylpheed:[0-9]{5}\]
+    Properties, enable Simplify Subject RegExp check box.
+
+  * new cache
 
-* new cache
------------------------------------
     New cache is  a new data cache structure for sylpheed, that will
     solve many of the problems sylpheed currently has with updates to
     flags.  But you will also notice a large speed gain when you open
     these folders. 
 
     New cache uses two new configuration parameters that can be
-    adjusted in ~/.sylpheed/sylpheedrc (no gui for them available yet).
+    adjusted in ~/[RCDIR]/sylpheedrc (no gui for them available yet).
 
     cache_max_mem_usage                (default: 4096)
        the maximum kB of memory sylpheed should use.
@@ -441,84 +590,169 @@ are hardly noticeable, but deserve mentioning:
     when you enter the folder. You have to update the folder manually,
     or activate the auto update setting in the options.
 
-There are a lot more options. If you find one, don't hesitate to
-mention it.
-
-* selective download, delete messages on server
------------------------------------
-    The selective download window lets you select messages, that
-    should be retrieved from or deleted on the server.
-    The selection can be automated by setting up a *global*
-    filtering rule (folder based rules are ignored), e.g
-      subject match "SPAM" delete_on_server
-    Next time, you retrieve the headers using selective download,
-    all messages that matched this criteria are marked.
-    NOTE: Selective download is a pop3 only feature and makes 
-         no sense if used as a folder processing filter.
-
-* Custom toolbar
-----------------
-   Configuration->Custom toolbar lets you define the toolbar 
-   you want. The configuration dialog enables you to set an icon,
-   an appropriate text and map an action to it. Actions to choose
-   from are predefined. You may as well have your "Sylpheed Actions"
-   (refer to "user definable actions" above) on your toolbar. 
-   Example: 
-       * Configuration->Actions 
-               - add an entry "Dillo: dillo %p&"
-        * Configuration->Custom toolbar    
-               - select Sylpheed Actions Feature
-               - select "Dillo: dillo %p&" from drop down list
-               - choose an icon and click ok
-       
-
-
-4. How to contribute
---------------------
-
-Sylpheed Main: 
-
-       submit it to the Sylpheed ML, Hiroyuki, or Paul Mangan
-       (for incorporation on the Sylpheed Patches page,
-        <http://www.thewildbeast.co.uk/sylpheed/>)
-
-Sylpheed Claws:
-
-       It is highly recommended to use the sourceforge project page
-       of claws. Check: 
-       http://sourceforge.net/tracker/?atid=384600&group_id=25528&func=browse
-
-       If that's too troublesome, either contact Paul Mangan or consider
-       posting to the sylpheed claws users mailing list.
-
-       Bugs can be reported in the same way; the recommended web page:
-       http://sourceforge.net/tracker/?group_id=25528&atid=384598
-
-       Of course you can also post to the sylpheed claws users
-       mailing list.
+  * SMTP Message Size Declaration
+    If the server supports it, oversize messages will not be sent and
+    the maximum allowed message size will be displayed in the log,
+    (/Tools/Log window/).
+
+  * Reply-finder
+    Clicking on the replied icon in the Status (S) column of the summary
+    view will attempt to find and display your reply that is stored in
+    your Outbox.
+
+  * pop before smtp authentication
+
+  * Automatic saving of message when composing
+
+  * signature in the message view can be coloured
+
+  * built-in gdb crash handler
+
+  * extra Font configuration
+
+  * message scoring
+
+  * 'hide read messages' feature
+
+  * Request Return-Receipt
+
+  * ability to change folder order
+
+  * 'ignore thread' marking
+
+  * message priority setting
+
+  * Automatic message drafting and cache saving on kill
+
+  * SSL certificate management and checking
+
+  * Indication of unread answers to marked mails:
+    '(!)' is appended to the folder name when a marked message
+    has a response
+
+  * address auto-completion includes a dynamic LDAP search
+
+  * address auro-completion works on nicknames and aliases
+
+  * Password encryption in config files is implemented using 
+    unix encrypt and setkey functions.
+   
+  This is not an exhaustive list.
+
+
+
+11. Tools
+--------- 
+  You will find all of these tools in the 'tools' directory:
+
+  acroread2sylpheed.pl 
+       send PDFs from Adobe Reader 7
+  calypso_convert.pl 
+       import mbox files exported by calypso
+  convert_mbox.pl
+       convert mbox format to MH format
+  eud2gc.py
+       convert a Eudora (v.3?) addressbook to vCard 
+       (GnomeCard) format
+  filter_conv.pl
+       convert sylpheed main's filter rules, (< 0.9.99),
+       into Claws' filtering format
+  freshmeat_search.pl
+       Actions script to lookup the selected text on
+       Freshmeat www.freshmeat.net using the configured
+       browser
+  gif2xface.pl
+       convert a gif file to an xface
+  google_msgid.pl
+       Actions script to lookup selected message-id on 
+       google using mozilla.
+  google_search.pl
+       Actions script to lookup up the selected text on
+       google using the configured browser
+  gpg-sign-syl
+       GnuPG cleartext-signing script for use with
+       Actions
+  kmail2sylpheed.pl
+       convert a Kmail addressbook to a Sylpheed
+       addressbook
+  kmail2sylpheed_v2.pl
+       new version of the address book conversion script
+       for newer versions of Kmail/Kaddressbook
+  maildir2sylpheed.pl
+       convert a maildir format mailbox into MH format
+  multiwebsearch.pl
+       search any searchable website for the selected text
+  nautilus2sylpheed.sh
+       enables sending files from the Nautilus file manager
+       to Sylpheed
+  OOo2sylpheed.pl
+       enable OpenOffice to send documents through
+       sylpheed
+  outlook2sylpheed.pl
+       convert an Outlook contacts list to a Sylpheed
+       addressbook
+  sylpheed-switcher
+       enable quick-switching between claws and main
+       in a non-destructive way
+  sylprint.pl
+       process a Sylpheed mail and print it using enscript
+       if available or lpr if not
+  tb2sylpheed
+       convert an addressbook exported from The Bat! into 
+       a Sylpheed addressbook
+  textviewer.sh
+       attempt to view an attachment as plain text
+  update-po 
+       translators' tool that eases the creation of 
+       *.po files
+  uudec
+       decode UUencoded mails, for use with Actions
+  kdeservicemenu/*
+       Service Menus for Konqueror to allow attaching files and
+       compressing/attaching files/directories to a new Compose
+       window
+
+
+12. How to contribute
+---------------------
+
+You are encourged to send patches via the Sylpheed-Claws sourceforge
+project's Patch Tracker.
+http://sourceforge.net/tracker/?atid=384600&group_id=25528&func=browse
+
+If that's too troublesome, either contact Paul Mangan
+<twb@users.sourceforge.net> or consider posting to the
+Sylpheed-Claws-users mailing list.
+http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-users
+
+Bugs can be reported with Claws' bugzilla at:
+http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/index.cgi
+
+Of course, you can also post to the Sylpheed-Claws-users mailing list.
 
 Also, we really try to incorporate good contributions, but sometimes we
 don't have enough time. If the contribution is really big, or requires
-a long time to stabilize, send a mail to Paul Mangan. We can probably
-arrange access to the Claws branch.
+a long time to stabilise, send a mail to Paul Mangan
+<twb@users.sourceforge.net>. We can probably arrange access to the
+Sylpheed-Claws CVS tree.
 
 
 
-5. How to request features
---------------------------
+13. How to request features
+---------------------------
 
-Ask around in both Sylpheed ML and Sylpheed Claws Users ML. Note
-that some developers may already thought about your feature, may
-perhaps be implementing it - or the feature was already discussed
-and rejected for whatever reason.  You might want to go ahead and 
-hack a patch for it. (That would be very cool!) Another
-possibility is to use the Feature Request Tracker at the
-sourceforge project page.
+Ask around in Sylpheed-Claws-users ML. Note that some developers may
+have already thought about your feature, may,perhaps, be implementing it,
+or the feature was already discussed and rejected for whatever reason.
+You might want to go ahead and hack a patch for it. (That would be very
+cool!) Another possibility is to use the Feature Request Tracker at the
+sourceforge project.
+http://sourceforge.net/tracker/?group_id=25528&atid=384601
 
 
 
-6. Installing Claws from CVS
-----------------------------
+14. Installing Claws from CVS
+-----------------------------
 
   a. Downloading
   --------------
@@ -526,12 +760,12 @@ sourceforge project page.
   To download the latest cvs cd to the directory where you wish to download
   to and type the following information:
 
-  cvs -d:pserver:anonymous@cvs.sylpheed-claws.sourceforge.net:/cvsroot/sylpheed-claws login
+  cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws login
 
   When prompted for a password press the RETURN key.
   After anonymously logging in:
 
-  cvs -z3 -d:pserver:anonymous@cvs.sylpheed-claws.sourceforge.net:/cvsroot/sylpheed-claws co sylpheed-claws 
+  cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws co -r gtk2 sylpheed-claws 
 
 
   b. Installing
@@ -546,8 +780,101 @@ sourceforge project page.
   You will need a full set of development tools installed to be able to run
   autogen.sh. See also ac/README.
 
-7. History
-----------
 
-TODO
 
+15. Release History
+-------------------
+
+GTK 2 Version
+-------------
+2005-05-09     1.9.9
+2005-03-18     1.9.6
+
+GTK 1 Version
+-------------
+2005-05-09     1.0.4a
+2005-03-24     1.0.4
+2005-03-10     1.0.3
+2005-02-08     1.0.1
+2005-01-17     1.0.0
+2004-12-06     0.9.13
+2004-09-27     0.9.12b
+2004-08-23     0.9.12a
+2004-06-28     0.9.12
+2004-05-31     0.9.11claws
+2004-03-08     0.9.10claws
+2004-02-06     0.9.9claws
+2003-12-19     0.9.8claws
+2003-11-26     0.9.7claws
+2003-10-02     0.9.6claws
+2003-09-10     0.9.5claws
+2003-08-04     0.9.4claws
+2003-07-12     0.9.3claws
+2003-05-24     0.9.0claws
+2003-03-12     0.8.11claws
+2003-02-12     0.8.10claws
+2003-01-24     0.8.9claws
+2002-12-26     0.8.8claws
+2002-12-23     0.8.7claws
+2002-11-25     0.8.6claws
+2002-10-07     0.8.5claws
+2002-09-22     0.8.3claws
+2002-08-28     0.8.2claws
+2002-07-30     0.8.1claws
+2002-07-23     0.8.0claws
+2002-06-15     0.7.8claws
+2002-05-18     0.7.6claws
+2002-04-28     0.7.5claws
+2002-03-11     0.7.4claws
+2002-02-19     0.7.2claws
+2002-02-14     0.7.1claws
+2002-01-14     0.7.0claws
+2001-12-16     0.6.6claws
+2001-10-16     0.6.5claws8
+2001-09-30     0.6.2claws
+2001-08-14     0.6.1claws
+2001-07-13     0.5.1claws
+2001-07-01     0.5.0claws3
+2001-06-16     0.4.99claws
+2001-05-29     0.4.99claws3
+2001-05-11     0.4.67claws1
+
+
+
+16. Useful links
+----------------
+Homepage
+    http://sylpheed-claws.sourceforge.net/
+Sylpheed-Claws for Windows homepage
+    http://sylpheed-claws.sourceforge.net/win32/
+FAQ
+    http://sylpheed-claws.sourceforge.net/phpwiki/
+Project page
+    http://sourceforge.net/projects/sylpheed-claws/
+Downloads
+    http://sourceforge.net/project/showfiles.php?group_id=25528
+External Plugins
+    http://sylpheed-claws.sourceforge.net/plugins.php
+Icon Themes
+    http://sylpheed-claws.sourceforge.net/themes.php
+CVS webview
+    http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/sylpheed-claws/sylpheed-claws/?only_with_tag=gtk2
+Users Mailing List subscription page
+    http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-users/
+Users Mailing List archive
+    http://sourceforge.net/mailarchive/forum.php?forum=sylpheed-claws-users/
+Commits Announcement List subscription page
+    http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-commits/
+Commits Announcement List archive
+    http://sourceforge.net/mailarchive/forum.php?forum=sylpheed-claws-commits/
+Bug Tracker
+    http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/index.cgi
+Feature Request Tracker
+    http://sourceforge.net/tracker/?group_id=25528&atid=384601
+Patch Tracker
+    http://sourceforge.net/tracker/?group_id=25528&atid=384600
+Internationalisation Status
+    http://sylpheed-claws.sourceforge.net/i18n.php
+
+
+