Adding upstream version 0.72.upstream/0.72

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 75 insertions, 0 deletions

diff --git a/share/doc/po4a-display-pod.xml b/share/doc/po4a-display-pod.xml
new file mode 100644
index 0000000..4c3a805
--- /dev/null
+++ b/share/doc/po4a-display-pod.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<!-- lifted from troff+man by doclifter -->
+<refentry id='po4adisplaypod1' xml:lang="en">
+<refentryinfo><date>2009-03-16</date></refentryinfo>
+<refmeta>
+<refentrytitle>PO4A-DISPLAY-POD</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='date'>2009-03-16</refmiscinfo>
+<refmiscinfo class='source'>Po4a Tools</refmiscinfo>
+<refmiscinfo class='manual'>Po4a Tools</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>po4a-display-pod</refname>
+<refpurpose>display of a translated POD file according to a PO</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>po4a-display-pod</command>
+    <arg choice='plain'><option>-p </option></arg>
+    <arg choice='plain'><replaceable>PO_FILE</replaceable></arg>
+    <arg choice='plain'><option>-m </option></arg>
+    <arg choice='plain'><replaceable>POD_FILE</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
+    <sbr/>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para>Translators can use <command>po4a-display-pod</command> to see
+how their translation of a man page will be rendered to the end
+users, without recompiling and reinstalling the whole project.
+Most of the time, the POD file is only available in source package or
+embedded in Perl script.</para>
+</refsect1>
+
+<refsect1 id='options'><title>OPTIONS</title>
+<variablelist remap='TP'>
+  <varlistentry>
+  <term><option>-p </option><replaceable>PO_FILE</replaceable></term>
+  <listitem>
+<para>The PO file containing the translations.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-m </option><replaceable>POD_FILE</replaceable></term>
+  <listitem>
+<para>The original POD file used by po4a to generate PO file.</para>
+  </listitem>
+  </varlistentry>
+  <varlistentry>
+  <term><option>-o </option><replaceable>PO4A_OPT</replaceable></term>
+  <listitem>
+<para>Some options to pass to <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+  </listitem>
+  </varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para>
+  <citerefentry>
+    <refentrytitle>po4a-display-man</refentrytitle><manvolnum>1</manvolnum>
+  </citerefentry>
+</para>
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Florentin Duneau</para>
+</refsect1>
+</refentry>
+