On 12/9/2003 10:48 PM, Randy W. Sims wrote:
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>.
Alright, that was a stupid question. I was temporarily overwhelmed by the coolness of these features in search.cpan.org that I hadn't run into before. The link should be to (a), and the user can decide from that page to either download the package or browse online.
So I've fixed the subject back to the original to reflect the discussed topic.
After rereading the spec there are still a few open issues if anyone wants to comment on them.
[..]
2) There is overlap between the (currently undocumented) 'provides' and the 'no_index' fields. I've reread the arguments on this, and while I agree with Ken that ideally we should specify what is provided rather than what is not, I feel this is one of those cases where the practical and the ideal don't sync. (This is kinda like the situation in Ruby, where methods are public unless specified; It seems bass ackwards at first until you look at how classes are generally written in practice.) I vote to document but deprecate the 'provides' field in favor of 'no_index'.
Please don't deprecate either of the two. There is a place and time for both keys, as you have observed. What's important is to define how they overlap.
For example Apache provides Allow and Deny directives to configure access permissions. You can read the spec on how the configuration overlap and override each other here:
http://httpd.apache.org/docs-2.0/mod/mod_access.html#allow
http://httpd.apache.org/docs-2.0/mod/mod_access.html#deny
Apache uses the Order directive to explicitly tell the overriding order:
http://httpd.apache.org/docs-2.0/mod/mod_access.html#order
I think META.yml could mimic that behavior 1:1.
Also I'd be in favour of having more consistent naming than 'provides' and 'no_index' if they are kept together. So for example either 'provides'/'hides' and index/no_index or similar.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
