summaryrefslogtreecommitdiff
path: root/lib/vars.pm
diff options
context:
space:
mode:
authorDavid Golden <dagolden@cpan.org>2012-07-05 19:58:28 -0400
committerDavid Golden <dagolden@cpan.org>2012-07-05 20:09:23 -0400
commit4d457ce0560741d33b57646b4da5e244cee8f8ef (patch)
tree67c5d6ef7839de00fcaf8e4d03c49f50628d419c /lib/vars.pm
parent0edb7bc2fb00ba77e194e13a9f0bb9a0a05cbcb2 (diff)
downloadperl-4d457ce0560741d33b57646b4da5e244cee8f8ef.tar.gz
vars.pm: remove 'obsolete' description [perl #113974]
The phrase 'obsolete' in the abstract is not well defined and may be inappropriate. This commit removes it and clarifies that use of vars.pm is discouraged when 'our' could be used instead. No perldelta note was added, as the change is trivial, despite the version number bump.
Diffstat (limited to 'lib/vars.pm')
-rw-r--r--lib/vars.pm11
1 files changed, 6 insertions, 5 deletions
diff --git a/lib/vars.pm b/lib/vars.pm
index 8ec107c1df..6ca6bb4d2c 100644
--- a/lib/vars.pm
+++ b/lib/vars.pm
@@ -2,7 +2,7 @@ package vars;
use 5.006;
-our $VERSION = '1.02';
+our $VERSION = '1.03';
use warnings::register;
use strict qw(vars subs);
@@ -48,7 +48,7 @@ __END__
=head1 NAME
-vars - Perl pragma to predeclare global variable names (obsolete)
+vars - Perl pragma to predeclare global variable names
=head1 SYNOPSIS
@@ -56,9 +56,10 @@ vars - Perl pragma to predeclare global variable names (obsolete)
=head1 DESCRIPTION
-NOTE: For variables in the current package, the functionality provided
-by this pragma has been superseded by C<our> declarations, available
-in Perl v5.6.0 or later. See L<perlfunc/our>.
+NOTE: For use with variables in the current package for a single scope, the
+functionality provided by this pragma has been superseded by C<our>
+declarations, available in Perl v5.6.0 or later, and use of this pragma is
+discouraged. See L<perlfunc/our>.
This will predeclare all the variables whose names are
in the list, allowing you to use them under "use strict", and