<div>Nicole</div><div><br></div><div><br></div>POD é a muito tempo o esquema de documentação 'oficial', principalmente se você pensar em publicação(CPAN). É o que o CPAN aceita para publicações. Mas, provavelmente, estou bem mal-informado sobre isso. Melhor dar uma olhada, caso pretenda publicar algo no CPAN. <div>
<br></div><div><div>De qualquer forma, a muito tempo eu ouso falar no doxygen, embora nunca tenha usado. Se não me engano, é o esquema que o pessoal de PHP e Java se baseam para documentar. É possível 'cuspir' documentação em Latex, e outros formatos, assim como POD. A diferença é que eles tem APIs facilitadoras prontas para indexar e 'cuspir' documentação em vários formatos. POD é meio 'faca na caveira', até onde eu sei. Eu pelo menos, faço meus próprios scripts utilizando pod2html. No entanto eu imagino que o pessoal mais novo já faça algo mais interessante que isto, certo pessoal?</div>
<div><br></div><div><br></div><div><div><br></div><div>Cheers!</div><div><div><br></div><div><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">Isso não é gambiarra se vc usar certo.<div><br></div><div>agora a vantagem do pod é a documentação estar no mesmo arquivo que o seu módulo. assim vc não precisa editar dois ou mais arquivos para fazer uma simples alteração e evita que a documentação fique obsoleta.</div>
<div><br></div><div>e fica pratico com o perldoc Seu::Modulo</div><div><br></div><div>agora vc pode ter .pod especificos para tutoriais ou outras explicações. a vantagem do POD é ser built-in mas vc pode usar o que vc quiser pra documentar, como um simples README em texto puro ou markdown, LaTeX, postscript, pdf, word, etc. Tudo depende do que vc quer - timtowtdi. </div>
<div><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 class="h5">
<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><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><div style="font-style:normal;font-size:16px;background-color:transparent;font-family:times new roman,new york,times,serif"></div></font></span></div></div><br></div></div><div class="im">_______________________________________________<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></div></blockquote></div><span class="HOEnZb"><font color="#888888"><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>
</font></span></div>
<br>_______________________________________________<br>
Rio-pm mailing list<br>
<a href="mailto:Rio-pm@pm.org">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>-- <br>André Garcia Carneiro<br>Software Engineer<br>
(11)982907780<br>
</div></div></div></div>