]> git.phdru.name Git - mimedecode.git/blobdiff - mimedecode.docbook
Add option -O to set the destination directory
[mimedecode.git] / mimedecode.docbook
index d98db683691271f016f08df8cfedd248c961c106..555c5f2525be9d84e7dcf442bfce9cf585bfe835 100644 (file)
         <option>-p header1[,header2,header3,...]:param1[,param2,param3,...]</option>
       </arg>
       <arg choice="opt">
-         <option>-r header</option>
+        <option>-p *[,-header1,-header2,-header3,...]:param1[,param2,param3,...]</option>
       </arg>
       <arg choice="opt">
-         <option>-R header:param</option>
+        <option>-p header1[,header2,header3,...]:*[,-param1,-param2,-param3,...]</option>
       </arg>
       <arg choice="opt">
-         <option>--remove-params=header</option>
+        <option>-p *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...]</option>
       </arg>
       <arg choice="opt">
-         <option>-beit mask</option>
+         <option>-r header1[,header2,header3...]</option>
+      </arg>
+      <arg choice="opt">
+         <option>-r *[,-header1,-header2,-header3...]</option>
+      </arg>
+      <arg choice="opt">
+        <option>-R header1[,header2,header3,...]:param1[,param2,param3,...]</option>
+      </arg>
+      <arg choice="opt">
+        <option>-R *[,-header1,-header2,-header3,...]:param1[,param2,param3,...]</option>
+      </arg>
+      <arg choice="opt">
+        <option>-R header1[,header2,header3,...]:*[,-param1,-param2,-param3,...]</option>
+      </arg>
+      <arg choice="opt">
+        <option>-R *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...]</option>
+      </arg>
+      <arg choice="opt">
+         <option>--set-header header:value</option>
+      </arg>
+      <arg choice="opt">
+         <option>--set-param header:param=value</option>
+      </arg>
+      <arg choice="opt">
+         <option>-Bbeit mask</option>
+      </arg>
+      <arg choice="opt">
+         <option>-O dest_dir</option>
       </arg>
       <arg choice="opt">
          <option>-o output_file</option>
       </listitem>
    </varlistentry>
 
+   <varlistentry>
+      <term>-p *[,-header1,-header2,-header3,...]:param1[,param2,param3,...]</term>
+      <listitem>
+         <para>
+            Add the parameters(s) to a list of headers parameters to decode;
+            the parameters will be decoded for all headers except the given
+            ones.
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-p header1[,header2,header3,...]:*[,-param1,-param2,-param3,...]</term>
+      <listitem>
+         <para>
+           Decode all parameters except listed for the given list of headers.
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-p *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...]</term>
+      <listitem>
+         <para>
+           Decode all parameters except listed for all headers (except listed).
+         </para>
+      </listitem>
+   </varlistentry>
+
    <varlistentry>
       <term>-P</term>
       <listitem>
    </varlistentry>
 
    <varlistentry>
-      <term>-r header</term>
+      <term>-r header1[,header2,header3...]</term>
       <listitem>
          <para>
-            Add the header to a list of headers to remove completely; initially
-            the list is empty.
+            Add the header(s) to a list of headers to remove completely;
+            initially the list is empty.
          </para>
       </listitem>
    </varlistentry>
 
    <varlistentry>
-      <term>-R header:param</term>
+      <term>-r *[,-header1,-header2,-header3...]</term>
       <listitem>
          <para>
-            Add the pair (header, param) to a list of headers parameters to
-            remove; initially the list is empty.
+           Remove all headers except listed.
          </para>
       </listitem>
    </varlistentry>
 
    <varlistentry>
-      <term>--remove-params=header</term>
+      <term>-R header1[,header2,header3,...]:param1[,param2,param3,...]</term>
       <listitem>
          <para>
-            Add the header to a list of headers from which all parameters will
-            be removed; initially the list is empty.
+            Add the parameters(s) to a list of headers parameters to remove;
+            the parameters will be decoded only for the given header(s).
+            Initially the list is empty.
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-R *[,-header1,-header2,-header3,...]:param1[,param2,param3,...]</term>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-R header1[,header2,header3,...]:*[,-param1,-param2,-param3,...]</term>
+   </varlistentry>
+
+   <varlistentry>
+      <term>-R *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...]</term>
+      <listitem>
+         <para>
+           Remove listed parameters (or all parameters except listed) frome
+           these headers (or from all headers except listed).
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>--set-header header:value</term>
+      <listitem>
+         <para>
+           The program sets or changes value for the header to the given value
+           (only at the top-level message).
+         </para>
+      </listitem>
+   </varlistentry>
+
+   <varlistentry>
+      <term>--set-param header:param=value</term>
+      <listitem>
+         <para>
+           The program sets or changes value for the header's parameter to the
+           given value (only at the top-level message). The header must exist.
          </para>
       </listitem>
    </varlistentry>
       </listitem>
    </varlistentry>
 
+   <varlistentry>
+      <term>-B mask</term>
+      <listitem>
+         <para>
+           Append mask to the list of binary content types that will be not
+           content-transfer-decoded (will be left as base64 or such).
+         </para>
+      </listitem>
+   </varlistentry>
+
    <varlistentry>
       <term>-e mask</term>
       <listitem>
       </listitem>
    </varlistentry>
 
+   <varlistentry>
+      <term>-O dest_dir</term>
+      <listitem>
+         <para>
+           Set destination directory for the output files. Default is current
+           directory.
+          </para>
+      </listitem>
+   </varlistentry>
+
    <varlistentry>
       <term>-o output_file</term>
       <listitem>
          <para>
-            Useful to set the output file in case of redirected stdin:
+            Set the output file. Uses destination directory from option -O.
+            Also useful in case of redirected stdin:
             <programlisting language="sh">mimedecode.py -o output_file &lt; input_file
 cat input_file | mimedecode.py -o output_file</programlisting>
          </para>
@@ -349,7 +464,7 @@ cat input_file | mimedecode.py -o output_file</programlisting>
 </variablelist>
 
 <para>
-   The 4 list options (-beit) require more explanation. They allow a user to
+   The 5 list options (-Bbeit) require more explanation. They allow a user to
    control body decoding with great flexibility. Think about said mail archive;
    for example, its maintainer wants to put there only texts, convert
    Postscript/PDF to text, pass HTML and images as is, and ignore everything