
        *****************************************************
        *           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 часть этой строки
было перенесена на следующую на пробеле. В результате в исходной версии
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().

=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 АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ

Copyright © 2002 SPI, Inc.

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