[Pdx-pm] February Meeting - Documenting Perl and Alternatives to POD
Ingy dot Net
ingy at ingy.net
Fri Feb 6 18:06:53 PST 2015
Please have a look at Swim: https://metacpan.org/pod/Swim
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
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)).
On Fri, Feb 6, 2015 at 5:29 PM, Anthony Johnson <aj at ohess.org> wrote:
> Hey all!
> 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.
> So it’s not that we don’t like POD, but...
> 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
> formatted documentation out of Perl source. I’ve been working on an
> extension to the Sphinx documentation engine to support writing rST
> formatted documentation in Perl source. Both attempts are in their infancy,
> so we’ll be looking for feedback and suggestions.
> 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.
> More info: http://calagator.org/events/1250467805
> See you all then,
> : http://daringfireball.net/projects/markdown/syntax
> : http://sphinx-doc.org
> : http://docutils.sourceforge.net/rst.html
> Anthony Johnson
> aj at ohess.org
> Pdx-pm-list mailing list
> Pdx-pm-list at pm.org
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Pdx-pm-list