diff options
author | David Golden <dagolden@cpan.org> | 2010-02-07 21:25:20 -0500 |
---|---|---|
committer | David Golden <dagolden@cpan.org> | 2010-02-07 21:25:20 -0500 |
commit | fab55263f31aa58824db74ec3ea813ef835044a6 (patch) | |
tree | 9f026fcfdb8fda45ba560dfb413b270e5ce2b6eb | |
parent | d412580b5bb56707bd663eed7c3e2147b4261de9 (diff) | |
download | perl-fab55263f31aa58824db74ec3ea813ef835044a6.tar.gz |
revise perldelta note on strict and lax version rules
-rw-r--r-- | pod/perl5120delta.pod | 30 |
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. |