X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=mimedecode.docbook;h=d98db683691271f016f08df8cfedd248c961c106;hb=132782e4926381f746dd9ea6b03e3feaaf52579a;hp=28af4acd0d4e0b7e35d725fa681b7149221331c2;hpb=5609ebe933595e091f216abf575c448b514d7cb1;p=mimedecode.git

diff --git a/mimedecode.docbook b/mimedecode.docbook
index 28af4ac..d98db68 100644
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -51,7 +51,10 @@
          <option>-d header1[,header2,header3...]</option>
       </arg>
       <arg choice="opt">
-         <option>-p header:param</option>
+         <option>-d *[,-header1,-header2,-header3...]</option>
+      </arg>
+      <arg choice="opt">
+        <option>-p header1[,header2,header3,...]:param1[,param2,param3,...]</option>
       </arg>
       <arg choice="opt">
          <option>-r header</option>
@@ -134,6 +137,13 @@
 </para>
 </refsect1>
 
+<refsect1>
+  <para>
+    Please be warned that in the following options asterisk is a shell
+    metacharacter and should be escaped or quoted. Either write -d \*,-h1,-h2
+    or -d '*,-h1,-h2' or such.
+  </para>
+</refsect1>
 
 <refsect1>
 <title>OPTIONS</title>
@@ -209,6 +219,19 @@
       </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>
+      </listitem>
+   </varlistentry>
+
    <varlistentry>
       <term>-D</term>
       <listitem>
@@ -219,13 +242,13 @@
    </varlistentry>
 
    <varlistentry>
-      <term>-p header:param</term>
+      <term>-p header1[,header2,header3,...]:param1[,param2,param3,...]</term>
       <listitem>
          <para>
-            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".
+            Add the parameters(s) to a list of headers parameters to decode;
+            the parameters will be decoded only for the given header(s).
+            Initially the list contains header "Content-Type", parameter "name";
+            and header "Content-Disposition", parameter "filename".
          </para>
       </listitem>
    </varlistentry>