Support adding domains from a file

[claws.git] / tools / README

diff --git a/tools/README b/tools/README
index b0f5792c3a11b38fdba4ac0c7d63802d218ea5c3..05bccc6a75c75ed53df79e96b6f39d39db32f846 100644 (file)
--- a/tools/README
+++ b/tools/README
@@ -14,7 +14,8 @@ Action scripts:
                                 OpenOffice
 
 Addressbook conversion:
-  csv2addressbook.pl           Import Becky or Thunderbird address books
+  csv2addressbook.pl           Import Becky, Thunderbird, Kmail, Gmail and Fox
+                               Mail address books
   eud2gc.py                     Convert Eudora address book to Gnomecard
   kmail2claws-mail.pl           Import a Kmail address book (KDE2)
   kmail2claws-mail_v2.pl        Import a Kmail address book (KDE3)
@@ -142,8 +143,8 @@ Address book conversion
 * csv2addressbook.pl
 
   WHAT IT DOES
-       This perl script will import a Becky address book and a Thunderbird
-       address book.
+       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.)
@@ -175,6 +176,46 @@ Address book conversion
        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>
@@ -313,7 +354,7 @@ Address book conversion
        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>
 
 
 * tb2claws-mail
@@ -547,14 +588,23 @@ Other tools
 * fix-date.sh
 
  WHAT IT DOES
-       It will replace the Date: value w/ the one picked up from
-       more recent Received: field if this field resides in one
-       line. Otherwise, it will take the file modification time
-       (using a RFC 2822-compliant form). If no X-Original-Date already
-       exist, the former Date value will be set in such field.
-
+       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 <filename> [<filename>..]
+       fix_date.sh %F
 
   Contact: wwp <wwp@claws-mail.org>
 
@@ -649,7 +699,7 @@ Other tools
 
   WHAT IT DOES
        This script tries to recognise an attachment by using the 'file'
-       command and/or the file extension and then uses the available Linux
+       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,
@@ -748,7 +798,7 @@ Extra tools
        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
@@ -771,3 +821,6 @@ Extra tools
   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.