.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "LOCALE::PO4A::POD.3PM 1"
.TH LOCALE::PO4A::POD.3PM 1 2025-11-22 "perl v5.42.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Locale::Po4a::Pod \- convert POD data from/to PO files
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\&    use Locale::Po4a::Pod;
\&    my $parser = Locale::Po4a::Pod\->new();
\&
\&    # Read POD from STDIN and write to STDOUT.
\&    $parser\->parse_from_filehandle;
\&
\&    # Read POD from file.pod and write to file.txt.
\&    $parser\->parse_from_file (\*(Aqfile.pod\*(Aq, \*(Aqfile.txt\*(Aq);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Locale::Po4a::Pod is a module to help the translation of documentation in
the POD format (the preferred language for documenting Perl) into other
[human] languages.
.PP
A new SimplePod parser is now available.  Please
consider using it instead of the current Pod module.  If you encounter any
bugs, your reports would be greatly appreciated.
.PP
The above warning message will be displayed for a transitional period.  To
disable it, set the \f(CW\*(C`no\-warn\-simple\*(C'\fR option.
.SH "STATUS OF THIS MODULE"
.IX Header "STATUS OF THIS MODULE"
I think that this module is rock stable, and there is only one known bug
with \fI/usr/lib/perl5/Tk/MainWindow.pod\fR (and some other
pages, see below) which contains:
.PP
.Vb 1
\&  C<" #n">
.Ve
.PP
Lack of luck, in the po4a version, this was split on the space by the
wrapping. As result, in the original version, the man page contains:
.PP
.Vb 1
\& " #n"
.Ve
.PP
and mine contains:
.PP
.Vb 1
\& "" #n""
.Ve
.PP
which is logic since C<foobar> is rewritten "foobar".
.PP
Complete list of pages having this problem on my box (from 564 pages; note
that it depends on the chosen wrapping column):
.PP
.Vb 8
\& /usr/lib/perl5/Tk/MainWindow.pod
\& /usr/share/perl/5.8.0/overload.pod
\& /usr/share/perl/5.8.0/pod/perlapi.pod
\& /usr/share/perl/5.8.0/pod/perldelta.pod
\& /usr/share/perl/5.8.0/pod/perlfaq5.pod
\& /usr/share/perl/5.8.0/pod/perlpod.pod
\& /usr/share/perl/5.8.0/pod/perlre.pod
\& /usr/share/perl/5.8.0/pod/perlretut.pod
.Ve
.SH INTERNALS
.IX Header "INTERNALS"
As a derived class from Pod::Parser, Locale::Po4a::Pod supports the same
methods and interfaces.  See Pod::Parser for all the details; briefly,
one creates a new parser with \f(CW\*(C`Locale::Po4a::Pod\->new()\*(C'\fR and then
calls either \fBparse_from_filehandle()\fR or \fBparse_from_file()\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Pod::Parser,
\&\fBLocale::Po4a::Man\fR\|(3pm),
\&\fBLocale::Po4a::TransTractor\fR\|(3pm),
\&\fBpo4a\fR\|(7)
.SH AUTHORS
.IX Header "AUTHORS"
.Vb 2
\& Denis Barbier <barbier@linuxfr.org>
\& Martin Quinson (mquinson#debian.org)
.Ve
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright © 2002 SPI, Inc.
.PP
This program is free software; you may redistribute it and/or modify it
under the terms of GPL v2.0 or later (see the COPYING file).