@@ -15,84 +15,6 @@ release.
1515If you are upgrading from an earlier release such as 5.43.2, first read
1616L<perl5433delta>, which describes differences between 5.43.2 and 5.43.3.
1717
18- =head1 Notice
19-
20- XXX Any important notices here
21-
22- =head1 Core Enhancements
23-
24- XXX New core language features go here. Summarize user-visible core language
25- enhancements. Particularly prominent performance optimisations could go
26- here, but most should go in the L</Performance Enhancements> section.
27-
28- [ List each enhancement as a =head2 entry ]
29-
30- =head1 Security
31-
32- XXX Any security-related notices go here. In particular, any security
33- vulnerabilities closed should be noted here rather than in the
34- L</Selected Bug Fixes> section.
35-
36- [ List each security issue as a =head2 entry ]
37-
38- =head1 Incompatible Changes
39-
40- XXX For a release on a stable branch, this section aspires to be:
41-
42- There are no changes intentionally incompatible with 5.XXX.XXX
43- If any exist, they are bugs, and we request that you submit a
44- report. See L</Reporting Bugs> below.
45-
46- [ List each incompatible change as a =head2 entry ]
47-
48- =head1 Deprecations
49-
50- XXX Any deprecated features, syntax, modules etc. should be listed here.
51-
52- =head2 Module removals
53-
54- XXX Remove this section if not applicable.
55-
56- The following modules will be removed from the core distribution in a
57- future release, and will at that time need to be installed from CPAN.
58- Distributions on CPAN which require these modules will need to list them as
59- prerequisites.
60-
61- The core versions of these modules will now issue C<deprecated>-category
62- warnings to alert you to this fact. To silence these deprecation warnings,
63- install the modules in question from CPAN.
64-
65- Note that these are (with rare exceptions) fine modules that you are encouraged
66- to continue to use. Their disinclusion from core primarily hinges on their
67- necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
68- not usually on concerns over their design.
69-
70- =over
71-
72- =item XXX
73-
74- XXX Note that deprecated modules should be listed here even if they are listed
75- as an updated module in the L</Modules and Pragmata> section.
76-
77- =back
78-
79- [ List each other deprecation as a =head2 entry ]
80-
81- =head1 Performance Enhancements
82-
83- XXX Changes which enhance performance without changing behaviour go here.
84- There may well be none in a stable release.
85-
86- [ List each enhancement as an =item entry ]
87-
88- =over 4
89-
90- =item *
91-
92- XXX
93-
94- =back
95-
9618=head1 Modules and Pragmata
9719
9820XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
@@ -140,123 +62,6 @@ XXX Remove this section if F<Porting/corelist-perldelta.pl> did not add any cont
14062
14163=back
14264
143- =head1 Documentation
144-
145- XXX Changes to files in F<pod/> go here. Consider grouping entries by
146- file and be sure to link to the appropriate page, e.g. L<perlfunc>.
147-
148- =head2 New Documentation
149-
150- XXX Changes which create B<new> files in F<pod/> go here.
151-
152- =head3 L<XXX>
153-
154- XXX Description of the purpose of the new file here
155-
156- =head2 Changes to Existing Documentation
157-
158- We have attempted to update the documentation to reflect the changes
159- listed in this document. If you find any we have missed, open an issue
160- at L<https://github.com/Perl/perl5/issues>.
161-
162- XXX Changes which significantly change existing files in F<pod/> go here.
163- However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
164- section.
165-
166- Additionally, the following selected changes have been made:
167-
168- =head3 L<XXX>
169-
170- =over 4
171-
172- =item *
173-
174- XXX Description of the change here
175-
176- =back
177-
178- =head1 Diagnostics
179-
180- The following additions or changes have been made to diagnostic output,
181- including warnings and fatal error messages. For the complete list of
182- diagnostic messages, see L<perldiag>.
183-
184- XXX New or changed warnings emitted by the core's C<C> code go here. Also
185- include any changes in L<perldiag> that reconcile it to the C<C> code.
186-
187- =head2 New Diagnostics
188-
189- XXX Newly added diagnostic messages go under here, separated into L</New Errors>
190- and L</New Warnings>
191-
192- =head3 New Errors
193-
194- =over 4
195-
196- =item *
197-
198- XXX L<message|perldiag/"message">
199-
200- =back
201-
202- =head3 New Warnings
203-
204- =over 4
205-
206- =item *
207-
208- XXX L<message|perldiag/"message">
209-
210- =back
211-
212- =head2 Changes to Existing Diagnostics
213-
214- XXX Changes (i.e. rewording) of diagnostic messages go here
215-
216- =over 4
217-
218- =item *
219-
220- XXX Describe change here
221-
222- =back
223-
224- =head1 Utility Changes
225-
226- XXX Changes to installed programs such as F<perldoc> and F<xsubpp> go here.
227- Most of these are built within the directory F<utils>.
228-
229- [ List utility changes as a =head2 entry for each utility and =item
230- entries for each change
231- Use F<XXX> with program names to get proper documentation linking. ]
232-
233- =head2 F<XXX>
234-
235- =over 4
236-
237- =item *
238-
239- XXX
240-
241- =back
242-
243- =head1 Configuration and Compilation
244-
245- XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
246- go here. Any other changes to the Perl build process should be listed here.
247- However, any platform-specific changes should be listed in the
248- L</Platform Support> section, instead.
249-
250- [ List changes as an =item entry ].
251-
252- =over 4
253-
254- =item *
255-
256- XXX
257-
258- =back
259-
26065=head1 Testing
26166
26267XXX Any significant changes to the testing of a freshly built perl should be
28893
28994=head1 Platform Support
29095
291- XXX Any changes to platform support should be listed in the sections below.
292-
293- [ Within the sections, list each platform as an =item entry with specific
294- changes as paragraphs below it. ]
295-
296- =head2 New Platforms
297-
298- XXX List any platforms that this version of perl compiles on, that previous
299- versions did not. These will either be enabled by new files in the F<hints/>
300- directories, or new subdirectories and F<README> files at the top level of the
301- source tree.
302-
303- =over 4
304-
305- =item XXX-some-platform
306-
307- XXX
308-
309- =back
310-
311- =head2 Discontinued Platforms
312-
313- XXX List any platforms that this version of perl no longer compiles on.
314-
315- =over 4
316-
317- =item XXX-some-platform
318-
319- XXX
320-
321- =back
322-
32396=head2 Platform-Specific Notes
32497
325- XXX List any changes for specific platforms. This could include configuration
326- and compilation changes or changes in portability/compatibility. However,
327- changes within modules for platforms should generally be listed in the
328- L</Modules and Pragmata> section.
329-
33098=over 4
33199
332100=item AIX
@@ -336,32 +104,8 @@ apparent bugs in the underlying operating system support.
336104
337105=back
338106
339- =head1 Internal Changes
340-
341- XXX Changes which affect the interface available to C<XS> code go here. Other
342- significant internal changes for future core maintainers should be noted as
343- well.
344-
345- [ List each change as an =item entry ]
346-
347- =over 4
348-
349- =item *
350-
351- XXX
352-
353- =back
354-
355107=head1 Selected Bug Fixes
356108
357- XXX Important bug fixes in the core language are summarized here. Bug fixes in
358- files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
359-
360- XXX Include references to GitHub issues and PRs as: [GH #12345] and the release
361- manager will later use a regex to expand these into links.
362-
363- [ List each fix as an =item entry ]
364-
365109=over 4
366110
367111=item *
@@ -399,38 +143,6 @@ context under C<use utf8;>.
399143
400144=back
401145
402- =head1 Known Problems
403-
404- XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
405- tests that had to be C<TODO>ed for the release would be noted here. Unfixed
406- platform specific bugs also go here.
407-
408- [ List each fix as an =item entry ]
409-
410- =over 4
411-
412- =item *
413-
414- XXX
415-
416- =back
417-
418- =head1 Errata From Previous Releases
419-
420- =over 4
421-
422- =item *
423-
424- XXX Add anything here that we forgot to add, or were mistaken about, in
425- the F<perldelta> of a previous release.
426-
427- =back
428-
429- =head1 Obituary
430-
431- XXX If any significant core contributor or member of the CPAN community has
432- died, add a short obituary here.
433-
434146=head1 Acknowledgements
435147
436148XXX Generate this with:
0 commit comments