POD 允许你在 Perl 代码中使用标记来创建文档。如果你见过 Javadoc 或 PHPdoc,它跟它们很相像。
POD 是语言的一部分,并非额外的规范。
使用 =head1 和 =head2 创建标题
要创建这样的列表:
- Wango
- Tango
- Fandango
=item * Wango
=item * Tango
=item * Fandango
=back
创建有序列表
要创建下面的列表:
- Visit perl101.org
- ???
- Profit!
使用:
POD 用 、I<>
及 C<>
分别表示粗体、斜体、代码。
I<This is italics>
C<This is code>
标记格式能够嵌套。
使用 L<> 超链接
段落会自动换行,并由至少一个空行分隔。
这来自于:
Everything in a paragraph word-wraps automatically. A paragraph
is separated by at least one blank line.
A literal block is indented at least one space
and does not
get
wrapped.
POD 不会使程序运行变慢
它将在编译时被去除。