Change t/pragma/warn oct()/hex() overflow tests to use %Config

[perl5.git] / pod / perlguts.pod

diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index c5289a1..2c6d3a2 100644 (file)
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -2286,7 +2286,8 @@ SV is set to 1.
 =item newSVpv
 
 Creates a new SV and copies a string into it.  The reference count for the
-SV is set to 1.  If C<len> is zero then Perl will compute the length.
+SV is set to 1.  If C<len> is zero, Perl will compute the length using
+strlen().  For efficiency, consider using C<newSVpvn> instead.
 
        SV*     newSVpv (const char* s, STRLEN len)
 
@@ -2295,13 +2296,14 @@ SV is set to 1.  If C<len> is zero then Perl will compute the length.
 Creates a new SV an initialize it with the string formatted like
 C<sprintf>.
 
-       SV*     newSVpvf(const char* pat, ...);
+       SV*     newSVpvf(const char* pat, ...)
 
 =item newSVpvn
 
 Creates a new SV and copies a string into it.  The reference count for the
-SV is set to 1.  If C<len> is zero then Perl will create a zero length 
-string.
+SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length 
+string.  You are responsible for ensuring that the source string is at least
+C<len> bytes long.
 
        SV*     newSVpvn (const char* s, STRLEN len)
 
@@ -2424,9 +2426,10 @@ set and the variable does not exist then NULL is returned.
 
 =item perl_get_cv
 
-Returns the CV of the specified Perl sub.  If C<create> is set and the Perl
-variable does not exist then it will be created.  If C<create> is not
-set and the variable does not exist then NULL is returned.
+Returns the CV of the specified Perl subroutine.  If C<create> is set and
+the Perl subroutine does not exist then it will be declared (which has
+the same effect as saying C<sub name;>).  If C<create> is not
+set and the subroutine does not exist then NULL is returned.
 
        CV*     perl_get_cv (const char* name, I32 create)
 
@@ -2772,7 +2775,7 @@ Returns a boolean indicating whether the SV is derived from the specified
 class.  This is the function that implements C<UNIVERSAL::isa>.  It works
 for class names as well as for objects.
 
-       bool    sv_derived_from _((SV* sv, const char* name));
+       bool    sv_derived_from (SV* sv, const char* name);
 
 =item SvEND
 
@@ -3399,18 +3402,18 @@ Processes its arguments like C<vsprintf> and appends the formatted output
 to an SV.  Uses an array of SVs if the C style variable argument list is
 missing (NULL).  Indicates if locale information has been used for formatting.
 
-       void    sv_catpvfn _((SV* sv, const char* pat, STRLEN patlen,
-                             va_list *args, SV **svargs, I32 svmax,
-                             bool *used_locale));
+       void    sv_catpvfn (SV* sv, const char* pat, STRLEN patlen,
+                           va_list *args, SV **svargs, I32 svmax,
+                           bool *used_locale);
 
 =item sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale)
 
 Works like C<vcatpvfn> but copies the text into the SV instead of
 appending it.
 
-       void    sv_setpvfn _((SV* sv, const char* pat, STRLEN patlen,
-                             va_list *args, SV **svargs, I32 svmax,
-                             bool *used_locale));
+       void    sv_setpvfn (SV* sv, const char* pat, STRLEN patlen,
+                           va_list *args, SV **svargs, I32 svmax,
+                           bool *used_locale);
 
 =item SvUV