From: Father Chrysostomos <sprout@cpan.org>
Date: Sun, 9 Oct 2011 05:23:50 +0000 (-0700)
Subject: Update docs for XS AUTOLOAD
X-Git-Tag: accepted/trunk/20130322.191538~2456
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=89fc9e2a93d8f1efaca9c57135763a5342ecdd36;p=platform%2Fupstream%2Fperl.git

Update docs for XS AUTOLOAD

This mentions the UTF8 flag and moves the discussion to perlapi, where
it belongs, IMHO.
---

diff --git a/pod/perlsub.pod b/pod/perlsub.pod
index 35d34f2..6d034f1 100644
--- a/pod/perlsub.pod
+++ b/pod/perlsub.pod
@@ -1433,8 +1433,7 @@ is not passed as an ordinary argument because, er, well, just
 because, that's why.  (As an exception, a method call to a nonexistent
 C<import> or C<unimport> method is just skipped instead.  Also, if
 the AUTOLOAD subroutine is an XSUB, C<$AUTOLOAD> is not populated;
-instead, you should call L<< C<SvPVX>E<sol>C<SvCUR>|perlapi >> on the
-C<CV> for C<AUTOLOAD> to retrieve the method name.)
+see L<perlapi/SvPVX> for details.)
 
 
 Many C<AUTOLOAD> routines load in a definition for the requested
diff --git a/sv.h b/sv.h
index c056423..46e53ac 100644
--- a/sv.h
+++ b/sv.h
@@ -685,6 +685,11 @@ Only use when you are sure SvNOK is true. See also C<SvNV()>.
 Returns a pointer to the physical string in the SV.  The SV must contain a
 string.
 
+During autoloading, if the AUTOLOAD routine is an XSUB, C<SvPVX(cv)>
+returns the name of the subroutine for which AUTOLOAD was invoked.
+Likewise, C<SvCUR(cv)> returns the length, and C<SvUTF8(cv)> returns true
+if the name is in UTF8.
+
 =for apidoc Am|STRLEN|SvCUR|SV* sv
 Returns the length of the string which is in the SV.  See C<SvLEN>.