Change option -d to decode all headers with exceptions

[mimedecode.git] / mimedecode.docbook

diff --git a/mimedecode.docbook b/mimedecode.docbook
index 382fba2cb2f6a79b998c12b3f7661c14fb7eb046..4cbd688f4535900ad77716890ed4f7920b17da75 100644 (file)
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -48,7 +48,10 @@
          <option>-H|--host=hostname</option>
       </arg>
       <arg choice="opt">
-         <option>-d header</option>
+         <option>-d header1[,header2,header3...]</option>
+      </arg>
+      <arg choice="opt">
+         <option>-d *[,-header1,-header2,-header3...]</option>
       </arg>
       <arg choice="opt">
          <option>-p header:param</option>
@@ -199,12 +202,31 @@
    </varlistentry>
 
    <varlistentry>
-      <term>-d header</term>
+      <term>-d header1[,header2,header3...]</term>
+      <listitem>
+         <para>
+            Add the header(s) to a list of headers to decode; initially the
+            list contains headers "From", "To", "Cc", "Reply-To",
+            "Mail-Followup-To" and "Subject".
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-d *[,-header1,-header2,-header3...]</term>
       <listitem>
          <para>
-            Add the header to a list of headers to decode; initially the list
-            contains headers "From", "To", "Cc", "Reply-To", "Mail-Followup-To"
-            and "Subject".
+           This variant completely changes headers decoding. First, the list of
+           headers to decode is cleared. Then all the headers are decoded
+           except the given list of exceptions (headers listed with '-'). In
+           this mode it would be meaningless to give more than one -d options
+           but the program doesn't enforce it.
+         </para>
+
+         <para>
+           Please be warned that the asterisk is a shell metacharacter and
+           should be escaped or quoted. Either write -d \*,-h1,-h2 or -d
+           '*,-h1,-h2'.
          </para>
       </listitem>
    </varlistentry>