fix typo: kmail 1.4.7

[claws.git] / tools / README

diff --git a/tools/README b/tools/README
index 588ce1828f1395622b23c3af5af52113b94522bb..ce1647de7c98f7c01b05a6768bd8036f45d6e43a 100644 (file)
--- a/tools/README
+++ b/tools/README
@@ -112,7 +112,10 @@
   WHAT IT DOES
 
   This perl script will convert an exported Kmail addressbook into a
-  Sylpheed addressbook.
+  Sylpheed 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.
 
   HOW TO USE IT
 
@@ -134,29 +137,35 @@
 
 -----------------------------------------------------------------------
 
-* ldif-to-xml.py
+* kmail2sylpheed_v2.pl
+
+  This script has been tested with Kmail 1.47 and KAddressBook 3.1beta1
 
   WHAT IT DOES
 
-  This python script converts the netscape ldif format address book to
-  the sylpheed xml format.
+  This perl script will convert a Kmail addressbook that has been
+  exported in csv format into a Sylpheed addressbook.
 
   HOW TO USE IT
 
-  Inside Netscape export your address book to a file.
-  From the command line, execute:
-
-      ./ldif-to-xml.py <path/filename>
+  (You must run sylpheed 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.
 
-  In case of trouble, just invoke your python interpreter directly:
+  If Sylpheed is running, close it.
 
-      python ldif-to-xml.py <path/filename>
+  From the command line, execute the following:
+ 
+       perl kmail2sylpheed_v2.pl --kmailfile=/path/to/addressbook.csv
+       
+  You can also use --help to see usage instructions.
 
-  Either way a file called addressbook.xml will be generated in the current
-  directory. This xml file should be merged with or simply placed in the
-  $HOME/.sylpheed directory.
+  Your Kmail addressbook data will now be contained in Sylpheed's
+  addressbook, under the name 'Kmail address book'.
 
-  Any problems, contact Rod Senra <rodrigo.senra@ic.unicamp.br>
+  Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>  
 
 -----------------------------------------------------------------------
 
@@ -197,6 +206,9 @@
 
   HOW TO USE IT
   
+  Edit line 29 of the script so that it contains the correct path:
+  exec "/usr/local/bin/sylpheed --attach $ARGV";
+  
   Start up OpenOffice.org.
   Go to 'Tools/Options/OpenOffice.org/External Programs'
   Enter the path to this script in the 'Program' box
@@ -288,6 +300,30 @@
 
 -----------------------------------------------------------------------
 
+* tb2sylpheed
+
+  WHAT IT DOES
+  
+  This perl script will convert an addressbook exported from The Bat! into 
+  a Sylpheed addressbook.
+
+  HOW TO USE IT
+
+  (You must run sylpheed at least once before running this script.)
+
+  If Sylpheed 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
+ 
+  The Bat! addressbook data will now be contained in Sylpheed's
+  addressbook, under the name 'The Bat! Address Book'.
+
+  Any questions, comments or problems, contact Urke MMI <urke@gmx.net>  
+
+-----------------------------------------------------------------------
 * update-po
 
   WHAT IT DOES