
        *****************************************************
        *           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) іншими мовами (якими
розмовляють люди).

У новій версії можна скористатися новим обробником
L<SimplePod|Locale::Po4a::SimplePod>. Ним варто користуватися замість
поточного модуля Pod. Якщо ви виявите якісь вади, будемо дуже раді вашим
звітам щодо них.

Протягом перехідного періоду буде показано наведене вище попередження. Щоб
вимкнути його показ, скористайтеся параметром C<no-warn-simple>.

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