fix typo: kmail 1.4.7
[claws.git] / tools / README
index bb01dbf1a70acae3f8b787466f8cd4feafcd1494..ce1647de7c98f7c01b05a6768bd8036f45d6e43a 100644 (file)
@@ -1,4 +1,4 @@
-* calypso_import.pl
+* calypso_convert.pl
 
   WHAT IT DOES
 
@@ -16,7 +16,7 @@
     $mboxfile : name of exported mbox, e.g. 'mail.txt'
     $outdir   : name of the MH folder to create, e.g. 'Calypso'
   Run the script using
-    perl calypso_import.pl
+    perl calypso_convert.pl
   Finally, import that folder by either selecting "New mailbox" or
   moving it into your existing directory and recreate the folder
   structure manually (contentmenu from folderview).
   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
 
 
 -----------------------------------------------------------------------
 
-* 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>  
 
 -----------------------------------------------------------------------
 
 
 -----------------------------------------------------------------------
 
+* OOo2sylpheed.pl
+
+  WHAT IT DOES
+  
+  This perl script enables OpenOffice.org to send documents to sylpheed
+  as attachments.
+
+  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
+  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
 
 -----------------------------------------------------------------------
 
+* 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