=head1 cabecera =head2 cabecera =item texto =over N =back =cut =pod =for X =begin X =end X
=pod
, =cut
Es útil cuando mezclas código y documentación. Le indica a Perl
que lo que sigue es documentación hasta que se alcance el siguiente
=cut
.
=head1
, =head2
Primer y segundo nivel de encabezamiento.
El texto cabecera
debe estar en el mismo párrafo que la directiva.
=over
, =back
, =item
=over
comienza una lista, =back
la termina
y los elementos de la lista se especifican con =item
.
El número que se le pasa a =over
indica el sangrado de los
items.
Veamos un ejemplo:
=over 4 =item * Bla, bla, primer item =item * Mas bla, bla, segundo item =back
Mantenga la consitencia en la presentación: use =item *
para producir puntos o bien la forma =item 1.
, =item 2.
, etc.
=for
, =begin
, =end
Nos permiten incluir secciones que no contienen texto POD
sino que van dirigidas a formatos especiales.
La directiva =for
tiene como ámbito el siguiente párrafo:
=for html <br> <p> Esto sólo aparece en HTML</p>
Mientras que =begin
y =end
delimitan el texto en cuestión.
Ademas de html
, otros nombres que se aceptan son
roff
, man
, latex
, tex
y text
.
Casiano Rodríguez León