Perl 教程 之 Perl POD 文档 1
Perl POD 文档
Perl 中可以在模块或脚本中嵌入 POD(Plain Old Documentation) 文档。
POD 是一种简单而易用的标记型语言(置标语言)。
POD 文档使用规则:
POD 文档以 =head1 开始, =cut 结束, =head1 前与 =cut 后添加一空行。
Perl 会忽略 POD 中的文档。实例如下:
实例
!/usr/bin/perl
print "Hello, World\n";
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
=cut
print "Hello, Baidu\n";
执行以上程序,输出结果为:
Hello, World
Hello, Baidu
我们还可以使用 "END" 或 "DATA" 将所在行之后的内容全部"注释"掉:
实例
!/usr/bin/perl
print "Hello, World\n";
while(){
print $_;
}
END
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, Baidu\n";
执行以上程序,输出结果为:
Hello, World
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, Baidu\n";
以下实例不读取 POD 文档:
实例
!/usr/bin/perl
print "Hello, World\n";
END
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, Baidu\n";
执行以上程序,输出结果为:
Hello, World
以下实例不读取 POD 文档:
实例
!/usr/bin/perl
print "Hello, World\n";
END
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, Baidu\n";
执行以上程序,输出结果为:
Hello, World