This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
pad.c: Expand pad_push SVf_READONLY explanation
authorFather Chrysostomos <sprout@cpan.org>
Tue, 18 Jun 2013 23:51:57 +0000 (16:51 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Fri, 26 Jul 2013 06:47:59 +0000 (23:47 -0700)
pad.c

diff --git a/pad.c b/pad.c
index 2bbf866..3586b64 100644 (file)
--- a/pad.c
+++ b/pad.c
@@ -715,7 +715,10 @@ which will be set in the value SV for the allocated pad entry:
     SVf_READONLY constant shared between recursion levels
 
 C<SVf_READONLY> has been supported here only since perl 5.20.  To work with
-earlier versions as well, use C<SVf_READONLY|SVs_PADTMP>.
+earlier versions as well, use C<SVf_READONLY|SVs_PADTMP>.  C<SVf_READONLY>
+does not cause the SV in the pad slot to be marked read-only, but simply
+tells C<pad_alloc> that it I<will> be made read-only (by the caller), or at
+least should be treated as such.
 
 I<optype> should be an opcode indicating the type of operation that the
 pad entry is to support.  This doesn't affect operational semantics,