Integrate changes #9584,9587 from maintperl into mainline.

keep eval"" CVs alive until the end of the statement in which
they're called

add README.macos (from Chris Nandor)

tyop in change#9555

p4raw-link: @9587 on //depot/maint-5.6/perl: d72c2fc956b5cb46ede17d06f89a463c78f1cf5f
p4raw-link: @9584 on //depot/maint-5.6/perl: e6fbcc36a54a8afd8dbcdcb9a8d8e178df530b97
p4raw-link: @9555 on //depot/perl: 6a0af2f17bcde4767b90a72eff7083c5effff21d

p4raw-id: //depot/perl@9588
p4raw-branched: from //depot/maint-5.6/perl@9583 'branch in'
	README.macos
p4raw-integrated: from //depot/maint-5.6/perl@9583 'copy in'
	pod/perlfaq9.pod (@9585..) 'merge in' scope.h (@8568..)
	pod/perl.pod (@8986..) MANIFEST (@9227..) win32/Makefile
	(@9286..) pp_ctl.c scope.c (@9288..) global.sym (@9289..)
	embed.h embed.pl objXSUB.h perlapi.c proto.h (@9292..)
	pod/buildtoc.PL (@9312..) win32/makefile.mk (@9495..) sv.c
	(@9496..) pod/perlguts.pod (@9514..)

4 files changed, 18 insertions, 3 deletions

diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index 140341bb40..dbe88afec0 100644
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -160,6 +160,7 @@ if (-d "pod") {
     perlepoc             
     perlhpux            
     perlmachten         
+    perlmacos
     perlmpeix         
     perlos2             
     perlos390           
@@ -179,6 +180,7 @@ if (-d "pod") {
     perlepoc             
     perlhpux            
     perlmachten         
+    perlmacos
     perlmpeix
     perlos2             
     perlos390           
diff --git a/pod/perl.pod b/pod/perl.pod
index fd55b8d85f..3d0cbbe1b3 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -114,6 +114,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perlepoc		Perl notes for EPOC
     perlhpux		Perl notes for HP-UX
     perlmachten		Perl notes for Power MachTen
+    perlmacos		Perl notes for Mac OS (Classic)
     perlmpeix		Perl notes for MPE/iX
     perlos2		Perl notes for OS/2
     perlos390		Perl notes for OS/390
diff --git a/pod/perlfaq9.pod b/pod/perlfaq9.pod
index 2609c4482e..96763802c5 100644
--- a/pod/perlfaq9.pod
+++ b/pod/perlfaq9.pod
@@ -394,7 +394,7 @@ the MIME/QP encoding.  Decoding BASE64 becomes as simple as:
     use MIME::Base64;
     $decoded = decode_base64($encoded);
 
-The MIME-Tools package (available from CPAN) support exctraction with
+The MIME-Tools package (available from CPAN) supports extraction with
 decoding of BASE64 encoded attachments and content directly from email
 messages.
 
diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index dad868a712..3b10af9eee 100644
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -1127,8 +1127,20 @@ and back.
 =item C<SAVEFREESV(SV *sv)>
 
 The refcount of C<sv> would be decremented at the end of
-I<pseudo-block>. This is similar to C<sv_2mortal>, which should (?) be
-used instead.
+I<pseudo-block>.  This is similar to C<sv_2mortal> in that it is also a
+mechanism for doing a delayed C<SvREFCNT_dec>.  However, while C<sv_2mortal>
+extends the lifetime of C<sv> until the beginning of the next statement,
+C<SAVEFREESV> extends it until the end of the enclosing scope.  These
+lifetimes can be wildly different.
+
+Also compare C<SAVEMORTALIZESV>.
+
+=item C<SAVEMORTALIZESV(SV *sv)>
+
+Just like C<SAVEFREESV>, but mortalizes C<sv> at the end of the current
+scope instead of decrementing its reference count.  This usually has the
+effect of keeping C<sv> alive until the statement that called the currently
+live scope has finished executing.
 
 =item C<SAVEFREEOP(OP *op)>