This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
rewrite "ref" documentation for clarity
[perl5.git] / pod / perldelta.pod
index 94b416c..d6e9437 100644 (file)
@@ -168,6 +168,14 @@ Quoting of glob names now obeys the Useqq option [perl #119831].
 Attempts to set an option to C<undef> through a combined getter/setter
 method are no longer mistaken for getter calls [perl #113090].
 
+=item *
+
+L<Pod::Html> has been upgraded from version 1.2203 to 1.23.
+A title for the HTML document will now be automatically generated by
+default from a "NAME" section in the POD document, as it used to be
+before the module was rewritten to use L<Pod::Simple::XHTML> to do the
+core of its job.  [perl #110520]
+
 =back
 
 =head2 Removed Modules and Pragmata
@@ -233,6 +241,9 @@ already documented in L<perlref>, are now documented in L<perlsyn> too.
 
 =head3 L<perlfunc>
 
+There is now a note that warnings generated by built-in functions are
+documented in L<perldiag> and L<warnings>.  [perl #116080]
+
 The documentation for the C<exists> operator no longer says that
 autovivification behaviour "may be fixed in a future release".
 We've determined that we're not going to change the default behaviour.
@@ -245,6 +256,8 @@ The description of C<@INC> hooks in the documentation for C<require>
 has been corrected to say that filter subroutines receive a useless
 first argument.  [perl #115754]
 
+The documentation of C<ref> has been rewritten for clarity.
+
 The documentation of C<use> now explains what syntactically qualifies
 as a version number for its module version checking feature.
 
@@ -254,6 +267,12 @@ For each binary table or property, the documentation now includes which
 characters in the range C<\x00-\xFF> it matches, as well as a list of
 the first few ranges of code points matched above that.
 
+=head3 L<perlobj>
+
+The documentation about C<DESTROY> methods has been corrected, updated,
+and revised, especially in regard to how they interact with exceptions.
+[perl #122753]
+
 =head3 L<perlsec>
 
 The documentation about set-id scripts has been updated and revised.
@@ -344,6 +363,12 @@ XXX Describe change here
 
 =item *
 
+The warning about useless use of a concatenation operator in void context
+is now generated for expressions with multiple concatenations, such as
+C<$a.$b.$c>, which used to mistakenly not warn.  [perl #6997]
+
+=item *
+
 Warnings that a variable or subroutine "masks earlier declaration in same
 ...", or that an C<our> variable has been redeclared, have been moved to a
 new warnings category "shadow".  Previously they were in category "misc".
@@ -396,6 +421,13 @@ L</Platform Support> section, instead.
 
 XXX
 
+=item *
+
+Where an HTML version of the doucmentation is installed, the HTML
+documents now use relative links to refer to each other.  Links from
+the index page of L<perlipc> to the individual section documents are
+now correct.  [perl #110056]
+
 =back
 
 =head1 Testing
@@ -551,6 +583,17 @@ are re-aliased during execution of the sort comparator.  [perl #92264]
 
 =item *
 
+C<reverse> with no operand, reversing C<$_> by default, is no longer in
+danger of corrupting the stack.  [perl #132544]
+
+=item *
+
+C<exec>, C<system>, et al are no longer liable to have their argument
+lists corrupted by reentrant calls and by magic such as tied scalars.
+[perl #129888]
+
+=item *
+
 Perl's own C<malloc> no longer gets confused by attempts to allocate
 more than a gigabyte on a 64-bit platform.  [perl #119829]