Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot

How do I link to an internal target on CPAN?

by roboticus (Chancellor)
on Nov 25, 2013 at 15:59 UTC ( #1064234=monkdiscuss: print w/replies, xml ) Need Help??

Hello, all:

I think I'm missing something: I can't seem to link into the middle of a document on CPAN as I would expect to be able to do. So I expect that either: (a) Someone may need to tap me with a cluebat, or (b) we may be missing a documentation shortcut.

Context: While answering a question (Re: Is it possible to run SQL select in Oracle ... tl;dr), I wanted to link to the fetchrow_hashref function in the DBI docs in CPAN. I expected that we would have a shortcut that could do so, but I wasn't able to figure out how to do it nicely.

I understand the standard shortcuts:

I was hoping I could use [mod://DBI#fetchrow_hashref] or [mod://] so I could link to the function in the latest version of the module, but neither works. Since neither worked, I tried linking to a specific version of DBI like [dist://DBI-1.630#fetchrow_hashref] and [dist://DBI-1.630/] but they don't work either.

So it doesn't look like I can do it unless I go to CPAN, find the appropriate location and paste in the link like: []. It's not a problem to do that, but I keep thinking that I must be doing it wrong.


When your only tool is a hammer, all problems look like your thumb.

Replies are listed 'Best First'.
Re: How do I link to an internal target on CPAN?
by tobyink (Abbot) on Nov 25, 2013 at 16:33 UTC

    For core modules and other documentation included with the Perl core distribution, you can use [doc://File::Spec#canonpath] (which results in: canonpath).

    use Moops; class Cow :rw { has name => (default => 'Ermintrude') }; say Cow->new->name
Re: How do I link to an internal target on CPAN? ([#])
by tye (Sage) on Nov 25, 2013 at 16:24 UTC

    Better handling of # in [] links was identified a long time ago as a needed improvement. I did some work on that but the roll out got rather gummed up for some fairly stupid reasons. Here's hoping I or somebody finds the time and motivation to revive or recreate that work sooner rather than later.

    - tye        

Re: How do I link to an internal target on CPAN? ( doc:// mod:// )
by Anonymous Monk on Nov 25, 2013 at 21:31 UTC

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: monkdiscuss [id://1064234]
Approved by marto
and all is quiet...

How do I use this? | Other CB clients
Other Users?
Others making s'mores by the fire in the courtyard of the Monastery: (3)
As of 2018-01-19 06:54 GMT
Find Nodes?
    Voting Booth?
    How did you see in the new year?

    Results (216 votes). Check out past polls.