'\" t
.\"     Title: PO4A-DISPLAY-MAN
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2006-04-08
.\"    Manual: Po4a Tools
.\"    Source: Po4a Tools
.\"  Language: English
.\"
.TH "PO4A\-DISPLAY\-MAN" "1" "2006\-04\-08" "Po4a Tools" "Po4a Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
po4a-display-man \- display a translated man page according to a PO
.SH "SYNOPSIS"
.HP \w'\fBpo4a\-display\-man\fR\ 'u
\fBpo4a\-display\-man\fR \fB\-p\fR \fIPO_FILE\fR [\fB\-m\fR\ \fIMASTER_FILE\fR] [\fB\-o\fR\ \fIPO4A_OPT\fR]
.br

.SH "DESCRIPTION"
.PP
Translators can use
\fBpo4a\-display\-man\fR
to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project\&.
.PP
This script only works with man pages written directly in
\fInroff\fR
and handled by the po4a\*(Aqs
\fIman\fR
module\&. Manual pages generated from other formats, like DocBook or POD, are not supported\&. See
\fBpo4a-display-pod\fR(1)
for an equivalent supporting
\fIPOD\fR
documents\&.
.SH "OPTIONS"
.PP
\fB\-p \fR\fIPO_FILE\fR
.RS 4
The PO file containing the translations\&.
.RE
.PP
\fB\-m \fR\fIMASTER_FILE\fR
.RS 4
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)\&.
When the master document is not provided with the
\fB\-m\fR
option,
\fBpo4a\-display\-man\fR
tries to find the original man page based on the line reference of the first string in the PO\&.
.RE
.PP
\fB\-o \fR\fIPO4A_OPT\fR
.RS 4
Some options to pass to
\fBpo4a-translate\fR(1)\&.
.RE
.SH "SEE ALSO"
.PP
\fBpo4a-display-pod\fR(1)
.SH "AUTHOR"
.PP
Thomas Huriaux