
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 ИМЕ

Locale::Po4a::Pod - двосмерна конверзија POD података и PO фајлова

=head1 СИНОПСИС

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # Чита POD са STDIN и уписује на STDOUT.
    $parser->parse_from_filehandle;

    # Чита POD из фајл.pod и уписује у фајл.txt.
    $parser->parse_from_file ('фајл.pod', 'фајл.txt');

=head1 ОПИС

Locale::Po4a::Pod је модул који помаже превођење документације у POD формату (препоручени језик за документовање Perl кода) на друге [људске] језике.

=head1 СТАТУС ОВОГ МОДУЛА

Мислим да је овај модул чврст као стена, и постоји само један познати баг са F</usr/lib/perl5/Tk/MainWindow.pod> (и неким другим страницама, погледајте ниже) које садрже:

  C<" #n">

Нема среће, у po4a верзији, ово је било подељено обавијањем на размаку. Као резултат, у оригиналној верзији, man страница садржи

 " #n"

а моја садржи

 "" #n""

што је и логично јер се CE<lt>foobarE<gt> поново исписује као "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





=head1 ДЕТАЉИ ИНТЕРНОГ ФУНКЦИОНИСАЊА

Као класа изведена из Pod::Parser, Locale::Po4a::Pod подржава исте методе и интерфејсе. Погледајте L<Pod::Parser> за све детаље; укратко, креира се нови парсер са C<< Locale::Po4a::Pod->new() >> и затим се позива или parse_from_filehandle() или parse_from_file().

new() може да прихвати опције у облику парова кључ/вредност које контролишу понашање парсера. Препознају се опције заједничке за све класе изведене из Pod::Parser:

=over 4

=item B<alt>

Ако је постављено на истиниту вредност, одабира алтернативни излазни формат који, између осталог, користи другачији стил наслова и обележава B<=item> ставке са две тачке на левој маргини. Подразумевана вредност је нетачно.

=item B<code>

Ако је постављено на истиниту вредност не-POD делови улазног фајла ће бити укључени у излаз. Корисно је да се види код који документују POD блокови тако да је POD обрађен, а код остављен недирнут.

=item B<indent>

Број размака којим се увлачи обичан текст, и подразумевано увлачење за B<=over> блокове. Подразумевана вредност је 4.

=item B<loose>

Ако се постави на истиниту вредност, након B<=head1> наслова се штампа празна линија. Ако се постави на нетачну вредност (што је подразумевано), након B<=head1> се не штампа празна линија, мада се једна и даље штампа након B<=head2>. Ово је подразумевано јер је то очекивано форматирање за странице упутства; ако форматирате документе са произвољним текстом, постављањем ове опције на истиниту вредност можете да добијете лепши испис.

=item B<quotes>

Поставља знаке навода који се користе за уоквиравање CE<lt>> текста. Ако је вредност један карактер, он се користи и за леви и за десни знак навода; ако су два карактера, први се користи као леви знак навода, а други као десни; а ако је четири карактера, прва два се користе као леви знак навода, а друга два као десни знак навода.

Ово такође може да се постави на специјалну вредност B<none>, и у том случају се око CE<lt>> текста не постављају знаци навода.

=item B<sentence>

Ако се постави на истиниту вредност, Locale::Po4a::Pod ће сматрати да се свака реченица завршава са два размака, и покушаће да задржи такво раздвајање. Ако се постави на неистиниту вредност, сви накнадни празни карактери у пасусима који нису обележени као дословни се сабијају у један знак размака. Подразумевано је истинита вредност.

=item B<width>

Колона на којој се врши обавијање текста на десној страни. Подразумевано је 76.

=back

=head1 ПОГЛЕДАЈТЕ ТАКОЂЕ

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 АУТОРИ

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

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

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

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

