diff options
Diffstat (limited to 'lib/version.pod')
| -rw-r--r-- | lib/version.pod | 19 |
1 files changed, 10 insertions, 9 deletions
diff --git a/lib/version.pod b/lib/version.pod index fcaf5d6acc..f4328f5439 100644 --- a/lib/version.pod +++ b/lib/version.pod @@ -11,15 +11,15 @@ version - Perl extension for Version Objects # Declaring a dotted-decimal $VERSION (keep on one line!) - use version 0.77; our $VERSION = version->declare("v1.2.3"); # formal - use version 0.77; our $VERSION = qv("v1.2.3"); # shorthand - use version 0.77; our $VERSION = qv("v1.2_3"); # alpha + use version; our $VERSION = version->declare("v1.2.3"); # formal + use version; our $VERSION = qv("v1.2.3"); # shorthand + use version; our $VERSION = qv("v1.2_3"); # alpha # Declaring an old-style decimal $VERSION (use quotes!) our $VERSION = "1.0203"; # recommended - use version 0.77; our $VERSION = version->parse("1.0203"); # formal - use version 0.77; our $VERSION = version->parse("1.02_03"); # alpha + use version; our $VERSION = version->parse("1.0203"); # formal + use version; our $VERSION = version->parse("1.02_03"); # alpha # Comparing mixed version styles (decimals, dotted-decimals, objects) @@ -60,9 +60,10 @@ source file. Quoting is recommended, as it ensures that trailing zeroes The more modern form of version assignment, with 3 (or potentially more) integers separated by decimal points (e.g. v1.2.3). This is the form that -Perl itself has used since 5.6.0 was released. The leading "v" is now +Perl itself has used since 5.6.0 was released. The leading 'v' is now strongly recommended for clarity, and will throw a warning in a future -release if omitted. +release if omitted. A leading 'v' character is required to pass the +L</is_strict()> test. =back @@ -95,7 +96,7 @@ Then increment any of the dotted-decimal components (v1.20.1 or v1.21.0). =head2 How to C<declare()> a dotted-decimal version - use version 0.77; our $VERSION = version->declare("v1.2.3"); + use version; our $VERSION = version->declare("v1.2.3"); The C<declare()> method always creates dotted-decimal version objects. When used in a module, you B<must> put it on the same line as "use version" to @@ -194,7 +195,7 @@ for dotted-decimal formats strings: =item C<is_strict()> -If you want to limit youself to a much more narrow definition of what +If you want to limit yourself to a much more narrow definition of what a version string constitutes, C<is_strict()> is limited to version strings like the following list: |