НАЗВАНИЕ

       Locale::Po4a::Pod: преобразование POD-данных из/в PO-файлы

КРАТКОЕ СОДЕРЖАНИЕ

           use Locale::Po4a::Pod;
           my $parser = Locale::Po4a::Pod->new();

           # Прочитать POD из STDIN и записать в STDOUT.
           $parser->parse_from_filehandle;

           # Прочитать POD из file.pod и записать в file.txt.
           $parser->parse_from_file ('file.pod', 'file.txt');

ОПИСАНИЕ

       Locale::Po4a::Pod — это модуль, предназначенным для помощи в переводе документации в формате POD
       (предпочтительный язык разметки документации Perl) на другие [человеческие] языки.

СОСТОЯНИЕ ЭТОГО МОДУЛЯ

       Я думаю, что этот модуль стабилен, как скала, и есть только одна известная ошибка в
       /usr/lib/perl5/Tk/MainWindow.pod (и в некоторых других страницах, см. ниже), которые содержат:

         C<" #n">

       Из-за неудачного стечение обстоятельств, в версии po4a часть этой строки было перенесена на следующую на
       пробеле. В результате в исходной версии man-страница содержит:

        " #n"

       а моя содержит:

        "" #n""

       что логично, т.к. C<foobar> преобразуется в "foobar".

       Полный список страниц, на которых возникала подобная проблема на моей машине (из 564 страниц; также
       заметьте, что это зависит от количества знаков после которого осуществляется перенос):

        /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

ВНУТРЕННОСТИ

       Являясь производным классом Pod::Parser, Locale::Po4a::Pod поддерживает те же методы и интерфейсы. См.
       подробности в Pod::Parser; если вкратце, то надо создать новый парсер с помощью
       "Locale::Po4a::Pod->new()", а затем вызывать либо parse_from_filehandle(), либо parse_from_file().

СМОТРИТЕ ТАКЖЕ

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

АВТОРЫ

        Денис Барбье (Denis Barbier) <barbier@linuxfr.org>
        Мартин Кенсон (Martin Quinson) (mquinson#debian.org)

АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ

       Copyright © 2002 SPI, Inc.

       Данная программа является свободным программным обеспечением; вы можете распространять и/или изменять её
       на условиях Универсальной общественной лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).

perl v5.38.2                                       2024-08-28                           LOCALE::PO4A::POD.3PM(1)