Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl-Sensitive Sunglasses
 
PerlMonks  

Re: Is POD Syntax Obsolete?

by pemungkah (Priest)
on Jun 13, 2013 at 03:40 UTC ( [id://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?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others learning in the Monastery: (5)
As of 2024-03-28 19:58 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found