pod/perldelta.pod

   1 =encoding utf8
   2
   3 =head1 NAME
   4
   5 perldelta - what is new for perl v5.35.2
   6
   7 =head1 DESCRIPTION
   8
   9 This document describes differences between the 5.35.1 release and the 5.35.2
  10 release.
  11
  12 If you are upgrading from an earlier release such as 5.35.0, first read
  13 L<perl5351delta>, which describes differences between 5.35.0 and 5.35.1.
  14
  15
  16
  17
  18 =head1 Modules and Pragmata
  19
  20 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
  21 go here.  If Module::CoreList is updated, generate an initial draft of the
  22 following sections using F<Porting/corelist-perldelta.pl>.  A paragraph summary
  23 for important changes should then be added by hand.  In an ideal world,
  24 dual-life modules would have a F<Changes> file that could be cribbed.
  25
  26 The list of new and updated modules is modified automatically as part of
  27 preparing a Perl release, so the only reason to manually add entries here is if
  28 you're summarising the important changes in the module update. (Also, if the
  29 manually-added details don't match the automatically-generated ones, the
  30 release manager will have to investigate the situation carefully.)
  31
  32 [ Within each section, list entries as an =item entry ]
  33
  34 =head2 New Modules and Pragmata
  35
  36 =over 4
  37
  38 =item *
  39
  40 XXX Remove this section if not applicable.
  41
  42 =back
  43
  44 =head2 Updated Modules and Pragmata
  45
  46 =over 4
  47
  48 =item *
  49
  50 C<perl5db.pl> has been upgraded from version 1.60 to 1.61.
  51
  52 The C<v> command works again, and now has some tests.
  53
  54 =back
  55
  56
  57 =head1 Documentation
  58
  59 =head2 Changes to Existing Documentation
  60
  61 =head3 L<perlintro>
  62
  63 =over 4
  64
  65 =item *
  66
  67 A number of sentences in L<perlintro> have been simplified,
  68 to make things clearer.
  69 Ambiguities were resolved, related to "special variables".
  70
  71 =back
  72
  73
  74 =head1 Platform Support
  75
  76 The :win32 IO layer has been removed. This experimental replacement for the
  77 :unix layer never reached maturity in its nearly two decades of existence.
  78
  79 =head1 Internal Changes
  80
  81 =over 4
  82
  83 =item *
  84
  85 The API constant formerly named C<G_ARRAY>, indicating list context, has now
  86 been renamed to a more accurate C<G_LIST>.  A compatibilty macro C<G_ARRAY> has
  87 been added to allow existing code to work unaffected.  New code should be
  88 written using the new constant instead.  This is supported by C<Devel::PPPort>
  89 version 3.63.
  90
  91 =item *
  92
  93 XXX
  94
  95 =back
  96
  97 =head1 Selected Bug Fixes
  98
  99 =over 4
 100
 101 =item *
 102
 103 The flags on the OPTVAL parameter to setsockopt() were previously
 104 checked before magic was called, possibly treating a numeric value as
 105 a packed buffer or vice versa.  It also ignored the UTF-8 flag,
 106 potentially treating the internal representation of an upgraded SV as
 107 the bytes to supply to the setsockopt() system call.  (github #18660)
 108
 109 =item *
 110
 111 Only set IOKp, not IOK on $) and $(.
 112 This was issue #18955: This will prevent serializers from serializing these
 113 variables as numbers (which loses the additional groups).
 114 This restores behaviour from 5.16
 115
 116 =back
 117
 118
 119 =head1 Acknowledgements
 120
 121 Perl 5.35.2 represents approximately 5 weeks of development since Perl
 122 5.35.1 and contains approximately 27,000 lines of changes across 420 files
 123 from 25 authors.
 124
 125 Excluding auto-generated files, documentation and release tools, there were
 126 approximately 14,000 lines of changes to 200 .pm, .t, .c and .h files.
 127
 128 Perl continues to flourish into its fourth decade thanks to a vibrant
 129 community of users and developers. The following people are known to have
 130 contributed the improvements that became Perl 5.35.2:
 131
 132 Atsushi Sugawara, Ben Cornett, Chris 'BinGOs' Williams, Christian Walde
 133 (Mithaldu), Craig A. Berry, David Golden, David Marshall, Felipe Gasper,
 134 Jakub Wilk, James E Keenan, Karl Williamson, Leam Hall, Leon Timmermans, Max
 135 Maischein, Neil Bowers, Nicholas Clark, Paul Evans, Paul Marquess, Richard
 136 Leach, Sawyer X, Sergey Poznyakoff, Sven Kirmess, Thibault Duponchelle, Todd
 137 Rinaldo, Tony Cook.
 138
 139 The list above is almost certainly incomplete as it is automatically
 140 generated from version control history. In particular, it does not include
 141 the names of the (very much appreciated) contributors who reported issues to
 142 the Perl bug tracker.
 143
 144 Many of the changes included in this version originated in the CPAN modules
 145 included in Perl's core. We're grateful to the entire CPAN community for
 146 helping Perl to flourish.
 147
 148 For a more complete list of all of Perl's historical contributors, please
 149 see the F<AUTHORS> file in the Perl source distribution.
 150
 151
 152 =head1 Reporting Bugs
 153
 154 If you find what you think is a bug, you might check the perl bug database
 155 at L<https://github.com/Perl/perl5/issues>.  There may also be information at
 156 L<http://www.perl.org/>, the Perl Home Page.
 157
 158 If you believe you have an unreported bug, please open an issue at
 159 L<https://github.com/Perl/perl5/issues>.  Be sure to trim your bug down to a
 160 tiny but sufficient test case.
 161
 162 If the bug you are reporting has security implications which make it
 163 inappropriate to send to a public issue tracker, then see
 164 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
 165 for details of how to report the issue.
 166
 167 =head1 Give Thanks
 168
 169 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
 170 you can do so by running the C<perlthanks> program:
 171
 172     perlthanks
 173
 174 This will send an email to the Perl 5 Porters list with your show of thanks.
 175
 176 =head1 SEE ALSO
 177
 178 The F<Changes> file for an explanation of how to view exhaustive details on
 179 what changed.
 180
 181 The F<INSTALL> file for how to build Perl.
 182
 183 The F<README> file for general stuff.
 184
 185 The F<Artistic> and F<Copying> files for copyright information.
 186
 187 =cut