需要的Perl POD文檔中當空行

Question

我注意到，很多吊艙具有線，如

code 

    =head1 DESCRIPTION 

    text 

之間的空行，這些空行嚴格要求，做具體的解析器生氣，如果是失蹤。

爲說明削減在perlpod幫助一點點，但我想知道其他結構：

要結束波德塊，用一個空行， 然後用 開頭的行「=切「，後面還有一個空行。這讓Perl（和Pod格式化程序）知道這是Perl代碼正在恢復的地方。 （該 了「=切」前空行是不是技術上的必要， 但許多 年長波德處理器需要它。）

Answer 1

perldoc perlpod說：「每一個命令需要在空行後，結束其第「和」許多舊的Pod翻譯器在每個Pod命令之前和每個Pod命令（包括「= cut」！）之後都需要一行爲空行。

段落用空行描述，所以我覺得很難想象在段落前面沒有空行的情況下啓動一個段落。也許在文件的開始？

請注意，Perl 6, Pod被重新定義，以便命令（之前和之後）周圍的空行不再需要。

Answer 2

• 從POD::Parser

請注意，POD有「段落」的概念：這是一件空白（閱讀：空）後開始行，用文件開始的一個例外，這也開始一段。這意味着尤其是命令（例如= head1）必須以空行開頭; END不是空行。

• 看到perlpodspec也，你會發現 爲什麼空行 所需的原因。