Skip to content

Commit 4b5793c

Browse files
erichermanbook
andcommitted
perldelta: remove empty sections
Co-authored-by: Philippe Bruhat (BooK) <book@cpan.org>
1 parent 05aed60 commit 4b5793c

File tree

1 file changed

+0
-288
lines changed

1 file changed

+0
-288
lines changed

pod/perldelta.pod

Lines changed: 0 additions & 288 deletions
Original file line numberDiff line numberDiff line change
@@ -15,84 +15,6 @@ release.
1515
If you are upgrading from an earlier release such as 5.43.2, first read
1616
L<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

9820
XXX 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

26267
XXX Any significant changes to the testing of a freshly built perl should be
@@ -288,45 +93,8 @@ XXX
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

436148
XXX Generate this with:

0 commit comments

Comments
 (0)