Update to DocBook 4.5; use local dtd

[mimedecode.git] / mimedecode.docbook

diff --git a/mimedecode.docbook b/mimedecode.docbook
index cc8ee2b7a8e5e4609b35acf64f6ae01aecf38d66..b3f09e1ebe7705bc856c5056d9f7fdb58e3c47e9 100644 (file)
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -1,6 +1,6 @@
 <?xml version="1.0" standalone="no"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1//EN"
-   "http://www.oasis-open.org/docbook/xml/4.1/docbook.dtd">
+<!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">
 
@@ -38,6 +38,9 @@
       <arg choice="opt">
          <option>-beit mask</option>
       </arg>
+      <arg choice="opt">
+         <option>-o output_file</option>
+      </arg>
       <arg choice="opt">input_file
         <arg choice="opt">output_file</arg>
       </arg>
@@ -237,10 +240,21 @@ flushed to stdout.
          </para>
       </listitem>
    </varlistentry>
+
+   <varlistentry>
+      <term>-o output_file</term>
+      <listitem>
+         <para>
+            Useful to set the output file 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>
+      </listitem>
+   </varlistentry>
 </variablelist>
 
 <para>
-   The last 4 options (-beit) require more explanation. They allow a user
+   The 4 list options (-beit) 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
@@ -248,7 +262,7 @@ else. Easy:
 </para>
 
 <para>
-<code language="shell">
+<code language="sh">
    mimedecode.py -t application/postscript -t application/pdf -b text/html
          -b 'image/*' -i '*/*'
 </code>