2010-09-30 36 views

Respuesta

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

De faq.perl.org [perlfaq7]

La forma más rápida y sucia a comentar a cabo más de una línea de Perl es rodear esas líneas con las directivas Pod. Debe colocar estas directivas al comienzo de la línea y en algún lugar donde Perl espera una nueva instrucción (por lo tanto, no en medio de declaraciones como # ). Se termina el comentario con =cut, poniendo fin a la sección de la vaina:

=pod 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=cut 

El método rápido y sucio de sólo funciona bien cuando no se va a dejar el código comentado en la fuente. Si aparece un analizador de Pod, , su comentario de líneas múltiples aparecerá en la traducción del Pod. Una mejor manera de también lo esconde de los analizadores de Pod.

La directiva puede marcar una sección para un propósito particular. Si el analizador de Pod no desea manejarlo, simplemente lo ignora. Etiqueta los comentarios con comment. Termine el comentario usando =end con la misma etiqueta . Todavía es necesario el =cut volver a código Perl del comentario Vaina:

=begin comment 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=end comment 

=cut 
+3

No es necesario comenzar el comentario con = POD, puede usar cualquier cosa para iniciar el comentario de varias líneas (decir = xyz, etc.) Pero sí, el final siempre debe estar con = cortar no incluso = CORTAR – Bharat

21

Lo encontré. Perl tiene comentarios multilínea:

#!/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 '= para comment' y' = corte', del segundo párrafo, se mostrará en * perldoc *. De modo que solo el primer párrafo se comentaría completamente desde ambos códigos y * perldoc *. Si esto debe evitarse, use '= begin comment' ... multi-lines/paragraph comments ...' = end comment (* new-line *) = cut'. –

Cuestiones relacionadas