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

Re^5: Any reason to have documentation-only *.pm file instead of *.pod for CPAN distro?

by Anonymous Monk
on Jan 04, 2025 at 10:19 UTC ( [id://11163557]=note: print w/replies, xml ) Need Help??


in reply to Re^4: Any reason to have documentation-only *.pm file instead of *.pod for CPAN distro?
in thread Any reason to have documentation-only *.pm file instead of *.pod for CPAN distro?

I'm new to POD and pod/pm interaction and precedence, please forgive my silly questions. I've just created Acme::AAA "distribution" tarball where I also included Cwd.pod to "hijack" a core module documentation. Then cpanm'd this tarball, checked with perldoc Cwd, and it printed "evil" content of my POD, not documentation extracted from Cwd.pm. Apart from, apparently, nothing prevents a "bad actor" to lure people to install something similar, but if uploaded to CPAN, what the https://metacpan.org/pod/Cwd would display then "globally"?

While we are at it, looks like perldoc link in SEE ALSO section of perlpod and elsewhere is broken in effect, it shows some obsolete Spanish translation.

  • Comment on Re^5: Any reason to have documentation-only *.pm file instead of *.pod for CPAN distro?
  • Select or Download Code

Replies are listed 'Best First'.
Re^6: Any reason to have documentation-only *.pm file instead of *.pod for CPAN distro?
by soonix (Chancellor) on Jan 04, 2025 at 12:45 UTC
Re^6: Any reason to have documentation-only *.pm file instead of *.pod for CPAN distro?
by marto (Cardinal) on Jan 08, 2025 at 11:03 UTC

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others avoiding work at the Monastery: (4)
As of 2026-01-16 15:48 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    What's your view on AI coding assistants?





    Results (119 votes). Check out past polls.

    Notices?
    hippoepoptai's answer Re: how do I set a cookie and redirect was blessed by hippo!
    erzuuliAnonymous Monks are no longer allowed to use Super Search, due to an excessive use of this resource by robots.