Browse files

Update UNIVERSAL::VERSION POD to reflect reality.

This should have been done when version objects were originally
added to the core back in 5.10.0.  Mea culpa.

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

Signed-off-by: David Golden <>
  • Loading branch information...
1 parent 249f7dd commit a3e88ad7b21876c5341fd043218d0725ec4c4fcb John Peacock committed with xdg Dec 9, 2011
Showing with 12 additions and 1 deletion.
  1. +6 −1 lib/
  2. +6 −0 pod/perldelta.pod
@@ -1,6 +1,6 @@
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
@@ -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).
+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
@@ -310,6 +310,12 @@ the locales: ja, ko, zh__big5han, zh__gb2312han, zh__pinyin, zh__stroke.
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.
=head2 Removed Modules and Pragmata

0 comments on commit a3e88ad

Please sign in to comment.