From a1f85d995e8797503b4272d0177e662c998792a2 Mon Sep 17 00:00:00 2001 From: "Paul \"LeoNerd\" Evans" Date: Thu, 25 Jul 2024 16:54:18 +0100 Subject: [PATCH] perldelta: Document the new SvTYPE() checks added by 2463f19365 and related work --- pod/perldelta.pod | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 89b7430cd1b6..a9a305975e22 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -351,7 +351,16 @@ well. =item * -XXX +When built with the C<-DDEBUGGING> compile option, perl API functions that +take pointers to distinct types of SVs (AVs, HVs or CVs) will check the +C of the passed values to ensure they are valid. Additionally, +internal code within core functions that attempts to extract AVs, HVs or CVs +from reference values passed in will also perform such checks. + +While this has been entirely tested by normal Perl CI testing, there may +still be some corner-cases where these constraints are violated in +otherwise-valid calls. These may require further investigation if they are +found, and specific code to be adjusted to account for it. =back