Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
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 UNIVERSAL.pm version and added a perldelta entry. -- DG]

Signed-off-by: David Golden <dagolden@cpan.org>
  • Loading branch information...
commit a3e88ad7b21876c5341fd043218d0725ec4c4fcb 1 parent 249f7dd
John Peacock authored dagolden committed
Showing with 12 additions and 1 deletion.
  1. +6 −1 lib/UNIVERSAL.pm
  2. +6 −0 pod/perldelta.pod
View
7 lib/UNIVERSAL.pm
@@ -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
method.
View
6 pod/perldelta.pod
@@ -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.
+
=back
=head2 Removed Modules and Pragmata
Please sign in to comment.
Something went wrong with that request. Please try again.