In perl.git, the branch blead has been updated
<https://perl5.git.perl.org/perl.git/commitdiff/d5407247046f2f01c1492998b32b3b148445febe?hp=16ada235c332e017667585e1a5a00ce43a31c529>
- Log -----------------------------------------------------------------
commit d5407247046f2f01c1492998b32b3b148445febe
Author: Zefram <zef...@fysh.org>
Date: Tue Dec 12 10:16:46 2017 +0000
better document version check aspect of "use"
-----------------------------------------------------------------------
Summary of changes:
pod/perlfunc.pod | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 0cf5031c25..18a52113be 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -9389,6 +9389,15 @@ The L<default C<VERSION> method|UNIVERSAL/C<VERSION ( [
REQUIRE ] )>>,
inherited from the L<C<UNIVERSAL>|UNIVERSAL> class, croaks if the given
version is larger than the value of the variable C<$Module::VERSION>.
+The VERSION argument cannot be an arbitrary expression. It only counts
+as a VERSION argument if it is a version number literal, starting with
+either a digit or C<v> followed by a digit. Anything that doesn't
+look like a version literal will be parsed as the start of the LIST.
+Nevertheless, many attempts to use an arbitrary expression as a VERSION
+argument will appear to work, because L<Exporter>'s C<import> method
+handles numeric arguments specially, performing version checks rather
+than treating them as things to export.
+
Again, there is a distinction between omitting LIST (L<C<import>|/import
LIST> called with no arguments) and an explicit empty LIST C<()>
(L<C<import>|/import LIST> not called). Note that there is no comma
--
Perl5 Master Repository
