Pulled out the remaining experimental references in the docsbriandfoy/perlexperiment

1 files changed, 224 insertions, 126 deletions

diff --git a/pod/perlexperiment.pod b/pod/perlexperiment.pod
index 10f2ee4741..3f7e99f98a 100644
--- a/pod/perlexperiment.pod
+++ b/pod/perlexperiment.pod
@@ -9,14 +9,229 @@ core. Although each of these are documented with their appropriate topics,
 this succinct listing gives you an overview and basic facts about their
 status.
 
+So far I've merely tried to find and list the experimental features and infer
+their inception, etc versions. There's a lot of speculation here.
+
 =head2 Current experiments
 
 =over 8
 
-=item The C<(?{code})>
+=item fork() emulation
+
+Introduced in Perl 5.6.1
+
+See also L<perlfork>
+
+=item Weak references
+
+Introduced in Perl 5.6.0
+
+=item Internal file glob
+
+Introduced in Perl 5.6.0
+
+Accepted in XXX
+
+=item 64-bit support
+
+Introduced in Perl 5.005
+
+Accepted in XXX
+
+=item die accepts a reference
+
+Introduced in Perl 5.005
+
+Accecpted in Perl XXX
+
+=item Unicode support
+
+Introduced in Perl 5.6.0
+
+Accepted in Perl 5.8.0 XXX
+
+=item -Dusemultiplicity -Dusethreads
+
+Introduced in Perl 5.6.0
+
+=item Long Doubles Still Don't Work In Solaris
+
+Introduced in Perl 5.7.0
+
+=item GetOpt::Long Options can now take multiple values at once (experimental)
+
+C<Getopt::Long> upgraded to version 2.35
+
+Removed in Perl 5.8.8
+
+=item 5.005-style threading
+
+Introduced in Perl 5.005
+
+Removed in Perl 5.10 XXX
+
+=item Test::Harness::Straps
+
+Removed in Perl 5.10.1
+
+=item perlcc
+
+Introduced in Perl 5.005
+
+Removed in Perl 5.9.0
+
+See also L<perlcompile>
+
+=item C<our> can now have an experimental optional attribute C<unique>
+
+Introduced in Perl 5.8.0
+
+=item Assertions
+
+The C<-A> command line switch
+
+Introduced in Perl 5.9.0
+
+Removed in Perl 5.9.5
+
+=item Linux abstract Unix domain sockets
+
+Introduced in Perl 5.9.2
+
+See also L<Socket>
+
+=item L<Pod::HTML2Pod|Pod::HTML2Pod>
+
+=item L<Pod::PXML|Pod::PXML>
+
+=item threads
+
+=item The <:pop> IO psuedolayer
+
+See also L<perlrun>
+
+=item The <:win32> IO psuedolayer
+
+See also L<perlrun>
+
+=item fields pragma
+
+Introduced in Perl 5.6.0
+
+Removed in XXX
+
+=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 av_create_and_push
+
+=item av_create_and_unshift_one
+
+=item av_create_and_unshift_one
+
+=item PL_keyword_plugin
+
+=item hv_iternext_flags
+
+=item lex_bufutf8
+
+=item lex_discard_to
+
+=item lex_grow_linestr
+
+=item lex_next_chunk
+
+=item lex_peek_unichar
+
+=item lex_read_space
+
+=item lex_read_to
+
+=item lex_read_unichar
+
+=item lex_stuff_pv
+
+=item lex_stuff_pvn
+
+=item lex_stuff_pvs
+
+=item lex_stuff_sv
+
+=item lex_unstuff
+
+=item parse_fullstmt
+
+=item parse_stmtseq
+
+=item PL_parser-E<gt>bufend
+
+=item PL_parser-E<gt>bufptr
+
+=item PL_parser-E<gt>linestart
+
+=item PL_parser-E<gt>linestr
+
+=item Perl_signbit
+
+=item pad_findmy
+
+=item sv_utf8_decode
+
+=item sv_utf8_downgrade
+
+=item bytes_from_utf8
+
+=item bytes_to_utf8
+
+=item utf8_to_bytes
+
+=item DB module
+
+Introduced in Perl 5.6.0
+
+See also L<perldebug>, L<perldebtut>
+
+=item The pseudo-hash data type
+
+Introduced in Perl 5.6.0
+
+=item Lvalue subroutines
+
+Introduced in Perl 5.6.0
+
+See also L<perlsub>
+
+=item There is an C<installhtml> target in the Makefile.
+
+=item Unicode in Perl on EBCDIC
+
+=item C<(?{code})>
+
+See also L<perlre>
+
+=item C<(??{ code })>
+
+See also L<perlre>
 
 =item Backtracking control verbs
 
+C<(*ACCEPT)>
+
 Introduced in: Perl 5.10
 
 See also: L<perlre/"Special Backtracking Control Verbs">
@@ -33,6 +248,14 @@ Introduced in: Perl 5.12
 
 See also: 
 
+=item gv_try_downgrade
+
+See also L<perlintern>
+
+=item Experimental Support for Sun Studio Compilers for Linux OS
+
+See also L<perllinux>
+
 =item Pluggable keywords
 
 See L<perlapi/PL_keyword_plugin> for the mechanism.
@@ -70,131 +293,6 @@ Removed in: 5.11.3
 
 =back
 
-=begin authors
-
-Here's a grep of the docs. Turn these into entries in the main text.
-
-perl5005delta.pod:When none of the experimental features are enabled, there should be
-perl5005delta.pod:WARNING: Threading is considered an B<experimental> feature.  Details of the
-perl5005delta.pod:WARNING: The Compiler and related tools are considered B<experimental>.
-perl5005delta.pod:C<B::Lint> is an experimental module to detect and warn about suspicious
-perl5005delta.pod:However, one experimental implementation of reliable signals is available
-perl5005delta.pod:Starting with 5.005, the beginnings of experimental support for systems
-perl5005delta.pod:exception objects.  This is an undocumented B<experimental> feature.
-perl5005delta.pod:C<perlcc>, a new experimental front end for the compiler is available.
-perl5100delta.pod:experimental tools have never worked reliably, and, due to the lack of
-perl5101delta.pod:As part of the C<Test::Harness> 2.x to 3.x upgrade, the experimental
-perl5101delta.pod:experimental C<Test::Harness::Straps> module (and its supporting
-
-perl5120delta.pod:Perl's developers consider this feature to be experimental. We may remove
-perl5120delta.pod:experimental, and only cover a small proportion of what would be
-perl5120delta.pod:Perl's developers consider this feature to be experimental. We may remove
-perl5120delta.pod:Unicode name. Consequently, this feature is experimental. We may remove
-perl5120delta.pod:As part of the C<Test::Harness> 2.x to 3.x upgrade, the experimental
-perl5120delta.pod:experimental regex escape>), names that look like curly brace -enclosed
-perl5136delta.pod:These block are still experimental, however, and still have problems with
-perl561delta.pod:but continues to be highly experimental.  It is not expected to be
-perl561delta.pod:If you are experimenting with Unicode support in perl, the development
-perl561delta.pod:experimental.  The level of support varies greatly among platforms.
-perl561delta.pod:improvements, but they continue to remain highly experimental.  Use in
-perl561delta.pod:However, the feature still remains experimental.
-perl561delta.pod:to be experimental.  See L<perlfork> for known bugs and caveats.
-perl561delta.pod:    NOTE: This is an experimental feature.  Implementation details are
-perl561delta.pod:    NOTE: This should be considered an experimental feature.  Implementation
-perl561delta.pod:    NOTE: This is currently an experimental feature.  Interfaces and
-perl561delta.pod:    NOTE: This is an experimental feature.  Details are subject to change.  
-perl561delta.pod:    NOTE: This is an experimental feature.  Details are subject to change.
-perl561delta.pod:    NOTE: The pseudo-hash data type continues to be experimental.
-perl561delta.pod:    NOTE: The Compiler suite remains highly experimental.  The
-perl561delta.pod:C<DB> is an experimental module that exposes a clean abstraction
-perl561delta.pod:The -Dusethreads flag now enables the experimental interpreter-based thread
-perl561delta.pod:support by default.  To get the flavor of experimental threads that was in
-perl561delta.pod:    NOTE: Support for threads continues to be an experimental feature.
-perl561delta.pod:tests.  (Note that support for 5.005-style threading remains experimental.)
-perl561delta.pod:As discussed above, many features are still experimental.  Interfaces and
-perl56delta.pod:    NOTE: This is an experimental feature.  Implementation details are
-perl56delta.pod:    NOTE: This should be considered an experimental feature.  Implementation
-perl56delta.pod:    NOTE: 64-bit support is still experimental on most platforms.
-perl56delta.pod:    NOTE: This is currently an experimental feature.  Interfaces and
-perl56delta.pod:    NOTE: This is an experimental feature.  Details are subject to change.  
-perl56delta.pod:    NOTE: This is an experimental feature.  Details are subject to change.
-perl56delta.pod:    NOTE: The pseudo-hash data type continues to be experimental.
-perl56delta.pod:    NOTE: The Compiler suite remains highly experimental.  The
-perl56delta.pod:C<DB> is an experimental module that exposes a clean abstraction
-perl56delta.pod:The -Dusethreads flag now enables the experimental interpreter-based thread
-perl56delta.pod:support by default.  To get the flavor of experimental threads that was in
-perl56delta.pod:    NOTE: Support for threads continues to be an experimental feature.
-perl56delta.pod:As discussed above, many features are still experimental.  Interfaces and
-perl570delta.pod:The experimental long double support is still very much so in Solaris.
-perl570delta.pod:Multithreading is still an experimental feature.  Some platforms
-perl570delta.pod:    # is still an experimental feature.  It is here to stop people
-perl571delta.pod:experimental.)
-perl572delta.pod:B<Note that support for 5.005-style threading remains experimental.>
-perl572delta.pod:experimental.  The implementations of long doubles are not yet
-perl581delta.pod:to be experimental.)
-perl584delta.pod:There is experimental support for Linux abstract Unix domain sockets.
-perl588delta.pod:Options can now take multiple values at once (experimental)
-perl58delta.pod:the lvalue subroutine feature still remains experimental.  [561+]
-perl58delta.pod:C<our> can now have an experimental optional attribute C<unique> that
-perl58delta.pod:B<Note that perlcc is still considered very experimental and
-perl58delta.pod:highly experimental.  Use in production environments is discouraged.
-perl58delta.pod:experimental and practically unsupported.  In 5.10, it is expected
-perl590delta.pod:Perl 5.9.0 has experimental support for assertions.  Note that the user
-perl590delta.pod:to be experimental.)
-perl592delta.pod:There is experimental support for Linux abstract Unix domain sockets.
-perl595delta.pod:experimental tools have never worked reliably, and, due to the lack of
-
-perlapi.pod:NOTE: this function is experimental and may change or be
-
-
-perlcompile.pod:experimental and incomplete back ends are described last.
-perlcygwin.pod:these are experimental.  You can either select an option when Configure
-perldebtut.pod:Useful, huh?  You can eval nearly anything in there, and experiment with bits
-perldebtut.pod:place to go), and of course, experiment.  
-perldebug.pod:nice environment to learn Perl, but if you interactively experiment using
-perldebug.pod:Debug a given program using threads (experimental).
-perldelta.pod:C<lex_start> has been added to the API, but is considered experimental.
-perldelta.pod:A new, experimental API has been added for accessing the internal
-perldsc.pod:with how references are to be represented on disk.  One experimental
-perlfaq1.pod:and an experimental version. The maintenance versions are stable, and
-perlfaq1.pod:minor release). The experimental versions may include features that
-perlfaq1.pod:them without an intermediate compilation step, allowing you to experiment
-perlfaq1.pod:and test/debug quickly and easily. This ease of experimentation flattens
-perlfunc.pod:defined, but experimental "layers" may give extra LIST arguments
-perlglossary.pod:generally, any experimental option that can be compiled into Perl,
-perlguts.pod:The most recent development releases of Perl has been experimenting with
-perlguts.pod:This function is part of the experimental development API, and may change
-perlguts.pod:Custom operator support is a new experimental feature that allows you to
-perlintern.pod:NOTE: this function is experimental and may change or be
-
-perllinux.pod:these compiler experimental.
-perlmacosx.pod:Support for 64-bit addressing is experimental: some aspects of Perl may be
-perlos2.pod:Note that these problems should not discourage experimenting, since they
-perlos390.pod:default.  If you would like to experiment with dynamic loading then
-perlpod.pod:it to Pod with the experimental L<Pod::HTML2Pod|Pod::HTML2Pod> module,
-perlpod.pod:(available in CPAN), and looking at the resulting code.  The experimental
-
-perlre.pod:part of the core language for many years.  Others are experimental
-perlre.pod:experimental, and may be changed without notice. Code executed that
-perlre.pod:experimental, and may be changed without notice. Code executed that
-perlre.pod:B<WARNING:> These patterns are experimental and subject to change or
-perlre.pod:B<WARNING:> This feature is highly experimental. It is not recommended
-
-
-perlrun.pod:An experimental pseudolayer that removes the topmost layer.
-perlrun.pod:On Win32 platforms this I<experimental> layer uses native "handle" IO
-perlrun.pod:compiler's numeric file descriptor routines. There is an experimental native
-perlsolaris.pod:perl thread implementation is still experimental, however, so beware.
-perlsub.pod:B<WARNING>: Lvalue subroutines are still experimental and the
-
-perltoc.pod:experimental, deprecated, discouraged, removed
-
-perltodo.pod:"experimental". It would be good to get this tested, make it work reliably, and
-perltodo.pod:remove the "experimental" tag. This would include
-perlunicode.pod:experimental.  On such platforms, references to UTF-8 encoding in this
-
-=end authors
-
 =head1 AUTHORS
 
 brian d foy C<< <brian.d.foy@gmail.com> >>