add The Bat! addressbook conversion script

[claws.git] / tools / README

diff --git a/tools/README b/tools/README
index 0891a577f1e5b6578829e9b248e51c5912970b95..6d617f1ba93a77f18324d30d5a25c3fc6cfb6b10 100644 (file)
--- a/tools/README
+++ b/tools/README
@@ -134,32 +134,6 @@
 
 -----------------------------------------------------------------------
 
-* ldif-to-xml.py
-
-  WHAT IT DOES
-
-  This python script converts the netscape ldif format address book to
-  the sylpheed xml format.
-
-  HOW TO USE IT
-
-  Inside Netscape export your address book to a file.
-  From the command line, execute:
-
-      ./ldif-to-xml.py <path/filename>
-
-  In case of trouble, just invoke your python interpreter directly:
-
-      python ldif-to-xml.py <path/filename>
-
-  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.
-
-  Any problems, contact Rod Senra <rodrigo.senra@ic.unicamp.br>
-
------------------------------------------------------------------------
-
 * newscache_clean.pl
 
   WHAT IT DOES AND WHY IT DOES IT
@@ -188,6 +162,57 @@
 
 -----------------------------------------------------------------------
 
+* OOo2sylpheed.pl
+
+  WHAT IT DOES
+  
+  This perl script enables OpenOffice.org to send documents to sylpheed
+  as attachments.
+
+  HOW TO USE IT
+  
+  Start up OpenOffice.org.
+  Go to 'Tools/Options/OpenOffice.org/External Programs'
+  Enter the path to this script in the 'Program' box
+  or select it by clicking on the '...' button.
+
+  You can then use 'File/Send/Document as email' to launch sylpheed
+  (if not already launched) and open a new compose window with the
+  document attached.
+
+  Tested with OpenOffice.org version 1.0
+  Any questions, comments or problems, contact Paul <claws@thewildbeast.co.uk>
+
+-----------------------------------------------------------------------
+
+* outlook2sylpheed.pl
+
+  WHAT IT DOES
+  
+  This perl script converts an Outlook generated contact list into a 
+  Sylpheed XML address book.
+
+  HOW TO USE IT
+  
+  You must export Outlook Express contact list as TXT file, choosing
+  only "Name" and "Address" fields to export.
+
+  You must exit Sylpheed before converting the contact list.
+
+  From the command line, execute the following:
+
+       outlook2sylpheed.pl fullpathname
+
+  BUGS
+
+  Only works with fields described above. If you have more complex
+  examples send them to me, and I'll try to enhance the script.
+
+  Any questions, comments or problems, contact 
+  Ricardo Mones Lastra <mones@aic.uniovi.es>
+
+-----------------------------------------------------------------------
+
 * sylpheed-switcher
 
   WHAT IT DOES
@@ -237,6 +262,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