Provide defined value for $TODO only where test is still failing.
[perl.git] / pod / perlexperiment.pod
1 =head1 NAME
2
3 perlexperiment - A listing of experimental features in Perl
4
5 =head1 DESCRIPTION
6
7 This document lists the current and past experimental features in the perl
8 core. Although all of these are documented with their appropriate topics,
9 this succinct listing gives you an overview and basic facts about their
10 status.
11
12 So far we've merely tried to find and list the experimental features and infer
13 their inception, versions, etc. There's a lot of speculation here.
14
15 =head2 Current experiments
16
17 =over 8
18
19 =item Smart match (C<~~>)
20
21 Introduced in Perl 5.10.0
22
23 Modified in Perl 5.10.1, 5.12.0
24
25 Using this feature triggers warnings in the category
26 C<experimental::smartmatch>.
27
28 The ticket for this feature is
29 L<[perl #119317]|https://rt.perl.org/rt3/Ticket/Display.html?id=119317>.
30
31 =item Pluggable keywords
32
33 The ticket for this feature is
34 L<[perl #119455]|https://rt.perl.org/rt3/Ticket/Display.html?id=119455>.
35
36 See L<perlapi/PL_keyword_plugin> for the mechanism.
37
38 Introduced in Perl 5.11.2
39
40 =item Regular Expression Set Operations
41
42 Introduced in Perl 5.18
43
44 The ticket for this feature is
45 L<[perl #119451]|https://rt.perl.org/rt3/Ticket/Display.html?id=119451>.
46
47 See also: L<perlrecharclass/Extended Bracketed Character Classes>
48
49 Using this feature triggers warnings in the category
50 C<experimental::regex_sets>.
51
52 =item Subroutine signatures
53
54 Introduced in Perl 5.20.0
55
56 Using this feature triggers warnings in the category
57 C<experimental::signatures>.
58
59 The ticket for this feature is
60 L<[perl #121481]|https://rt.perl.org/Ticket/Display.html?id=121481>.
61
62 =item Aliasing via reference
63
64 Introduced in Perl 5.22.0
65
66 Using this feature triggers warnings in the category
67 C<experimental::refaliasing>.
68
69 The ticket for this feature is
70 L<[perl #122947]|https://rt.perl.org/rt3/Ticket/Display.html?id=122947>.
71
72 See also: L<perlref/Assigning to References>
73
74 =item The "const" attribute
75
76 Introduced in Perl 5.22.0
77
78 Using this feature triggers warnings in the category
79 C<experimental::const_attr>.
80
81 The ticket for this feature is
82 L<[perl #123630]|https://rt.perl.org/rt3/Ticket/Display.html?id=123630>.
83
84 See also: L<perlsub/Constant Functions>
85
86 =item use re 'strict';
87
88 Introduced in Perl 5.22.0
89
90 Using this feature triggers warnings in the category
91 C<experimental::re_strict>.
92
93 See L<re/'strict' mode>
94
95 =item The <:win32> IO pseudolayer
96
97 The ticket for this feature is
98 L<[perl #119453]|https://rt.perl.org/rt3/Ticket/Display.html?id=119453>.
99
100 See also L<perlrun>
101
102 =item Declaring a reference to a variable
103
104 Introduced in Perl 5.26.0
105
106 Using this feature triggers warnings in the category
107 C<experimental::declared_refs>.
108
109 The ticket for this feature is
110 L<[perl #128654]|https://rt.perl.org/rt3/Ticket/Display.html?id=128654>.
111
112 See also: L<perlref/Declaring a Reference to a Variable>
113
114 =item There is an C<installhtml> target in the Makefile.
115
116 The ticket for this feature is
117 L<[perl #116487]|https://rt.perl.org/rt3/Ticket/Display.html?id=116487>.
118
119 =item Unicode in Perl on EBCDIC
120
121 =item Script runs
122
123 Introduced in Perl 5.28.0
124
125 Using this feature triggers warnings in the category
126 C<experimental::script_run>.
127
128 See also: L<perlre/Script Runs>
129
130 =item Alpabetic assertions
131
132 Introduced in Perl 5.28.0
133
134 Using this feature triggers warnings in the category
135 C<experimental::alpha_assertions>.
136
137 See also: L<perlre/Extended Patterns>.
138
139 =back
140
141 =head2 Accepted features
142
143 These features were so wildly successful and played so well with others that
144 we decided to remove their experimental status and admit them as full, stable
145 features in the world of Perl, lavishing all the benefits and luxuries thereof.
146 They are also awarded +5 Stability and +3 Charisma.
147
148 =over 8
149
150 =item 64-bit support
151
152 Introduced in Perl 5.005
153
154 =item die accepts a reference
155
156 Introduced in Perl 5.005
157
158 =item DB module
159
160 Introduced in Perl 5.6.0
161
162 See also L<perldebug>, L<perldebtut>
163
164 =item Weak references
165
166 Introduced in Perl 5.6.0
167
168 =item Internal file glob
169
170 Introduced in Perl 5.6.0
171
172 =item fork() emulation
173
174 Introduced in Perl 5.6.1
175
176 See also L<perlfork>
177
178 =item -Dusemultiplicity -Duseithreads
179
180 Introduced in Perl 5.6.0
181
182 Accepted in Perl 5.8.0
183
184 =item Support for long doubles
185
186 Introduced in Perl 5.6.0
187
188 Accepted in Perl 5.8.1
189
190 =item The C<\N> regex character class
191
192 The C<\N> character class, not to be confused with the named character
193 sequence C<\N{NAME}>, denotes any non-newline character in a regular
194 expression.
195
196 Introduced in Perl 5.12
197
198 Exact version of acceptance unclear, but no later than Perl 5.18.
199
200 =item C<(?{code})> and C<(??{ code })>
201
202 Introduced in Perl 5.6.0
203
204 Accepted in Perl 5.20.0
205
206 See also L<perlre>
207
208 =item Linux abstract Unix domain sockets
209
210 Introduced in Perl 5.9.2
211
212 Accepted before Perl 5.20.0.  The Socket library is now primarily maintained
213 on CPAN, rather than in the perl core.
214
215 See also L<Socket>
216
217 =item Lvalue subroutines
218
219 Introduced in Perl 5.6.0
220
221 Accepted in Perl 5.20.0
222
223 See also L<perlsub>
224
225 =item Backtracking control verbs
226
227 C<(*ACCEPT)>
228
229 Introduced in Perl 5.10
230
231 Accepted in Perl 5.20.0
232
233 =item The <:pop> IO pseudolayer
234
235 See also L<perlrun>
236
237 Accepted in Perl 5.20.0
238
239 =item C<\s> in regexp matches vertical tab
240
241 Accepted in Perl 5.22.0
242
243 =item Postfix dereference syntax
244
245 Introduced in Perl 5.20.0
246
247 Accepted in Perl 5.24.0
248
249 =item Lexical subroutines
250
251 Introduced in Perl 5.18.0
252
253 Accepted in Perl 5.26.0
254
255 =item String- and number-specific bitwise operators
256
257 Introduced in Perl 5.22.0
258
259 Accepted in Perl 5.28.0
260
261 =back
262
263 =head2 Removed features
264
265 These features are no longer considered experimental and their functionality
266 has disappeared. It's your own fault if you wrote production programs using
267 these features after we explicitly told you not to (see L<perlpolicy>).
268
269 =over 8
270
271 =item 5.005-style threading
272
273 Introduced in Perl 5.005
274
275 Removed in Perl 5.10
276
277 =item perlcc
278
279 Introduced in Perl 5.005
280
281 Moved from Perl 5.9.0 to CPAN
282
283 =item The pseudo-hash data type
284
285 Introduced in Perl 5.6.0
286
287 Removed in Perl 5.9.0
288
289 =item GetOpt::Long Options can now take multiple values at once (experimental)
290
291 C<Getopt::Long> upgraded to version 2.35
292
293 Removed in Perl 5.8.8
294
295 =item Assertions
296
297 The C<-A> command line switch
298
299 Introduced in Perl 5.9.0
300
301 Removed in Perl 5.9.5
302
303 =item Test::Harness::Straps
304
305 Moved from Perl 5.10.1 to CPAN
306
307 =item C<legacy>
308
309 The experimental C<legacy> pragma was swallowed by the C<feature> pragma.
310
311 Introduced in Perl 5.11.2
312
313 Removed in Perl 5.11.3
314
315 =item Lexical C<$_>
316
317 Using this feature triggered warnings in the category
318 C<experimental::lexical_topic>.
319
320 Introduced in Perl 5.10.0
321
322 Removed in Perl 5.24.0
323
324 =item Array and hash container functions accept references
325
326 Using this feature triggered warnings in the category
327 C<experimental::autoderef>.
328
329 Superseded by L</Postfix dereference syntax>.
330
331 Introduced in Perl 5.14.0
332
333 Removed in Perl 5.24.0
334
335 =item C<our> can have an experimental optional attribute C<unique>
336
337 Introduced in Perl 5.8.0
338
339 Deprecated in Perl 5.10.0
340
341 Removed in Perl 5.28.0
342
343 =back
344
345 =head1 SEE ALSO
346
347 For a complete list of features check L<feature>.
348
349 =head1 AUTHORS
350
351 brian d foy C<< <brian.d.foy@gmail.com> >>
352
353 SE<eacute>bastien Aperghis-Tramoni C<< <saper@cpan.org> >>
354
355 =head1 COPYRIGHT
356
357 Copyright 2010, brian d foy C<< <brian.d.foy@gmail.com> >>
358
359 =head1 LICENSE
360
361 You can use and redistribute this document under the same terms as Perl
362 itself.
363
364 =cut