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