
        *****************************************************
        *           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 - PO ファイルと POD データの変換

=head1 書式

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();

    # 標準入力からPODを読み、標準出力に書き出す。
    $parser->parse_from_filehandle;

    # file.podから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 訳者

 倉澤 望 <nabetaro@debian.or.jp>
 Debian JP Documentation ML <debian-doc@debian.or.jp>

=head1 著作権とライセンス

Copyright © 2002 SPI, Inc.

本プログラムは自由ソフトウェアです。GPL v2.0以降の条項に基づき再頒布と変更を行えます（COPYINGファイルを参照）。
