summaryrefslogtreecommitdiff
path: root/pod/perlguts.pod
diff options
context:
space:
mode:
authorPerl 5 Porters <perl5-porters@africa.nicoh.com>1997-04-01 12:01:35 +1200
committerChip Salzenberg <chip@atlantic.net>1997-04-01 12:01:35 +1200
commitdc848c6f6758d4d951bb5c7a9f432e6390e094df (patch)
treeb1ff54c203609fbf9148e072f34e0109600bb3a4 /pod/perlguts.pod
parent212ac238b7c76fe74b999bd66633ce1bda0b362f (diff)
downloadperl-dc848c6f6758d4d951bb5c7a9f432e6390e094df.tar.gz
[inseparable changes from match from perl-5.003_96 to perl-5.003_97]
CORE LANGUAGE CHANGES Subject: Reenable but deprecate inherited AUTOLOAD for plain funcs From: Chip Salzenberg <chip@perl.com> Files: ext/DynaLoader/DynaLoader.pm gv.c lib/Text/ParseWords.pm pod/perldelta.pod pod/perldiag.pod t/op/method.t CORE PORTABILITY Subject: Win32 update Date: Wed, 02 Apr 1997 01:08:09 -0500 From: Gurusamy Sarathy <gsar@engin.umich.edu> Files: win32/VC-2.0/modules.mak win32/VC-2.0/perl.mak win32/VC- 2.0/perldll.mak win32/perl.mak Msg-ID: 199704020608.BAA29538@aatma.engin.umich.edu (applied based on p5p patch as commit 8d0ff1118aaee510902477e928a660803304346c) DOCUMENTATION Subject: Clean up some poddities, and make C<make html> work again From: Chip Salzenberg <chip@perl.com> Files: pod/Makefile pod/perldelta.pod pod/perldiag.pod pod/perlfaq8.pod pod/perlfunc.pod pod/perlop.pod pod/perltrap.pod Subject: Eliminate pod warnings in libs From: Chip Salzenberg <chip@perl.com> Files: lib/CGI.pm lib/ExtUtils/Command.pm LIBRARY AND EXTENSIONS Subject: Eliminate warning in CGI.pm From: Chip Salzenberg <chip@perl.com> Files: lib/CGI.pm OTHER CORE CHANGES Subject: Introduce and use gv_fetchmethod_autoload() From: Chip Salzenberg <chip@perl.com> Files: global.sym gv.c pod/perlguts.pod proto.h universal.c
Diffstat (limited to 'pod/perlguts.pod')
-rw-r--r--pod/perlguts.pod30
1 files changed, 20 insertions, 10 deletions
diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index c14e17d0bd..382c6c2e00 100644
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -1400,24 +1400,34 @@ method's CV, which can be obtained from the GV with the C<GvCV> macro.
=item gv_fetchmethod
+=item gv_fetchmethod_autoload
+
Returns the glob which contains the subroutine to call to invoke the
-method on the C<stash>. In fact in the presense of autoloading this may
-be the glob for "AUTOLOAD". In this case the corresponing variable
+method on the C<stash>. In fact in the presense of autoloading this may
+be the glob for "AUTOLOAD". In this case the corresponding variable
$AUTOLOAD is already setup.
-Note that if you want to keep this glob for a long time, you need to
-check for it being "AUTOLOAD", since at the later time the call
+The third parameter of C<gv_fetchmethod_autoload> determines whether AUTOLOAD
+lookup is performed if the given method is not present: non-zero means
+yes, look for AUTOLOAD; zero means no, don't look for AUTOLOAD. Calling
+C<gv_fetchmethod> is equivalent to calling C<gv_fetchmethod_autoload> with a
+non-zero C<autoload> parameter.
+
+These functions grant C<"SUPER"> token as a prefix of the method name.
+
+Note that if you want to keep the returned glob for a long time, you
+need to check for it being "AUTOLOAD", since at the later time the call
may load a different subroutine due to $AUTOLOAD changing its value.
Use the glob created via a side effect to do this.
-This function grants C<"SUPER"> token as a prefix of the method name.
-
-Has the same side-effects and as C<gv_fetchmeth> with C<level==0>.
-C<name> should be writable if contains C<':'> or C<'\''>.
+These functions have the same side-effects and as C<gv_fetchmeth> with
+C<level==0>. C<name> should be writable if contains C<':'> or C<'\''>.
The warning against passing the GV returned by C<gv_fetchmeth> to
-C<perl_call_sv> apply equally to C<gv_fetchmethod>.
+C<perl_call_sv> apply equally to these functions.
GV* gv_fetchmethod _((HV* stash, char* name));
+ GV* gv_fetchmethod_autoload _((HV* stash, char* name,
+ I32 autoload));
=item gv_stashpv
@@ -2920,4 +2930,4 @@ API Listing by Dean Roehrich <F<roehrich@cray.com>>.
=head1 DATE
-Version 31.4: 1997/3/30
+Version 31.5: 1997/4/1