This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Added a perldeta file for 5.11.1
[perl5.git] / pod / perl5111delta.pod
CommitLineData
9a7a3243
JV
1=head1 NAME
2
3[ Any text flagged as XXX needs to be processed before release. ]
4
5perldelta - what is new for perl v5.11.1
6
7=head1 DESCRIPTION
8
9This document describes differences between the 5.11.0 release and
10the 5.11.1 release.
11
12=head1 Notice
13
14
15=head1 Incompatible Changes
16
17XXX For a release on a stable branch, this section aspires to be:
18
19 There are no changes intentionally incompatible with 5.XXX.XXX. If any
20 exist, they are bugs and reports are welcome.
21
22
23=head1 Core Enhancements
24
25XXX New core language features go here. Summarise user-visible core language
26enhancements. Particularly prominent performance optimisations could go
27here, but most should go in the L</Performance Enhancements> section.
28
29=head1 New Platforms
30
31XXX List any platforms that this version of perl compiles on, that previous
32versions did not. These will either be enabled by new files in the F<hints/>
33directories, or new subdirectories and F<README> files at the top level of the
34source tree.
35
36=head1 Modules and Pragmata
37
38XXX All changes to installed files in F<ext/> and F<lib/> go here, in a list
39ordered by distribution name. Minimally it should be the module version,
40but it's more useful to the end user to give a paragraph's summary of the
41module's changes. In an ideal world, dual-life modules would have a
42F<Changes> file that could be cribbed.
43
44=head2 New Modules and Pragmata
45
46=over 4
47
48=item C<XXX>
49
50XXX
51
52=back
53
54=head2 Pragmata Changes
55
56=over 4
57
58=item C<XXX>
59
60XXX
61
62=back
63
64=head2 Updated Modules
65
66=over 4
67
68=item C<XXX>
69
70XXX
71
72=back
73
74=head1 Utility Changes
75
76XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
77here. Most of these are built within the directories F<utils> and F<x2p>.
78
79=over 4
80
81=item F<XXX>
82
83XXX
84
85=back
86
87=head1 New Documentation
88
89XXX Changes which create B<new> files in F<pod/> go here.
90
91=over 4
92
93=item L<XXX>
94
95XXX
96
97=back
98
99=head1 Changes to Existing Documentation
100
101XXX Changes which significantly change existing files in F<pod/> go here.
102Any changes to F<pod/perldiag.pod> should go in L</New or Changed Diagnostics>.
103
104
105=head1 Performance Enhancements
106
107XXX Changes which enhance performance without changing behaviour go here. There
108may well be none in a stable release.
109
110=over 4
111
112=item *
113
114XXX
115
116=back
117
118=head1 Installation and Configuration Improvements
119
120XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
121go here.
122
123=head2 Configuration improvements
124
125XXX
126
127=head2 Compilation improvements
128
129XXX
130
131=head2 Platform Specific Changes
132
133=over 4
134
135=item XXX-some-platform
136
137XXX
138
139=back
140
141=head1 Selected Bug Fixes
142
143XXX Important bug fixes in the core language are summarised here.
144Bug fixes in files in F<ext/> and F<lib/> are best summarised in
145L</Modules and Pragmata>.
146
147=over 4
148
149=item *
150
151XXX
152
153=back
154
155=head1 New or Changed Diagnostics
156
157XXX New or changed warnings emitted by the core's C<C> code go here.
158
159=over 4
160
161=item C<XXX>
162
163XXX
164
165=back
166
167=head1 Changed Internals
168
169XXX Changes which affect the interface available to C<XS> code go here.
170
171=over 4
172
173=item *
174
175XXX
176
177=back
178
179=head1 New Tests
180
181XXX Changes which create B<new> files in F<t/> go here. Changes to
182existing files in F<t/> aren't worth summarising, although the bugs that
183they represent may be.
184
185=over 4
186
187=item F<XXX>
188
189XXX
190
191=back
192
193=head1 Known Problems
194
195XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
196tests that had to be C<TODO>ed for the release would be noted here, unless
197they were specific to a particular platform (see below).
198
199This is a list of some significant unfixed bugs, which are regressions
200from either 5.10.1 or 5.11.0.
201
202=over 4
203
204=item *
205
206XXX
207
208=back
209
210=head1 Deprecations
211
212XXX Add any new known deprecations here.
213
214The following items are now deprecated.
215
216=over 4
217
218=item *
219
220XXX
221
222=back
223
224=head1 Platform Specific Notes
225
226XXX Any changes specific to a particular platform. VMS and Win32 are the usual
227stars here. It's probably best to group changes under the same section layout
228as the main perldelta
229
230=item Obituary
231
232XXX If any significant core contributor has died, we've added a short obituary
233here.
234
235=head1 Acknowledgements
236
237XXX The list of people to thank goes here.
238
239
240=head1 Reporting Bugs
241
242If you find what you think is a bug, you might check the articles
243recently posted to the comp.lang.perl.misc newsgroup and the perl
244bug database at http://rt.perl.org/perlbug/ . There may also be
245information at http://www.perl.org/ , the Perl Home Page.
246
247If you believe you have an unreported bug, please run the B<perlbug>
248program included with your release. Be sure to trim your bug down
249to a tiny but sufficient test case. Your bug report, along with the
250output of C<perl -V>, will be sent off to perlbug@perl.org to be
251analysed by the Perl porting team.
252
253If the bug you are reporting has security implications, which make it
254inappropriate to send to a publicly archived mailing list, then please send
255it to perl5-security-report@perl.org. This points to a closed subscription
256unarchived mailing list, which includes all the core committers, who be able
257to help assess the impact of issues, figure out a resolution, and help
258co-ordinate the release of patches to mitigate or fix the problem across all
259platforms on which Perl is supported. Please only use this address for
260security issues in the Perl core, not for modules independently
261distributed on CPAN.
262
263=head1 SEE ALSO
264
265The F<Changes> file for an explanation of how to view exhaustive details
266on what changed.
267
268The F<INSTALL> file for how to build Perl.
269
270The F<README> file for general stuff.
271
272The F<Artistic> and F<Copying> files for copyright information.
273
274=cut