sync 098claws
[claws.git] / tools / README
index 42166f649c84e39f5f29e187518f8cbdfd7d1b9f..e9969eea8bcd7af5288e918cad5616c2c3f35f66 100644 (file)
@@ -17,10 +17,12 @@ Addressbook conversion:
   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
 
 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
 
 Other tools:
   filter_conv.pl                Convert old-style filters to new filtering
@@ -32,7 +34,7 @@ Other tools:
 
 Extra tools:
   gif2xface.pl                  Convert a 48x48 GIF file to an X-Face header
-  launch_phoenix               Open URLs in Phoenix
+  launch_firebird              Open URLs in mozilla-firebird
 
 --------------------------------------------------------------------------------
 Detailed Descriptions:
@@ -254,6 +256,30 @@ Address book conversion
 
   Contact: Urke MMI <urke@gmx.net>  
 
+
+* vcard2xml.py
+
+  WHAT IT DOES
+       This python script will convert an Evolution vCard into a Sylpheed
+       address book.
+
+  HOW TO USE IT
+       (You must run sylpheed at least once before running this script.)
+
+       If Sylpheed is running, close it.
+       From the command line, execute the following:
+
+               vcard2xml.py source_file [destination_file]
+       When only <source_file> is specified it will overwrite (and
+       create a backup of) the existing addressbook. 
+       When both arguments are suplied it will create a new additional 
+       addressbook named as <destination_file>.
+       If the script encounters an error it will attempt to roll back
+       the changes and restore the original files.
+
+  Contact: Bogdan Sumanariu <bsumanariu@one5.ro> 
+
 --------------------------------------------------------------------------------
 
 Mailbox conversion
@@ -304,6 +330,32 @@ Mailbox conversion
 
   Contact: Fred Marton <Fred.Marton@uni-bayreuth.de>
 
+* maildir2sylpheed.pl
+
+  WHAT IT DOES
+       This perl script converts a mailbox in maildir format into
+       Sylpheed's MH format.
+  
+  HOW TO USE IT
+  
+       Exit Sylpheed if running.
+       
+       Run the script using:
+        
+               perl maildir2sylpheed.pl --kmaildir=mail_folder_name
+               
+       Start Sylpheed 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>
 --------------------------------------------------------------------------------
 
 Other tools
@@ -479,17 +531,17 @@ Extra tools
   Contact: Ricardo Mones Lastra <mones@aic.uniovi.es>
 
 
-* launch_phoenix
+* launch_firebird
 
   WHAT IT DOES
-       Check for a running phoenix process and and open a new tab with a 
-       given URL, or execute phoenix with that URL
+       Check for a running mozilla-firebird process and and open a new tab 
+       with a given URL, or execute mozilla-firebird with that URL
   
   HOW TO USE IT  
        In Common Preferences move to the 'Other' tab and enter the
        following in the 'Web browser' box
   
-       launch_phoenix '%s'
+       launch_firebird '%s'
   
   Contact: Mohammed Sameer <Uniball@linux-egypt.org>