doc for change#2978

p4raw-link: @2978 on //depot/perl: 2ba6ecf407bef45da384c153231c33d524202d81

p4raw-id: //depot/perl@2979

1 files changed, 4 insertions, 2 deletions

diff --git a/pod/perlsub.pod b/pod/perlsub.pod
index ef5a3c5fa2..3a5357392c 100644
--- a/pod/perlsub.pod
+++ b/pod/perlsub.pod
@@ -864,8 +864,10 @@ unbackslashed C<@> or C<%> eats all the rest of the arguments, and forces
 list context.  An argument represented by C<$> forces scalar context.  An
 C<&> requires an anonymous subroutine, which, if passed as the first
 argument, does not require the "C<sub>" keyword or a subsequent comma.  A
-C<*> does whatever it has to do to turn the argument into a reference to a
-symbol table entry.
+C<*> allows the subroutine to accept a bareword, constant, scalar expression,
+typeglob, or a reference to a typeglob in that slot.  The value will be
+available to the subroutine either as a simple scalar, or (in the latter
+two cases) as a reference to the typeglob.
 
 A semicolon separates mandatory arguments from optional arguments.
 (It is redundant before C<@> or C<%>.)