perldelta: clarify the deprecation of non-PerlIO perl

[perl5.git] / pod / perl561delta.pod

diff --git a/pod/perl561delta.pod b/pod/perl561delta.pod
index ddc2509..49ff54f 100644 (file)
--- a/pod/perl561delta.pod
+++ b/pod/perl561delta.pod
@@ -1,6 +1,6 @@
 =head1 NAME
 
-perl561delta - what's new for perl v5.6.x
+perl561delta - what's new for perl v5.6.1
 
 =head1 DESCRIPTION
 
@@ -343,9 +343,10 @@ C<Configure -S> can be run non-interactively.
 
 =head2 Documentation
 
-README.aix, README.solaris and README.macos have been added.  README.posix-bc
-has been renamed to README.bs2000.  These are installed as L<perlaix>,
-L<perlsolaris>, L<perlmacos>, and L<perlbs2000> respectively.
+README.aix, README.solaris and README.macos have been added.
+README.posix-bc has been renamed to README.bs2000.  These are
+installed as L<perlaix>, L<perlsolaris>, L<perlmacos>, and
+L<perlbs2000> respectively.
 
 The following pod documents are brand new:
 
@@ -502,7 +503,7 @@ You will need a thread library package installed.  See README.hpux.
 
 Long doubles should now work under Linux.
 
-MacOS Classic is now supported in the mainstream source package.
+Mac OS Classic is now supported in the mainstream source package.
 See README.macos.
 
 Support for MPE/iX has been updated.  See README.mpeix.
@@ -762,13 +763,13 @@ as requiring an automatic lock() when it is entered, you had to declare
 that with a C<use attrs> pragma in the body of the subroutine.
 That can now be accomplished with declaration syntax, like this:
 
-    sub mymethod : locked method ;
+    sub mymethod : locked method;
     ...
     sub mymethod : locked method {
        ...
     }
 
-    sub othermethod :locked :method ;
+    sub othermethod :locked :method;
     ...
     sub othermethod :locked :method {
        ...
@@ -1384,9 +1385,15 @@ already.  The fatal error has been downgraded to an optional warning:
 
 This warns you that C<"fred@example.com"> is going to turn into
 C<fred.com> if you don't backslash the C<@>.
-See http://www.plover.com/~mjd/perl/at-error.html for more details
+See http://perl.plover.com/at-error.html for more details
 about the history here.
 
+=head2 @- and @+ provide starting/ending offsets of regex submatches
+
+The new magic variables @- and @+ provide the starting and ending
+offsets, respectively, of $&, $1, $2, etc.  See L<perlvar> for
+details.
+
 =head1 Modules and Pragmata
 
 =head2 Modules
@@ -1402,7 +1409,7 @@ See L<attributes>.
 =item B
 
 The Perl Compiler suite has been extensively reworked for this
-release.  More of the standard Perl testsuite passes when run
+release.  More of the standard Perl test suite passes when run
 under the Compiler, but there is still a significant way to
 go to achieve production quality compiled executables.
 
@@ -2970,7 +2977,6 @@ You should use the new declaration syntax instead.
 The C<use attrs> pragma is now obsolete, and is only provided for
 backward-compatibility. See L<perlsub/"Subroutine Attributes">.
 
-
 =item Premature end of script headers
 
 See Server error.
@@ -3357,8 +3363,8 @@ Note that the above issue is not relevant to the default build of
 Perl, whose interfaces continue to match those of prior versions
 (but subject to the other options described here).
 
-See L<perlguts/"The Perl API"> for detailed information on the
-ramifications of building Perl with this option.
+See L<perlguts/Background and PERL_IMPLICIT_CONTEXT> for detailed information
+on the ramifications of building Perl with this option.
 
     NOTE: PERL_IMPLICIT_CONTEXT is automatically enabled whenever Perl is built
     with one of -Dusethreads, -Dusemultiplicity, or both.  It is not