X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=mimedecode.docbook;h=87bd3643cb7b2def88c2681e56554723da608a13;hb=b43690a1e6349e29309f19a8305893d1fbd48427;hp=746fedad5c3daaaa0a3c78c896a6f4b745e4d5f7;hpb=1d7e83e56c2d0208fd2c8e4a2d3102f339081c73;p=mimedecode.git

diff --git a/mimedecode.docbook b/mimedecode.docbook
index 746feda..87bd364 100644
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -42,10 +42,10 @@
          <option>-cCDP</option>
       </arg>
       <arg choice="opt">
-         <option>-H|--host=hostname</option>
+         <option>-f charset</option>
       </arg>
       <arg choice="opt">
-         <option>-f charset</option>
+         <option>-H|--host=hostname</option>
       </arg>
       <arg choice="opt">
          <option>-d header</option>
@@ -53,6 +53,12 @@
       <arg choice="opt">
          <option>-p header:param</option>
       </arg>
+      <arg choice="opt">
+         <option>-r header</option>
+      </arg>
+      <arg choice="opt">
+         <option>-R header:param</option>
+      </arg>
       <arg choice="opt">
          <option>-beit mask</option>
       </arg>
@@ -113,13 +119,13 @@ command-line options.
    than POSIX, please don't ask me; real OS users can consult my example at
    <ulink url="http://phdru.name/Software/dotfiles/mailcap.html">http://phdru.name/Software/dotfiles/mailcap.html</ulink>).
    The decoding process uses the first copiousoutput filter it can find. If
-   there is no any filter the body just passed as is.
+   there are no filters the body just passed as is.
 </para>
 
 <para>
    Then Content-Type header is consulted for charset. If it is not equal to the
-   current locale charset the body text is recoded. Finally message headers and
-   the body are flushed to stdout.
+   current locale charset and recoding is allowed the body text is recoded.
+   Finally message headers and the body are flushed to stdout.
 </para>
 </refsect1>
 
@@ -151,8 +157,8 @@ command-line options.
       <term>-c</term>
       <listitem>
          <para>
-            Recode different character sets in message body to current default
-            charset; this is the default.
+            Recode different character sets in message bodies to the current
+            default charset; this is the default.
          </para>
       </listitem>
    </varlistentry>
@@ -161,28 +167,28 @@ command-line options.
       <term>-C</term>
       <listitem>
          <para>
-            Do not recode character sets in message body.
+            Do not recode character sets in message bodies.
          </para>
       </listitem>
    </varlistentry>
 
    <varlistentry>
-      <term>-H hostname</term>
-      <term>--host=hostname</term>
+      <term>-f charset</term>
       <listitem>
          <para>
-           Use this hostname in X-MIME-Autoconverted headers instead of the
-           current hostname.
+            Force this charset to be the current default charset instead of
+            the current locale.
          </para>
       </listitem>
    </varlistentry>
 
    <varlistentry>
-      <term>-f charset</term>
+      <term>-H hostname</term>
+      <term>--host=hostname</term>
       <listitem>
          <para>
-            Force this charset to be the current default charset instead of
-            the current locale.
+           Use this hostname in X-MIME-Autoconverted headers instead of the
+           current hostname.
          </para>
       </listitem>
    </varlistentry>
@@ -192,7 +198,8 @@ command-line options.
       <listitem>
          <para>
             Add the header to a list of headers to decode; initially the list
-            contains headers "From" and "Subject".
+            contains headers "From", "To", "Cc", "Reply-To", "Mail-Followup-To"
+            and "Subject".
          </para>
       </listitem>
    </varlistentry>
@@ -210,9 +217,10 @@ command-line options.
       <term>-p header:param</term>
       <listitem>
          <para>
-            Add the (header, param) pair to a list of headers' parameters to
-            decode; initially the list contains header "Content-Disposition",
-            parameter "filename".
+            Add the pair (header, param) to a list of headers parameters to
+            decode; initially the list contains header "Content-Type",
+            parameter "name" and header "Content-Disposition", parameter
+            "filename".
          </para>
       </listitem>
    </varlistentry>
@@ -221,7 +229,27 @@ command-line options.
       <term>-P</term>
       <listitem>
          <para>
-            Clear the list of headers' parameters to decode (make it empty).
+            Clear the list of headers parameters to decode (make it empty).
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-r header</term>
+      <listitem>
+         <para>
+            Add the header to a list of headers to remove completely; initially
+            the list is empty.
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-R header:param</term>
+      <listitem>
+         <para>
+            Add the pair (header, param) to a list of headers parameters to
+            remove; initially the list is empty.
          </para>
       </listitem>
    </varlistentry>
@@ -298,15 +326,15 @@ else. Easy:
 </para>
 
 <para>
-   When the program decodes a message (or its part), it consults
-Content-Type header. The content type is searched in all 4 lists, in order
-"text-binary-ignore-error". If found, appropriate action performed. If not
-found, the program search the same lists for "type/*" mask (the type of
-"text/html" is just "text"). If found, appropriate action performed. If not
-found, the program search the same lists for "*/*" mask. If found,
-appropriate action performed. If not found, the program uses default
-action, which is to decode everything to text (if mailcap specifies
-a filter).
+   When the program decodes a message (non-MIME or a non-multipart subpart of a
+   MIME message), it consults Content-Type header. The content type is searched
+   in all 4 lists, in order "text-binary-ignore-error". If found, appropriate
+   action performed. If not found, the program search the same lists for
+   "type/*" mask (the type of "text/html" is just "text"). If found,
+   appropriate action performed. If not found, the program search the same
+   lists for "*/*" mask. If found, appropriate action performed. If not found,
+   the program uses default action, which is to decode everything to text (if
+   mailcap specifies a filter).
 </para>
 
 <para>
@@ -334,12 +362,13 @@ the program always uses the default decoding.
 <title>BUGS</title>
 <para>
    The program may produce incorrect MIME message. The purpose of the program
-is to decode whatever it is possible to decode, not to produce absolutely
-correct MIME output. The incorrect parts are obvious - decoded Subject headers
-and filenames. Other than that output is correct MIME message. The program does
-not try to guess whether the headers are correct. For example, if a message
-header states that charset is iso8859-5, but the body is actually in utf-8
-the program will recode the message with the wrong charset.
+   is to decode whatever it is possible to decode, not to produce absolutely
+   correct MIME output. The incorrect parts are obvious - decoded
+   From/To/Cc/Reply-To/Mail-Followup-To/Subject headers and filenames. Other
+   than that output is correct MIME message. The program does not try to guess
+   whether the headers are correct. For example, if a message header states
+   that charset is iso8859-5, but the body is actually in utf-8 the program
+   will recode the message with the wrong charset.
 </para>
 </refsect1>