1

多くの Pod には次のような行の間に空白行があることに気付きました

    code

    =head1 DESCRIPTION

    text

これらの空白行は厳密に必要ですか? 特定のパーサーが行方不明になった場合、動揺しますか?

perlpodのcutの説明は少し役に立ちますが、他の構成について疑問に思っていました:

Pod ブロックを終了するには、空白行を使用し、次に "=cut" で始まる行を使用し、その後に空白行を使用します。これにより、Perl (および Pod フォーマッター) は、ここで Perl コードが再開されていることを認識できます。(「=cut」の前の空白行は技術的には必要ありませんが、多くの古い Pod プロセッサでは必要です。)

4

2 に答える 2

6

perldoc perlpodは、「すべてのコマンドは、その段落を終了するために、その後に空白行が必要である」と述べており、「多くの古い Pod トランスレーターは、すべての Pod コマンドの前とすべての Pod コマンド (「=cut」を含む!) の後の行を空白行にする必要があります。 "。

パラグラフは空行で区切られているので、直前に空行がなければコマンド パラグラフを開始することは想像しにくいと思います。多分ファイルの先頭に？

Perl 6 では、Podが再定義され、コマンドの前後の空白行が不要になることに注意してください。

于 2010-11-27T07:24:04.583 に答える
4

POD には「段落」の概念があることに注意してください。これは空白 (空) 行の後に始まるものですが、ファイルの開始は例外であり、これも段落の開始です。つまり、特にコマンド (例: =head1 ) の前には空行が必要です。ENDは空行ではありません。

  • perlpodspecも参照してください。空白行が必要な理由がわかります。
于 2010-11-27T07:42:48.800 に答える