Alias de uma olhada na função <span style="font-family:arial,sans-serif;font-size:medium;background-color:rgb(255,255,255)">pod2usage</span><br><br><div class="gmail_quote">2012/12/18 Tiago Peczenyj <span dir="ltr"><<a href="mailto:tiago.peczenyj@gmail.com" target="_blank">tiago.peczenyj@gmail.com</a>></span><br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><br></div>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.<div>

<br></div><div>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.<div><div class="h5"><br>
<br><div class="gmail_quote">2012/12/18 Nicole Scherer <span dir="ltr"><<a href="mailto:bionica2007-perl@yahoo.com" target="_blank">bionica2007-perl@yahoo.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div><div style="font-size:12pt;font-family:times new roman,new york,times,serif"><div>Obrigada, Stanislaw, Aureliano e Tiago!</div><div><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


Vou estudar estes links que o Aureliano passou.</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


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.</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


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.</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


<br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">[]'s</div><span><font color="#888888"><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


Nicole</div></font></span><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


<br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">PS: Não sei como não entrei no rio-pm antes... é tão bom!!!!</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


<br><div><span></span></div></div><div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"><span></span></div><div>
<br></div>  </div><div style="font-family:times new roman,new york,times,serif;font-size:12pt"><div> </div><div style="font-family:times new roman,new york,times,serif;font-size:12pt"><div>
 <div dir="ltr"> <font face="Arial"> <hr size="1">  <b><span style="font-weight:bold">De:</span></b> Nicole Scherer <<a href="mailto:bionica2007-perl@yahoo.com" target="_blank">bionica2007-perl@yahoo.com</a>><br> <b><span style="font-weight:bold">Para:</span></b> "<a href="mailto:rio-pm@pm.org" target="_blank">rio-pm@pm.org</a>" <<a href="mailto:rio-pm@pm.org" target="_blank">rio-pm@pm.org</a>> <br>


 <b><span style="font-weight:bold">Enviadas:</span></b> Terça-feira, 18 de Dezembro de 2012 10:27<br> <b><span style="font-weight:bold">Assunto:</span></b> [Rio-pm] Perl POD<br> </font> </div></div><div><div> <br>
<div><div><div style="font-size:12pt;font-family:times new roman,new york,times,serif"><div>Oi Mongers,</div><div><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


vocês usam o perl POD para documentar seus scripts e pacotes, ou há outra estratégia de documentação mais recomendada.</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


<br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">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.</div>


<div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">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?</div>


<div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


Acho engraçado
 que o próprio nome "Plain Old Documentation format" diz que é antigo (o que não necessariamente significa desatualizado)</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


Li algo sobre "Natural Docs", alguém usa?</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"><br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


<br></div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">[]'s</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif">


Nicole</div><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"></div></div></div></div><br></div></div><div>_______________________________________________<br>


Rio-pm mailing list<br><a href="mailto:Rio-pm@pm.org" target="_blank">Rio-pm@pm.org</a><br><a href="http://mail.pm.org/mailman/listinfo/rio-pm" target="_blank">http://mail.pm.org/mailman/listinfo/rio-pm</a><br><br> </div>


</div> </div>  </div></div><br>_______________________________________________<br>
Rio-pm mailing list<br>
<a href="mailto:Rio-pm@pm.org" target="_blank">Rio-pm@pm.org</a><br>
<a href="http://mail.pm.org/mailman/listinfo/rio-pm" target="_blank">http://mail.pm.org/mailman/listinfo/rio-pm</a><br></blockquote></div><br><br clear="all"><div><br></div></div></div><div class="im">-- <br>Tiago B. Peczenyj<br>

Linux User #405772<br>
<br><a href="http://about.me/peczenyj" target="_blank">http://about.me/peczenyj</a><br>
</div></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Tiago B. Peczenyj<br>Linux User #405772<br><br><a href="http://about.me/peczenyj" target="_blank">http://about.me/peczenyj</a><br>