This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
8b7dbe421b612607d193830be6fcc62151e8861e
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.17.11
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.17.10 release and the 5.17.11
10 release.
11
12 If you are upgrading from an earlier release such as 5.17.9, first read
13 L<perl51710delta>, which describes differences between 5.17.9 and 5.17.10.
14
15 =head1 Incompatible Changes
16
17 Although no major incompatibilities have been introduced, the "switch" family
18 of features have been marked experimental and will now emit warnings.  These
19 are:  the C<~~> operator, C<given>, and C<when>.
20
21 =head1 Modules and Pragmata
22
23 =head2 Updated Modules and Pragmata
24
25 =over 4
26
27 =item *
28
29 Fixed the merge of ExtUtils-MakeMaker 6.65_01 to remove an excluded
30 file.  This was causing a test failure on Win32 [perl #117477]
31
32 =item *
33
34 B::Deparse has been upgraded from version 1.19 to 1.20, adding stub deparsing
35 for lexical subroutines.
36
37 =item *
38
39 bigint has been upgraded from version 0.33 to 0.34.
40
41 =item *
42
43 CPAN has been upgraded from its trial 2.00 release to its final 2.00 release.
44
45 =item *
46
47 Exporter has been upgraded from version 5.67 to 5.68.
48
49 =item *
50
51 ExtUtils::CBuilder has been upgraded from version 0.280209 to 0.280210.
52
53 =item *
54
55 IO has been upgraded from version 1.27 to 1.28.
56
57 =item *
58
59 overload has been upgraded from version 1.21 to 1.22.
60
61 =item *
62
63 Storable has been upgraded from version 2.40 to 2.41.
64
65 =item *
66
67 warnings has been upgraded from version 1.17 to 1.18.
68
69 =back
70
71 =head2 Changes to Existing Documentation
72
73 =head3 Asian-language documentation
74
75 The Asian-language documentation, previously stored in a few different
76 encodings, have been transcoded to UTF-8.
77
78 =head1 Diagnostics
79
80 The following additions or changes have been made to diagnostic output,
81 including warnings and fatal error messages.  For the complete list of
82 diagnostic messages, see L<perldiag>.
83
84 =head3 New Warnings
85
86 =over 4
87
88 =item *
89
90 L<Smartmatch is experimental|perldiag/"Smartmatch is experimental">
91
92 =item *
93
94 L<given is experimental|perldiag/"given is experimental">
95
96 =item *
97
98 L<when is experimental|perldiag/"when is experimental">
99
100 =back
101
102 =head1 Platform Support
103
104 =head2 Platform-Specific Notes
105
106 =over 4
107
108 =item VMS
109
110 As of 5.18.0, Perl on VMS can (at last) be built in and installed from a
111 directory having dots in the name, so it is no longer necessary to rename the
112 top-level source directory before building.
113
114 The pertinent instructions have been removed from README.vms, so we also no
115 longer need to update the version number that was embedded in those
116 instructions.
117
118 =back
119
120 =head1 Selected Bug Fixes
121
122 =over 4
123
124 =item Make vms.c's Perl_flex_fstat preserve errno on success
125
126 =item split's first argument is more consistently interpreted
127
128 After some changes earlier in 5.17, C<split>'s behavior has been simplified: if
129 the PATTERN argument evaluates to a literal string containing one space, it is
130 treated the way that a I<literal> string containing one space once was.
131
132 =item Handle overloading properly in compile-time regex
133
134 C<(?{…})> and C<qr> constant overloading did not play nicely together, and when
135 C<qr> constant overloading was in effect, C<qr> constructs inside a C<(?{…})>
136 construct were incorrectly interpreted. [perl #116823]
137
138 =back
139
140 =head1 Acknowledgements
141
142 Perl 5.17.11 represents approximately 4 weeks of development since Perl 5.17.10
143 and contains approximately 3,800 lines of changes across 130 files from 17
144 authors.
145
146 Perl continues to flourish into its third decade thanks to a vibrant community
147 of users and developers. The following people are known to have contributed the
148 improvements that became Perl 5.17.11:
149
150 Aaron Crane, Andy Dougherty, Brian Fraser, Chris 'BinGOs' Williams, Craig A.
151 Berry, David Mitchell, François Perrad, James E Keenan, Jan Dubois, Karl
152 Williamson, Leon Timmermans, Max Maischein, Moritz Lenz, Nicholas Clark,
153 Ricardo Signes, Tony Cook, Yves Orton.
154
155 The list above is almost certainly incomplete as it is automatically generated
156 from version control history. In particular, it does not include the names of
157 the (very much appreciated) contributors who reported issues to the Perl bug
158 tracker.
159
160 Many of the changes included in this version originated in the CPAN modules
161 included in Perl's core. We're grateful to the entire CPAN community for
162 helping Perl to flourish.
163
164 For a more complete list of all of Perl's historical contributors, please see
165 the F<AUTHORS> file in the Perl source distribution.
166
167 =head1 Reporting Bugs
168
169 If you find what you think is a bug, you might check the articles recently
170 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
171 http://rt.perl.org/perlbug/ .  There may also be information at
172 http://www.perl.org/ , the Perl Home Page.
173
174 If you believe you have an unreported bug, please run the L<perlbug> program
175 included with your release.  Be sure to trim your bug down to a tiny but
176 sufficient test case.  Your bug report, along with the output of C<perl -V>,
177 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
178
179 If the bug you are reporting has security implications, which make it
180 inappropriate to send to a publicly archived mailing list, then please send it
181 to perl5-security-report@perl.org.  This points to a closed subscription
182 unarchived mailing list, which includes all the core committers, who will be
183 able to help assess the impact of issues, figure out a resolution, and help
184 co-ordinate the release of patches to mitigate or fix the problem across all
185 platforms on which Perl is supported.  Please only use this address for
186 security issues in the Perl core, not for modules independently distributed on
187 CPAN.
188
189 =head1 SEE ALSO
190
191 The F<Changes> file for an explanation of how to view exhaustive details on
192 what changed.
193
194 The F<INSTALL> file for how to build Perl.
195
196 The F<README> file for general stuff.
197
198 The F<Artistic> and F<Copying> files for copyright information.
199
200 =cut