Beefy Boxes and Bandwidth Generously Provided by pair Networks
Keep It Simple, Stupid
 
PerlMonks  

Re^3: POD troubles

by LanX (Canon)
on May 14, 2011 at 10:37 UTC ( #904802=note: print w/ replies, xml ) Need Help??


in reply to Re^2: POD troubles
in thread POD troubles

> but the first example that is implied to work on current translators shows =head paragraphs immediately after "plain" paragraph text, which contradicts the bulk of the documentation. Presumably the bulk of the document was not updated with new rules, when this example was tacked on to the end.

could you please post this "wrong" example, I can't find it.

Cheers Rolf


Comment on Re^3: POD troubles
Re^4: POD troubles
by John M. Dlugosz (Monsignor) on May 14, 2011 at 11:18 UTC
    OK, it states:


    Many older Pod translators require the lines before every Pod command and after every Pod command (including "=cut"!) to be a blank line. Having something like this:
        # - - - - - - - - - - - -
        =item $firecracker->boom()
        This noisily detonates the firecracker object.
        =cut
        sub boom {
        ...
    
    ...will make such Pod translators completely fail to see the Pod block at all.


    So, "many older translators" don't like that, but current ones do? Otherwise why bother mentioning it?

      sigh ... thank you for wasting my time!

      Cheers Rolf

        I don't follow. This passage implies that this is supposed to work (except on "some old translators"), but it contradicts the bulk of the document which states that paragraphs must be followed by (actually, terminated with) a blank line.

        I was indeed reading the fine manual, read it end to end several times, and cross-checked versions 10.1 and the current 12.whatever. My observation stands: the example which is implied to work as-is on current translators contradicts the description given earlier. If it's not intended to work, why explain that it must be changed for "older" parsers? If it never works at all, it's a silly thing to say.

        I think I can afford the -- vote. But I think it's unwarranted, after re-reading my post.

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others about the Monastery: (7)
As of 2014-07-28 22:48 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    My favorite superfluous repetitious redundant duplicative phrase is:









    Results (210 votes), past polls