Personally, I've always thought that Perl has a very natural feel to it, and deserves a doc markup format that's also natural: [Markdown] (and [Pandoc]'s Markdown has just the right additions, IMO).
[Markdown]: http://daringfireball.net/projects/markdown/ [Pandoc]: http://johnmacfarlane.net/pandoc/ My plan is to keep writing my own various docs in Pandoc Markdown (regardless of what programming language I'm working in at the moment), and if I *really* need POD5 or POD6, just use Pandoc to convert them to html, and then find a module on the CPAN to convert the resulting html to POD5 or POD6 (Pandoc doesn't currently convert directly to either Pod). I encourage others to do the same. It's funny; the Python folks left their previous doc format (LaTeX), and went (IMO) in the right direction, but ended up going with the less attractive [reST] rather than Markdown. [reST]: http://docutils.sourceforge.net/rst.html ---John
