【发布时间】:2011-04-19 04:44:13
【问题描述】:
【问题讨论】:
-
只需做 =head ##你的代码来注释 =cut
标签: perl comments multiline perl-data-structures
【问题讨论】:
标签: perl comments multiline perl-data-structures
POD is the official way to do multi line comments in Perl,
来自 faq.perl.org[perlfaq7]
注释掉多行 Perl 的快速而简单的方法是 用 Pod 指令包围这些行。你必须把这些 在行首和 Perl 的某处的指令 需要一个新的语句(所以不在像 # 这样的语句中间 厘米)。您以
=cut结束评论,结束 Pod 部分:
=pod
my $object = NotGonnaHappen->new();
ignored_sub();
$wont_be_assigned = 37;
=cut
只有当你不打算这样做时,这种快速而肮脏的方法才有效 将注释代码留在源代码中。如果出现 Pod 解析器, 您的多行注释将显示在 Pod 翻译中。一种 更好的方法也将其从 Pod 解析器中隐藏起来。
=begin指令可以为特定目的标记一个部分。如果 Pod 解析器不想处理它,它只是忽略它。标签 带有comment的 cmets。使用=end结束评论 相同的标签。您仍然需要=cut从 播客评论:
=begin comment
my $object = NotGonnaHappen->new();
ignored_sub();
$wont_be_assigned = 37;
=end comment
=cut
【讨论】:
我找到了。 Perl 有多行 cmets:
#!/usr/bin/perl
use strict;
use warnings;
=for comment
Example of multiline comment.
Example of multiline comment.
=cut
print "Multi Line Comment Example \n";
【讨论】:
=for comment 和=cut 之间,从第二段开始,它将显示在perldoc 中。所以只有第一段会从代码和 perldoc 中得到完整的注释。如果应该避免这种情况,请使用=begin comment ...multi-lines/paragraph cmets...=end comment (*new-line*) =cut。