ANNOUNCE

   1
   2                                 mimedecode.py
   3
   4 WHAT IS IT
   5
   6    Mail users, especially in non-English countries, often find that mail
   7 messages arrived in different formats, with different content types, in
   8 different encodings and charsets. Usually this is good because it allows us to
   9 use appropriate format/encoding/whatever. Sometimes, though, some unification
  10 is desirable. For example, one may want to put mail messages into an archive,
  11 make HTML indices, run search indexer, etc. In such situations converting
  12 messages to text in one character set and skipping some binary attachments is
  13 much desirable.
  14
  15    Here is the solution - mimedecode.py.
  16
  17    This is a program to decode MIME messages. The program expects one input
  18 file (either on command line or on stdin) which is treated as an RFC822
  19 message, and decodes to stdout or an output file. If the file is not an RFC822
  20 message it is just copied to the output one-to-one. If the file is a simple
  21 RFC822 message it is decoded as one part. If it is a MIME message with multiple
  22 parts ("attachments") all parts are decoded. Decoding can be controlled by
  23 command-line options.
  24
  25
  26 WHAT'S NEW in version 2.5.0 (2014-03-??)
  27
  28    Add option --set-header=header:value to set header's value (only at the top
  29 level).
  30
  31    Add option --set-param=header:param=value to set header parameter's value
  32 (only at the top level).
  33
  34 WHAT'S NEW in version 2.4.0 (2014-03-08)
  35
  36    Change option -d to accept a comma-separated list of headers:
  37 -d h1,h2,h3,...
  38
  39    Change option -d to decode all headers and accept a list of exceptions:
  40 -d *,-h1,-h2,...
  41
  42    Change option -p to accept lists of headers and parameters:
  43 -p h1,h2,h3,..:p1,p2,p3,..
  44
  45    Allow * and exceptions for -p in the headers and parameters lists:
  46 -p *,-h1,-h2,-h3:p1,p2,p3
  47 -p h1,h2,h3:*,-p1,-p2,-p3
  48 -p *,-h1,-h2,-h3:*,-p1,-p2,-p3
  49
  50    Change option -r to accept a list of headers: -r h1,h2,h3,...
  51
  52    Change option -r to remove all headers and accept a list of exceptions:
  53 -r *,-h1,-h2,...
  54
  55    Change option -R to accept lists of headers and parameters:
  56 -R h1,h2,h3:p1,p2,p3
  57 -R h1,h2,h3:*,-p1,-p2,-p3
  58 -R *,-h1,-h2,-h3:p1,p2,p3
  59 -R *,-h1,-h2,-h3:*,-p1,-p2,-p3
  60
  61    Publish docs in html format.
  62
  63    Add ChangeLog.
  64
  65 WHAT'S NEW in version 2.3.7 (2014-02-23)
  66
  67    Add option -r to remove headers and option -R to remove headers parameters.
  68
  69
  70 WHERE TO GET
  71    Home page: http://phdru.name/Software/Python/#mimedecode
  72     git clone http://git.phdru.name/mimedecode.git
  73     git clone  git://git.phdru.name/mimedecode.git
  74
  75    Requires: Python 2.2.2+, m_lib 2.0+.
  76
  77    Recommends: configured mailcap database.
  78
  79    Documentation: http://phdru.name/Software/Python/mimedecode.html
  80       (also included in the package in html, man and txt formats).
  81
  82 AUTHOR
  83    Oleg Broytman <phd@phdru.name>
  84
  85 COPYRIGHT
  86    Copyright (C) 2001-2014 PhiloSoft Design.
  87
  88 LICENSE
  89    GPL