Alias de uma olhada na função pod2usage 2012/12/18 Tiago Peczenyj <[email protected]>
> > Eu tenho as minhas duvidas. Para pacotes sim é muito util pois cada função > que vc esta exportando ou cada método é importante de ser documentado pois > vai ser utilizado fora dali. > > Agora se eu tenho um script ou uma aplicação eu gosto de colocar no final > para ter uma noção clara de todo o codigo. > > > 2012/12/18 Nicole Scherer <[email protected]> > >> Obrigada, Stanislaw, Aureliano e Tiago! >> >> Vou estudar estes links que o Aureliano passou. >> >> Eu só usei até agora o POD depois do _END_ , mas vi que ele pode ser >> muito mais útil se eu usar desde o cabeçalho do script, poupando assim meus >> comentários tipo ### sobre cada função. >> Vou preparar uma apresentação sobre o uso do POD para meus colegas do >> laboratório. Se for implementado por todos, vai nos facilitar muito a vida. >> >> []'s >> Nicole >> >> >> PS: Não sei como não entrei no rio-pm antes... é tão bom!!!! >> >> >> ------------------------------ >> *De:* Nicole Scherer <[email protected]> >> *Para:* "[email protected]" <[email protected]> >> *Enviadas:* Terça-feira, 18 de Dezembro de 2012 10:27 >> *Assunto:* [Rio-pm] Perl POD >> >> 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 >> [email protected] >> http://mail.pm.org/mailman/listinfo/rio-pm >> >> >> _______________________________________________ >> Rio-pm mailing list >> [email protected] >> http://mail.pm.org/mailman/listinfo/rio-pm >> > > > > -- > Tiago B. Peczenyj > Linux User #405772 > > http://about.me/peczenyj > -- Tiago B. Peczenyj Linux User #405772 http://about.me/peczenyj
_______________________________________________ Rio-pm mailing list [email protected] http://mail.pm.org/mailman/listinfo/rio-pm
