2 files changed, 165 insertions, 0 deletions
diff --git a/share/doc/po4a-display-man.xml b/share/doc/po4a-display-man.xml
new file mode 100644
index 0000000..761c49e
--- /dev/null
+++ b/share/doc/po4a-display-man.xml
@@ -0,0 +1,90 @@
+<?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='po4adisplayman1' xml:lang="en">
+<refentryinfo><date>2006-04-08</date></refentryinfo>
+<refmeta>
+<refentrytitle>PO4A-DISPLAY-MAN</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class='date'>2020-04-19</refmiscinfo>
+<refmiscinfo class='source'>Po4a Tools</refmiscinfo>
+<refmiscinfo class='manual'>Po4a Tools</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>po4a-display-man</refname>
+<refpurpose>display a translated man page according to a PO</refpurpose>
+</refnamediv>
+<!-- body begins here -->
+<refsynopsisdiv id='synopsis'>
+<cmdsynopsis>
+  <command>po4a-display-man</command>
+    <arg choice='plain'><option>-p</option> </arg>
+    <arg choice='plain'><replaceable>PO_FILE</replaceable></arg>
+    <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>MASTER_FILE</replaceable></arg></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-man</command> to see
+how their translation of a man page will be rendered to the end
+users, without recompiling and reinstalling the whole project.</para>
+
+<para>This script only works with man pages written directly in
+<emphasis remap='I'>nroff</emphasis> and handled by the po4a's
+<emphasis remap='I'>man</emphasis> module. 
+Manual pages generated from other formats, like DocBook or POD, are not
+supported.
+See <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> for an equivalent supporting <emphasis remap='I'>POD</emphasis> documents.
+</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>MASTER_FILE</replaceable></term>
+  <listitem>
+<para>The original man page.
+It can be the absolute or relative path to the original man page (gzipped
+or not), the name of the man page or the name and section of the man page
+(using the man.section format).
+<!-- .br -->
+When the master document is not provided with the <option>-m</option> option,
+<command>po4a-display-man</command> tries to find the original man page
+based on the line reference of the first string in the PO.</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-pod</refentrytitle><manvolnum>1</manvolnum>
+  </citerefentry>
+</para>
+
+</refsect1>
+
+<refsect1 id='author'><title>AUTHOR</title>
+<para>Thomas Huriaux</para>
+</refsect1>
+</refentry>
+
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>
+