This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
use re 'strict' doc changes
[perl5.git] / pod / perlexperiment.pod
index 664820a..1e7dd27 100644 (file)
@@ -16,29 +16,14 @@ their inception, versions, etc. There's a lot of speculation here.
 
 =over 8
 
-=item C<(?{code})> and C<(??{ code })>
-
-Introduced in Perl 5.6.0
-
-See also L<perlre>
-
-=item Lvalue subroutines
-
-Introduced in Perl 5.6.0
-
-See also L<perlsub>
-
 =item C<our> can now have an experimental optional attribute C<unique>
 
 Introduced in Perl 5.8.0
 
 Deprecated in Perl 5.10.0
 
-=item Linux abstract Unix domain sockets
-
-Introduced in Perl 5.9.2
-
-See also L<Socket>
+The ticket for this feature is
+L<[perl #119313]|https://rt.perl.org/rt3/Ticket/Display.html?id=119313>.
 
 =item Smart match (C<~~>)
 
@@ -49,6 +34,9 @@ Modified in Perl 5.10.1, 5.12.0
 Using this feature triggers warnings in the category
 C<experimental::smartmatch>.
 
+The ticket for this feature is
+L<[perl #119317]|https://rt.perl.org/rt3/Ticket/Display.html?id=119317>.
+
 =item Lexical C<$_>
 
 Introduced in Perl 5.10.0
@@ -56,8 +44,14 @@ Introduced in Perl 5.10.0
 Using this feature triggers warnings in the category
 C<experimental::lexical_topic>.
 
+The ticket for this feature is
+L<[perl #119315]|https://rt.perl.org/rt3/Ticket/Display.html?id=119315>.
+
 =item Pluggable keywords
 
+The ticket for this feature is
+L<[perl #119455]|https://rt.perl.org/rt3/Ticket/Display.html?id=119455>.
+
 See L<perlapi/PL_keyword_plugin> for the mechanism.
 
 Introduced in: Perl 5.11.2
@@ -66,6 +60,9 @@ Introduced in: Perl 5.11.2
 
 Introduced in Perl 5.14.0
 
+The ticket for this feature is
+L<[perl #119437]|https://rt.perl.org/rt3/Ticket/Display.html?id=119437>.
+
 =item Lexical subroutines
 
 Introduced in: Perl 5.18
@@ -75,138 +72,99 @@ See also: L<perlsub/Lexical Subroutines>
 Using this feature triggers warnings in the category
 C<experimental::lexical_subs>.
 
+The ticket for this feature is
+L<[perl #120085]|https://rt.perl.org/rt3/Ticket/Display.html?id=120085>.
+
 =item Regular Expression Set Operations
 
 Introduced in: Perl 5.18
 
+The ticket for this feature is
+L<[perl #119451]|https://rt.perl.org/rt3/Ticket/Display.html?id=119451>.
+
 See also: L<perlrecharclass/Extended Bracketed Character Classes>
 
 Using this feature triggers warnings in the category
 C<experimental::regex_sets>.
 
-=item C<\s> in regexp matches vertical tab
-
-Introduced in Perl 5.18
-
-=item The <:pop> IO pseudolayer
-
-See also L<perlrun>
-
-=item The <:win32> IO pseudolayer
-
-See also L<perlrun>
-
-=item MLDBM
-
-See also L<perldsc>
-
-=item internal functions with M flag
-
-See also L<perlguts>
-
-=item lex_start API
-
-Introduced in Perl 5.13.7
-
-=item internal API for C<%^H>
-
-Introduced in Perl 5.13.7
-
-See also C<cophh_> in L<perlapi>.
-
-=item alloccopstash
-
-Introduced in Perl 5.18.0
-
-=item av_create_and_push
-
-=item av_create_and_unshift_one
-
-=item av_create_and_unshift_one
-
-=item cop_store_label
-
-Introduced in Perl 5.16.0
-
-=item PL_keyword_plugin
-
-=item gv_fetchmethod_*_flags
+=item Subroutine signatures
 
-Introduced in Perl 5.16.0
+Introduced in Perl 5.20.0
 
-=item hv_iternext_flags
-
-=item lex_bufutf8
+Using this feature triggers warnings in the category
+C<experimental::signatures>.
 
-=item lex_discard_to
+The ticket for this feature is
+L<[perl #121481]|https://rt.perl.org/Ticket/Display.html?id=121481>.
 
-=item lex_grow_linestr
+=item Postfix dereference syntax
 
-=item lex_next_chunk
+Introduced in Perl 5.20.0
 
-=item lex_peek_unichar
+Using this feature triggers warnings in the category
+C<experimental::postderef>.
 
-=item lex_read_space
+The ticket for this feature is
+L<[perl #120162]|https://rt.perl.org:443/rt3/Ticket/Display.html?id=120162>.
 
-=item lex_read_to
+=item Aliasing via reference
 
-=item lex_read_unichar
+Introduced in Perl 5.22.0
 
-=item lex_stuff_pv
+Using this feature triggers warnings in the category
+C<experimental::refaliasing>.
 
-=item lex_stuff_pvn
+The ticket for this feature is
+L<[perl #122947]|https://rt.perl.org/rt3/Ticket/Display.html?id=122947>.
 
-=item lex_stuff_pvs
+See also: L<perlref/Assigning to References>
 
-=item lex_stuff_sv
+=item The "const" attribute
 
-=item lex_unstuff
+Introduced in Perl 5.22.0
 
-=item op_scope
+Using this feature triggers warnings in the category
+C<experimental::const_attr>.
 
-=item op_lvalue
+The ticket for this feature is
+L<[perl #123630]|https://rt.perl.org/rt3/Ticket/Display.html?id=123630>.
 
-=item parse_fullstmt
+See also: L<perlsub/Constant Functions>
 
-=item parse_stmtseq
+=item use re 'strict';
 
-=item PL_parser-E<gt>bufend
+Introduced in Perl 5.22.0
 
-=item PL_parser-E<gt>bufptr
+Using this feature triggers warnings in the category
+C<experimental::re_strict>.
 
-=item PL_parser-E<gt>linestart
+See L<re/'strict' mode>
 
-=item PL_parser-E<gt>linestr
+=item String- and number-specific bitwise operators
 
-=item Perl_signbit
+Introduced in: Perl 5.22.0
 
-=item pad_findmy
+See also: L<perlop/Bitwise String Operators>
 
-=item sv_utf8_decode
+Using this feature triggers warnings in the category
+C<experimental::bitwise>.
 
-=item sv_utf8_downgrade
+The ticket for this feature is
+L<[perl #123707]|https://rt.perl.org/rt3/Ticket/Display.html?id=123707>.
 
-=item bytes_from_utf8
+=item The <:win32> IO pseudolayer
 
-=item bytes_to_utf8
+The ticket for this feature is
+L<[perl #119453]|https://rt.perl.org/rt3/Ticket/Display.html?id=119453>.
 
-=item utf8_to_bytes
+See also L<perlrun>
 
 =item There is an C<installhtml> target in the Makefile.
 
-=item Unicode in Perl on EBCDIC
-
-See also: L<perlre/"Special Backtracking Control Verbs">
-
-=item Code expressions, conditional expressions, and independent expressions in regexes
-
-=item gv_try_downgrade
+The ticket for this feature is
+L<[perl #116487]|https://rt.perl.org/rt3/Ticket/Display.html?id=116487>.
 
-See also L<perlintern>
-
-=item Experimental Support for Sun Studio Compilers for Linux OS
-
-See also L<perllinux>
+=item Unicode in Perl on EBCDIC
 
 =back
 
@@ -269,6 +227,31 @@ Introduced in Perl 5.12
 
 Exact version of acceptance unclear, but no later than Perl 5.18.
 
+=item C<(?{code})> and C<(??{ code })>
+
+Introduced in Perl 5.6.0
+
+Accepted in Perl 5.20.0
+
+See also L<perlre>
+
+=item Linux abstract Unix domain sockets
+
+Introduced in Perl 5.9.2
+
+Accepted before Perl 5.20.0.  The Socket library is now primarily maintained
+on CPAN, rather than in the perl core.
+
+See also L<Socket>
+
+=item Lvalue subroutines
+
+Introduced in Perl 5.6.0
+
+Accepted in Perl 5.20.0
+
+See also L<perlsub>
+
 =item Backtracking control verbs
 
 C<(*ACCEPT)>
@@ -277,6 +260,16 @@ Introduced in: Perl 5.10
 
 Accepted in Perl 5.20.0
 
+=item The <:pop> IO pseudolayer
+
+See also L<perlrun>
+
+Accepted in Perl 5.20.0
+
+=item C<\s> in regexp matches vertical tab
+
+Accepted in Perl 5.22.0
+
 =back
 
 =head2 Removed features
@@ -333,6 +326,10 @@ Removed in: 5.11.3
 
 =back
 
+=head1 SEE ALSO
+
+For a complete list of features check L<feature>.
+
 =head1 AUTHORS
 
 brian d foy C<< <brian.d.foy@gmail.com> >>