[Rio-pm] Perl POD

[Stanislaw Pusep]

Costumo comentar os blocos de código assim:

=for comment
$_='while(read+STDIN,$_,2048){$a=29;$b=73;$c=142;$t=255;@t=map{$_%16or$t^=$c^=(
$m=(11,10,116,100,11,122,20,100)[$_/16%8])&110;$t^=(72, em z=(64,72,$a^=12*($_%16
-2?0:$m&17)),$b^=$_%64?12:0, em z)[$_%8]}(16..271);if((@a=unx"C*",$_)[20]&48){$h
=5;$_=unxb24,join"", em b=map{xB8,unxb8,chr($_^$a[--$h+84])}@ARGV;s/...$/1$&/;$
d=unxV,xb25,$_;$e=256|(ord$b[4])<<9|ord$b[3];$d=$d8^($f=$t&($d12^$d4^
$d^$d/8))<<17,$e=$e8^($t&($g=($q=$e14&7^$e)^$q*8^$q<<6))<<9,$_=$t[$_]^
(($h=8)+=$f+(~$g&$t))for em a[128..$#a]}print+x"C*", em a}';s/x/pack+/g;eval
=cut


ABS()



2012/12/18 Nicole Scherer <bionica2007-perl em yahoo.com>

> Oi Mongers,
>
> vocês usam o perl POD para documentar seus scripts e pacotes, ou há outra
> estratégia de documentação mais recomendada.
>
> Pergunto, porque já usei (bem pouquinho) o POD, só que com ele eu perco a
> gambiarra de comentar pedaços grandes de código usando o =begin ... =cut.
> Existe outra estratégia não-gambiarra de comentar pedaços de código que
> não seja colocando # no início de cada linha?
>
> Acho engraçado que o próprio nome "Plain Old Documentation format" diz que
> é antigo (o que não necessariamente significa desatualizado)
> Li algo sobre "Natural Docs", alguém usa?
>
>
> []'s
> Nicole
>
> _______________________________________________
> Rio-pm mailing list
> Rio-pm em pm.org
> http://mail.pm.org/mailman/listinfo/rio-pm
>
-------------- Próxima Parte ----------
Um anexo em HTML foi limpo...
URL: <http://mail.pm.org/pipermail/rio-pm/attachments/20121218/926b4a61/attachment.html>