Re: linking to PODs on search.cpan.org (was Re: META.yml Update Proposal)

On 12/8/2003 5:12 PM, Graham Barr wrote:
> 
> On 8 Dec 2003, at 21:55, Stas Bekman wrote:
> 
>> Graham Barr wrote:
>>
>>> On 8 Dec 2003, at 20:42, Stas Bekman wrote:
>>>
>>>> Also Graham, it'd be really nice to have search.cpan.org support 
>>>> 'exact match', many times I want to link to a module in the docs 
>>>> using search.cpan.org, and ?query=Foo::Bar is not the best choice as 
>>>> it gives you more than one matches most of the time and sometimes 
>>>> the right choice is not on the top. I think only when you say: 
>>>> ?query=Foo::Bar&mode=module it gives you that module first (e.g. 
>>>> search for CGI). But I want to be able to link directly to the 
>>>> latest version (that you get to after following one of the links 
>>>> from the search's output) and not search output.
>>>
>>> If you are trying to link to the POD of a module, then you should be 
>>> using /perldoc?CGI
>>
>>
>> No, I want to be able to link to the distribution dir, e.g.:
>> http://search.cpan.org/~lds/CGI.pm-3.00/
>> without that -3.00 version in the path, so it'll always point to the 
>> latest distro.
> 
> 
>   http://search.cpan.org/dist/CGI.pm/
> 
> Graham.
> 

Ok, one more question (I hope). Let's say that the spec is put in a 
distribution with a 'Makefile.PL' and/or 'Build.PL' file. Let's say it's 
named CPAN-META-Specification-1.1.tar.gz. When we link to it, what do we 
link to: a) the package, 
L<http://search.cpan.org/dist/CPAN-META-Specifiction/>, or b) the 
pod/html inside the package, 
L<http://search.cpan.org/dist/CPAN-META-Specifiction/Specification.pod>.

Randy.

PS: The current draft update proposal is at 
<http://www.thepierianspring.org/META-spec.html>.

-- 
A little learning is a dang'rous thing;
Drink deep, or taste not the Pierian spring;
There shallow draughts intoxicate the brain;
And drinking largely sobers us again.
                 - Alexander Pope