summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Golden <dagolden@cpan.org>2010-02-07 21:25:20 -0500
committerDavid Golden <dagolden@cpan.org>2010-02-07 21:25:20 -0500
commitfab55263f31aa58824db74ec3ea813ef835044a6 (patch)
tree9f026fcfdb8fda45ba560dfb413b270e5ce2b6eb
parentd412580b5bb56707bd663eed7c3e2147b4261de9 (diff)
downloadperl-fab55263f31aa58824db74ec3ea813ef835044a6.tar.gz
revise perldelta note on strict and lax version rules
-rw-r--r--pod/perl5120delta.pod30
1 files changed, 16 insertions, 14 deletions
diff --git a/pod/perl5120delta.pod b/pod/perl5120delta.pod
index 683415c384..4f177494f2 100644
--- a/pod/perl5120delta.pod
+++ b/pod/perl5120delta.pod
@@ -385,20 +385,22 @@ number format. See L<"Version number formats"> for details.
=head2 Version number formats
Acceptable version number formats have been formalized into "strict" and
-"lax" rules. C<package NAME VERSION> takes a strict version number. C<use
-NAME VERSION> takes a lax version number. C<UNIVERSAL::VERSION> and the
-L<version> object constructors take lax version numbers. Providing an
-invalid version will result in a fatal error.
-
-These formats will be documented fully in the L<version> module in a
-subsequent release of Perl 5.11. To a first approximation, a "strict"
-version number is a positive decimal number (integer or decimal-fraction)
-without exponentiation or else a dotted-decimal v-string with a leading 'v'
-character and at least three components. A "lax" version number allows
-v-strings with fewer than three components or without a leading 'v'. Under
-"lax" rules, both decimal and dotted-decimal versions may have a trailing
-"alpha" component separated by an underscore character after a fractional
-or dotted-decimal component.
+"lax" rules. C<package NAME VERSION> takes a strict version number.
+C<UNIVERSAL::VERSION> and the L<version> object constructors take lax
+version numbers. Providing an invalid version will result in a fatal
+error. The version argument in C<use NAME VERSION> is first parsed as a
+numeric literal or v-string and then passed to C<UNIVERSAL::VERSION>
+(and must then pass the "lax" format test).
+
+These formats are documented fully in the L<version> module. To a first
+approximation, a "strict" version number is a positive decimal number
+(integer or decimal-fraction) without exponentiation or else a
+dotted-decimal v-string with a leading 'v' character and at least three
+components. A "lax" version number allows v-strings with fewer than
+three components or without a leading 'v'. Under "lax" rules, both
+decimal and dotted-decimal versions may have a trailing "alpha"
+component separated by an underscore character after a fractional or
+dotted-decimal component.
The L<version> module adds C<version::is_strict> and C<version::is_lax>
functions to check a scalar against these rules.