Document gv_stashpvn

This is already in the API supported by Devel::PPPort, and is
more efficient than gv_stashpv if the length is already known.

p4raw-id: //depot/perl@23644

1 files changed, 15 insertions, 2 deletions

diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index 1ac07ce0ac..1bdc2f286e 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -883,11 +883,24 @@ Found in file gv.c
 =item gv_stashpv
 
 Returns a pointer to the stash for a specified package.  C<name> should
-be a valid UTF-8 string.  If C<create> is set then the package will be
+be a valid UTF-8 string and must be null-terminated.  If C<create> is set
+then the package will be created if it does not already exist.  If C<create>
+is not set and the package does not exist then NULL is returned.
+
+	HV*	gv_stashpv(const char* name, I32 create)
+
+=for hackers
+Found in file gv.c
+
+=item gv_stashpvn
+
+Returns a pointer to the stash for a specified package.  C<name> should
+be a valid UTF-8 string.  The C<namelen> parameter indicates the length of
+the C<name>, in bytes.  If C<create> is set then the package will be
 created if it does not already exist.  If C<create> is not set and the
 package does not exist then NULL is returned.
 
-	HV*	gv_stashpv(const char* name, I32 create)
+	HV*	gv_stashpvn(const char* name, U32 namelen, I32 create)
 
 =for hackers
 Found in file gv.c