1.0 (20200625)

    - When replacing text-versus-HTML alternatives, choose the translated HTML alternative instead
    - Added -Y option: Choose the plain text alternative over the translated HTML (unless vestigial)
    - Added -F types option: Save attachments to files on disk (list of mimetypes/exts/filenames)
    - Added -G path option: Directory to save attachments in (for use with -F)
    - Added -C spec option: Custom attachment translations (list of mimetype_or_ext:ext:command)
    - Added Makefile, README.md, COPYING, LICENSE, INSTALL
    - Added translation of .docx and .xlsx attachments using docx2txt and xlsx2csv
    - Preserve original Content-Disposition creation-date/modification-date/read-date parameters
    - Fixed bug: Wasn't preserving original Content-Type charset parameter for text/* translations
    - Added .bat and .ps1 to the list of MS Windows executable filename extensions
    - Added self-identifying and legal information to the help message
    - Changed default mimetype for csv attachments inside winmail.dat to text/csv (was text/plain)
    - Use /etc/mime.types if available for determining mimetypes for attachments inside winmail.dat
    - Added handling of --help and --version command line options (but no other long options)
    - Added -Q spec option: Custom patterns to identify vestigial text alternatives
    - Fixed bug: Was assuming MS Windows executables all have mimetype application/octet
    - Fixed manpage headers and footers
    - Ensure Perl compatibility from Perl 5.6 to (probably) Perl 7

CHANGELOG

@@ -1,3 +1,27 @@
+CHANGELOG
+=========
+
+1.0 (20200625)
+
+    - When replacing text-versus-HTML alternatives, choose the translated HTML alternative instead
+    - Added -Y option: Choose the plain text alternative over the translated HTML (unless vestigial)
+    - Added -F types option: Save attachments to files on disk (list of mimetypes/exts/filenames)
+    - Added -G path option: Directory to save attachments in (for use with -F)
+    - Added -C spec option: Custom attachment translations (list of mimetype_or_ext:ext:command)
+    - Added Makefile, README.md, COPYING, LICENSE, INSTALL
+    - Added translation of .docx and .xlsx attachments using docx2txt and xlsx2csv
+    - Preserve original Content-Disposition creation-date/modification-date/read-date parameters
+    - Fixed bug: Wasn't preserving original Content-Type charset parameter for text/* translations
+    - Added .bat and .ps1 to the list of MS Windows executable filename extensions
+    - Added self-identifying and legal information to the help message
+    - Changed default mimetype for csv attachments inside winmail.dat to text/csv (was text/plain)
+    - Use /etc/mime.types if available for determining mimetypes for attachments inside winmail.dat
+    - Added handling of --help and --version command line options (but no other long options)
+    - Added -Q spec option: Custom patterns to identify vestigial text alternatives
+    - Fixed bug: Was assuming MS Windows executables all have mimetype application/octet
+    - Fixed manpage headers and footers
+    - Ensure Perl compatibility from Perl 5.6 to (probably) Perl 7
+
 20110321
 
     - Added Content-Disposition creation-date/modification-date/read-date parameters
@@ -69,3 +93,10 @@
 
     - Initial version
 
+--------------------------------------------------------------------------------
+
+    URL: http://raf.org/textmail
+    GIT: https://github.com/raforg/textmail
+    Date: 20200625
+    Author: raf <raf@raf.org>
+

COPYING

@@ -0,0 +1,26 @@
+COPYING
+=======
+textmail - mail filter to replace MS Word/HTML attachments with plain text
+
+Copyright (C) 2003-2007, 2011, 2020 raf <raf@raf.org>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, see <https://www.gnu.org/licenses/>.
+
+--------------------------------------------------------------------------------
+
+    URL: http://raf.org/textmail
+    GIT: https://github.com/raforg/textmail
+    Date: 20200625
+    Author: raf <raf@raf.org>
+

INSTALL

@@ -0,0 +1,54 @@
+INSTALL
+=======
+Textmail is written in Perl and should run on any system with perl(1).
+There are no dependencies on any non-standard Perl modules. It does,
+however, depend on several external programs. See REQUIREMENTS below.
+
+To install textmail and its manpage (under /usr/local by default):
+
+    tar xzf textmail-X.Y.tar.gz
+    cd textmail-X.Y
+    make install
+
+To install under /usr:
+
+    make PREFIX=/usr install
+
+To uninstall textmail and its manpage (from under /usr/local):
+
+    make uninstall
+
+To uninstall textmail and its manpage (from under /usr):
+
+    make PREFIX=/usr uninstall
+
+For more details:
+
+    make help
+
+The manpage for textmail is textmail(1).
+
+REQUIREMENTS
+============
+Requires GNU make to install (but manual installation is easy).
+Requires perl (but no non-standard perl modules).
+Requires pod2man (comes with perl) to make the manpage.
+Requires pod2html (comes with perl) to make the html manpage.
+Requires the following external programs for various functions:
+
+  docx2txt  - To convert modern Word documents to text
+  antiword  - To convert old Word documents to text (default)
+  catdoc    - To convert old Word documents to text (alternative)
+  xlsx2csv  - To convert modern Excel documents to CSV
+  xls2csv   - To convert old Excel documents to CSV
+  lynx      - To convert HTML documents to text
+  pdftotext - To convert PDF documents to text
+  mktemp    - To create a temporary directory
+
+--------------------------------------------------------------------------------
+
+    URL: http://raf.org/textmail
+    GIT: https://github.com/raforg/textmail
+    Date: 20200625
+    Author: raf <raf@raf.org>
+