Sync Spanish manual
[claws.git] / tools / README
index 02d59916d807dcbea0159bd2b83f6873c1f1dbb8..25ef782251729dee5a54887e2b4bae8d4de65670 100644 (file)
@@ -4,38 +4,54 @@ Contents of the tools directory:
 --------------------------------------------------------------------------------
 
 Action scripts:
-  freshmeat_search.pl          Search freshmeat.net for selected text
+  freshmeat_search.pl           Search freshmeat.net for selected text
   google_msgid.pl               Search groups.google.com for selected message-id
-  google_search.pl             Search google.com for selected text
-  multiwebsearch.pl            Search any search engine for the selected text
-  textviewer.sh                        Attempt to view an attachment as plain text
+  google_search.pl              Search google.com for selected text
+  multiwebsearch.pl             Search any search engine for the selected text
+  textviewer.sh                 Attempt to view an attachment as plain text
   uudec                         Decode and display uuencoded images
+  uuooffice                     Decode uuencoded attachments and open them with
+                                OpenOffice
+  cm-reparent.pl                Fix thread parenting for two or more messages
 
 Addressbook conversion:
+  csv2addressbook.pl           Import Becky, Thunderbird, Kmail, Gmail and Fox
+                               Mail address books
   eud2gc.py                     Convert Eudora address book to Gnomecard
-  kmail2sylpheed.pl             Import a Kmail address book (KDE2)
-  kmail2sylpheed_v2.pl          Import a Kmail address book (KDE3)
-  outlook2sylpheed.pl           Import an Outlook generated contact list
-  tb2sylpheed                   Import The Bat! address books
-  vcard2xml.py                 Import an Evolution vCard
+  kmail2claws-mail.pl           Import a Kmail address book (KDE2)
+  kmail2claws-mail_v2.pl        Import a Kmail address book (KDE3)
+  mew2claws-mail.pl            Import a Mew address book
+  outlook2claws-mail.pl         Import an Outlook generated contact list
+  tb2claws-mail                 Import The Bat! address books
+  vcard2xml.py                  Import an Evolution vCard
 
 Mailbox conversion:
   calypso_convert.pl            Import mbox files with attachments from Calypso
-  convert_mbox.pl              Import mbox files
-  maildir2sylpheed.pl          Convert a maildir mailbox to MH format
-  tbird2syl.py                 Integrate a Thunderbird folder tree into Claws
+  convert_mbox.pl               Import mbox files
+  kmail-mailbox2claws-mail.pl   Convert a kmail mailbox to a Claws Mail mailbox
+  tbird2claws.py                Integrate a Thunderbird folder tree into Claws
 
 Other tools:
-  acroread2sylpheed.pl         Send PDFs from Adobe Reader 7
-  filter_conv_new.pl           Convert new-style Sylpheed filters to filtering
+  acroread2claws-mail.pl        Send PDFs from Adobe Reader 7
+  claws-mail-compose-insert-files.pl
+                                Insert files into a new Compose window
+  filter_conv_new.pl            Convert new-style Sylpheed filters to filtering
   filter_conv.pl                Convert old-style Sylpheed filters to filtering
-  nautilus2sylpheed.sh         Send files from Nautilus
-  OOo2sylpheed.pl               Send documents from OpenOffice.org
+  fix-date.sh                   Replace/Add a message's Date field
+  mairix.sh                     A wrapper to mairix, to enable global searches in
+                                mail folders
+  nautilus2claws-mail.sh        Send files from Nautilus
+  OOo2claws-mail.pl             Send documents from OpenOffice.org
+  popfile-link.sh               Open messages in POPFile control center to edit
+                                their status
   sylprint.pl                   Printing engine, explained in README.sylprint
-  update-po                     Update the .po files named on the command line.
+  textviewer.pl                 Display various attachments as text
+  thunderbird-filters-convertor.pl
+                                Convert Thunderbird filtering rules
 
 Extra tools:
   gif2xface.pl                  Convert a 48x48 GIF file to an X-Face header
+  update-po                     Update the .po files named on the command line.
 
 --------------------------------------------------------------------------------
 Detailed Descriptions:
@@ -44,11 +60,6 @@ Detailed Descriptions:
 Action scripts
 --------------
 
-* freshmeat_search.pl
-  WORKS ON: selection
-  COMMAND: |freshmeat_search.pl
-  Search freshmeat.net for selected text using the default Sylpheed-Claws browser
-
 * google_msgid.pl
   WORKS ON: selection
   COMMAND: |google_msgid.pl
@@ -58,33 +69,43 @@ Action scripts
 * google_search.pl
   WORKS ON: selection
   COMMAND: |google_search.pl
-  Search google.com for selected text using the default Sylpheed-Claws browser
+  Search google.com for selected text using the default Claws Mail browser
 
 * multiwebsearch.pl
   WORKS ON: selection
   see further down for details
 
+* textviewer.sh
+  WORKS ON: current message part
+  COMMAND: textviewer.sh %p |
+  Attempt to view an attachment as plain text
+
 * uudec
   WORKS ON: current message (or part of multipart message)
   COMMAND: uudec %f&
   Decode and display uuencoded images using uudecode.
 
-* textviewer.sh
-  WORKS ON: current message part
-  COMMAND: textviewer.sh %p |
-  Attempt to view an attachment as plain text
+* uuooffice
+  WORKS ON: current message (or part of multipart message)
+  COMMAND: uuooffice %f&
+  Decode uuencoded attachments and open them with OpenOffice
+
+* cm-reparent.pl
+  WORKS ON: selected messages (two or more)
+  COMMAND: cm-reparent.pl %F
+  Thread the selected messages based on date, old to new
 
-* More action examples can be found at
-  http://melvin.hadasht.free.fr/home/sylpheed/actions/
+* More action examples can be found at the Claws Mail FAQ
+  http://www.claws-mail.org/faq/index.php/Actions
 
 ** multiwebsearch.pl **
 
   WHAT IT DOES
        This is an Actions script that allows you to search
        websites for the selected text. It uses the default
-       Sylpheed-Claws browser as configured through Sylpheed
-       -Claws' GUI and specified in ~/.sylpheed-claws/sylpheedrc,
-       and a configuration file called multiwebsearch.conf.
+       Claws Mail browser as configured through Claws Mail's 
+       GUI and specified in ~/.claws-mail/clawsrc, and a
+       configuration file called multiwebsearch.conf.
        
   CONFIGURATION
        The configuration file takes the following format:
@@ -98,7 +119,7 @@ Action scripts
        is included.
        
   HOW TO USE IT
-       Copy 'multiwebsearch.conf' to ~/.sylpheed-claws/
+       Copy 'multiwebsearch.conf' to ~/.claws-mail/
        
        Configure an Action:
        a) pre-configured website 
@@ -114,12 +135,92 @@ Action scripts
        which you type one of your configured aliases
 
   
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
 --------------------------------------------------------------------------------
 
 Address book conversion
 -----------------------
 
+* csv2addressbook.pl
+
+  WHAT IT DOES
+       This perl script will import a Becky, Thunderbird, Kmail, Gmail and
+       Fox Mail address book.
+
+  HOW TO USE IT
+       (You must run claws-mail at least once before running this script.)
+
+       Becky >= 2.41
+       -------------
+       In Becky you need to do a CSV full export with titles of your
+       address book.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=becky --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'Becky address book'.
+
+
+       Thunderbird >= 2.0.0.6
+       ----------------------
+       In Thunderbird you need to export your address book as 'comma
+       separated'.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=thunderbird --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'Thunderbird address book'.
+
+       Kmail >= 1.9.7 / Kaddressbook >= 3.5.7
+       --------------------------------------
+       In Kaddressbook you need to export your address book as 'CSV List'.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=kmail --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'Kmail address book'.
+
+       WARNING: Kmail/Kaddressbook has a bug whereby it exports badly
+       formatted CSV if the values are quoted.
+
+       Gmail
+       -----
+       In the Gmail web interface you need to export your address book
+       as Outlook CSV format.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=gmail --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'gmail address book'.
+
+       Fox Mail
+       --------
+       Export your Fox Mail address book as CSV with all possible headers.
+
+       Run the script with the following options:
+
+       perl csv2addressbook.pl --type=foxmail --csv=/full/path/to/file.csv
+
+       Addtionally you can use the option '--name="My address book"', if
+       you don't use this option the new Claws address book will be
+       called 'foxmail address book'.
+
+       You can also run the script with '--help' to get a brief usage message.
+
+  Contact: Paul Mangan <paul@claws-mail.org>
+
 * eud2gc.py
 
   WHAT IT DOES
@@ -137,67 +238,88 @@ Address book conversion
 
   Contact: Jeroen Versteeg <j.m.versteeg@student.utwente.nl>
 
-* kmail2sylpheed.pl
+* kmail2claws-mail.pl
 
   WHAT IT DOES
        This perl script will convert an exported Kmail addressbook into a
-       Sylpheed-Claws addressbook. If your version of Kmail is 1.37 or
+       Claws Mail addressbook. If your version of Kmail is 1.37 or
        greater and/or your version of KAddressBook is 3.1beta1 or greater,
        or this script mixes up your definitions and their related data, use
-       'kmail2sylpheed_v2.pl' instead.
+       'kmail2claws-mail_v2.pl' instead.
 
   HOW TO USE IT
-       (You must run sylpheed-claws at least once before running this script.)
+       (You must run claws-mail at least once before running this script.)
 
        In Kmail's Address book choose '/File/Export List'. This will export
        your Kmail address book data to a *.csv file.
 
-       If Sylpheed-Claws is running, close it.
+       If Claws Mail is running, close it.
 
        From the command line, execute the following:
  
-               perl kmail2sylpheed.pl --kmailfile=/path/to/addressbook.csv
+               perl kmail2claws-mail.pl --kmailfile=/path/to/addressbook.csv
 
-       Your Kmail address book data will now be contained in Sylpheed-Claws'
+       Your Kmail address book data will now be contained in Claws Mail'
        address book, under the name 'Kmail Address Book'.
 
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
     
 
-* kmail2sylpheed_v2.pl
+* kmail2claws-mail_v2.pl
 
   This script has been tested with Kmail 1.4.7 and KAddressBook 3.1beta1
 
   WHAT IT DOES
        This perl script will convert a Kmail address book that has been
-       exported in csv format into a Sylpheed-Claws address book.
+       exported in csv format into a Claws Mail address book.
 
   HOW TO USE IT
-       (You must run sylpheed-claws at least once before running this script.)
+       (You must run claws-mail at least once before running this script.)
   
        Open Kmail's Addressbook, /File/Address Book
        In Kmail's Addressbook choose '/File/Export/Export List...'. This 
        will allow you to export your Kmail addressbook data to a *.csv file.
 
-       If Sylpheed-Claws is running, close it.
+       If Claws Mail is running, close it.
 
        From the command line, execute the following:
  
-               perl kmail2sylpheed_v2.pl --kmailfile=/path/to/addressbook.csv
+               perl kmail2claws-mail_v2.pl --kmailfile=/path/to/addressbook.csv
        
        You can also use --help to see usage instructions.
 
-       Your Kmail addressbook data will now be contained in Sylpheed-Claws'
+       Your Kmail addressbook data will now be contained in Claws Mail'
        addressbook, under the name 'Kmail address book'.
 
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>  
+  Contact: Paul Mangan <paul@claws-mail.org>
+
+* mew2claws-mail.pl
 
+  WHAT IT DOES
+       This perl script will convert a Mew address book into a Claws Mail
+       address book.
 
-* outlook2sylpheed.pl
+  HOW TO USE IT
+       (You must run claws-mail at least once before running this script.)
+  
+       If Claws Mail is running, close it.
+
+       From the command line, execute the following:
+               perl mew2claws-mail.pl --mew-addressbook=/path/to/mew/addressbook
+       
+       You can also use --help to see usage instructions.
+
+       Your Mew addressbook data will now be contained in Claws Mail's
+       addressbook, under the name 'Mew Address Book'.
+
+  Contact: Jérôme Lelong <jerome.lelong@gmail.com>
+
+* outlook2claws-mail.pl
 
   WHAT IT DOES
        This perl script converts an Outlook generated contact list into a 
-       Sylpheed-Claws XML address book.
+       Claws Mail XML address book.
 
   HOW TO USE IT
        For text files:
@@ -205,22 +327,22 @@ Address book conversion
        You must export Outlook Express contact list as TXT file, choosing
        only "Name" and "Address" fields to export.
 
-       You must exit Sylpheed-Claws before converting the contact list.
+       You must exit Claws Mail before converting the contact list.
 
        From the command line, execute the following:
 
-               outlook2sylpheed.pl fullpathname
+               outlook2claws-mail.pl fullpathname
 
        For csv files:
        -------------
        You must export Outlook contact list as CSV file, choosing ALL the
        fields available for exporting.
 
-       You must exit Sylpheed-Claws before converting the contact list.
+       You must exit Claws Mail before converting the contact list.
 
        From the command line, execute the following:
 
-               outlook2sylpheed.pl --csv fullpathname
+               outlook2claws-mail.pl --csv fullpathname
 
   LIMITATIONS
        For text files only works with fields described above. If you have 
@@ -228,31 +350,31 @@ Address book conversion
        script.
 
        For csv files you must export all fields (but only non empty fields
-       are added to the created Sylpheed-Claws address book) and the number
+       are added to the created Claws Mail address book) and the number
        of fields expected is harcoded. Look for the $nboffields variable in
        the script and change its value if you are sure you exported all
        fields and script gives the 'unknown csv file format' error.
 
-  Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
+  Contact: Ricardo Mones <ricardo@mones.org>
 
 
-* tb2sylpheed
+* tb2claws-mail
 
   WHAT IT DOES
        This perl script will convert an address book exported from The Bat! 
-       into a Sylpheed-Claws address book.
+       into a Claws Mail address book.
 
   HOW TO USE IT
-       (You must run sylpheed-claws at least once before running this script.)
+       (You must run claws-mail at least once before running this script.)
 
-       If Sylpheed-Claws is running, close it.
+       If Claws Mail is running, close it.
 
        Export The Bat! Address Book to CSV file format with all fields 
        selected to YES and then start:
 
-               tb2sylpheed --tbfile=/full/path/to/thebat/addressbook.csv
+               tb2claws-mail --tbfile=/full/path/to/thebat/addressbook.csv
  
-       The Bat! addressbook data will now be contained in Sylpheed-Claws'
+       The Bat! addressbook data will now be contained in Claws Mail'
        addressbook, under the name 'The Bat! Address Book'.
 
   Contact: Urke MMI <urke@gmx.net>  
@@ -261,13 +383,13 @@ Address book conversion
 * vcard2xml.py
 
   WHAT IT DOES
-       This python script will convert an Evolution vCard into a Sylpheed-Claws
+       This python script will convert an Evolution vCard into a Claws Mail
        address book.
 
   HOW TO USE IT
-       (You must run sylpheed-claws at least once before running this script.)
+       (You must run claws-mail at least once before running this script.)
 
-       If Sylpheed-Claws is running, close it.
+       If Claws Mail is running, close it.
        From the command line, execute the following:
 
                vcard2xml.py source_file [destination_file]
@@ -317,7 +439,7 @@ Mailbox conversion
 
   WHAT IT DOES
        This perl script converts an mbox directory's contents into 
-       Sylpheed-Claws' MH format.
+       Claws Mail' MH format.
   
   HOW TO USE IT
   
@@ -325,54 +447,52 @@ Mailbox conversion
         
                perl convert_mbox.pl MBOX MH_DIR
                
-       Move the outputted MH_DIR and its contents into your Sylpheed-Claws
-       Mail folder; in Sylpheed-Claws right-click the top-level folder and
+       Move the outputted MH_DIR and its contents into your Claws Mail
+       Mail folder; in Claws Mail right-click the top-level folder and
        choose 'Rebuild folder tree' from the popup menu.
 
   Contact: Fred Marton <Fred.Marton@uni-bayreuth.de>
 
-* maildir2sylpheed.pl
+* kmail-mailbox2claws-mail.pl
 
   WHAT IT DOES
-       This perl script converts a mailbox in maildir format into
-       Sylpheed-Claws' MH format.
+       This perl script converts a kmail mailbox  into Claws Mail' mailbox.
   
   HOW TO USE IT
   
-       Exit Sylpheed-Claws if running.
+       Exit Claws Mail if running.
        
        Run the script using:
         
-               perl maildir2sylpheed.pl --kmaildir=mail_folder_name
+               kmail-mailbox2claws-mail.pl --kmaildir=/full/path/to/kmail/mailbox
                
-       Start Sylpheed-Claws and right-click the toplevel mailbox, i.e
+       Start Claws Mail and right-click the toplevel mailbox, i.e
        "Mailbox (MH)", and select 'Rebuild folder tree'.
        You may also need to run '/File/Folder/Check for new messages
        in all folders'
-       Your maildir directory will be backed-up.
        
        Additional options:
                --debug         debug mode
                --dry-run       test mode, nothing is actually written
                --help          brief usage info
        
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
 
-* tbird2syl.py
+* tbird2claws.py
 
   WHAT IT DOES
        This python script integrates a Thunderbird folder tree into 
-        Sylpheed-Claws.
+        Claws Mail.
   
   HOW TO USE IT
   
        The script receives two parameters from command-line:
-       <Thunderbird folder path> <Sylpheed folder path>
+       <Thunderbird folder path> <Claws Mail folder path>
 
        The best way to use it is to go to inside your Thunderbird
        root mailfolder directory and invoke it as:
 
-               <path>\python2.4 <path>\tbird2syl.py . <path to sylpheed>\Mail
+               <path>\python2.4 <path>\tbird2claws.py . <path to Claws Mail>\Mail
 
   Contact: Aleksandar Urosevic aka Urke MMI <urke@gmx.net>
 
@@ -381,32 +501,55 @@ Mailbox conversion
 Other tools
 -----------
 
-* acroread2sylpheed.pl
+* acroread2claws-mail.pl
 
   WHAT IT DOES
        This perl script enables Adobe Reader 7 to send documents to
-       Sylpheed-Claws as attachments.
+       Claws Mail as attachments.
 
   HOW TO USE IT
-       Make sure that the script is executable (chmod +x acroread2sylpheed.pl)
+       Make sure that the script is executable (chmod +x acroread2claws-mail.pl)
        Start up Adobe Reader 7 (acroread)
        Go to /Edit/Preferences/SendMail
        Select any email client except 'System Mail (mail)'
        Enter the path to this script in the alternate location box  
 
        You can then use 'File/Email' or the Email toolbar button to launch
-       sylpheed-claws (if not already launched) and open a new compose window
+       claws-mail (if not already launched) and open a new compose window
        with the PDF attached.
   
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
+
+* claws-mail-compose-insert-files.pl
 
+  WHAT IT DOES
+       This script enables inserting files into the message body of a new 
+       Claws Mail Compose window from the command line. Additionally To,
+       Cc, Bcc, Subject and files to attach to the message can be specified. 
+
+  HOW TO USE IT
+       claws-mail-compose-insert-files.pl [options]
+       Options:
+               --help -h
+               --to "Person One <mail@address.net>"
+               --cc "Person One <mail@address.net>"
+                       --bcc "Person One <mail@address.net>"
+               --subject "My subject"
+               --attach FILE
+               --insert FILE
+
+       For multiple recipients separate the addresses with ','
+       e.g. --to "Person One <mail@address.net>,Person Two <mail2@address.net>"
+       --attach and --insert can be used multiple times
+  
+  Contact: Paul Mangan <paul@claws-mail.org>
 
 * filter_conv_new.pl
 
   WHAT IT DOES
        This perl script provides easy conversion of your filtering rules from
        sylpheed's new filter system (>= 0.9.99) to the filtering system used in
-       sylpheed-claws. (Disabled rules are ignored)
+       Claws Mail.
        It reads '~/.sylpheed-2.0/filter.xml' or '~/.sylpheed/filter.xml' and
        writes '~/[CLAWS CONFIG DIR]/matcherrc'
   
@@ -421,7 +564,7 @@ Other tools
   REQUIREMENTS
        XML::SimpleObject
 
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
   
 
 * filter_conv.pl
@@ -429,8 +572,8 @@ Other tools
   WHAT IT DOES
        This perl script provides easy conversion of your filtering rules
        from sylpheed's old filter system (< 0.9.99) to the filtering system
-       used in sylpheed-claws.
-       It reads '~/.sylpheed/filterrc' and writes '~/.sylpheed-claws/matcherrc'
+       used in Claws Mail.
+       It reads '~/.sylpheed/filterrc' and writes '~/.claws-mail/matcherrc'
   
   HOW TO USE IT
        Issue the following command from the 'tools' directory:
@@ -440,10 +583,52 @@ Other tools
        That's it, the new filtering system is now implemented with your
        previous rules applied.
 
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
   
 
-* nautilus2sylpheed.sh
+* fix-date.sh
+
+ WHAT IT DOES
+       Add a 'Date:' header to the selected email(s) when such header is 
+       missing. The correct date is guessed from other headers that contain 
+       timestamp information (preferred: Fetchinfo header if found) or from 
+       the file or system date as a fallback. The order or preference for the
+       date valuereplacement can be changed by editing the script.
+       This script can be used to fix messages that show non RFC-compliant
+       Date headers as well.
+       X-Original-Date is always added too if not already existing (if so,
+       it's left untouched), to keep track of the original value if any.
+       An existing Date: header is not overwritten unless you use the --force
+       switch.
+       Non RFC-compliant dates can be overwritten using the --rfc switch. Use
+       --strict to use strict RFC matching patterns for date values in other
+       headers.
+       
+  HOW TO USE IT
+       fix_date.sh %F
+
+  Contact: wwp <wwp@claws-mail.org>
+
+
+* mairix.sh
+
+ WHAT IT DOES
+       It's a wrapper to mairix, a tool that makes indexed searches
+       and shows search results in a virtual folder. Maildir, MH and
+       mbox formats are supported, see:
+       http://www.rpcurnow.force9.co.uk/mairix/
+
+  HOW TO USE IT
+       mairix.sh
+       mairix.sh <mairix rcfile> [<mairix options>..]
+    
+    For instance:    
+    mairix.sh ~/.mairixrc s:word1,word2
+
+  Contact: wwp <wwp@claws-mail.org>
+
+
+* nautilus2claws-mail.sh
 
   WHAT IT DOES
        This script will recursively attach a number of selected 
@@ -452,23 +637,23 @@ Other tools
   HOW TO USE IT
        Copy the script to $HOME/.gnome2/nautilus-scripts, chmod u+x, 
        and restart nautilus (killall -9 nautilus). You will now have 
-       a right-click menu item: '/Scripts/nautilus2sylpheed.sh'
+       a right-click menu item: '/Scripts/nautilus2claws-mail.sh'
        
   Contact: Reza Pakdel <hrpakdel@cpsc.ucalgary.ca>
 
 
-* OOo2sylpheed.pl
+* OOo2claws-mail.pl
 
   WHAT IT DOES
        This perl script enables OpenOffice.org to send documents to
-       Sylpheed-Claws as attachments.
+       Claws Mail as attachments.
 
   HOW TO USE IT
     OpenOffice.org Version 2.0
     ----------------------------
        This script is not needed for OOo version 2, which can work
-       directly with Sylpheed-Claws.
-       Go to 'Tools/Options/Internet/E-mail' and enter 'sylpheed-claws'
+       directly with Claws Mail.
+       Go to 'Tools/Options/Internet/E-mail' and enter 'claws-mail'
        in the box.
 
     OpenOffice.org Version 1.1.0
@@ -477,42 +662,105 @@ Other tools
        Go to 'Tools/Options/OpenOffice.org/External Programs'
        Select either ''Mozilla 1.x (Option 1)', or 
        'Netscape 6.x - 7.0 (Option 1)' from the 'Program' selection
-       Enter the path to OOo2sylpheed.pl in the 'Path' box
+       Enter the path to OOo2claws-mail.pl in the 'Path' box
        or select it by clicking on the '...' button.
     
        You can then use 'File/Send/Document as email' to launch
-       sylpheed-claws (if not already launched) and open a new compose
+       claws-mail (if not already launched) and open a new compose
        window with the document attached.
 
     OpenOffice.org Version 1.0
     --------------------------
        Start up OpenOffice.org.
        Go to 'Tools/Options/OpenOffice.org/External Programs'
-       Enter the path to OOo2sylpheed.pl in the 'Program' box
+       Enter the path to OOo2claws-mail.pl in the 'Program' box
        or select it by clicking on the '...' button.
 
 
-  Contact: Paul Mangan <claws@thewildbeast.co.uk>
+  Contact: Paul Mangan <paul@claws-mail.org>
 
 
-* update-po
+* popfile-link.sh
+
+ WHAT IT DOES
+       Open selected messages in POPFile control center to edit their
+       status. Requires that POPFile is running and that the messages
+       have been processed by it (X-POPFile-Link: header is expected).
+       POPFile control center opens with the web browser set in
+       Claws Mail prefs.
+
+  HOW TO USE IT
+       popfile-link.sh <filename> [<filename>..]
+    
+
+  Contact: wwp <wwp@claws-mail.org>
+
+
+* textviewer.pl
 
   WHAT IT DOES
-       This script is a message catalog translator's tool, it updates the .po 
-       files named on the command line.
+       This script tries to recognise an attachment by using the 'file'
+       command and/or the file extension and then uses the available
+       utilities to make an effort to display it as text. For example
+               .doc                    antiword -w 72
+               .txt, .diff, .c, .h,
+                 .ic. .ec, .cc, .sh,
+                 .sed, .awk            cat
+               .html                   txt2htm or text2html
+               .xls, .sxc, .csv        xlscat -L
+               .rtf                    rtf2text
+               .pdf                    pdf2text %f -
+               .odt                    ooo2txt
+               .pl, .pm                perltidy -st -se or  cat
+               .bz2                    bzip2 -d < %f | strings
 
   HOW TO USE IT
-       This script needs to be copied to and run from the 'po' directory.
-  
-               ./update-po lang.po lang2.po ...
+       Go to /Configuration/Message View/External Programs and enter the
+       path to the script in the "Command for 'Display as text'" box.
+       Now when you right-click an attachment and choose 'Display as text'
+       this script will be invoked.
 
-       to update one or more <yourlang>.po files from the sourcecode files
-        named in POTFILES.in. The old .po file is save in a .po.old file.
+       
+  Contact: H.Merijn Brand <h.m.brand@xs4all.nl>
 
-       For example, when you want to update fr.po, run ./update-po fr.po, 
-       then edit fr.po to update your translation.
 
-  Contact: Wilbert Berendsen <wilbert@oswf.org>
+* thunderbird-filters-convertor.pl
+
+  WHAT IT DOES
+       This perl script converts Thunderbird filtering rules into Claws Mail
+       filtering rules. It can be run several times, once for each filter
+       configuration file in Thunderbird.
+
+  HOW TO USE IT
+       The script takes 3 arguments:
+
+       --tbird-file=PATH TO FILE       The full path to the file to be converted
+       --mailbox-name=NAME             The name of the Claws Mail mailbox
+       --account-name=NAME             The name of the account to be used (optional)   
+
+       --tbird-file must point to the Thunderbird filter file (msgFilterRules.dat)
+       that you want to convert, it must contain the full path to the file.
+       --mailbox-name should be given the name of your mailbox in Claws Mail, e.g.
+       if the top-level folder is 'Mailbox (MH)' then this option should be
+       'Mailbox'.
+       --account-name is optional, only needed if you are creating account-specific
+       rules. This is the name of your account in Claws Mail, which should
+       correspond to an account that you had in Thunderbird, e.g. the acount whose
+       rules you are converting.
+
+       This script presumes that your folder hierarchy in Claws Mail matches the
+       one that you had in Thunderbird. If you used the tbird2claws.py script to
+       convert your Thunderbird mailbox, then the folder hierarchy should match.
+
+       If the Claws Mail filtering configuration file (matcherrc) does not exist,
+       the script will create it; if it does exist, the newly converted rules will
+       be appended to it.
+
+  REQUIREMENTS
+       Getopt::Long
+       URI::Escape
+
+  Contact: Paul Mangan <paul@claws-mail.org>
 
 --------------------------------------------------------------------------------
 
@@ -524,9 +772,9 @@ Extra tools
   WHAT IT DOES
        This perl script converts a monochrome (1 bit) 48x48 pixels GIF file
        into an X-Face graphic suitable for inclusion into custom headers of
-       Sylpheed-Claws. An X-Face allows to quickly identify (or be identified
-       as) the sender of a mail message in a xface-capable MUA (like sylpheed
-       -claws).
+       Claws Mail. An X-Face allows to quickly identify (or be identified
+       as) the sender of a mail message in a xface-capable MUA (like Claws
+       Mail).
 
   HOW TO USE IT
        After obtaining the desired image for your X-Face you should:
@@ -541,16 +789,39 @@ Extra tools
                ./gif2xface < filename.gif > filename.xface
 
        In filename.xface will be the X-Face header ready to use.
-       You can add a custom header in Sylpheed-Claws through Configuration->
+       You can add a custom header in Claws Mail through Configuration->
        Preferences per account, "Send" tab, check "Add user-defined header"
-       then "Edit..." if you want to add it via Sylpheed -Claws interface, or do
+       then "Edit..." if you want to add it via the Claws Mail interface, or do
 
-               echo "0:" `cat filename.xface` > ~/.sylpheed-claws/customheaderrc
+               echo "0:" `cat filename.xface` > ~/.claws-mail/customheaderrc
 
        if you want to create the custom headers file yourself (Warning: this
        method is valid only if you don't have any other custom header set or
        they will be lost!).
 
-  Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
+  Contact: Ricardo Mones <ricardo@mones.org>
+
+
+* update-po
+
+  WHAT IT DOES
+       This script is a message catalog translator's tool, it updates the .po 
+       files named on the command line.
+
+  HOW TO USE IT
+       This script needs to be copied to and run from the 'po' directory.
+  
+               ./update-po lang.po lang2.po ...
+
+       to update one or more <yourlang>.po files from the sourcecode files
+        named in POTFILES.in. The old .po file is save in a .po.old file.
+
+       For example, when you want to update fr.po, run ./update-po fr.po, 
+       then edit fr.po to update your translation.
+
+  Contact: Wilbert Berendsen <wilbert@oswf.org> or the Claws Mail Team
 
 --------------------------------------------------------------------------------
+This file is Copyright 1999-2014 by the Claws Mail team.
+See accompanying COPYING file for license details.
+See each included script for copyright and license details.