Update script and doc from web's tools dir

[claws.git] / tools / README

diff --git a/tools/README b/tools/README
index d562f467e819df94a086616852c45a18d3e0f67a..c6310b5506063c53692da17027afc784c316b6c1 100644 (file)
--- a/tools/README
+++ b/tools/README
@@ -592,29 +592,33 @@ Other tools
   Contact: Paul Mangan <paul@claws-mail.org>
   
 
-* fix-date.sh
+* fix_date.sh
 
- WHAT IT DOES
-       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 %F
+  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 value replacement can be changed by editing
+  the script.
 
-  Contact: wwp <wwp@claws-mail.org>
+  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.
+
+  WORKS ON: selected message(s)
 
+  COMMAND: fix_date.sh %F
+
+  CONTACT: wwp <wwp@claws-mail.org>
 
 * mairix.sh
 
@@ -707,18 +711,25 @@ 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
-       utilities to make an effort to display it as text. For example
-               .doc                    antiword -w 72
-               .txt, .diff, .c, .h,
-                 .ic. .ec, .cc, .sh,
-                 .sed, .awk            cat
-               .html                   txt2htm or text2html
-               .xls, .sxc, .csv        xlscat -L
-               .rtf                    rtf2text
-               .pdf                    pdf2text %f -
-               .odt                    ooo2txt
-               .pl, .pm                perltidy -st -se or  cat
-               .bz2                    bzip2 -d < %f | strings
+       utilities to make an effort to display it as text.
+
+       $ textview.pl --list
+
+       will show available conversion, the top:
+
+         .awk          cat
+         .bin          strings
+         .bz2          bzip2 -d < %f | strings
+         .c            cat
+         .cc           cat
+         .csv          xlscat -L
+
+       If there are multiple alternatives available, they are listed in
+       the ordder they are tried, like for .xls:
+
+         .xls          xlscat -L
+         .xls          catdoc -x -dutf-8
+         .xls          wvText
 
   HOW TO USE IT
        Go to /Configuration/Message View/External Programs and enter the
@@ -726,7 +737,10 @@ Other tools
        Now when you right-click an attachment and choose 'Display as text'
        this script will be invoked.
 
-       
+       xlscat comes with the perl module Spreadsheet::Read, which is a
+       wrapper module over several parsers and supports ods, sxc, csv, xls,
+       xlsx, and sq.  See https://metacpan.org/release/Spreadsheet-Read
+
   Contact: H.Merijn Brand <h.m.brand@xs4all.nl>