Change option -d to decode all headers with exceptions

[mimedecode.git] / mimedecode.docbook

diff --git a/mimedecode.docbook b/mimedecode.docbook
index 28af4acd0d4e0b7e35d725fa681b7149221331c2..4cbd688f4535900ad77716890ed4f7920b17da75 100644 (file)
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -50,6 +50,9 @@
       <arg choice="opt">
          <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>
       </arg>
@@ -209,6 +212,25 @@
       </listitem>
    </varlistentry>
 
+   <varlistentry>
+      <term>-d *[,-header1,-header2,-header3...]</term>
+      <listitem>
+         <para>
+           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>
+
    <varlistentry>
       <term>-D</term>
       <listitem>