LOCALE::PO4A::POD.3PM(1)                   User Contributed Perl Documentation


NAME
       Locale::Po4a::Pod - convert POD data from/to PO files

SYNOPSIS
           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 ('file.pod', 'file.txt');

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.

STATUS OF THIS MODULE
       I think that this module is rock stable, and there is only one known
       bug with /usr/lib/perl5/Tk/MainWindow.pod (and some other pages, see
       below) which contains:

         C<" #n">

       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:

        " #n"

       and mine contains:

        "" #n""

       which is logic since C<foobar> is rewritten "foobar".

       Complete list of pages having this problem on my box (from 564 pages;
       note that it depends on the chosen wrapping column):

        /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

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 "Locale::Po4a::Pod->new()" and
       then calls either parse_from_filehandle() or parse_from_file().

SEE ALSO
       Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm),
       po4a(7)

AUTHORS
        Denis Barbier <barbier@linuxfr.org>
        Martin Quinson (mquinson#debian.org)

COPYRIGHT AND LICENSE
       Copyright (C) 2002 SPI, Inc.

       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).

perl v5.38.2                      2024-06-26          LOCALE::PO4A::POD.3PM(1)