pod/perl5130delta.pod

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