termcol: hsv method in Colour module
[sheet.git] / perl.inc.pl
1 use utf8;
2
3 +{
4         v5.6 => {
5                 new => [
6                         ['<code>use warnings</code>', 'pragma to enable warnings in lexical scope'],
7                         ['<code>use utf8</code>', 'experimental unicode semantics <small>(completed in v5.8)</small>', v5.8],
8                         ['<code>use charnames</code>', 'string escape <code>\N{}</code> to insert named character'],
9                         ['<code>our</code>', 'declare global variables'],
10                         ['<code>v1.2.3</code>', q"represent strings as vector of ordinals, useful in version numbers (<code>printf '%vd'</code> to display)"],
11                         ['<code>0b0</code>', q"binary numbers in literals, <code>printf '%b'</code>, and <code>oct</code>"],
12                         ['<code>sub :lvalue</code>', 'subroutine attribute to return a modifiable value', v5.20],
13 #                       ['<code>sub :locked :method</code>', 'syntax to declare subroutine attributes'], # can be inferred from :lvalue support
14                         ['<code>open my $fh, $mode, $expr</code>', 'file handles in scoped scalars, third argument for unambiguous file name'],
15                         [q"<code>pack 'q'</code>", '64-bit integer support (also large files &gt;2GiB)', v5.8.1],
16                         ['<code>sort $coderef ()</code>', 'comparison function can be a subroutine reference; prototype <code>($$)</code> to pass elements as normal <code>@_</code>'],
17                         ['<code>CHECK {}</code>', 'special block called at end of compilation'],
18                         ['<code>/[[:…:]]/</code>', 'POSIX character class syntax such as <code>/[[:alpha:]]/</code>'],
19                         # quite a lot more, but leave it at this
20                 ],
21                 release => '2000-03-23',
22                 distro => {
23                         debian => 'woody',
24                         rhel => '2', # v5.6.0; also in red hat 7.0
25                         solaris => '9', # v5.6.1; 2002-05 eol 2014-10
26                 },
27                 unicode => '3.0.1',
28         },
29
30         v5.8 => {
31                 new => [
32                         [q"<code>no utf8</code>", 'full unicode support, <code>utf8</code> pragma only for script encoding'],
33                         [q"<code>binmode $fh, ':perlio'</code>", 'file handle behaviour altered by PerlIO layers'],
34                         [q"<code>open $fh, '-|', @cmd</code>", 'open list to fork a command without spawning a shell'],
35                         [q"<code>open $fh, '>', \$var</code>", 'perl scalars as virtual files'],
36                         [q"<code>printf '%1$s', @args</code>", 'syntax to use parameters out of order'],
37                         [q"<code>1_2_3 == 123</code>", 'underscores between digits allowed in numeric constants'],
38 #                       [q"<code>use if</code>", 'conditional module inclusion'], # also installable in earlier versions
39                 ],
40                 release => '2002-07-18',
41                 distro => {
42                         debian => 'sarge',
43                         rhel => '3', # v5.8.0; v5.8.8 in RHEL6 (2007-2014)
44                         solaris => '10', # v5.8.4; 2005-01 eol 2021-01
45                         centos => '3-5', # v5.8.0 in v3 (2004-03); v5.8.8 in v5 (eol 2017-03)
46                 },
47                 unicode => '3.2.0',
48         },
49
50         v5.10 => {
51                 new => [
52                         ['<code>//</code>', 'defined-or operator'],
53                         ['<code>~~</code>', 'smart-match operator to compare different data types <small>(updated in v5.10.1)</small>', 'experimental::smartmatch'],
54                         ['<code>given</code>', 'switch statement to smart-match with <code>when</code>/<code>default</code>', 'experimental::smartmatch'],
55                         ['<code>/(?&lt;name>)/</code>', 'named capture buffers into <code>%+</code>'],
56                         ['<code>s/keep\K//</code>', 'floating positive lookbehind, efficient alternative for <code>s/(keep)/$1/</code>'],
57                         ['<code>/\v/, /\h/</code>', 'vertical and horizontal whitespace escapes'],
58                         ['<code>my $_</code>', 'lexically scoped version of the default variable', 'experimental::lexical_topic'],
59                 ],
60                 release => '2007-12-18',
61                 distro => {
62                         debian => 'lenny',
63                         rhel => '6', # v5.10.1
64                         centos => '6', # v5.10.1 (2011-07 eol 2020-11)
65                 },
66                 unicode => '5.0.0',
67         },
68
69         v5.12 => {
70                 new => [
71                         ['<code>package version</code>', '<code>package</code> NAME VERSION shorthand for <code>our $VERSION</code>'],
72                         ['<code>...</code>', 'yada-yada operator: code placeholder'],
73                         ['<code>use 5.012</code>', 'Implicit <code>strict</code> if use VERSION >= v5.12'],
74                         ['<code>… when</code>', '<code>when</code> is now allowed to be used as a statement modifier'],
75                         [q"<code>use overload 'qr'</code>", 'customisable conversion to regular expressions'],
76                         ['<code>/\N/</code>', 'inverse \n to match any character except newline regardless of <code>/s</code>', v5.18],
77                 ],
78                 release => '2010-04-12',
79                 unicode => '5.2',
80                 distro => {
81                         solaris => '11', # also v5.8.4; 2010-11 eol 2024-11
82                 },
83         },
84
85         v5.14 => {
86                 new => [
87                         ['<code>s///r</code>', 'non-destructive substitution'],
88                         ['<code>/(?^)/</code>', 'construct to reset to default modifiers'],
89                         ['<code>/(?{ m() })/</code>', 'regular expressions can be nested in <code>/(?{})/</code> and <code>/(??{})/</code>', v5.20],
90                         [q"<code>use re '/flags'</code>", 'customise default modifiers'],
91                         ['<code>each $ref</code> e.a.', 'array and hash container functions accept references', v0.5.23.1],
92                         ['<code>FH->method</code>', 'filehandle method calls load IO::File on demand (eg. <code>STDOUT->flush</code>)'],
93                 ],
94                 release => '2011-05-14',
95                 distro => {
96                         debian => 'wheezy',
97                 },
98                 unicode => '6.0+#8',
99         },
100
101         v5.16 => {
102                 new => [
103                         ['<code>__SUB__</code>', 'current subroutine reference'],
104                         ['<code>fc, "\F"</code>', 'unicode foldcase to compare case-insensitively'],
105                         ['<code>"\N{}"</code>', 'automatic <code>use charnames qw( :full :short )</code>'],
106                 ],
107                 release => '2012-05-20',
108                 distro => {
109                         rhel => '7', # v5.16.3
110                         centos => '7', # v5.16.3 (2014-07 eol 2024-06)
111                 },
112                 unicode => '6.1',
113         },
114
115         v5.18 => {
116                 new => [
117                         ['<code>${^LAST_FH}</code>', 'last read filehandle (used by <code>$.</code>)'],
118                         ['<code>/(?[ a + b ])/</code>', 'regex set operations (character substraction <code>-</code>, unions <code>&amp;</code>)', 'experimental::regex_sets'],
119                         ['<code>my sub</code>', 'lexical subroutines (also <code>state</code>, <code>our</code>)', 'experimental::lexical_subs'],
120                         ['<code>next $expression</code>', 'loop controls allow runtime expressions'],
121                         [q"<code>no warnings 'experimental::…'</code>", 'mechanism for experimental features, as of now required for smartmatch'],
122                 ],
123                 release => '2013-05-18',
124                 unicode => '6.2',
125         },
126
127         v5.20 => {
128                 new => [
129                         ['<code>sub ($var)</code>', 'subroutine signatures', 'experimental::signatures'],
130                         ['<code>%hash{…}</code>', 'hash slices return key+value pairs'],
131                         ['<code>[]->@*</code>', 'postfix dereferencing (also e.g. <code>$scalar->$*</code> for <code>$$scalar</code>)', v5.23.1, 'experimental::postderef'],
132                         [q"<code>use warnings 'once'; $a</code>", 'variables $a and $b are exempt from <em>used once</em> warnings'],
133                 ],
134                 unicode => '6.3',
135                 release => '2014-05-27',
136                 distro => {
137                         debian => 'jessie',
138                 },
139         },
140
141         v5.22 => {
142                 new => [
143                         ['<code>\$alias =</code>', 'aliasing via reference'],
144                         ['<code>&lt;&lt;>></code>', 'safe <code>readline</code> ignoring open flags in arguments'],
145                         ['<code>/()/n</code>', 'flag to disable numbered capturing, turning <code>()</code> into <code>(?:)</code>'],
146                         ['<code>/\b{}/</code>', 'boundary types: <em>gcb</em> (grapheme cluster), <em>sb</em> (sentence), <em>wb</em> (word)'],
147                         ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', 'experimental::bitwise'],
148                         [q"<code>use re 'strict'</code>", 'apply stricter syntax rules to regular expression patterns', 'experimental::re_strict'],
149                         ['<code>0x.beep+0</code>', q"hexadecimal floating point notation with binary power; <code>printf '%a'</code> to display"],
150                 ],
151                 unicode => '7.0',
152                 release => '2015-06-01',
153         },
154 }