
        *****************************************************
        *           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();

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

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

=head1 ОПИС

Locale::Po4a::Pod — модуль, який допомагає у перекладі документації у форматі POD (основною мовою документації до Perl) іншими мовами (якими розмовляють люди).

=head1 СТАН ЦЬОГО МОДУЛЯ

Я вважаю цей модуль дуже стабільним. У нього лише одна відома вада, пов'язана із F</usr/lib/perl5/Tk/MainWindow.pod> (та деякими іншими сторінками, див. нижче), де міститься такий рядок:

  C<" #n">

На жаль, у версії po4a цей рядок ділиться за пробілом на два рядки. У результаті, якщо у початковій версії сторінка підручника містить таке:

 " #n"

то після обробки вона містить таке:

 "" #n""

Це логічно, оскільки CE<lt>щось тамE<gt> переписується як "щось там".

Повний список сторінок із цією проблемою на комп'ютері автора (з 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().

=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ

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

=head1 АВТОРИ

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

=head1 АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ

© SPI, inc., 2002.

Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл COPYING).

