metacpan-web icon indicating copy to clipboard operation
metacpan-web copied to clipboard

Opening source prefers pod over pm files

Open Leont opened this issue 11 years ago • 9 comments

When clicking on the source button for a module that has split .pod and .pm files, it will open the (fairly useless) .pod file instead of the much more useful .pm file. For example Net::LDAP.

Leont avatar Feb 05 '14 13:02 Leont

There is a .pod AND a .pm file for Net::LDAP - https://metacpan.org/pod/Net::LDAP has the correct link

ranguard avatar Feb 05 '14 13:02 ranguard

Maybe need a 'source .pod' and 'source .pm' link or something?

ranguard avatar Feb 05 '14 13:02 ranguard

+1 to this.

I keep running into it and every time I do it's far from obvious initially why the file I'm looking at doesn't contain any perl code. It surprises me every single time.

leonerd avatar Dec 08 '16 19:12 leonerd

https://metacpan.org/pod/Net::LDAP has the correct link

That isn't very helpful when both the search engine and the distribution overview link to the pod.

Leont avatar Dec 08 '16 19:12 Leont

This is mostly fixed now. The distribution page now links to the .pm file, which has separate links for the source and pod source. The search page is still linking the pod file though.

haarg avatar Dec 20 '16 01:12 haarg

The distribution page is now correctly linking to the pm file.

haarg avatar Mar 20 '17 09:03 haarg

On my reading, this could be closed? It offers a "Pod source" link now?

mohawk2 avatar Apr 22 '20 01:04 mohawk2

I think the remaining issue is that the actual search links to https://metacpan.org/pod/distribution/perl-ldap/lib/Net/LDAP.pod

oalders avatar Apr 22 '20 01:04 oalders

Bump. Recently started splitting my code and documentation and this problem annoys me. There's no clear indication that "Source" will show me pod, not perl. Also no easy way to go to corresponding .pm file, the easiest seems to be changing the extension in the browser address bar...

bbrtj avatar Nov 28 '22 16:11 bbrtj