diff options
author | Jesse Luehrs <doy@tozt.net> | 2012-06-19 14:45:51 -0500 |
---|---|---|
committer | Jesse Luehrs <doy@tozt.net> | 2012-06-19 14:46:38 -0500 |
commit | 954945b80e44176480730cfb7ac7bb8c742a88e2 (patch) | |
tree | 45d17b6354c48358755ce3523bab4f8d798cb4f3 | |
parent | 81c3bbe75d9e2c58a868a8c7a2ad91ba8d5b282a (diff) | |
download | perl-954945b80e44176480730cfb7ac7bb8c742a88e2.tar.gz |
more proofreading
-rw-r--r-- | pod/perldelta.pod | 96 |
1 files changed, 33 insertions, 63 deletions
diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 6e4a1c3819..b8e57928de 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -29,10 +29,10 @@ C<prototype(&CORE::pos)>. =head1 Incompatible Changes -=head2 C</(?{})/> and C</(??{}> have been heavily reworked. +=head2 C</(?{})/> and C</(??{})/> have been heavily reworked The implementation of this feature has been almost completely rewritten. -Although its main intent is to fix bugs, some behaviours, especially +Although its main intent is to fix bugs, some behaviors, especially related to the scope of lexical variables, will have changed. This is described more fully in the L</Selected Bug Fixes> section. @@ -40,7 +40,7 @@ described more fully in the L</Selected Bug Fixes> section. Unicode 6.0 reused the name "BELL" for a different code point than it traditionally had meant. Since Perl v5.14, use of this name still -referred to U+0007, but would raise a deprecated warning. Now, "BELL" +referred to U+0007, but would raise a deprecation warning. Now, "BELL" refers to U+1F514, and the name for U+0007 is "ALERT". All the functions in L<charnames> have been correspondingly updated. @@ -57,7 +57,7 @@ Instead you must write with whitespace separating the operator from the closing delimiter of the regular expression. Not having whitespace has resulted in a -deprecated warning since Perl v5.14.0. +deprecation warning since Perl v5.14.0. =head2 C<require> dies for unreadable files @@ -109,12 +109,12 @@ Work around an edge case on Linux with Busybox's unzip. L<Archive::Tar> has been upgraded from version 1.82 to 1.88. -ptar now supports -T option and dashless options [rt.cpan.org #75473], -[rt.cpan.org #75475]. +ptar now supports the -T option as well as dashless options +[rt.cpan.org #75473], [rt.cpan.org #75475]. Auto-encode filenames marked as UTF-8 [rt.cpan.org #75474]. -Don't use tell on IO::Zlib handles [rt.cpan.org #64339]. +Don't use C<tell> on L<IO::Zlib> handles [rt.cpan.org #64339]. Don't try to C<chown> on symlinks. @@ -122,21 +122,17 @@ Don't try to C<chown> on symlinks. L<attributes> has been upgraded from version 0.19 to 0.20. -No visible changes. - =item * L<autodie> has been upgraded from version 2.10 to 2.11. -No visible changes. - =item * L<B> has been upgraded from version 1.35 to 1.36. C<B::COP::stashlen> has been replaced with C<B::COP::stashoff>. -C<B::COP::stashpv> now supports UTF8 package names and embedded NULs. +C<B::COP::stashpv> now supports UTF-8 package names and embedded NULs. =item * @@ -154,8 +150,6 @@ The constructor now respects overridden accessor methods [perl #29230]. L<Compress::Raw::Bzip2> has been upgraded from version 2.048 to 2.052. -No visible changes. - =item * L<Compress::Raw::Zlib> has been upgraded from version 2.048 to 2.054. @@ -169,8 +163,6 @@ Fix build failures on Irix, Solaris, and Win32, and also when building as C++ L<CPAN::Meta> has been upgraded from version 2.120630 to 2.120921. -Split L<CPAN::Meta::Requirements> into its own distribution. - =item * L<CPAN::Meta::Requirements> has been upgraded from version 2.120630 to 2.122. @@ -183,8 +175,6 @@ Added C<requirements_for_module> method. L<CPAN::Meta::YAML> has been upgraded from version 0.007 to 0.008. -No visible changes. - =item * L<CPANPLUS> has been upgraded from version 0.9121 to 0.9130. @@ -198,13 +188,13 @@ Handle multiple C<makemakerargs> and C<makeflags> arguments better. Use C<File::HomeDir> when available, and provide C<PERL5_CPANPLUS_HOME> to override the autodetection. -Always re-fetch CHECKSUMS if C<fetchdir> is set. +Always re-fetch F<CHECKSUMS> if C<fetchdir> is set. =item * L<Digest::MD5> has been upgraded from version 2.51 to 2.52. -Fix Digest::Perl::MD5 OO fallback [rt.cpan.org #66634]. +Fix C<Digest::Perl::MD5> OO fallback [rt.cpan.org #66634]. =item * @@ -223,14 +213,10 @@ make use of them. [perl #111782, #111798]. L<File::DosGlob> has been upgraded from version 1.07 to 1.08. -There are no visible changes, only minor internal refactorings. - =item * L<File::Fetch> has been upgraded from version 0.32 to 0.34. -No visible changes. - =item * L<File::Spec::Unix> has been upgraded from version 3.39_02 to 3.39_03. @@ -242,8 +228,6 @@ the root directory twice [perl #111510]. L<Filter::Util::Call> has been upgraded from version 1.40 to 1.45. -No visible changes. - =item * L<HTTP::Tiny> has been upgraded from version 0.017 to 0.022. @@ -294,32 +278,22 @@ Fix use of C<requires> on perls installed to a path with spaces. L<Object::Accessor> has been upgraded from version 0.42 to 0.44. -No visible changes. - =item * L<Params::Check> has been upgraded from version 0.32 to 0.36. -No visible changes. - =item * L<Parse::CPAN::Meta> has been upgraded from version 1.4402 to 1.4404. -No visible changes. - =item * L<PerlIO::mmap> has been upgraded from version 0.010 to 0.011. -No visible changes. - =item * L<PerlIO::via::QuotedPrint> has been upgraded from version 0.06 to 0.07. -No visible changes. - =item * L<Pod::Html> has been upgraded from version 1.15_02 to 1.16. @@ -327,15 +301,13 @@ L<Pod::Html> has been upgraded from version 1.15_02 to 1.16. The option C<--libpods> has been reinstated. It is deprecated, and its use does nothing other than issue a warning that it is no longer supported. -Since the HTML files generated by pod2html claim to have a utf-8 charset, -actually write the files out using utf-8 [perl #111446]. +Since the HTML files generated by pod2html claim to have a UTF-8 charset, +actually write the files out using UTF-8 [perl #111446]. =item * L<POSIX> has been upgraded from version 1.30 to 1.31. -No visible changes. - =item * L<re> has been upgraded from version 0.19 to 0.20. @@ -346,7 +318,9 @@ See note about C<op_comp> in the L</Internal Changes> section below. L<Safe> has been upgraded from version 2.31_01 to 2.33_01. -XXX where do these dev versions come from? +Fix interactions with C<Devel::Cover>. + +Don't eval code under C<no strict>. =item * @@ -375,8 +349,6 @@ Use C<fc> for casefolding. L<Storable> has been upgraded from version 2.35 to 2.36. -No visible changes. - =item * L<Term::ANSIColor> has been upgraded from version 3.01 to 3.02. @@ -391,14 +363,14 @@ L<Test::Harness> has been upgraded from version 3.23 to 3.25. Fix glob semantics on Win32 [rt.cpan.org #49732]. -Don't use Win32::GetShortPathName when calling perl [rt.cpan.org #47890]. +Don't use C<Win32::GetShortPathName> when calling perl [rt.cpan.org #47890]. Ignore -T when reading shebang [rt.cpan.org #64404]. Handle the case where we don't know the wait status of the test more gracefully. -Make the test summary 'ok' line overrideable so that it can be changed to a +Make the test summary 'ok' line overridable so that it can be changed to a plugin to make the output of prove idempotent. Don't run world-writable files. @@ -422,7 +394,7 @@ that returns all the casefolds. =item * -L<perlfaq> has been synchronised with version 5.0150040 from C<CPAN>. +L<perlfaq> has been synchronized with version 5.0150040 from CPAN. =back @@ -463,8 +435,6 @@ reason. =head2 Platform-Specific Notes -XXX note fails on win2k and vms - =over 4 =item Win32 @@ -518,7 +488,7 @@ experimental. See L<perlapi>. =item * The implementation of code blocks in regular expressions, such as C<(?{})> -and C<(??{})> has been heavily reworked to eliminate a whole slew of bugs. +and C<(??{})>, has been heavily reworked to eliminate a whole slew of bugs. The main user-visible changes are: =over 4 @@ -551,7 +521,7 @@ compiled once, at perl compile-time: =item * Lexical variables are now sane as regards scope, recursion and closure -behaviour. In particular, C</A(?{B})C/> behaves (from a closure viewpoint) +behavior. In particular, C</A(?{B})C/> behaves (from a closure viewpoint) exactly like C</A/ && do { B } && /C/>, while C<qr/A(?{B})C/> is like C<sub {/A/ && do { B } && /C/}>. So this code now works how you might expect, creating three regexes that match 0, 1, and 2: @@ -582,8 +552,8 @@ from the code block, not from any enclosing subroutine. =item * Perl normally caches the compilation of run-time patterns, and doesn't -recompile if the pattern hasn't changed; but this is now disabled if -required for the correct behaviour of closures; for example: +recompile if the pattern hasn't changed, but this is now disabled if +required for the correct behavior of closures. For example: my $code = '(??{$x})'; for my $x (1..3) { @@ -633,7 +603,7 @@ C<vec> no longer produces "uninitialized" warnings in lvalue context =item * -An optimisation involving fixed strings in regular expressions could cause +An optimization involving fixed strings in regular expressions could cause a severe performance penalty in edge cases. This has been fixed [perl #76546]. @@ -645,7 +615,7 @@ as C<(?:)> or C<(?:|)>) could disable some optimizations. This has been fixed. =item * The "Can't find an opnumber" message that C<prototype> produces when passed -a string like "CORE::nonexistent_keyword" now passes UTF8 and embedded +a string like "CORE::nonexistent_keyword" now passes UTF-8 and embedded NULs through unchanged [perl #97478]. =item * @@ -686,15 +656,15 @@ depending on whether it is a string or number internally. =item * -C<open> with "<&" for the mode checks to see whether the third argument is -a number, in determining whether to treat it as a file descriptor or a -handle name. Magical variables like C<$1> were always failing the numeric -check and being treated as handle names. +C<open> with C<< <& >> for the mode checks to see whether the third argument is +a number, in determining whether to treat it as a file descriptor or a handle +name. Magical variables like C<$1> were always failing the numeric check and +being treated as handle names. =item * C<warn>'s handling of magical variables (C<$1>, ties) has undergone several -fixes. FETCH is only called once now on a tied argument or a tied C<$@> +fixes. C<FETCH> is only called once now on a tied argument or a tied C<$@> [perl #97480]. Tied variables returning objects that stringify as "" are no longer ignored. A tied C<$@> that happened to return a reference the I<previous> time is was used is no longer ignored. @@ -726,7 +696,7 @@ variables (C<$1>, ties) were not fixed till now [perl #57706]. =item * Unary negation now treats strings consistently, regardless of the internal -UTF8 flag. +C<UTF8> flag. =item * @@ -745,12 +715,12 @@ sequence C<"\8"> is unrecognized. =item * -C<__SUB__> now works in special blocks (BEGIN, END, etc.). +C<__SUB__> now works in special blocks (C<BEGIN>, C<END>, etc.). =item * Thread creation on Windows could theoretically result in a crash if done -inside a BEGIN block. It still does not work properly, but it no longer +inside a C<BEGIN> block. It still does not work properly, but it no longer crashes [perl #111610]. =item * @@ -767,7 +737,7 @@ sub name, and no longer produces the "Unable to create sub" error =item * -On VMS, Module::Build still fails its test suite. +On VMS, L<Module::Build> still fails its test suite. =item * |