This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Consolidate sv_dec-ish entries
authorKarl Williamson <khw@cpan.org>
Sun, 6 Sep 2020 03:45:54 +0000 (21:45 -0600)
committerKarl Williamson <khw@cpan.org>
Thu, 10 Sep 2020 01:56:34 +0000 (19:56 -0600)
sv.c

diff --git a/sv.c b/sv.c
index 0ed9d06..b259ace 100644 (file)
--- a/sv.c
+++ b/sv.c
@@ -9078,9 +9078,14 @@ Perl_sv_inc_nomg(pTHX_ SV *const sv)
 
 /*
 =for apidoc sv_dec
+=for apidoc_item sv_dec_nomg
 
-Auto-decrement of the value in the SV, doing string to numeric conversion
-if necessary.  Handles 'get' magic and operator overloading.
+These auto-decrement the value in the SV, doing string to numeric conversion
+if necessary.  They both handle operator overloading.
+
+They differ only in that:
+
+C<sv_dec> handles 'get' magic; C<sv_dec_nomg> skips 'get' magic.
 
 =cut
 */
@@ -9094,15 +9099,6 @@ Perl_sv_dec(pTHX_ SV *const sv)
     sv_dec_nomg(sv);
 }
 
-/*
-=for apidoc sv_dec_nomg
-
-Auto-decrement of the value in the SV, doing string to numeric conversion
-if necessary.  Handles operator overloading.  Skips handling 'get' magic.
-
-=cut
-*/
-
 void
 Perl_sv_dec_nomg(pTHX_ SV *const sv)
 {