Beefy Boxes and Bandwidth Generously Provided by pair Networks
Welcome to the Monastery
 
PerlMonks  

Re^8: POD troubles (RTFM)

by John M. Dlugosz (Monsignor)
on May 14, 2011 at 12:08 UTC ( #904822=note: print w/replies, xml ) Need Help??


in reply to Re^7: POD troubles (RTFM)
in thread POD troubles

Right. older translators don't like that. Write it as below if you intend such older translators to be able to swallow it.

It doesn't say "POD files can't do this." It says "Many older Pod translators...". Meaning that others don't. "will make such Pod translators...fail". Not "will never work", but will make (only) those old nasty ones fail. That is, it's not backward compatible.

I don't see it meaning anything else. It's not like one of those cube pictures where it snaps into something different once you realize what was meant... it's saying that this example is not backward compatible, NOT that it's illegal.

Arguing is pointless. Clearly it is either wrong or at least capable of being misinterpreted by someone who read it carefully.

Replies are listed 'Best First'.
Re^9: POD troubles (RTFM)
by LanX (Sage) on May 14, 2011 at 12:15 UTC
    The documentation can't be clearer, it says that newer translators try to be more fault tolerant and is also explicit with counterexamples.

    See my last post for according passages.

    your problems are

    1. that you didn't expect core pod2html to be one of such older translators ... well welcome in the world of a >20 years old open-source project where backwards compatibility dominates.

    2. that you want that a tunnel view on a single paragraph already includes the information of a whole man-page.

    Cheers Rolf

    PS: I'm off!

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others exploiting the Monastery: (2)
As of 2021-10-16 12:58 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    My first memorable Perl project was:







    Results (69 votes). Check out past polls.

    Notices?