In perl.git, the branch blead has been updated
<http://perl5.git.perl.org/perl.git/commitdiff/66b30015e9d89a525f42ddbf87f0c41bcdee0ba4?hp=f60cb31d9ea9f1e3a5fc5e411fc7b1d8978b2dc2>
- Log -----------------------------------------------------------------
commit 66b30015e9d89a525f42ddbf87f0c41bcdee0ba4
Author: David Golden <dagol...@cpan.org>
Date: Thu Jul 5 19:39:59 2012 -0400
perlfunc: clarify docs for 'our' [perl #113974]
In response to the thread, this attempts to clarify the aliasing and
scope of 'our' (as well as 'use vars').
-----------------------------------------------------------------------
Summary of changes:
pod/perldelta.pod | 4 ++--
pod/perlfunc.pod | 25 ++++++++++++-------------
2 files changed, 14 insertions(+), 15 deletions(-)
diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 6ebd93c..23057b6 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -152,13 +152,13 @@ XXX Changes which significantly change existing files in
F<pod/> go here.
However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
section.
-=head3 L<XXX>
+=head3 L<perlfunc>
=over 4
=item *
-XXX Description of the change here
+Clarified documentation of C<our>.
=back
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 3413d29..bd46787 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -4269,18 +4269,17 @@ X<our> X<global>
=for Pod::Functions +5.6.0 declare and assign a package variable (lexical
scoping)
-C<our> associates a simple name with a package variable in the current
-package for use within the current scope. When C<use strict 'vars'> is in
-effect, C<our> lets you use declared global variables without qualifying
-them with package names, within the lexical scope of the C<our> declaration.
-In this way C<our> differs from C<use vars>, which is package-scoped.
-
-Unlike C<my> or C<state>, which allocates storage for a variable and
-associates a simple name with that storage for use within the current
-scope, C<our> associates a simple name with a package (read: global)
-variable in the current package, for use within the current lexical scope.
-In other words, C<our> has the same scoping rules as C<my> or C<state>, but
-does not necessarily create a variable.
+C<our> makes a lexical alias to a package variable of the same name in the
current
+package for use within the current lexical scope.
+
+C<our> has the same scoping rules as C<my> or C<state>, but C<our> only
+declares an alias, whereas C<my> or C<state> both declare a variable name and
+allocate storage for that name within the current scope.
+
+This means that when C<use strict 'vars'> is in effect, C<our> lets you use
+a package variable without qualifying it with the package name, but only within
+the lexical scope of the C<our> declaration. In this way, C<our> differs from
+C<use vars>, which creates file-scoped aliases instead.
If more than one value is listed, the list must be placed
in parentheses.
@@ -4288,7 +4287,7 @@ in parentheses.
our $foo;
our($bar, $baz);
-An C<our> declaration declares a global variable that will be visible
+An C<our> declaration declares an alias for a package variable that will be
visible
across its entire lexical scope, even across package boundaries. The
package in which the variable is entered is determined at the point
of the declaration, not at the point of use. This means the following
--
Perl5 Master Repository
