In perl.git, the branch blead has been updated
<http://perl5.git.perl.org/perl.git/commitdiff/18a6db115daa0eae0c26f4c6877876d1117159c0?hp=55108fc8754e2bc60bfcce2f4c6389f06cbe6f53>
- Log -----------------------------------------------------------------
commit 18a6db115daa0eae0c26f4c6877876d1117159c0
Author: David Golden <dagol...@cpan.org>
Date: Fri Jun 10 11:55:56 2011 -0400
Show diagnostic link format in perldelta template
M Porting/perldelta_template.pod
M t/porting/known_pod_issues.dat
commit 2592f3b832c159dbaca3ea37d8d842e46310bb8a
Author: David Golden <dagol...@cpan.org>
Date: Fri Jun 10 13:54:35 2011 -0400
podcheck.t: decode verbatim paragraphs before checking length
M t/porting/known_pod_issues.dat
M t/porting/podcheck.t
commit bdab33d100838438dfafd8d5afc02de7514f4365
Author: David Golden <dagol...@cpan.org>
Date: Fri Jun 10 12:59:26 2011 -0400
Partial perldelta update through 9603df1
Additional documentation related entries have not yet been added
M pod/perldelta.pod
commit e67bd9d27a537b59af930ff5814f5b4e57008f61
Author: David Golden <dagol...@cpan.org>
Date: Fri Jun 10 11:53:16 2011 -0400
git-deltatool: show progress only for interactive modes
M Porting/git-deltatool
-----------------------------------------------------------------------
Summary of changes:
Porting/git-deltatool | 9 +-
Porting/perldelta_template.pod | 24 +++++-
pod/perldelta.pod | 193 +++++++++++++++++++++++++++++++---------
t/porting/known_pod_issues.dat | 4 +-
t/porting/podcheck.t | 10 ++-
5 files changed, 186 insertions(+), 54 deletions(-)
diff --git a/Porting/git-deltatool b/Porting/git-deltatool
index 1223d4d..1458989 100644
--- a/Porting/git-deltatool
+++ b/Porting/git-deltatool
@@ -92,7 +92,8 @@ sub assign {
my @choices = ( $self->section_choices, $self->action_choices );
$self->_iterate_commits(
sub {
- my $log = shift;
+ my ($log, $i, $count) = @_;
+ say "\n### Commit @{[$i+1]} of $count ###";
say "-" x 75;
$self->show_header($log);
$self->show_body($log, 1);
@@ -108,7 +109,8 @@ sub review {
my @choices = ( $self->review_choices, $self->action_choices );
$self->_iterate_commits(
sub {
- my $log = shift;
+ my ($log, $i, $count) = @_;
+ say "\n### Commit @{[$i+1]} of $count ###";
say "-" x 75;
$self->show_header($log);
$self->show_notes($log, 1);
@@ -179,8 +181,7 @@ sub _iterate_commits {
my $list = [ $self->find_commits($type) ];
my $count = @$list;
while ( my ($i,$log) = each @$list ) {
- say "\n### Commit @{[$i+1]} of $count ###";
- redo unless $fcn->($log);
+ redo unless $fcn->($log, $i, $count);
}
return 1;
}
diff --git a/Porting/perldelta_template.pod b/Porting/perldelta_template.pod
index 37c94d8..896a904 100644
--- a/Porting/perldelta_template.pod
+++ b/Porting/perldelta_template.pod
@@ -149,17 +149,35 @@ diagnostic messages, see L<perldiag>.
XXX New or changed warnings emitted by the core's C<C> code go here. Also
include any changes in L<perldiag> that reconcile it to the C<C> code.
-[ Within each section, list entries as a =item entry ]
+[ Within each section, list entries as a =item entry that links to perldiag,
+ e.g.
+
+ =item *
+
+ L<Invalid version object|perldiag/"Invalid version object">
+]
=head2 New Diagnostics
XXX Newly added diagnostic messages go here
+=head3 New Errors
+
=over 4
=item *
-XXX
+XXX L<message|perldiag/"message">
+
+=back
+
+=head3 New Warnings
+
+=over 4
+
+=item *
+
+XXX L<message|perldiag/"message">
=back
@@ -171,7 +189,7 @@ XXX Changes (i.e. rewording) of diagnostic messages go here
=item *
-XXX
+XXX Describe change here
=back
diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 98abe96..0361c58 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -19,6 +19,8 @@ L<perl5YYYdelta>, which describes differences between
5.ZZZ.ZZZ and
Some of the changes have been included in Perl 5.14.1. These are
indicated with a "(5.14.1)" marker.
+XXX compare this perldelta to 5.14.1 and double check the notation
+
=head1 Notice
XXX Any important notices here
@@ -43,6 +45,13 @@ L</Selected Bug Fixes> section.
[ List each incompatible change as a =head2 entry ]
+=head2 C<$$> no longer caches PID
+
+Previously, if one embeds Perl or uses XS and calls fork(3) from C, Perls
+notion of C<$$> could go out of sync with what getpid() returns. By always
+fetching the value of C<$$> via getpid(), this potential bug is eliminated.
+Code that depends on the caching behavior will break.
+
=head1 Deprecations
XXX Any deprecated features, syntax, modules etc. should be listed here.
@@ -94,6 +103,10 @@ XXX
=item *
+L<constant> has been updated from version 1.21 to 1.22.
+
+=item *
+
L<Archive::Extract> has been upgraded from version 0.48 to version 0.52
Includes a fix for FreeBSD to only use C<unzip> if it is located in
@@ -102,6 +115,10 @@ C</usr/bin>.
=item *
+L<Attribute::Handlers> updated from version 0.88 to 0.91
+
+=item *
+
L<B> has been upgraded from version 1.29 to version 1.30.
=item *
@@ -148,10 +165,6 @@ L<Compress::Raw::Zlib> has been upgraded from version
2.033 to version 2.035
L<CPAN::Meta> has been upgraded from version 2.110440 to version 2.110930
-commit 0dc56b6ea90acbb1f9e29a03d008475a618262f3
-Author: Chris 'BinGOs' Williams <ch...@bingosnet.co.uk>
-Date: Wed May 18 11:12:21 2011 +0100
-
=item *
L<CPANPLUS> has been upgraded from version 0.9103 to version 0.9105
@@ -164,6 +177,10 @@ L<CPANPLUS::Dist::Build> has been upgraded from version
0.54 to version 0.56
=item *
+L<Data::Dumper> has been upgraded from version 2.128 to 2.131.
+
+=item *
+
L<DB_File> has been upgraded from version 1.821 to version 1.822
Warnings are now in sync with perl's
@@ -190,12 +207,25 @@ documentation updates.
=item *
+L<ExtUtils::CBuilder> updated from version 0.280203 to 0.280204. The new
version
+append CFLAGS and LDFLAGS to their Config.pm counterparts.
+
+=item *
+
L<Filter::Util::Call> has been upgraded from version 1.08 to version 1.39
C<decrypt> fixed to work with v5.14.0
=item *
+L<Filter::Simple> updated from version 0.85 to 0.87
+
+=item *
+
+L<FindBin> updated from version 1.50 to 1.51.
+
+=item *
+
L<JSON::PP> has been upgraded from version 2.27105 to version 2.27200
Fixed C<incr_parse> decoding string more correctly.
@@ -210,6 +240,10 @@ More stable C<great_circle_direction> algorithm.
=item *
+L<Module::CoreList> has been updated to include Perl 5.12.4.
+
+=item *
+
L<Object::Accessor> has been upgraded from version 0.38 to version 0.42
Eliminated use of C<exists> on array elements which has been deprecated.
@@ -313,6 +347,16 @@ XXX Changes which significantly change existing files in
F<pod/> go here.
However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
section.
+=head3 L<perlfork>
+
+=over
+
+=item *
+
+Added portability caveats related to using kill on forked process.
+
+=back
+
=head3 L<perlfunc>
=over
@@ -386,13 +430,14 @@ include any changes in L<perldiag> that reconcile it to
the C<C> code.
XXX Newly added diagnostic messages go here
+=head3 New Warnings
+
=over 4
-=item *
+=item L<Useless assignment to a temporary|perldiag/"Useless assignment to a
temporary">
-Assigning to a temporary scalar returned from an XS lvalue subroutine now
-produces a warning: "Useless assignment to a temporary". This should help
-PDL users [RT #31946].
+Assigning to a temporary returned from an XS lvalue subroutine now produces a
+warning [RT #31946].
=back
@@ -443,6 +488,12 @@ L</Platform Support> section, instead.
F<regexp.h> has been modified for compatibility with GCC's B<-Werror>
option, as used by some projects that include perl's header files (5.14.1).
+=item *
+
+USE_LOCALE{,_COLLATE,_CTYPE,_NUMERIC} have been added the output of perl -V
+as they have affect the behaviour of the interpreter binary (albeit only
+in a small area).
+
=back
=head1 Testing
@@ -479,9 +530,30 @@ source tree.
=over 4
-=item XXX-some-platform
+=item GNU/Hurd
-XXX
+=over
+
+=item *
+
+No longer overrides possible extra $ccflags values given to Configure
+on GNU/Hurd. C.f. Bug-Debian: http://bugs.debian.org/587901
+
+=back
+
+=item Mac OS X
+
+Clarified apple developer tools requirements in README.macosx
+
+=item MSWin32
+
+Supplied F<makefile.mk> patched to support gcc-4.x.x and README.win32
+updated accordingly. [RT #91354]
+
+=item Solaris
+
+Updated the list of required packages for building perl to reflect Solaris 9
+and 10 in README.solaris [RT #90850]
=back
@@ -528,6 +600,13 @@ beyond SvLEN(), the regular end of the string.
SvCOMPILED() and
SvCOMPILED_{on,off}() now exist solely for compatibility for XS code.
The first is always 0, the other two now no-ops.
+=item *
+
+When empting a hash of its elements (e.g. via undef(%h), or %h=()), HvARRAY
+field is no longer temporarily zeroed. Any destructors called on the freed
+elements see the remaining elements. Thus, %h=() becomes more like C<delete
+$h{$_} for keys %h>.
+
=back
=head1 Selected Bug Fixes
@@ -538,6 +617,8 @@ L</Modules and Pragmata>.
[ List each fix as a =item entry ]
+=head2 Regular expressions and character classes
+
=over 4
=item *
@@ -554,7 +635,7 @@ succeeded inaprropriately. This is now fixed.
=item *
5.14.0 introduced some memory leaks in regular expression character
-classes such as C<[\w\s]>, which have now been fixed (5.14.1).
+classes such as C<[\w\s]>, which have now been fixed
=item *
@@ -567,7 +648,7 @@ portion of the fold, plus some more.
"s\N{U+DF}" =~ /[\x{DF}foo]/i
-is one such case. C<\xDF> folds to C<"ss"> (5.14.1).
+is one such case. C<\xDF> folds to C<"ss">
=item *
@@ -589,31 +670,27 @@ LATIN SMALL LIGATURE ST.
=item *
-Formats: number of edge cases have been fixed with formats and formline;
+Fixed memory leak regression in regular expression compilation
+under threading
+
+=back
+
+=head2 Formats
+
+A number of edge cases have been fixed with formats and formline;
in particular, where the format itself is potentially variable (such as
with ties and overloading), and where the format and data differ in their
encoding. In both these cases, it used to possible for the output to be
corrupted.
-=item *
-
-A bug has been fixed that would cause a "Use of freed value in iteration"
-error if the next two hash elements that would be iterated over are
-deleted [RT #85026] (5.14.1).
-
-=item *
-
-Passing the same constant subroutine to both C<index> and C<formline> no
-longer causes one or the other to fail [RT #89218] (5.14.1).
-
-=item *
+=head2 Copy-on-write scalars
XXX Someone tell me whether this first clause is correct (see commit
765f542d):
Copy-on-write scalars were introduced in 5.10.0. These occur when
C<__PACKAGE__> or a hash key is a assigned to a scalar. Several parts
-of Perl were not updated to account for them, but have now been fixed:
+of Perl were not updated to account for them, but have now been fixed.
=over
@@ -647,11 +724,9 @@ See L</Updated Modules and Pragmata>, above.
=back
-=item *
-
-There have been various fixes to lvalue subroutines:
+=head2 lvalue subroutines
-XXX Should these first three go under New Features?
+There have been various fixes to lvalue subroutines.
=over
@@ -694,18 +769,14 @@ Autovivification now works on values returned from lvalue
subroutines
=item *
-XXX This entry is probably too sarcastic in its use of "inanities". But
-I'm too tired to think of a better wording.
-
-When called in pass-by-reference context (e.g., subroutine arguments or a
-list passed to C<for>), an lvalue subroutine returning arrays or hashes
-used to bind the arrays (or hashes) to scalar variables--something that is
-not supposed to happen. This could result in "Bizzare copy of ARRAY"
-errors or C<print> ignoring its arguments. It also made inanities like
-C<@{\$_}> "work". This was fixed in 5.14.0 if an array were the first
-thing returned from the subroutine (but not for C<$scalar, @array> or
-hashes being returned). Now a more general fix has been applied
-[RT #23790].
+When called in pass-by-reference context (e.g., subroutine arguments or a list
+passed to C<for>), an lvalue subroutine returning arrays or hashes used to bind
+the arrays (or hashes) to scalar variables--something that is not supposed to
+happen. This could result in "Bizzare copy of ARRAY" errors or C<print>
+ignoring its arguments. It also made non-sensical code like C<@{\$_}> "work".
+This was fixed in 5.14.0 if an array were the first thing returned from the
+subroutine (but not for C<$scalar, @array> or hashes being returned). Now a
+more general fix has been applied [RT #23790].
=item *
@@ -714,14 +785,52 @@ it does.
=back
+=head2 Other notable fixes
+
+=over
+
+=item *
+
+A bug has been fixed that would cause a "Use of freed value in iteration"
+error if the next two hash elements that would be iterated over are
+deleted [RT #85026]
+
+=item *
+
+Passing the same constant subroutine to both C<index> and C<formline> no
+longer causes one or the other to fail [RT #89218].
+
=item *
List assignment to lexical variables declared with attributes in the same
statement (C<my ($x,@y) : blimp = (72,94)>) stopped working in Perl 5.8.0.
It has now been fixed.
+=item *
+
+Fixed perldoc search path for VMS.
+
=back
+=head2 Additional fixes by ticket number
+
+XXX Prefix these with "\n=item *\n" once the list is final
+
+Fixed RT #78074: Make it explicit that symtab manipulation is not supported
+Fixed RT #84526: given wasn't calling set magic
+Fixed RT #87740: Perl debugger restart fails on Windows
+Fixed RT #88822: Test failure t/re_fold_grind.t with bleadperl
+Fixed RT #89896: Locale::Maketext test failure
+Fixed RT #90106: ODBM_File failures on Ubuntu natty
+Fixed RT #90122: Make h2ph correctly search gcc include directories
+Fixed RT #90160: U* gives âU0 mode on an empty stringâ
+Fixed RT #90888: C<each(ARRAY)> on scalar context should wrapped into
C<defined()>
+Fixed RT #90898: B::Deparse failure on glob()
+Fixed RT #91032: formline: bugs with non-string formats
+Fixed RT #91880: C<$_> refcounting problems in @INC filters
+Fixed RT #92258: <$fh> hangs on a glob copy
+Fixed RT #92290 and RT #92406: Returning a pad var from an lvalue sub
+
=head1 Known Problems
XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat
index d325aa8..1717388 100644
--- a/t/porting/known_pod_issues.dat
+++ b/t/porting/known_pod_issues.dat
@@ -256,8 +256,6 @@ pod/perlintro.pod Verbatim line length including indents
exceeds 80 by 11
pod/perliol.pod Verbatim line length including indents exceeds 80 by
8
pod/perlipc.pod Verbatim line length including indents exceeds 80 by
21
pod/perlirix.pod Verbatim line length including indents exceeds 80 by
4
-pod/perljp.pod Verbatim line length including indents exceeds 80 by 1
-pod/perlko.pod Verbatim line length including indents exceeds 80 by 14
pod/perllocale.pod Verbatim line length including indents exceeds 80 by
4
pod/perllol.pod Verbatim line length including indents exceeds 80 by
4
pod/perlmacosx.pod ? Should you be using F<...> or maybe L<...> instead of
1
@@ -333,7 +331,7 @@ porting/epigraphs.pod Verbatim line length including
indents exceeds 80 by 3
porting/expand-macro.pl Verbatim line length including indents exceeds
80 by 2
porting/how_to_write_a_perldelta.pod There is no NAME 1
porting/how_to_write_a_perldelta.pod Verbatim line length including indents
exceeds 80 by 3
-porting/perldelta_template.pod Apparent broken link 5
+porting/perldelta_template.pod Apparent broken link 7
porting/perldelta_template.pod Pod NAME already used 1
porting/perldelta_template.pod Verbatim line length including indents exceeds
80 by 1
porting/pumpkin.pod Verbatim line length including indents exceeds 80 by
9
diff --git a/t/porting/podcheck.t b/t/porting/podcheck.t
index 6d987b2..2a1531d 100644
--- a/t/porting/podcheck.t
+++ b/t/porting/podcheck.t
@@ -550,17 +550,23 @@ package My::Pod::Checker { # Extend Pod::Checker
$self->SUPER::verbatim($paragraph, $line_num, $pod_para);
+ my $addr = Scalar::Util::refaddr $self;
+
# Pick up the name, since the parent class doesn't in verbatim
# NAMEs; so treat as non-verbatim. The parent class only allows one
# paragraph in a NAME section, so if there is an extra blank line, it
# will trigger a message, but such a blank line is harmless, so skip
# in that case.
- if ($in_NAME{Scalar::Util::refaddr $self} && $paragraph =~ /\S/) {
+ if ($in_NAME{$addr} && $paragraph =~ /\S/) {
$self->textblock($paragraph, $line_num, $pod_para);
}
my @lines = split /^/, $paragraph;
for my $i (0 .. @lines - 1) {
+ if ( my $encoding = $seen_encoding_cmd{$addr} ) {
+ require Encode;
+ $lines[$i] = Encode::decode($encoding, $lines[$i]);
+ }
$lines[$i] =~ s/\s+$//;
my $indent = $self->get_current_indent;
my $exceeds = length(Text::Tabs::expand($lines[$i]))
@@ -638,7 +644,7 @@ package My::Pod::Checker { # Extend Pod::Checker
}
elsif ($cmd eq "encoding") {
my ($file, $line) = $pod_para->file_line;
- $seen_encoding_cmd{$addr} = 1;
+ $seen_encoding_cmd{$addr} = $paragraph; # for later decoding
if ($command_count{$addr} != 1 && $seen_pod_cmd{$addr}) {
$self->poderror({ -line => $line, -file => $file,
-msg => $encoding_first
--
Perl5 Master Repository
