我注意到很多Pod在这些行之间有空白行
code
=head1 DESCRIPTION
text
这些空白行是否严格需要,如果缺少特定的解析器,会让他们感到沮丧.
关于perlpod 切入的描述有点帮助,但我想知道其他结构:
要结束Pod块,请使用空行,然后使用以"= cut"开头的行,并在其后面加一个空行.这让Perl(和Pod格式化程序)知道这是Perl代码恢复的地方.("= cut"之前的空白行在技术上不是必需的,但许多较旧的Pod处理器需要它.)
perldoc perlpod说"每个命令都需要后面的空行,结束它的段落"和"许多旧的Pod转换器需要在每个Pod命令之前和每个Pod命令之后(包括"= cut"!)为空白行".
段落用空行描绘,所以我发现很难想象在它前面没有空行的情况下启动一个命令段落.也许在文件的开头？
请注意,在Perl 6中,Pod被重新定义,因此不再需要命令(之前和之后)的空白行.
| 归档时间： |
|
| 查看次数： |
514 次 |
| 最近记录： |