2010-09-30 62 views

Répondre

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

De faq.perl.org [perlfaq7]

La manière rapide et sale pour commenter plus d'une ligne de Perl est pour entourer ces lignes avec des directives Pod. Vous devez mettre ces directives au début de la ligne et quelque part où Perl attend une nouvelle instruction (donc pas au milieu des instructions comme les commentaires # ). Vous finissez le commentaire avec =cut, mettant fin à la section Pod:

=pod 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=cut 

La méthode rapide et sale ne fonctionne bien que lorsque vous ne prévoyez pas de laisser le code commenté dans la source. Si un parseur de Pod arrive, votre commentaire multiligne va apparaître dans la traduction de Pod. A une meilleure façon de le cacher à partir des analyseurs Pod. La directive peut marquer une section dans un but particulier. Si l'analyseur Pod ne veut pas le gérer, il l'ignore simplement. Marquez les commentaires avec comment. Terminez le commentaire en utilisant =end avec le même libellé . Vous avez encore besoin de la =cut pour revenir au code Perl du commentaire Pod :

=begin comment 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=end comment 

=cut 
+3

Il n'est pas nécessaire de lancer le commentaire avec = POD, vous pouvez utiliser n'importe quoi pour démarrer un commentaire multi-ligne (say = xyz etc) Mais oui end doit toujours être avec = cut not even = CUT – Bharat

21

Je l'ai trouvé. Perl a multi-lignes:

#!/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

entre '= pour comment' et' = cut', à partir du deuxième paragraphe, il sera montré dans * perldoc *. Ainsi, seul le premier paragraphe serait entièrement commenté à la fois par les codes et * perldoc *. Si cela doit être évité, utilisez '= begin comment' ... multi-lignes/commentaires de paragraphe ...' = fin de commentaire (* new-line *) = cut'. –