X-Git-Url: https://git.phdru.name/?p=mimedecode.git;a=blobdiff_plain;f=ANNOUNCE;h=b6a51c23ed1c406fa684d638446d4e42b7a25c7e;hp=5bd1a55f072cf5b607c74a21f7a8fca5b53d329f;hb=464264ba922a7ce7875eb4364e0cac63c8d348c7;hpb=41e92ab685cbcf842d1c4f33b8b29f94193938ed

diff --git a/ANNOUNCE b/ANNOUNCE
index 5bd1a55..b6a51c2 100644
--- a/ANNOUNCE
+++ b/ANNOUNCE
@@ -1,66 +1,68 @@
 
-                                mimedecode.py
+                                  mimedecode
 
 WHAT IS IT
 
    Mail users, especially in non-English countries, often find that mail
 messages arrived in different formats, with different content types, in
-different encodings and charsets. Usually this is good because it allows us to
-use appropriate format/encoding/whatever. Sometimes, though, some unification
-is desirable. For example, one may want to put mail messages into an archive,
-make HTML indices, run search indexer, etc. In such situations converting
-messages to text in one character set and skipping some binary attachments is
-much desirable.
+different encodings and charsets. Usually this is good because it allows
+us to use appropriate format/encoding/whatever. Sometimes, though, some
+unification is desirable. For example, one may want to put mail messages
+into an archive, make HTML indices, run search indexer, etc. In such
+situations converting messages to text in one character set and skipping
+some binary attachments is much desirable.
 
-   Here is the solution - mimedecode.py.
+   Here is the solution - mimedecode.
 
-   This is a program to decode MIME messages. The program expects one input
-file (either on command line or on stdin) which is treated as an RFC822
-message, and decodes to stdout or an output file. If the file is not an RFC822
-message it is just copied to the output one-to-one. If the file is a simple
-RFC822 message it is decoded as one part. If it is a MIME message with multiple
-parts ("attachments") all parts are decoded. Decoding can be controlled by
-command-line options.
+   This is a program to decode MIME messages. The program expects one
+input file (either on command line or on stdin) which is treated as an
+RFC822 message, and decodes to stdout or an output file. If the file is
+not an RFC822 message it is just copied to the output one-to-one. If the
+file is a simple RFC822 message it is decoded as one part. If it is a
+MIME message with multiple parts ("attachments") all parts are decoded.
+Decoding can be controlled by command-line options.
 
+   Think about said mail archive; for example, its maintainer wants to
+put there only texts, convert PDF/Postscript to text, pass HTML and
+images decoding base64 to html but leaving images encoded, and ignore
+everything else. This is how it could be done:
 
-WHAT'S NEW in version 2.5.0 (2014-03-??)
+   mimedecode -t application/pdf -t application/postscript -t text/plain -b text/html -B 'image/*' -i '*/*'
 
-   Add option --set-header=header:value to set header's value (only at the top
-level).
 
-   Add option --set-param=header:param=value to set header parameter's value
-(only at the top level). The header must exist.
+Version 2.9.0 (2017-12-12)
 
-   Add option -B to skip content-transfer-decoding binary attachments.
+   Split mimedecode.py into mimedecode library and a small script.
 
-   Add options --save-headers, --save-body and --save-message to save decoded
-headers/bodies/messages to files.
+   Made the library executable via ``python -m mimedecode``.
 
-   Add option -O to set the destination directory for output files.
+Version 2.8.0 (2017-11-03)
 
-   Create the directory for the output files (-O) if it doesn't exits.
+   Python 3.
 
-   Fix a minor bug: if a multipart message (or a subpart) lacks any textual
-content - avoid putting an excessive newline.
+   Stop supporting Python 2.6.
 
 
 WHERE TO GET
    Home page: http://phdru.name/Software/Python/#mimedecode
+    git clone https://github.com/phdru/mimedecode.git
     git clone http://git.phdru.name/mimedecode.git
     git clone  git://git.phdru.name/mimedecode.git
 
-   Requires: Python 2.2.2+, m_lib 2.0+.
+   Requires: Python 2.7 or Python 3.3+, m_lib.defenc 1.0+.
+   Tests require: tox, m_lib 3.1+.
 
    Recommends: configured mailcap database.
 
    Documentation: http://phdru.name/Software/Python/mimedecode.html
       (also included in the package in html, man and txt formats).
 
+
 AUTHOR
    Oleg Broytman <phd@phdru.name>
 
 COPYRIGHT
-   Copyright (C) 2001-2014 PhiloSoft Design.
+   Copyright (C) 2001-2017 PhiloSoft Design.
 
 LICENSE
    GPL