Ответ 1
POD is the official way to do multi line comments in Perl,
- см. Многострочные комментарии в perl код и
- Более эффективные способы создания многострочных комментариев в 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
. Завершите комментарий, используя=end
с помощью такой же ярлык. Вам все еще нужно=cut
вернуться к Perl-коду из Pod комментарий:
=begin comment
my $object = NotGonnaHappen->new();
ignored_sub();
$wont_be_assigned = 37;
=end comment
=cut