Document &CORE::nullary() calls
authorFather Chrysostomos <sprout@cpan.org>
Thu, 18 Aug 2011 05:25:39 +0000 (22:25 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Thu, 18 Aug 2011 13:50:57 +0000 (06:50 -0700)
lib/CORE.pod
pod/perldelta.pod

index 10fa424..d83763c 100644 (file)
@@ -32,10 +32,12 @@ CORE package, but is part of Perl's syntax.
 
 For many Perl functions, the CORE package contains real subroutines.  This
 feature is new in Perl 5.16.  You can take references to these and make
-aliases.  However, they can only be called as barewords; i.e., you cannot
+aliases.  However, most can only be called as barewords; i.e., you cannot
 use ampersand syntax (C<&foo>) or call them through references.  See the
-C<shove> example above.  This works for all overridable keywords, except
-for C<dump> and the infix operators.
+C<shove> example above.  These subroutines exist for all overridable
+keywords, except for C<dump> and the infix operators.  Calling with
+ampersand syntax and through references currently works only for functions
+that take no arguments, like C<fork>.
 
 =head1 OVERRIDING CORE FUNCTIONS
 
index 0c9488a..6af6eda 100644 (file)
@@ -38,16 +38,18 @@ here, but most should go in the L</Performance Enhancements> section.
 =head2 Subroutines in the CORE namespace
 
 Many Perl keywords are now available as subroutines in the CORE namespace.
-These cannot be called through references or via C<&foo> syntax yet, but
+Most of these cannot be called through
+references or via C<&foo> syntax yet, but
 must be called as barewords.  In other words, you can now do this:
 
     BEGIN { *entangle = \&CORE::tie }
     entangle $variable, $package, @args;
 
 This currently works for overridable keywords other than C<dump> and the
-infix operators.
+infix operators.  Calling through references only works for functions that
+take no arguments (like C<wantarray>).
 
-Work is under way to allow these subroutines to be called through
+Work is under way to allow more of these subroutines to be called through
 references.
 
 =head2 C<__FILE__()> Syntax