2010-09-30 16 views

Odpowiedz

114
POD is the official way to do multi line comments in Perl, 

Od faq.perl.org [perlfaq7]

quick-and-brudny sposób wypowiedzieć się więcej niż jedna linia Perl jest aby otoczyć te linie dyrektywami Pod. Musisz umieścić te dyrektywy na początku linii i gdzieś, gdzie Perl oczekuje nowego wyciągu (a więc nie w środku instrukcji, takich jak komentarze # ). Skończyć komentarz z =cut, kończąc sekcji Pod:

=pod 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=cut 

Szybko i brzydka metoda działa dobrze tylko wtedy, gdy nie planują opuścić skomentowany kod w źródle. Jeśli pojawi się parownik Pod, , twój komentarz wielowierszowy pojawi się w tłumaczeniu podpodu. Lepszy sposób ukrywa go również przed parserami Pod.

Dyrektywa może oznaczyć sekcję do określonego celu. Jesli parser Pod nie chce sobie z tym poradzic, po prostu je ignoruje. Etykieta komentarze z comment. Zakończ komentarz, używając =end z tą samą etykietą. Trzeba jeszcze =cut wrócić do kodu Perl z komentarzem Pod:

=begin comment 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=end comment 

=cut 
+3

Nie trzeba zaczynać komentarza za pomocą = POD, możesz użyć dowolnej rzeczy, aby rozpocząć komentarz wielowierszowy (powiedzmy = xyz itp.) Ale tak koniec musi zawsze być z = cut not even = CUT – Bharat

21

Znalazłem. Perl posiada komentarzy multi-line:

#!/usr/bin/perl 

use strict; 

use warnings; 

=for comment 

Example of multiline comment. 

Example of multiline comment. 

=cut 

print "Multi Line Comment Example \n"; 
+2

W latach '= dla comment' i' = cut', z drugiego akapitu, pojawi się w * perldoc *. Więc tylko pierwszy akapit będzie w pełni skomentowany z obu kodów i * perldoc *. Jeśli tego uniknąć, użyj '= rozpocznij komentarz' ... komentarze wieloliniowe/akapity ...' = komentarz końcowy (* nowa linia *) = cut'. –