Beefy Boxes and Bandwidth Generously Provided by pair Networks
Clear questions and runnable code
get the best and fastest answer
 
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.

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? | Other CB clients
Other Users?
Others browsing the Monastery: (3)
As of 2023-03-27 04:51 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    Which type of climate do you prefer to live in?






    Results (63 votes). Check out past polls.

    Notices?