pod/perldelta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
   6 to be processed before release. ]
   7
   8 perldelta - what is new for perl v5.27.10
   9
  10 =head1 DESCRIPTION
  11
  12 This document describes differences between the 5.27.9 release and the 5.27.10
  13 release.
  14
  15 If you are upgrading from an earlier release such as 5.27.8, first read
  16 L<perl5279delta>, which describes differences between 5.27.8 and 5.27.9.
  17
  18 =head1 Notice
  19
  20 XXX Any important notices here
  21
  22 =head1 Core Enhancements
  23
  24 =head2 XXX
  25
  26 XXX
  27
  28 =head1 Security
  29
  30 XXX Any security-related notices go here.  In particular, any security
  31 vulnerabilities closed should be noted here rather than in the
  32 L</Selected Bug Fixes> section.
  33
  34 [ List each security issue as a =head2 entry ]
  35
  36 =head1 Incompatible Changes
  37
  38 XXX For a release on a stable branch, this section aspires to be:
  39
  40     There are no changes intentionally incompatible with 5.XXX.XXX
  41     If any exist, they are bugs, and we request that you submit a
  42     report.  See L</Reporting Bugs> below.
  43
  44 [ List each incompatible change as a =head2 entry ]
  45
  46 =head1 Deprecations
  47
  48 XXX Any deprecated features, syntax, modules etc. should be listed here.
  49
  50 =head2 Module removals
  51
  52 XXX Remove this section if not applicable.
  53
  54 The following modules will be removed from the core distribution in a
  55 future release, and will at that time need to be installed from CPAN.
  56 Distributions on CPAN which require these modules will need to list them as
  57 prerequisites.
  58
  59 The core versions of these modules will now issue C<"deprecated">-category
  60 warnings to alert you to this fact.  To silence these deprecation warnings,
  61 install the modules in question from CPAN.
  62
  63 Note that these are (with rare exceptions) fine modules that you are encouraged
  64 to continue to use.  Their disinclusion from core primarily hinges on their
  65 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
  66 not usually on concerns over their design.
  67
  68 =over
  69
  70 =item XXX
  71
  72 XXX Note that deprecated modules should be listed here even if they are listed
  73 as an updated module in the L</Modules and Pragmata> section.
  74
  75 =back
  76
  77 [ List each other deprecation as a =head2 entry ]
  78
  79 =head1 Performance Enhancements
  80
  81 =over 4
  82
  83 =item *
  84
  85 XXX
  86
  87 =back
  88
  89 =head1 Modules and Pragmata
  90
  91 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
  92 go here.  If Module::CoreList is updated, generate an initial draft of the
  93 following sections using F<Porting/corelist-perldelta.pl>.  A paragraph summary
  94 for important changes should then be added by hand.  In an ideal world,
  95 dual-life modules would have a F<Changes> file that could be cribbed.
  96
  97 The list of new and updated modules is modified automatically as part of
  98 preparing a Perl release, so the only reason to manually add entries here is if
  99 you're summarising the important changes in the module update. (Also, if the
 100 manually-added details don't match the automatically-generated ones, the
 101 release manager will have to investigate the situation carefully.)
 102
 103 [ Within each section, list entries as an =item entry ]
 104
 105 =head2 New Modules and Pragmata
 106
 107 =over 4
 108
 109 =item *
 110
 111 XXX Remove this section if not applicable.
 112
 113 =back
 114
 115 =head2 Updated Modules and Pragmata
 116
 117 =over 4
 118
 119 =item *
 120
 121 L<Carp> has been upgraded from version 1.46 to 1.4x.
 122
 123 XXX Please update the version number.
 124
 125 L<Carp>, when generating stack traces, now attempts to work around
 126 longstanding bugs resulting from Perl's non-reference-counted stack.
 127 [perl #52610]
 128
 129 Carp has been modified to avoid assuming that objects cannot be
 130 overloaded without the L<overload> module loaded (this can happen with
 131 objects created by XS modules).  Previously, infinite recursion would
 132 result if an XS-defined overload method itself called Carp.  [perl #132828]
 133
 134 Carp now avoids using C<overload::StrVal>, partly because older versions
 135 of L<overload> (included with perl 5.14 and earlier) load L<Scalar::Util>
 136 at run time, which will fail if Carp has been invoked after a syntax error.
 137
 138 L<I18N::Langinfo> has been upgraded from version 0.15 to 0.16.
 139
 140 This module is now available on all platforms, emulating the system
 141 L<nl_langinfo(3)> on systems that lack it.  Some caveats apply, as
 142 L<detailed in its documentation|I18N::Langinfo>, the most severe being
 143 that the C<CODESET> item is not implemented on those systems, always
 144 returning C<"">.
 145
 146 =back
 147
 148 =head2 Removed Modules and Pragmata
 149
 150 =over 4
 151
 152 =item *
 153
 154 XXX
 155
 156 =back
 157
 158 =head1 Documentation
 159
 160 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
 161 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 162
 163 =head2 New Documentation
 164
 165 XXX Changes which create B<new> files in F<pod/> go here.
 166
 167 =head3 L<XXX>
 168
 169 XXX Description of the purpose of the new file here
 170
 171 =head2 Changes to Existing Documentation
 172
 173 XXX Changes which significantly change existing files in F<pod/> go here.
 174 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 175 section.
 176
 177 Additionally, the following selected changes have been made:
 178
 179 =head3 L<XXX>
 180
 181 =over 4
 182
 183 =item *
 184
 185 XXX Description of the change here
 186
 187 =back
 188
 189 =head1 Diagnostics
 190
 191 The following additions or changes have been made to diagnostic output,
 192 including warnings and fatal error messages.  For the complete list of
 193 diagnostic messages, see L<perldiag>.
 194
 195 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
 196 include any changes in L<perldiag> that reconcile it to the C<C> code.
 197
 198 =head2 New Diagnostics
 199
 200 XXX Newly added diagnostic messages go under here, separated into New Errors
 201 and New Warnings
 202
 203 =head3 New Errors
 204
 205 =over 4
 206
 207 =item *
 208
 209 XXX L<message|perldiag/"message">
 210
 211 =back
 212
 213 =head3 New Warnings
 214
 215 =over 4
 216
 217 =item *
 218
 219 XXX
 220
 221 =back
 222
 223 =head2 Changes to Existing Diagnostics
 224
 225 XXX Changes (i.e. rewording) of diagnostic messages go here
 226
 227 =over 4
 228
 229 =item *
 230
 231 The new (as of 5.27.8) restriction forbidding use of C<goto> to enter the
 232 argument of a binary or list expression (see L<perldiag/"Can't
 233 E<quot>gotoE<quot> into a binary or list expression">) has been relaxed to
 234 allow entering the I<first> argument of an operator that takes a fixed
 235 number of arguments, since this is a case that will not cause stack
 236 corruption.  [perl #132854]
 237
 238 =item *
 239
 240 The warning added in 5.27.8 concerning UTF-8 locale compatibility was
 241 misleading.  The new wording and explanation are at
 242 L<perldiag/Locale '%s' contains (at least) the following characters which
 243 have unexepected meanings: %s  The Perl program will use the exepected
 244 meanings>
 245
 246 =back
 247
 248 =head1 Utility Changes
 249
 250 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
 251 Most of these are built within the directory F<utils>.
 252
 253 [ List utility changes as a =head2 entry for each utility and =item
 254 entries for each change
 255 Use L<XXX> with program names to get proper documentation linking. ]
 256
 257 =head2 L<XXX>
 258
 259 =over 4
 260
 261 =item *
 262
 263 XXX
 264
 265 =back
 266
 267 =head1 Configuration and Compilation
 268
 269 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
 270 go here.  Any other changes to the Perl build process should be listed here.
 271 However, any platform-specific changes should be listed in the
 272 L</Platform Support> section, instead.
 273
 274 [ List changes as an =item entry ].
 275
 276 =over 4
 277
 278 =item *
 279
 280 F<lib/unicore/mktables> now correctly canonicalizes the names of the
 281 dependencies stored in the files it generates.
 282
 283 F<regen/mk_invlists.pl>, unlike the other F<regen/*.pl> scripts, used
 284 C<$0> to name itself in the dependencies stored in the files it
 285 generates.  It now uses a literal so that the path stored in the
 286 generated files doesn't depend on how F<regen/mk_invlists.pl> is
 287 invoked.
 288
 289 This lack of canonical names could cause test failures in
 290 F<t/porting/regen.t>.  [perl #132925]
 291
 292 =back
 293
 294 =head1 Testing
 295
 296 Tests were added and changed to reflect the other additions and
 297 changes in this release.  Furthermore, these significant changes were
 298 made:
 299
 300 =over 4
 301
 302 =item *
 303
 304 XXX
 305
 306 =back
 307
 308 =head1 Platform Support
 309
 310 =head2 New Platforms
 311
 312 =over 4
 313
 314 =item That Plaftorm
 315
 316 XXX
 317
 318 =back
 319
 320 =head2 Discontinued Platforms
 321
 322 XXX List any platforms that this version of perl no longer compiles on.
 323
 324 =over 4
 325
 326 =item XXX-some-platform
 327
 328 XXX
 329
 330 =back
 331
 332 =head2 Platform-Specific Notes
 333
 334 XXX List any changes for specific platforms.  This could include configuration
 335 and compilation changes or changes in portability/compatibility.  However,
 336 changes within modules for platforms should generally be listed in the
 337 L</Modules and Pragmata> section.
 338
 339 =over 4
 340
 341 =item XXX-some-platform
 342
 343 XXX
 344
 345 =back
 346
 347 =head1 Internal Changes
 348
 349 =over 4
 350
 351 =item *
 352
 353 The item names passed to the function L<perlapi/Perl_langinfo>,
 354 introduced in 5.27.4, may no longer be prefixed with C<PERL_>.  For
 355 example, if you want the current floating point radix character, you
 356 must call it like C<Perl_langinfo(RADIXCHAR)>.
 357
 358 =back
 359
 360 =head1 Selected Bug Fixes
 361
 362 =over 4
 363
 364 =item *
 365
 366 XXX
 367
 368 =back
 369
 370 =head1 Known Problems
 371
 372 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
 373 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
 374 platform specific bugs also go here.
 375
 376 [ List each fix as an =item entry ]
 377
 378 =over 4
 379
 380 =item *
 381
 382 XXX
 383
 384 =back
 385
 386 =head1 Errata From Previous Releases
 387
 388 =over 4
 389
 390 =item *
 391
 392 XXX Add anything here that we forgot to add, or were mistaken about, in
 393 the perldelta of a previous release.
 394
 395 =back
 396
 397 =head1 Obituary
 398
 399 XXX If any significant core contributor or member of the CPAN community has
 400 died, add a short obituary here.
 401
 402 =head1 Acknowledgements
 403
 404 XXX Generate this with:
 405
 406   perl Porting/acknowledgements.pl v5.27.9..HEAD
 407
 408 =head1 Reporting Bugs
 409
 410 If you find what you think is a bug, you might check the perl bug database
 411 at L<https://rt.perl.org/> .  There may also be information at
 412 L<http://www.perl.org/> , the Perl Home Page.
 413
 414 If you believe you have an unreported bug, please run the L<perlbug> program
 415 included with your release.  Be sure to trim your bug down to a tiny but
 416 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 417 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 418
 419 If the bug you are reporting has security implications which make it
 420 inappropriate to send to a publicly archived mailing list, then see
 421 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
 422 for details of how to report the issue.
 423
 424 =head1 Give Thanks
 425
 426 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
 427 you can do so by running the C<perlthanks> program:
 428
 429     perlthanks
 430
 431 This will send an email to the Perl 5 Porters list with your show of thanks.
 432
 433 =head1 SEE ALSO
 434
 435 The F<Changes> file for an explanation of how to view exhaustive details on
 436 what changed.
 437
 438 The F<INSTALL> file for how to build Perl.
 439
 440 The F<README> file for general stuff.
 441
 442 The F<Artistic> and F<Copying> files for copyright information.
 443
 444 =cut