Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation

Re: Is POD Syntax Obsolete?

by pemungkah (Priest)
on Jun 13, 2013 at 03:40 UTC ( #1038661=note: print w/replies, xml ) Need Help??

in reply to Is POD Syntax Obsolete?

POD has you covered. From perldoc perlpod:
For, begin, and end will let you have regions of text/code/data that are not generally interpreted as normal POD text, but are passed directly to particular formatters, or are otherwise special. A formatter that can use that format will use the region, otherwise it will be completely ignored.
So you could write a Markdown POD formatter that would look for these and interpret the paragraphs as Markdown.
=begin markdown # PARAMETERS The following are good parameters: * **-foo** ... =end markdown
Since the text is otherwise ignored if the formatter doesn't know how to handle it, you don't get weird-looking stuff in your output if this runs through the usual POD formatter.

Log In?

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://1038661]
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others cooling their heels in the Monastery: (3)
As of 2022-05-28 06:50 GMT
Find Nodes?
    Voting Booth?
    Do you prefer to work remotely?

    Results (98 votes). Check out past polls.