<div dir="ltr"><div><div><div>Please have a look at Swim: <a href="https://metacpan.org/pod/Swim">https://metacpan.org/pod/Swim</a><br><br></div>I have converted the Pod of all my more important CPAN dists (80+) to it. (Swim in the GitHub repo becomes Pod on CPAN). I also use it to doc my Bash projects like:<br><br><ul><li><a href="https://github.com/ingydotnet/git-hub#readme">https://github.com/ingydotnet/git-hub#readme</a></li><li><a href="https://github.com/ingydotnet/git-subrepo#readme">https://github.com/ingydotnet/git-subrepo#readme</a></li><li><a href="https://github.com/ingydotnet/test-more-bash#readme">https://github.com/ingydotnet/test-more-bash#readme</a><br></li><li><a href="https://github.com/ingydotnet/json-bash/#readme">https://github.com/ingydotnet/json-bash/#readme</a><br></li></ul><br></div>It is meant to be a superset of Pod and Markdown and others, while having a syntax nicer than all of them. It generates perfect Pod (which is a wonderful markup (if you don't have to write it by hand)).<br><br>Cheers, Ingy<br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Feb 6, 2015 at 5:29 PM, Anthony Johnson <span dir="ltr"><<a href="mailto:aj@ohess.org" target="_blank">aj@ohess.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hey all!<br>
<br>
It’s that time again! We’ll be meeting next week, Feb 12th. It seemed support for a downtown meetup was relatively high, if there is no objection, we’ll just host at the same venue as last month (PIE on NW 12th and Davis). Definitely send your feedback my way if you have any, we don’t want to exclude anyone.<br>
<br>
So it’s not that we don’t like POD, but...<br>
<br>
Stefan and I will be discussing some new alternatives to POD that we’ve both been working on. Stefan has been working on parsing Markdown[1] formatted documentation out of Perl source. I’ve been working on an extension to the Sphinx documentation engine[2] to support writing rST[3] formatted documentation in Perl source. Both attempts are in their infancy, so we’ll be looking for feedback and suggestions.<br>
<br>
If anyone else would like to join in, or if someone wants to defend lowly ol’ POD, you’re welcome to join in as well.<br>
<br>
More info: <a href="http://calagator.org/events/1250467805" target="_blank">http://calagator.org/events/1250467805</a><br>
<br>
See you all then,<br>
Anthony<br>
<br>
[1]: <a href="http://daringfireball.net/projects/markdown/syntax" target="_blank">http://daringfireball.net/projects/markdown/syntax</a><br>
[2]: <a href="http://sphinx-doc.org" target="_blank">http://sphinx-doc.org</a><br>
[3]: <a href="http://docutils.sourceforge.net/rst.html" target="_blank">http://docutils.sourceforge.net/rst.html</a><br>
--<br>
Anthony Johnson<br>
<a href="mailto:aj@ohess.org">aj@ohess.org</a><br>
@agjhnsn<br>
<br>
<br>
<br>
<br>
_______________________________________________<br>
Pdx-pm-list mailing list<br>
<a href="mailto:Pdx-pm-list@pm.org">Pdx-pm-list@pm.org</a><br>
<a href="http://mail.pm.org/mailman/listinfo/pdx-pm-list" target="_blank">http://mail.pm.org/mailman/listinfo/pdx-pm-list</a></blockquote></div><br></div>