perl: link between related or revised features
[sheet.git] / perl.inc.pl
1 use utf8;
2
3 +{
4         v5.004 => {
5                 release => '1997-05-15',
6                 distro => {
7                         debian => '2.0', # hamm 1998-07 to potato 2000-08 eol 2003-06
8                 },
9                 unstable => 0,
10         },
11
12         v5.005 => {
13                 new => [
14                         ['threads' => '', {experimental => 0, stable => 0}],
15                         ['<code>B::…</code>', 'backend hooks'],
16                         ['<code>qr//</code>' => 'overhauled regular expression engine: precompile operator, lookahead/behind, code, conditions, localised flags'],
17                         ['<code>… foreach</code>' => '<code>for(each)</code> as statement modifier, with large ranges optimised as counting loops'],
18                         ['<code>…::</code>' => 'implicitly quoted package name'],
19                         ['<code>ref $@</code>' => '<code>die</code> passes reference values to exception handlers'],
20                         ['<code>INIT {}</code>', 'subs run just before the perl runtime begins execution'],
21                         ['<code>tie @…</code>' => 'base class for <code>TIEARRAY</code> implementations, and generally improved supported of tied handlers'],
22                         ['<code>substr …,…,…,$replace</code>', 'replacement string in 4th argument'],
23                         ['<code>splice …,…,-$length</code>', 'negative length indicates elements to keep at the end of an array'],
24                         ['<code>$/</code>', 'integer or scalar separator makes <code>&lt;&gt;</code> read records instead of lines'],
25                 ],
26                 release => '1998-07-22',
27                 unstable => 0,
28         },
29
30         v5.6 => {
31                 new => [
32                         ['<code>use warnings</code>', 'pragma to enable warnings in lexical scope', {name => 'warnings'}],
33                         ['<code>use utf8</code>', 'experimental unicode semantics <small>(completed in <a href="#utf8_data">v5.8</a>)</small>', {name => 'utf8', experimental => 0, stable => v5.8}],
34                         ['<code>use charnames</code>', 'string escape <code>\N{}</code> to insert named character'],
35                         ['<code>our</code>', 'declare global variables'],
36                         ['<code>v1.2.3</code>', q"represent strings as vector of ordinals, useful in version numbers (<code>printf '%vd'</code> to display)"],
37                         ['<code>0b0</code>', q"binary numbers in literals, <code>printf '%b'</code>, and <code>oct</code>"],
38                         ['<code>sub :lvalue</code>', 'subroutine attribute to return a modifiable value', {name => 'sub_lvalue', experimental => 0, stable => v5.20}],
39 #                       ['<code>sub :locked :method</code>', 'syntax to declare subroutine attributes'], # can be inferred from :lvalue support
40                         ['<code>open my $fh, $mode, $expr</code>', 'file handles in scoped scalars, third argument for unambiguous file name'],
41                         [q"<code>pack 'q'</code>", '64-bit integer support (also large files &gt;2GiB)', {experimental => 0, stable => v5.8.1}],
42                         ['<code>sort $coderef ()</code>', 'comparison function can be a subroutine reference; prototype <code>($$)</code> to pass elements as normal <code>@_</code>'],
43                         ['<code>CHECK {}</code>', 'special block called at end of compilation'],
44                         ['<code>/[[:…:]]/</code>', 'POSIX character class syntax such as <code>/[[:alpha:]]/</code>'],
45                         # quite a lot more, but leave it at this
46                 ],
47                 release => '2000-03-23',
48                 distro => {
49                         debian => '3.0', # woody 2002-07 eol 2006-06
50                         rhel => '2', # v5.6.0; also in red hat 7.0
51                         solaris => '9', # v5.6.1; 2002-05 eol 2014-10
52                         aix => '5.1', # 2001-05 eol 2006-04
53                         opensuse => '7.1', # 2001-01
54                 },
55                 versum => 'start of modern compatibility',
56                 unicode => '3.0.1',
57         },
58
59         v5.8 => {
60                 new => [
61                         [q"<code>no utf8</code>", 'full unicode support, <code>utf8</code> pragma only for script encoding', {name => 'utf8_data'}],
62                         [q"<code>binmode $fh, ':perlio'</code>", 'file handle behaviour altered by PerlIO layers', {name => 'perlio'}],
63                         [q"<code>open $fh, '-|', @cmd</code>", 'open list to fork a command without spawning a shell'],
64                         [q"<code>open $fh, '>', \$var</code>", 'perl scalars as virtual files'],
65                         [q"<code>printf '%1$s', @args</code>", 'syntax to use parameters out of order'],
66                         [q"<code>1_2_3 == 123</code>", 'underscores between digits allowed in numeric constants'],
67 #                       [q"<code>use if</code>", 'conditional module inclusion'], # also installable in earlier versions
68                 ],
69                 release => '2002-07-18',
70                 distro => {
71                         debian => '3.1', # sarge 2005-06 eol 2008-03, v5.8.8 in etch 2007-04 eol 2010-02
72                         rhel => '3', # v5.8.0; v5.8.8 in RHEL6 (2007-2014)
73                         solaris => '10', # v5.8.4; 2005-01 eol 2021-01
74                         centos => '3-5', # v5.8.0 in v3 (2004-03); v5.8.8 in v5 (eol 2017-03)
75                         ubuntu => '4.10', # v5.8.4 (2004-10); v5.8.7 in 6.06 LTS (2006-06); v5.8.8 in 8.04 LTS (2008-04)
76                         aix => '5.2', # v5.8.0; v5.8.2 in 5.3 and 6.1 (eol 2017-04-30)
77                         freebsd => '4-6',
78                         opensuse => '8.1', # 2002-09 eol (SLES8 2002-10 eol 2007-12 ltss 2009-12)
79                 },
80                 distrosum => "RHEL 3, SLES 8, AIX 5/6 until 2017, Solaris 10 until 2021",
81                 versum => 'stable minimum during 20[01]\d',
82                 support => '2021-01', # solaris
83                 unicode => '3.2.0',
84         },
85
86         v5.10 => {
87                 new => [
88                         ['<code>//</code>', 'defined-or operator'],
89                         ['<code>~~</code>', 'smart-match operator to compare different data types <small>(updated in v5.10.1)</small>', {experimental => 'smartmatch'}],
90                         ['<code>say</code>', 'print with newline, equivalent to <code>print @_, "\n"</code>', {feature => 'say'}],
91                         ['<code>given</code>', 'switch statement to smart-match with <code>when</code>/<code>default</code>', {name => 'switch', feature => 'switch', experimental => 'smartmatch'}],
92                         ['<code>/(?&lt;name>)/</code>', 'named capture buffers into <code>%+</code>'],
93                         ['<code>/(?1)/</code>', 'recursive regular expression patterns'],
94                         ['<code>/(?|)/</code>', 'resets capture numbering for each contained branch'],
95                         ['<code>/.++/</code>', 'possessive quantifiers <code>?+</code>, <code>*+</code>, <code>++</code> to match greedily'],
96                         ['<code>s/keep\K//</code>', 'floating positive lookbehind, efficient alternative for <code>s/(keep)/$1/</code>'],
97                         ['<code>/p</code>', 'optionally preserve <code>${^MATCH}</code> variables (avoiding <code>$&</code> penalty until COW in v5.20)'],
98                         ['<code>/\v/, /\h/</code>', 'vertical and horizontal whitespace escapes (<code>\V</code> <code>\H</code> to invert); also <code>/\R/</code> for newlines'],
99                         ['<code>my $_</code>', 'lexically scoped version of the default variable', {experimental => 'lexical_topic', dropped => v5.23.4}],
100                         ['<code>state</code>', 'persistent <code>my</code> variables (scalars only until <a href="#state_ext">5.28</a>)', {feature => 'state'}],
101                 ],
102                 release => '2007-12-18',
103                 distro => {
104                         debian => '5.0', # lenny 2009-02 eol 2012-02
105                         rhel => '6', # v5.10.1 (-6.9 2017-03 eol 2020-11 TuxCare els 2024-12)
106                         centos => '6', # v5.10.1 (2011-07 eol 2020-11 TuxCare els 2024-11)
107                         ubuntu => '8.10', # v5.10.1 in 10.04 LTS 2010-04 eol 2013-05
108                         aix => '7.1', # v5.10.1 (2010-09 eol 2023-04)
109                         opensuse => '11.0', # 2008-06 (SLES11 2009-03 eol 2019-03 ltss 2022-03)
110                 },
111                 distrosum => "SLES 11 until 2022, RHEL 6 until 2020 or commercially 2024, AIX 7.1 until 2023",
112                 versum => "supported commercially until 2024",
113                 support => '2024-11', # aix
114                 unicode => '5.0.0',
115         },
116
117         v5.12 => {
118                 new => [
119                         ['<code>package</code> version', '<code>package</code> NAME VERSION shorthand for <code>our $VERSION</code>'],
120                         ['<code>...</code>', 'yada-yada operator: code placeholder'],
121                         ['<code>use 5.012</code>', 'implicit <code>strict</code> if use VERSION >= v5.12'],
122                         ['<code>… when</code>', '<code>when</code> is now allowed to be used as a statement modifier'],
123                         [q"<code>use overload 'qr'</code>", 'customisable conversion to regular expressions'],
124                         ['<code>/\N/</code>', 'inverse \n to match any character except newline regardless of <code>/s</code>', {experimental => 0, stable => v5.18}],
125                         ['<code>each $ref</code> e.a.', 'array and hash container functions accept references', {experimental => 'autoderef', dropped => v5.23.1}],
126                 ],
127                 release => '2010-04-12',
128                 unicode => '5.2',
129                 distro => {
130                         solaris => '11', # also v5.8.4; 2010-11; v11.3 eol 2024-01
131                         ubuntu => '11.10',
132                         freebsd => '7',
133                         opensuse => '11.3', # 2010-07
134                 },
135                 support => '2024-01', # solaris
136         },
137
138         v5.14 => {
139                 new => [
140                         ['<code>s///r</code>', 'non-destructive substitution'],
141                         ['<code>/(?{ m() })/</code>', 'regular expressions can be nested in <code>/(?{})/</code> and <code>/(??{})/</code>', {experimental => 0, stable => v5.20}],
142                         ['<code>/dalu</code>', 'regexp modifiers to restrict character classes: either <strong>d</strong>efault, <strong>a</strong>scii, <strong>l</strong>ocale, or <strong>u</strong>nicode semantics.'],
143                         [q"<code>use re '/flags'</code>", 'customise default modifiers'],
144                         ['<code>/(?^)/</code>', 'construct to reset to default modifiers'],
145                         ['<code>FH->method</code>', 'filehandle method calls load IO::File on demand (eg. <code>STDOUT->flush</code>)'],
146                         ['<code>\o{}</code>', 'escape sequence for octal values beyond \777'],
147                 ],
148                 release => '2011-05-14',
149                 distro => {
150                         debian => '7', # wheezy 2013-05 eol 2018-05 elts 2020-06
151                         ubuntu => '12.04',
152                         opensuse => '12.1', # 2011-11 (SLES12 2014-10 eol 2024-10 ltss 2027-10)
153                 },
154                 distrosum => "Debian 7 until 2020, Ubuntu 12.04, SLES 12 until 2027",
155                 support => '2027-10', # suse
156                 unicode => '6.0+#8',
157         },
158
159         v5.16 => {
160                 new => [
161                         ['<code>__SUB__</code>', 'current subroutine reference', {feature => 'current_sub'}],
162                         ['<code>fc, "\F"</code>', 'unicode foldcase to compare case-insensitively', {feature => 'fc'}],
163                         ['<code>"\N{}"</code>', 'automatic <code>use charnames qw( :full :short )</code>'],
164                 ],
165                 release => '2012-05-20',
166                 distro => {
167                         rhel => '7', # v5.16.3 (-7.9 2020-09 eol 2024-06)
168                         centos => '7', # v5.16.3 (2014-07 eol 2024-06 TuxCare els 2028-06)
169                         freebsd => '9',
170                         opensuse => '12.2', # 2012-09
171                 },
172                 unicode => '6.1',
173         },
174
175         v5.18 => {
176                 new => [
177                         ['<code>${^LAST_FH}</code>', 'last read filehandle (used by <code>$.</code>)'],
178                         ['<code>/(?[ a + b ])/</code>', 'regex set operations (character subtraction <code>-</code>, union <code>+</code>, intersection <code>&amp;</code>, xor <code>^</code>)', {experimental => 'regex_sets', stable => v5.36}],
179                         ['<code>my sub</code>', 'lexical subroutines (also <code>state</code>, <code>our</code>); buggy before v5.22', {experimental => 'lexical_subs', stable => v5.26}],
180                         ['<code>next $expression</code>', 'loop controls allow runtime expressions'],
181                         [q"<code>no warnings 'experimental::…'</code>", 'mechanism for experimental features, as of now required for <em>smartmatch</em>'],
182                 ],
183                 release => '2013-05-18',
184                 distro => {
185                         ubuntu => '14.04 LTS', # trusty
186                         opensuse => '13.1', # 2013-11 eol 2016-01
187                 },
188                 unicode => '6.2',
189         },
190
191         v5.20 => {
192                 new => [
193                         ['<code>sub ($var)</code>', 'subroutine signatures', {feature => 'signatures', experimental => 'signatures', stable => v5.36}],
194                         ['<code>%hash{…}</code>', 'hash slices return key+value pairs'],
195                         ['<code>[]->@*</code>', 'postfix dereferencing (also e.g. <code>$scalar->$*</code> for <code>$$scalar</code>)', {feature => 'postderef, postderef_qq', experimental => 'postderef', stable => v5.23.1}],
196                         [q"<code>use warnings 'once'; $a</code>", 'variables $a and $b are exempt from <em>used once</em> warnings'],
197                 ],
198                 unicode => '6.3',
199                 release => '2014-05-27',
200                 distro => {
201                         debian => '8', # jessie 2015-04 eol 2018-06 lts 2020-06 elts 2025-06
202                         ubuntu => '14.10', # utopic
203                         aix => '7.2', # 2015-12 eol 2028?
204                         opensuse => '13.2', # 2014-11 eol 2017-01
205                 },
206                 distrosum => "Debian 8 until 2025, Ubuntu 14.10, openSUSE 13.2, AIX 7.2",
207                 versum => "extended vendor support 202X",
208         },
209
210         v5.22 => {
211                 new => [
212                         ['<code>\$alias =</code>', 'aliasing via reference (scoped as of v5.25.3)', {experimental => 'refaliasing'}],
213                         ['<code>&lt;&lt;>></code>', 'safe <code>readline</code> ignoring open flags in arguments'],
214                         ['<code>/()/n</code>', 'flag to disable numbered capturing, turning <code>()</code> into <code>(?:)</code>'],
215                         ['<code>/\b{}/</code>', 'boundary types: <em>gcb</em> (grapheme cluster), <em>sb</em> (sentence), <em>wb</em> (word)'],
216                         ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', {feature => 'bitwise', experimental => 'bitwise', stable => v5.28}],
217                         [q"<code>use re 'strict'</code>", 'apply stricter syntax rules to regular expression patterns', {experimental => 're_strict'}],
218                         ['<code>0x.beep+0</code>', q"hexadecimal floating point notation with binary power; <code>printf '%a'</code> to display"],
219                         ['<code><s>??</s></code>', 'single match shorthand (deprecated since v5.14) requires the operator <code><em>m</em>?PATTERN?</code>'],
220                 ],
221                 unicode => '7.0',
222                 release => '2015-06-01',
223                 distro => {
224                         ubuntu => '16.04 LTS', # xenial 2016-04 eol 2021-04 TuxCare els 2025-04
225                 },
226         },
227
228         v5.24 => {
229                 new => [
230                         [q"<code>printf '%.*2$x'</code>", 'reordered precision arguments'],
231                         ['<code>/\b{lb}/</code>', 'line break boundary type (position suitable for hyphenation)'],
232                         ['<code>/faster/</code>', 'various significant speedups, notably matching fixed substrings, <code>/i</code> on caseless languages, 64-bit arithmetic, scope overhead'],
233                 ],
234                 unicode => '8.0',
235                 release => '2016-05-09',
236                 distro => {
237                         debian => '9', # stretch 2017-06 eol 2020-07 lts 2022-06 elts 2027-06
238                         ubuntu => '17.04', # zesty 2017-04 eol 2018-01
239                         freebsd => '10',
240                 },
241                 support => '2027-06',
242         },
243
244         v5.26 => {
245                 new => [
246                         ['<code>&lt;&lt;~EOT</code>', 'indented here-docs, strips same whitespace before delimiter in each line'],
247                         ['<code>@{^CAPTURE}</code>', q"array of last match's captures, so <code>${^CAPTURE}[0]</code> is <code>$1</code>"],
248                         ['<code>//xx</code>', 'extended modifier to also ignore whitespace in bracketed character classes'],
249                 ],
250                 unicode => '9.0', # also Script_Extensions/scx in "\p{script}"
251                 release => '2017-05-30',
252                 distro => {
253                         ubuntu => '17.10', # artful 2017-10; 18.04 LTS 2018-04 eol 2023-04
254                         opensuse => '15.0', # 2018-05 eol 2019-11; same in 15.4 2022-06
255                         centos => '8', # 2019-09 eol 2021-12 TuxCare els 2026-01
256                 },
257                 distrosum => "stable servers such as Ubuntu 17.10+ (Debian &gt;9), CentOS 8, openSUSE 15.0",
258                 support => '2023-04',
259         },
260
261         v5.28 => {
262                 new => [
263                         ['<code>delete %hash{…}</code>', 'hash slices can be deleted with key+value pairs'],
264                         ['<code>/(*…)/</code>', 'alphabetic synonyms for assertions, e.g. <code>(*atomic:…)</code> for <code>(?&gt;…)</code> and <code>(*nlb:…)</code> for <code>(?&lt;!…)</code>', {experimental => 'alpha_assertions', stable => v5.31.6}],
265                         ['<code>/(*script_run:)/</code>', 'enforces all characters to be from the same script', {experimental => 'script_run', stable => v5.31.6}],
266                         ['<code>state @a</code>', 'persistent lexical array or hash variables (in addition to <a href="#state">scalars</a>)', {name => 'state_ext'}],
267                         ['perl<code> -i -pe die</code>', 'safe in-place editing: files are replaced only after successful completion'],
268                         ['<code>${^SAFE_LOCALES}</code>', 'locales are thread-safe on supported systems, indicated by this variable'],
269                 ],
270                 unicode => '10.0',
271                 release => '2018-06-22',
272                 distro => {
273                         debian => '10', # buster 2019-07
274                         ubuntu => '19.04', # disco 2019-04 eol 2020-01
275                         freebsd => '11', # eol 2021-09
276                 },
277                 distrosum => "stable systems such as Debian 10, Ubuntu 19.04, FreeBSD 11",
278         },
279
280         v5.30 => {
281                 new => [
282                         ['<code>/(?<=var+)</code>', 'variable length lookbehind assertions', {experimental => 'vlb', stable => v5.36}],
283                         ['<code>m(\p{nv=/.*/})</code>', 'match unicode properties by regular expressions', {experimental => 'uniprop_wildcards'}],
284                         ['<code><s>my $state if 0</s></code>', 'workaround for <code><a href="#state">state</a></code> (deprecated since v5.10!) is now prohibited'],
285                         [q"<code>qr'\N'</code>", 'Delimiters must be graphemes; unescaped <code>{</code> illegal; <code>\N</code> in single quotes'],
286                 ],
287                 unicode => '12.1',
288                 release => '2019-05-22',
289                 distro => {
290                         ubuntu => '20.04', # focal LTS 2020-04 eol 2025-04
291                 },
292         },
293
294         v5.32 => {
295                 new => [
296                         ['<code>isa</code>', 'infix operator to check class instance', {feature => 'isa', experimental => 'isa', stable => v5.36}],
297                         ['<code>$min &lt; $_ &lt;= $max</code>', 'chained comparison repeats inner part as <code>$min &lt; $_ and $_ &lt;= $max</code>'],
298                         ['<code>/\p{Name=$var}/</code>', 'match Unicode Name property like <code>\N{}</code> but with interpolation and subpatterns'],
299                         [q"<code>open F, '+&gt;&gt;', undef</code>", 'respect append mode on temporary files with mixed access'],
300                         ["<code>no feature 'indirect'</code>", 'disable indirect object notation such as <code>new Class</code> instead of <code>Class-&gt;new</code>'],
301                         ['streamzip', 'program distributed with core IO::Compress::Base to compress stdin into a zip container'],
302                 ],
303                 unicode => '13.0',
304                 release => '2020-06-20',
305                 details => 'https://www.effectiveperlprogramming.com/2020/01/perl-v5-32-new-features/',
306                 distro => {
307                         debian => '11', # bullseye 2021-08
308                         ubuntu => '21.04', # hirsute 2021-04 eol 2022-01
309                         rhel => '8', # -8.7 and -9.1 2022-11
310                         solaris => '11.4', # 2018-08 eol 2034-11 (SRU 38 removes 5.22, 5.26)
311                 },
312                 distrosum => "stable systems such as Debian 11, Ubuntu 21.04, RHEL 8, Solaris 11.4, AIX 7.3",
313                 support => '2034-11', # solaris
314         },
315
316         v5.34 => {
317                 new => [
318                         ['<code>try {} catch</code>', 'exception handling similar to eval blocks', {feature => 'try', experimental => 'try'}],
319                         ['<code>/{,<i>n</i>}/</code>', 'empty lower bound quantifier is accepted as shorthand for 0'],
320                         ['<code>\x{ … }</code>', 'insignificant space within curly braces, also for <code>\b{}</code>, <code>\g{}</code>, <code>\k{}</code>, <code>\N{}</code>, <code>\o{}</code> as well as <code>/{m,n}/</code> quantifiers'],
321                         ['<code>0o0</code>', 'octal prefix <code>0o</code> alternative to <code>0…</code> and <code>oct</code>'],
322                         ['<code>re::optimization(qr//)</code>', 'debug regular expression optimization information discovered at compile time'],
323                         ['<code>no feature …</code>', 'disable discouraged practices of <code>bareword_filehandles</code> and <code>multidimensional</code> array emulation'],
324                 ],
325                 release => '2021-05-20',
326                 distro => {
327                         ubuntu => '22.04', # jammy LTS 2022-04 eol 2027-04
328                         aix => '7.3', # 2021-12 eol 2035?
329                 },
330         },
331
332         v5.36 => {
333                 new => [
334                         ['<code>use v5.36</code>', "use <code>warnings</code>; use feature qw'<code>signatures isa</code>'; no feature qw'<code>indirect multidimensional switch</code>'"],
335                         ['<code>use builtin</code>', 'namespace for interpreter functions, such as <code>weaken</code> and <code>blessed</code> from <code>Scalar::Util</code>, <code>ceil</code>/<code>floor</code> from <code>POSIX</code>, and <code>trim</code> like <code>String::Util</code>', {experimental => 'builtin'}],
336                         ['<code>is_bool(!0)</code>', 'distinguish scalar variable types (by <code>builtin</code> functions) for data interoperability', {name => 'is_bool'}],
337                         ['<code>for my ($k, $v) (%hash)</code>', 'iterate over multiple values at a time (including <code>builtin::indexed</code> for arrays)', {experimental => 'for_list', feature => 'for_list'}],
338                         ['<code>defer {}</code>', 'queue code to be executed when going out of scope', {feature => 'defer', experimental => 'defer'}],
339                         ['<code>try {} finally {}</code>', 'run code at the end of a <code><a href="#try">try</a></code> construct regardless of failure', {name => 'finally', feature => 'try', experimental => 'try'}],
340                         ['<code>q«…»</code>', 'unicode delimiters for quoting operators', {experimental => 'extra_paired_delimiters'}],
341                         ['<code>sub ($var) {!<s>pop</s>}</code>', '<a href="#signatures">signature</a>d subs are stable, but mixing with the arguments array <code>@_</code> remains experimental', {feature => 'signatures', experimental => 'args_array_with_signatures'}],
342                         ['<code>$SIG{FPE}</code>', 'floating-point exceptions no longer deferred but delivered immediately like other signals', {name => 'sig_fpe'}],
343                         ['perl<code> -g</code>', 'disable input record separator (slurp mode), alias for <code>-0777</code>'],
344                 ],
345                 unicode => '14.0',
346                 release => '2022-05-28',
347                 distro => {
348                         debian => '12', # bookworm 2023 upcoming
349                         ubuntu => '23.04', # lunar upcoming
350                 },
351         },
352 }