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>