Beefy Boxes and Bandwidth Generously Provided by pair Networks RobOMonk
"be consistent"
 
PerlMonks  

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.


Comment on Re: Is POD Syntax Obsolete?
Select or Download Code

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others chanting in the Monastery: (6)
As of 2014-04-25 02:08 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    April first is:







    Results (579 votes), past polls