ИМЕ¶

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 кода) на друге [људске] језике.

Сада је доступан нови SimplePod парсер. Молимо вас да га користите уместо текућег Pod модула. У случају да нађете на било какве багове, бићемо вам захвални ако поднесете извештаје о багу.

У прелазном периоду ће се исплаћивати горња порука упозорења. Ако желите да је искључите, поставите опцију "no-warn-simple".

СТАТУС ОВОГ МОДУЛА¶

Мислим да је овај модул чврст као стена, и постоји само један познати баг са /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)

АУТОРИ¶

 Дени Барбије <barbier@linuxfr.org>
 Мартин Квинсон (mquinson#debian.org)

ПРАВА УМНОЖАВАЊА И ЛИЦЕНЦА¶

Права умножавања © 2002 SPI, Inc.

Овај програм је слободан софтвер; можете да га редистрибуирате и/или мењате под условима GPL v2.0 или новије (погледајте фајл COPYING).