Beefy Boxes and Bandwidth Generously Provided by pair Networks
Think about Loose Coupling
 
PerlMonks  

Re^2: Mysterious crash of perldoc

by Textorix (Acolyte)
on Mar 15, 2019 at 00:30 UTC ( #1231301=note: print w/replies, xml ) Need Help??


in reply to Re: Mysterious crash of perldoc
in thread Mysterious crash of perldoc

Hi Laurent_R,

Thanks for your reply... especially about the online renderer... that looks useful!

A resolution to the problem has been found--see update in the original post. It seems that perldoc will error out on a .pl or .pm file if some sort of paragraph starter other than =pod is not present, although podchecker does not flag this as invalid POD and no error occurs in perldoc if the file is a .pod file.

Replies are listed 'Best First'.
Re^3: Mysterious crash of perldoc
by davido (Cardinal) on Mar 15, 2019 at 14:46 UTC

    I looked at the source code for Pod::Perldoc yesterday and was also surprised to see =head being treated special explicitly in the code. In particular, subroutine containspod opens a file and looks for m/^=head/. It feels to me like that ought to allow for any of the POD commands, but certainly =pod. Perhaps that would violate some aspect of the spec, though I haven't been able to find anything suggesting that POD has to contain a =head1 command.

    I don't know if this qualifies as a bug, or if it's intended behavior. It is a little surprising though.


    Dave

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others examining the Monastery: (4)
As of 2021-12-04 17:13 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    R or B?



    Results (30 votes). Check out past polls.

    Notices?