abort messages with http error code
[sheet.git] / perl.inc.pl
1 use utf8;
2
3 +{
4         v5.005 => {
5                 new => [
6                         ['threads' => '', {experimental => 0, stable => 0}],
7                         ['<code>B::…</code>', 'backend hooks'],
8                         ['<code>qr//</code>' => 'overhauled regular expression engine: precompile operator, lookahead/behind, code, conditions, localised flags'],
9                         ['<code>… foreach</code>' => '<code>for(each)</code> as statement modifier, with large ranges optimised as counting loops'],
10                         ['<code>…::</code>' => 'implicitly quoted package name'],
11                         ['<code>ref $@</code>' => '<code>die</code> passes reference values to exception handlers'],
12                         ['<code>INIT {}</code>', 'subs run just before the perl runtime begins execution'],
13                         ['<code>tie @…</code>' => 'base class for <code>TIEARRAY</code> implementations, and generally improved supported of tied handlers'],
14                         ['<code>substr …,…,…,$replace</code>', 'replacement string in 4th argument'],
15                         ['<code>splice …,…,-$length</code>', 'negative length indicates elements to keep at the end of an array'],
16                         ['<code>$/</code>', 'integer or scalar separator makes <code>&lt;&gt;</code> read records instead of lines'],
17                 ],
18                 release => '1998-07-22',
19                 unstable => 0,
20         },
21
22         v5.6 => {
23                 new => [
24                         ['<code>use warnings</code>', 'pragma to enable warnings in lexical scope'],
25                         ['<code>use utf8</code>', 'experimental unicode semantics <small>(completed in v5.8)</small>', {experimental => 0, stable => v5.8}],
26                         ['<code>use charnames</code>', 'string escape <code>\N{}</code> to insert named character'],
27                         ['<code>our</code>', 'declare global variables'],
28                         ['<code>v1.2.3</code>', q"represent strings as vector of ordinals, useful in version numbers (<code>printf '%vd'</code> to display)"],
29                         ['<code>0b0</code>', q"binary numbers in literals, <code>printf '%b'</code>, and <code>oct</code>"],
30                         ['<code>sub :lvalue</code>', 'subroutine attribute to return a modifiable value', {experimental => 0, stable => v5.20}],
31 #                       ['<code>sub :locked :method</code>', 'syntax to declare subroutine attributes'], # can be inferred from :lvalue support
32                         ['<code>open my $fh, $mode, $expr</code>', 'file handles in scoped scalars, third argument for unambiguous file name'],
33                         [q"<code>pack 'q'</code>", '64-bit integer support (also large files &gt;2GiB)', {experimental => 0, stable => v5.8.1}],
34                         ['<code>sort $coderef ()</code>', 'comparison function can be a subroutine reference; prototype <code>($$)</code> to pass elements as normal <code>@_</code>'],
35                         ['<code>CHECK {}</code>', 'special block called at end of compilation'],
36                         ['<code>/[[:…:]]/</code>', 'POSIX character class syntax such as <code>/[[:alpha:]]/</code>'],
37                         # quite a lot more, but leave it at this
38                 ],
39                 release => '2000-03-23',
40                 distro => {
41                         debian => 'woody',
42                         rhel => '2', # v5.6.0; also in red hat 7.0
43                         solaris => '9', # v5.6.1; 2002-05 eol 2014-10
44                         aix => '5.1', # 2001-05 eol 2006-04
45                         opensuse => '7.1',
46                 },
47                 unicode => '3.0.1',
48         },
49
50         v5.8 => {
51                 new => [
52                         [q"<code>no utf8</code>", 'full unicode support, <code>utf8</code> pragma only for script encoding'],
53                         [q"<code>binmode $fh, ':perlio'</code>", 'file handle behaviour altered by PerlIO layers'],
54                         [q"<code>open $fh, '-|', @cmd</code>", 'open list to fork a command without spawning a shell'],
55                         [q"<code>open $fh, '>', \$var</code>", 'perl scalars as virtual files'],
56                         [q"<code>printf '%1$s', @args</code>", 'syntax to use parameters out of order'],
57                         [q"<code>1_2_3 == 123</code>", 'underscores between digits allowed in numeric constants'],
58 #                       [q"<code>use if</code>", 'conditional module inclusion'], # also installable in earlier versions
59                 ],
60                 release => '2002-07-18',
61                 distro => {
62                         debian => 'sarge',
63                         rhel => '3', # v5.8.0; v5.8.8 in RHEL6 (2007-2014)
64                         solaris => '10', # v5.8.4; 2005-01 eol 2021-01
65                         centos => '3-5', # v5.8.0 in v3 (2004-03); v5.8.8 in v5 (eol 2017-03)
66                         ubuntu => '4.10',
67                         aix => '5.2', # v5.8.0; v5.8.2 in 5.3 and 6.1 (eol 2017-04-30)
68                         freebsd => '4-6',
69                         opensuse => '8.1',
70                 },
71                 distrosum => "dinosaur platforms such as Solaris 10, AIX 5.2, RHEL 3, SLES 8",
72                 unicode => '3.2.0',
73         },
74
75         v5.10 => {
76                 new => [
77                         ['<code>//</code>', 'defined-or operator'],
78                         ['<code>~~</code>', 'smart-match operator to compare different data types <small>(updated in v5.10.1)</small>', {experimental => 'smartmatch'}],
79                         ['<code>say</code>', 'print with newline, equivalent to <code>print @_, "\n"</code>', {feature => 'say'}],
80                         ['<code>given</code>', 'switch statement to smart-match with <code>when</code>/<code>default</code>', {feature => 'switch', experimental => 'smartmatch'}],
81                         ['<code>/(?&lt;name>)/</code>', 'named capture buffers into <code>%+</code>'],
82                         ['<code>/(?1)/</code>', 'recursive regular expression patterns'],
83                         ['<code>/.++/</code>', 'possessive quantifiers <code>?+</code>, <code>*+</code>, <code>++</code> to match greedily'],
84                         ['<code>s/keep\K//</code>', 'floating positive lookbehind, efficient alternative for <code>s/(keep)/$1/</code>'],
85                         ['<code>/\v/, /\h/</code>', 'vertical and horizontal whitespace escapes'],
86                         ['<code>my $_</code>', 'lexically scoped version of the default variable', {experimental => 'lexical_topic', dropped => v5.23.4}],
87                         ['<code>state</code>', 'persistent <code>my</code> variables', {feature => 'state'}],
88                 ],
89                 release => '2007-12-18',
90                 distro => {
91                         debian => 'lenny',
92                         rhel => '6', # v5.10.1
93                         centos => '6', # v5.10.1 (2011-07 eol 2020-11)
94                         ubuntu => '8.10', # v5.10.1 in 10.04 LTS
95                         aix => '7.1', # v5.10.1 (2010-09 eol 2020?)
96                         opensuse => '11.0',
97                 },
98                 unicode => '5.0.0',
99         },
100
101         v5.12 => {
102                 new => [
103                         ['<code>package</code> version', '<code>package</code> NAME VERSION shorthand for <code>our $VERSION</code>'],
104                         ['<code>...</code>', 'yada-yada operator: code placeholder'],
105                         ['<code>use 5.012</code>', 'implicit <code>strict</code> if use VERSION >= v5.12'],
106                         ['<code>… when</code>', '<code>when</code> is now allowed to be used as a statement modifier'],
107                         [q"<code>use overload 'qr'</code>", 'customisable conversion to regular expressions'],
108                         ['<code>/\N/</code>', 'inverse \n to match any character except newline regardless of <code>/s</code>', {experimental => 0, stable => v5.18}],
109                 ],
110                 release => '2010-04-12',
111                 unicode => '5.2',
112                 distro => {
113                         solaris => '11', # also v5.8.4; 2010-11 eol 2024-11
114                         ubuntu => '11.10',
115                         freebsd => '7',
116                         opensuse => '11.3',
117                 },
118         },
119
120         v5.14 => {
121                 new => [
122                         ['<code>s///r</code>', 'non-destructive substitution'],
123                         ['<code>/(?^)/</code>', 'construct to reset to default modifiers'],
124                         ['<code>/(?{ m() })/</code>', 'regular expressions can be nested in <code>/(?{})/</code> and <code>/(??{})/</code>', {experimental => 0, stable => v5.20}],
125                         [q"<code>use re '/flags'</code>", 'customise default modifiers'],
126                         ['<code>each $ref</code> e.a.', 'array and hash container functions accept references', {experimental => 'postderef', dropped => v5.23.1}],
127                         ['<code>FH->method</code>', 'filehandle method calls load IO::File on demand (eg. <code>STDOUT->flush</code>)'],
128                 ],
129                 release => '2011-05-14',
130                 distro => {
131                         debian => '7', # wheezy 2013-05 eol 2018-05
132                         ubuntu => '12.04',
133                         opensuse => '12.1',
134                 },
135                 distrosum => "stable servers such as Debian 7, Ubuntu 12.04, CentOS 7",
136                 unicode => '6.0+#8',
137         },
138
139         v5.16 => {
140                 new => [
141                         ['<code>__SUB__</code>', 'current subroutine reference', {feature => 'current_sub'}],
142                         ['<code>fc, "\F"</code>', 'unicode foldcase to compare case-insensitively', {feature => 'fc'}],
143                         ['<code>"\N{}"</code>', 'automatic <code>use charnames qw( :full :short )</code>'],
144                 ],
145                 release => '2012-05-20',
146                 distro => {
147                         rhel => '7', # v5.16.3
148                         centos => '7', # v5.16.3 (2014-07 eol 2024-06)
149                         freebsd => '9',
150                         opensuse => '12.2',
151                 },
152                 unicode => '6.1',
153         },
154
155         v5.18 => {
156                 new => [
157                         ['<code>${^LAST_FH}</code>', 'last read filehandle (used by <code>$.</code>)'],
158                         ['<code>/(?[ a + b ])/</code>', 'regex set operations (character substraction <code>-</code>, unions <code>&amp;</code>)', {experimental => 'regex_sets'}],
159                         ['<code>my sub</code>', 'lexical subroutines (also <code>state</code>, <code>our</code>); buggy before v5.22', {experimental => 'lexical_subs', stable => v5.26}],
160                         ['<code>next $expression</code>', 'loop controls allow runtime expressions'],
161                         [q"<code>no warnings 'experimental::…'</code>", 'mechanism for experimental features, as of now required for <em>smartmatch</em>'],
162                 ],
163                 release => '2013-05-18',
164                 distro => {
165                         ubuntu => '14.04 LTS', # trusty
166                         opensuse => '13.1',
167                 },
168                 unicode => '6.2',
169         },
170
171         v5.20 => {
172                 new => [
173                         ['<code>sub ($var)</code>', 'subroutine signatures', {feature => 'signatures', experimental => 'signatures'}],
174                         ['<code>%hash{…}</code>', 'hash slices return key+value pairs'],
175                         ['<code>[]->@*</code>', 'postfix dereferencing (also e.g. <code>$scalar->$*</code> for <code>$$scalar</code>)', {feature => 'postderef, postderef_qq', experimental => 'postderef', stable => v5.23.1}],
176                         [q"<code>use warnings 'once'; $a</code>", 'variables $a and $b are exempt from <em>used once</em> warnings'],
177                 ],
178                 unicode => '6.3',
179                 release => '2014-05-27',
180                 distro => {
181                         debian => '8', # jessie 2015-04 eol 2020-05
182                         ubuntu => '14.10', # utopic
183                         aix => '7.2',
184                         opensuse => '13.2', # 2014-11 eol 2017-01
185                 },
186                 distrosum => "stable servers such as Debian 8 (oldstable), Ubuntu 14.10, FreeBSD 10, openSUSE 13.2",
187         },
188
189         v5.22 => {
190                 new => [
191                         ['<code>\$alias =</code>', 'aliasing via reference (scoped as of v5.25.3)', {experimental => 'refaliasing'}],
192                         ['<code>&lt;&lt;>></code>', 'safe <code>readline</code> ignoring open flags in arguments'],
193                         ['<code>/()/n</code>', 'flag to disable numbered capturing, turning <code>()</code> into <code>(?:)</code>'],
194                         ['<code>/\b{}/</code>', 'boundary types: <em>gcb</em> (grapheme cluster), <em>sb</em> (sentence), <em>wb</em> (word)'],
195                         ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', {experimental => 'bitwise'}],
196                         [q"<code>use re 'strict'</code>", 'apply stricter syntax rules to regular expression patterns', {experimental => 're_strict'}],
197                         ['<code>0x.beep+0</code>', q"hexadecimal floating point notation with binary power; <code>printf '%a'</code> to display"],
198                 ],
199                 unicode => '7.0',
200                 release => '2015-06-01',
201                 distro => {
202                         ubuntu => '16.04 LTS', # xenial
203                 },
204         },
205
206         v5.24 => {
207                 new => [
208                         [q"<code>printf '%.*2$x'</code>", 'reordered precision arguments'],
209                         ['<code>/\b{lb}/</code>', 'line break boundary type (position suitable for hyphenation)'],
210                         ['<code>/faster/</code>', 'various significant speedups, notably matching fixed substrings, <code>/i</code> on caseless languages, 64-bit arithmetic, scope overhead'],
211                 ],
212                 unicode => '8.0',
213                 release => '2016-05-09',
214                 distro => {
215                         debian => '9', # stretch 2017-06
216                         ubuntu => '17.04', # zesty
217                         freebsd => '10',
218                 },
219         },
220
221         v5.26 => {
222                 new => [
223                         ['<code>&lt;&lt;~EOT</code>', 'indented here-docs, strips same whitespace before delimiter in each line'],
224                         ['<code>@{^CAPTURE}</code>', q"array of last match's captures, so <code>${^CAPTURE}[0]</code> is <code>$1</code>"],
225                         ['<code>//xx</code>', 'extended modifier to also ignore whitespace in bracketed character classes'],
226                 ],
227                 unicode => '9.0', # also Script_Extensions/scx in "\p{script}"
228                 release => '2017-05-30',
229                 distro => {
230                         ubuntu => '17.10', # artful
231                 },
232         },
233 }