This is a live mirror of the Perl 5 development currently hosted at
perlapi: Fix up SV handling pod
authorKarl Williamson <>
Sat, 4 Aug 2018 19:15:58 +0000 (13:15 -0600)
committerKarl Williamson <>
Sun, 5 Aug 2018 11:52:48 +0000 (05:52 -0600)
The pod for this has gotten screwed up over the releases, with a section
entitled SV-Body Allocation containing a bunch of SV manipulation
functions, and another section with that name containing still more with
no real rhyme or reason as to why one would be in one vs the other.  And
one function was in both places.  This commit consolidates all these
into one section entitled "SV Manipulation Functions"


diff --git a/handy.h b/handy.h
index 1f7ab84..2ce56ac 100644 (file)
--- a/handy.h
+++ b/handy.h
@@ -271,7 +271,7 @@ typedef U64TYPE U64;
-=head1 SV-Body Allocation
+=head1 SV Manipulation Functions
 =for apidoc Ama|SV*|newSVpvs|"literal string" s
 Like C<newSVpvn>, but takes a literal string instead of a
diff --git a/sv.c b/sv.c
index ed7047e..e0b7feb 100644 (file)
--- a/sv.c
+++ b/sv.c
@@ -791,9 +791,6 @@ Perl_sv_free_arenas(pTHX)
   are decremented to point at the unused 'ghost' memory, knowing that
   the pointers are used with offsets to the real memory.
-=head1 SV-Body Allocation
 Allocation of SV-bodies is similar to SV-heads, differing as follows;
diff --git a/sv.h b/sv.h
index 1c72242..f3392b0 100644 (file)
--- a/sv.h
+++ b/sv.h
@@ -1649,10 +1649,6 @@ Like C<sv_setsv> but doesn't process magic.
 =for apidoc Am|void|sv_catsv_nomg|SV* dsv|SV* ssv
 Like C<sv_catsv> but doesn't process magic.
-=for apidoc Amdb|STRLEN|sv_utf8_upgrade_nomg|SV *sv
-Like C<sv_utf8_upgrade>, but doesn't do magic on C<sv>.