This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
PerlIO::Via: check arg is non-NULL before using it.
[perl5.git] / pod / perl561delta.pod
index cc411dc..1ccc85a 100644 (file)
@@ -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.
@@ -743,7 +744,7 @@ than C<$]> (a numeric value).  (This is a potential incompatibility.
 Send us a report via perlbug if you are affected by this.)
 
 The v1.2.3 syntax is also now legal in Perl.
-See L<Support for strings represented as a vector of ordinals> for more on that.
+See L</Support for strings represented as a vector of ordinals> for more on that.
 
 To cope with the new versioning system's use of at least three significant
 digits for each version component, the method used for incrementing the
@@ -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.
 
@@ -2085,7 +2092,7 @@ capabilities.  In other words: if your operating system has the
 necessary APIs and datatypes, you should be able just to go ahead and
 use them, for threads by Configure -Dusethreads, and for 64 bits
 either explicitly by Configure -Duse64bitint or implicitly if your
-system has 64-bit wide datatypes.  See also L<"64-bit support">.
+system has 64-bit wide datatypes.  See also L</"64-bit support">.
 
 =head2 Long Doubles
 
@@ -2096,7 +2103,7 @@ Perl's scalars, use -Duselongdouble.
 =head2 -Dusemorebits
 
 You can enable both -Duse64bitint and -Duselongdouble with -Dusemorebits.
-See also L<"64-bit support">.
+See also L</"64-bit support">.
 
 =head2 -Duselargefiles
 
@@ -2104,7 +2111,7 @@ Some platforms support system APIs that are capable of handling large files
 (typically, files larger than two gigabytes).  Perl will try to use these
 APIs if you ask for -Duselargefiles.
 
-See L<"Large file support"> for more information. 
+See L</"Large file support"> for more information. 
 
 =head2 installusrbinperl
 
@@ -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
@@ -3444,7 +3450,7 @@ is executed:
 
 =over
 
-=item 
+=item *
 
 64-bit builds
 
@@ -3459,7 +3465,7 @@ in 64-bit HP-UX.  The test attempts to create and connect to
 
 Note that 64-bit support is still experimental.
 
-=item 
+=item *
 
 Failure of Thread tests
 
@@ -3468,7 +3474,7 @@ fundamental problems in the 5.005 threading implementation.  These are
 not new failures--Perl 5.005_0x has the same bugs, but didn't have these
 tests.  (Note that support for 5.005-style threading remains experimental.)
 
-=item
+=item *
 
 NEXTSTEP 3.3 POSIX test failure
 
@@ -3477,7 +3483,7 @@ operating system libraries is buggy: the %j format numbers the days of
 a month starting from zero, which, while being logical to programmers,
 will cause the subtests 19 to 27 of the lib/posix test may fail.
 
-=item 
+=item *
 
 Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with gcc