This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update UNIVERSAL::VERSION POD to reflect reality.
authorJohn Peacock <jpeacock@cpan.org>
Fri, 9 Dec 2011 01:55:37 +0000 (20:55 -0500)
committerDavid Golden <dagolden@cpan.org>
Fri, 9 Dec 2011 19:59:04 +0000 (14:59 -0500)
This should have been done when version objects were originally
added to the core back in 5.10.0.  Mea culpa.

[I bumped UNIVERSAL.pm version and added a perldelta entry. -- DG]

Signed-off-by: David Golden <dagolden@cpan.org>
lib/UNIVERSAL.pm
pod/perldelta.pod

index 4e41223..1adf09c 100644 (file)
@@ -1,6 +1,6 @@
 package UNIVERSAL;
 
 package UNIVERSAL;
 
-our $VERSION = '1.10';
+our $VERSION = '1.11';
 
 # UNIVERSAL should not contain any extra subs/methods beyond those
 # that it exists to define. The use of Exporter below is a historical
 
 # UNIVERSAL should not contain any extra subs/methods beyond those
 # that it exists to define. The use of Exporter below is a historical
@@ -168,6 +168,11 @@ it will do a comparison and die if the package version is not
 greater than or equal to C<REQUIRE>, or if either C<$VERSION> or C<REQUIRE>
 is not a "lax" version number (as defined by the L<version> module).
 
 greater than or equal to C<REQUIRE>, or if either C<$VERSION> or C<REQUIRE>
 is not a "lax" version number (as defined by the L<version> module).
 
+The return from C<VERSION> will actually be the stringified version object
+using the package C<$VERSION> scalar, which is guaranteed to be equivalent
+but may not be precisely the contents of the C<$VERSION> scalar.  If you want
+the actual contents of C<$VERSION>, use C<$CLASS::VERSION> instead.
+
 C<VERSION> can be called as either a class (static) method or an object
 method.
 
 C<VERSION> can be called as either a class (static) method or an object
 method.
 
index 85a80ca..42b71f6 100644 (file)
@@ -310,6 +310,12 @@ the locales: ja, ko, zh__big5han, zh__gb2312han, zh__pinyin, zh__stroke.
 
 Now Locale/*.pl files are searched in @INC.
 
 
 Now Locale/*.pl files are searched in @INC.
 
+=item *
+
+L<UNIVERSAL> has been upgraded from version 1.10 to 1.11.
+
+Documentation change clarifies return values from UNIVERSAL::VERSION.
+
 =back
 
 =head2 Removed Modules and Pragmata
 =back
 
 =head2 Removed Modules and Pragmata