X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=mimedecode.docbook;h=29d081d84993ff38e5a618d659545b7b6cd8890e;hb=c8623aa92c99464cd2405d31c376fa3da844c3e4;hp=67011a66213f8435a2e3b798c50c544d713122f7;hpb=259081fe8a17e0619ce7803dd3cb310ebdd25202;p=mimedecode.git

diff --git a/mimedecode.docbook b/mimedecode.docbook
index 67011a6..29d081d 100644
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -2,10 +2,10 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "file:///usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">
 
-<refentry id="mimedecode.py">
+<refentry id="mimedecode">
 
 <refentryinfo>
-  <title>mimedecode.py</title>
+  <title>mimedecode</title>
   <productname>mimedecode.docbook</productname>
   <author>
     <firstname>Oleg</firstname>
@@ -14,24 +14,24 @@
     <personblurb/>
   </author>
   <copyright>
-    <year>2001-2014</year>
+    <year>2001-2018</year>
     <holder>PhiloSoft Design.</holder>
   </copyright>
 </refentryinfo>
 
 <refmeta>
-   <refentrytitle>mimedecode.py</refentrytitle>
+   <refentrytitle>mimedecode</refentrytitle>
    <manvolnum>1</manvolnum>
 </refmeta>
 
 <refnamediv>
-   <refname>mimedecode.py</refname>
+   <refname>mimedecode</refname>
    <refpurpose>decode MIME message</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
    <cmdsynopsis>
-      <command>mimedecode.py</command>
+      <command>mimedecode</command>
       <arg choice="opt">
          <option>-h|--help</option>
       </arg>
@@ -90,7 +90,7 @@
          <option>--set-param header:param=value</option>
       </arg>
       <arg choice="opt">
-         <option>-Bbeit mask</option>
+         <option>-BbeIit mask</option>
       </arg>
       <arg choice="opt">
          <option>--save-headers|body|message mask</option>
@@ -122,7 +122,7 @@
 </para>
 
 <para>
-   Here is a solution - mimedecode.py!
+   Here is a solution - mimedecode!
 </para>
 
 <para>
@@ -156,7 +156,7 @@
    to find a way to convert the body to plain text (can be prevented with
    options -Bbei). (The author has no idea how mailcap can be configured on
    OSes other than POSIX, please don't ask; users can consult an example at
-   <ulink url="http://phdru.name/Software/dotfiles/mailcap.html">http://phdru.name/Software/dotfiles/mailcap.html</ulink>).
+   <ulink url="https://phdru.name/Software/dotfiles/mailcap.html">https://phdru.name/Software/dotfiles/mailcap.html</ulink>).
    The decoding process uses the first copiousoutput filter it can find. If
    there are no filters the body just passed as is.
 </para>
@@ -422,6 +422,17 @@
       </listitem>
    </varlistentry>
 
+   <varlistentry>
+      <term>-I mask</term>
+      <listitem>
+         <para>
+            Append mask to the list of content types to completely ignore.
+            There will be no output - no headers, no body, no warning. For a
+            multipart part the entire subtree is removed.
+         </para>
+      </listitem>
+   </varlistentry>
+
    <varlistentry>
       <term>-i mask</term>
       <listitem>
@@ -483,8 +494,8 @@
          <para>
             Save output to the file related to the 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>
+            <programlisting language="sh">mimedecode -o output_file &lt; input_file
+cat input_file | mimedecode -o output_file</programlisting>
          </para>
       </listitem>
    </varlistentry>
@@ -501,7 +512,7 @@ cat input_file | mimedecode.py -o output_file</programlisting>
 
 <para>
 <code language="sh">
-  mimedecode.py -t application/pdf -t application/postscript -t text/plain
+  mimedecode -t application/pdf -t application/postscript -t text/plain
       -b text/html -B 'image/*' -i '*/*'
 </code>
 </para>
@@ -520,6 +531,12 @@ cat input_file | mimedecode.py -o output_file</programlisting>
    earlier than -B */*.
 </para>
 
+<para>
+  Options -e/-I/-i can also work with multipart subparts of a MIME message. In
+  case of -I/-i the entire subtree of that multipart is removed; with -i it's
+  replaced with ignore warning.
+</para>
+
 <para>
    Initially all 5 lists are empty, so without any additional parameters
    the program always uses the default decoding (as -t */*).
@@ -597,7 +614,7 @@ cat input_file | mimedecode.py -o output_file</programlisting>
 <refsect1>
 <title>COPYRIGHT</title>
 <para>
-  Copyright (C) 2001-2014 PhiloSoft Design.
+  Copyright (C) 2001-2018 PhiloSoft Design.
 </para>
 </refsect1>
 
@@ -624,8 +641,8 @@ cat input_file | mimedecode.py -o output_file</programlisting>
 <refsect1>
 <title>SEE ALSO</title>
 <para>
-  mimedecode.py home page:
-  <ulink url="http://phdru.name/Software/Python/#mimedecode">http://phdru.name/Software/Python/#mimedecode</ulink>
+  mimedecode home page:
+  <ulink url="https://phdru.name/Software/Python/#mimedecode">https://phdru.name/Software/Python/#mimedecode</ulink>
 </para>
 </refsect1>