From a24ded606bb59c5c16a2c1b6af192beca18b734f Mon Sep 17 00:00:00 2001 From: Father Chrysostomos Date: Thu, 2 Dec 2010 18:02:06 -0800 Subject: [PATCH] Document the explicit * in tie *$handle --- pod/perltie.pod | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/pod/perltie.pod b/pod/perltie.pod index 791753d..d23c667 100644 --- a/pod/perltie.pod +++ b/pod/perltie.pod @@ -869,6 +869,13 @@ All of this is especially useful when perl is embedded in some other program, where output to STDOUT and STDERR may have to be redirected in some special way. See nvi and the Apache module for examples. +When tying a handle, the first argument to C should begin with an +asterisk. So, if you are tying STDOUT, use C<*STDOUT>. If you have assigned +it to a scalar variable, say C<$handle>, use C<*$handle>. C +works, too, but that is considered a bug and will be fixed in Perl 5.16. It +is supposed to tie the scalar C<$handle>, not the handle inside it. +C emits a deprecation warning as of Perl 5.14. + In our example we're going to create a shouting handle. package Shout; -- 2.7.4