Subject: | Fix pod warnings against podchecker |
Some podchecker warnings in dist:
mstevens@osaka:~/CPAN-Meta-2.110440.orig %
~/bleadperl/build/bin/podchecker5.13.9 **/*.pm
lib/CPAN/Meta/Converter.pm pod syntax OK.
lib/CPAN/Meta/Feature.pm pod syntax OK.
lib/CPAN/Meta/History.pm pod syntax OK.
lib/CPAN/Meta.pm pod syntax OK.
lib/CPAN/Meta/Prereqs.pm pod syntax OK.
lib/CPAN/Meta/Spec.pm pod syntax OK.
*** ERROR: =over on line 888 without closing =back (at head2) at line
903 in file lib/CPAN/Meta/Validator.pm
*** ERROR: =over on line 905 without closing =back (at head1) at line
966 in file lib/CPAN/Meta/Validator.pm
lib/CPAN/Meta/Validator.pm has 2 pod syntax errors.
mstevens@osaka:~/CPAN-Meta-2.110440.orig %
Should be fixed by patch.
Subject: | cpan.meta.pod.diff |
diff -urN CPAN-Meta-2.110440.orig/lib/CPAN/Meta/Validator.pm CPAN-Meta-2.110440/lib/CPAN/Meta/Validator.pm
--- CPAN-Meta-2.110440.orig/lib/CPAN/Meta/Validator.pm 2011-02-13 03:55:35.000000000 +0000
+++ CPAN-Meta-2.110440/lib/CPAN/Meta/Validator.pm 2011-02-19 21:00:15.000000000 +0000
@@ -891,13 +891,16 @@
Checks whether a map (or hash) part of the data structure conforms to the
appropriate specification definition.
+
=item * check_list($spec,$data)
Checks whether a list (or array) part of the data structure conforms to
the appropriate specification definition.
+
=item * check_lazylist($spec,$data)
Checks whether a list conforms, but converts strings to a single-element list
+
=back
=head2 Validator Methods
@@ -911,54 +914,67 @@
Note: No longer used as we now read the data structure, not the file.=item * url($self,$key,$value)
Validates that a given value is in an acceptable URL format
+
=item * urlspec($self,$key,$value)
Validates that the URL to a META specification is a known one.
+
=item * string_or_undef($self,$key,$value)
Validates that the value is either a string or an undef value. Bit of a
catchall function for parts of the data structure that are completely user
defined.
+
=item * string($self,$key,$value)
Validates that a string exists for the given key.
+
=item * file($self,$key,$value)
Validate that a file is passed for the given key. This may be made more
thorough in the future. For now it acts like \&string.
+
=item * exversion($self,$key,$value)
Validates a list of versions, e.g. '<= 5, >=2, ==3, !=4, >1, <6, 0'.
+
=item * version($self,$key,$value)
Validates a single version string. Versions of the type '5.8.8' and '0.00_00'
are both valid. A leading 'v' like 'v1.2.3' is also valid.
+
=item * boolean($self,$key,$value)
Validates for a boolean value. Currently these values are '1', '0', 'true',
'false', however the latter 2 may be removed.
+
=item * license($self,$key,$value)
Validates that a value is given for the license. Returns 1 if an known license
type, or 2 if a value is given but the license type is not a recommended one.
+
=item * custom_1($self,$key,$value)
Validates that the given key is in CamelCase, to indicate a user defined
keyword and only has characters in the class [-_a-zA-Z]. In version 1.X
of the spec, this was only explicitly stated for 'resources'.
+
=item * custom_2($self,$key,$value)
Validates that the given key begins with 'x_' or 'X_', to indicate a user
defined keyword and only has characters in the class [-_a-zA-Z]
+
=item * identifier($self,$key,$value)
Validates that key is in an acceptable format for the META specification,
for an identifier, i.e. any that matches the regular expression
qr/[a-z][a-z_]/i.
+
=item * module($self,$key,$value)
Validates that a given key is in an acceptable module name format, e.g.
'Test::CPAN::Meta::Version'.
+
=back
=end internals