canonical way to make stable link to most recent version of CPAN module documentation?

genehack has asked for the wisdom of the Perl Monks concerning the following question:

I'd like to link directly to the most recent version of documentation for a particular module -- for example, I'd like to have a link that takes me directly to http://search.cpan.org/~dwheeler/SVN-Notify-2.78/lib/SVN/Notify.pm that will automatically switch over to pointing to SVN::Notify version 2.79 (or greater) once a new release is made.

All the examples I've found on the net (after an admittedly short search) involve linking to search.cpan.org with an embedded query string, but this isn't what I want. I don't want to point to search results, I'd like to point directly to a particular piece of documentation, but always get the most recent version of it.

Is there any standard way of doing this?

Comment on canonical way to make stable link to most recent version of CPAN module documentation?

Replies are listed 'Best First'.
Re: canonical way to make stable link to most recent version of CPAN module documentation? by jettero (Monsignor) on Sep 24, 2008 at 10:43 UTC
You can actually just remove the version from the URL: http://search.cpan.org/~dwheeler/SVN-Notify/lib/SVN/Notify.pm If that behavior is documented, I do not know where. Of course, on here on PM you can also link with `[mod://SVN::Notify]`, but I imagine that's not what you're asking. -Paul	[reply] [d/l]
Re^2: canonical way to make stable link to most recent version of CPAN module documentation? by parv (Parson) on Sep 24, 2008 at 11:57 UTC
Thank you very much for showing.	[reply]
Re^2: canonical way to make stable link to most recent version of CPAN module documentation? by genehack (Beadle) on Sep 24, 2008 at 21:25 UTC
Thanks, that's exactly what I was looking for. (I did know about the [mod:] syntax but this is for my weblog, for instance.)	[reply]
Re: canonical way to make stable link to most recent version of CPAN module documentation? by moritz (Cardinal) on Sep 24, 2008 at 14:38 UTC
Every search.cpan.org documentation page contains the permalink link on the top right corner, which links to something like `http://search.cpan.org/perldoc?Test::More`.	[reply] [d/l]
Re^2: canonical way to make stable link to most recent version of CPAN module documentation? by genehack (Beadle) on Sep 24, 2008 at 21:27 UTC
Also exactly what I was looking for. Not sure why I overlooked that, actually... thanks.	[reply]
Re: canonical way to make stable link to most recent version of CPAN module documentation? by Your Mother (Archbishop) on Sep 25, 2008 at 07:00 UTC
What I've been doing for a few years and has worked perfectly (so far) is to swap "~author" for "dist" and take out the version. http://search.cpan.org/~dwheeler/SVN-Notify-2.78/lib/SVN/Notify.pm becomes http://search.cpan.org/dist/SVN-Notify/lib/SVN/Notify.pm.	[reply]
Re: canonical way to make stable link to most recent version of CPAN module documentation? by bingos (Vicar) on Sep 25, 2008 at 08:14 UTC
If you are trying to link documentation in other modules from your own module's documentation, I've always found that L<SVN::Notify> will DWIM	[reply]


go ahead... be a heretic
	PerlMonks