• perlfunc
  [doc://open] --> open
• pragma:
  [doc://open.pm] --> open.pm
• pragma deeplink:
  [doc://open.pm#IMPLEMENTATION-DETAILS] --> IMPLEMENTATION DETAILS

• core module:
  [doc://B::Deparse] --> B::Deparse
• core module.pm: (same)
  [doc://B::Deparse.pm] --> B::Deparse.pm
• core module deeplink
  [doc://B::Deparse#Synopsis] --> Synopsis

... and for completenes

• perlvar:
  [doc://$_] --> $_

updates

• expanded and commented tests
• #IMPLEMENTATION-DETAILS was case sensitive
• added perlvar

G'day Rolf,

I don't know if you've made several typos or if there's a problem with your patch. Obviously, as you're awaiting approval for the patch, I can't test it.

You posted four links; these three are invalid:

http://perldoc.perl.org/open.pm.html
http://perldoc.perl.org/open.pm.html#Implementation-Details
http://perldoc.perl.org/B/Deparse.pm.html
[download]

In each case, if you remove the '.pm' part, they will be valid.

I think it would also be a good test to show the open function ([doc://open]) resolving to https://perldoc.perl.org/functions/open.html and the open pragma ([doc://open.pm]) resolving to https://perldoc.perl.org/open.html.

Update (additional information): More for completeness than anything else, I'll just add the http: is converted to https: by perldoc.perl.org regardless of whether the link is valid or not.

— Ken

Hi Ken

The ".pm" will be stripped from the URLs after the new patch is approved. (If ever)

Until that 3 of 4 shown links are broken.

[doc://] never knew a ".pm" notation before, this is a new feature.

See also Re^2: NEW [doc://perldoc#deeplink] works now with all perldocs

Cheers Rolf
_{(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery}

I've submitted a new patch...

Applied.

Thanks, all tests in Re^2: NEW [doc://perldoc#deeplink] works now with all perldocs ( pragmas/modules vs functions conflicts ) run fine.

You can link to it as a demo from the tidings, if you want.

Cheers Rolf
_{(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery}

[doc://open.pm#Implementation-Details] --> Implementation Details
FAILs... because apparently anchor names are case sensitive, and the anchor names in use (mostly?) on perldoc.perl.org are AlL-cApS. Try:

[doc://open.pm#IMPLEMENTATION-DETAILS] --> Implementation Details

Should we convert the user-supplied anchor name to uppercase for this purpose? I tend to think so... but only if we believe that that will work 99.9% of the time for perldoc.perl.org.

I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.

> FAILs... because apparently anchor names are case sensitive,

Race commenting, I ran and expanded the tests as soon as I saw your approval :)

> Should we convert the user-supplied anchor name to uppercase for this purpose?

No, I don't think so, we can't keep up to date with changes in perldoc.perl.org.

The author of the post should care.

Cheers Rolf
_{(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery}

Pragmas having the same name like functions are a problem for doc, and there is no possible DWIM solution to decide which one is meant:

• https://perldoc.perl.org/functions/open.html
• https://perldoc.perl.org/open.html

Your attempt to write open.pm to indicate a module/pragma might be a workaround.

PS: FWIW personally I'm using my own JS solution, which takes the full URL but shortens the text.

• so this https://perldoc.perl.org/open.html#Implementation-Details
• becomes [HTTPs://perldoc.perl.org/open.html#Implementation-Details|open#Implementation-Details]
• displays open#Implementation-Details

Indeed, adding .pm to indicate the pragma DWYM. :-)

• [doc://open] -> open
• [doc://open.pm] -> open.pm
I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.