Beefy Boxes and Bandwidth Generously Provided by pair Networks
Don't ask to ask, just ask
 
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 surveying the Monastery: (9)
As of 2015-07-30 10:38 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (271 votes), past polls