/snap/gh/640/usr/share/perl/5.38.2
NameSizeModeActions
App/-0755rm
Archive/-0755rm
Attribute/-0755rm
autodie/-0755rm
B/-0755rm
Carp/-0755rm
Class/-0755rm
Compress/-0755rm
Config/-0755rm
CPAN/-0755rm
DBM_Filter/-0755rm
Devel/-0755rm
Digest/-0755rm
Encode/-0755rm
encoding/-0755rm
Exporter/-0755rm
ExtUtils/-0755rm
File/-0755rm
Filter/-0755rm
Getopt/-0755rm
HTTP/-0755rm
I18N/-0755rm
IO/-0755rm
IPC/-0755rm
JSON/-0755rm
Locale/-0755rm
Math/-0755rm
Memoize/-0755rm
Module/-0755rm
Net/-0755rm
overload/-0755rm
Params/-0755rm
Parse/-0755rm
Perl/-0755rm
PerlIO/-0755rm
Pod/-0755rm
pod/-0755rm
Search/-0755rm
TAP/-0755rm
Term/-0755rm
Test/-0755rm
Test2/-0755rm
Text/-0755rm
Thread/-0755rm
Tie/-0755rm
Time/-0755rm
Unicode/-0755rm
unicore/-0755rm
User/-0755rm
version/-0755rm
warnings/-0755rm
AnyDBM_File.pm26180644editdlrm
autodie.pm124360644editdlrm
AutoLoader.pm157970644editdlrm
AutoSplit.pm196370644editdlrm
autouse.pm42380644editdlrm
base.pm109610644editdlrm
Benchmark.pm310230644editdlrm
bigfloat.pm219680644editdlrm
bigint.pm232470644editdlrm
bignum.pm282170644editdlrm
bigrat.pm211340644editdlrm
blib.pm20620644editdlrm
builtin.pm103920644editdlrm
bytes.pm37820644editdlrm
bytes_heavy.pl7580644editdlrm
Carp.pm359940644editdlrm
charnames.pm210490644editdlrm
constant.pm147240644editdlrm
CORE.pod31880644editdlrm
CPAN.pm1479710644editdlrm
DB.pm189220644editdlrm
DBM_Filter.pm143850644editdlrm
deprecate.pm50360644editdlrm
diagnostics.pm193340644editdlrm
Digest.pm112250644editdlrm
DirHandle.pm20850644editdlrm
Dumpvalue.pm176680644editdlrm
dumpvar.pl155550644editdlrm
English.pm47610644editdlrm
Env.pm55690644editdlrm
experimental.pm89300644editdlrm
Exporter.pm192120644editdlrm
Fatal.pm592360644editdlrm
feature.pm545970644editdlrm
fields.pm94750644editdlrm
FileCache.pm55490644editdlrm
FileHandle.pm68050644editdlrm
filetest.pm40030644editdlrm
FindBin.pm46160644editdlrm
if.pm36310644editdlrm
integer.pm32540644editdlrm
Internals.pod25750644editdlrm
less.pm32040644editdlrm
locale.pm48850644editdlrm
Memoize.pm325860644editdlrm
meta_notation.pm20690644editdlrm
NEXT.pm189820644editdlrm
ok.pm9670644editdlrm
open.pm84980644editdlrm
overload.pm547230644editdlrm
overloading.pm18080644editdlrm
parent.pm27020644editdlrm
perl5db.pl3175700644editdlrm
perlfaq.pm770644editdlrm
PerlIO.pm142590644editdlrm
Safe.pm253520644editdlrm
SelectSaver.pm10760644editdlrm
SelfLoader.pm176860644editdlrm
sigtrap.pm87330644editdlrm
sort.pm29920644editdlrm
stable.pm46570644editdlrm
strict.pm47830644editdlrm
subs.pm9450644editdlrm
Symbol.pm49050644editdlrm
Test.pm300420644editdlrm
Test2.pm63930644editdlrm
Thread.pm82890644editdlrm
UNIVERSAL.pm68340644editdlrm
utf8.pm108880644editdlrm
vars.pm24580644editdlrm
version.pm19760644editdlrm
version.pod98320644editdlrm
vmsish.pm43130644editdlrm
warnings.pm570690644editdlrm
XSLoader.pm113990644editdlrm
_charnames.pm356790644editdlrm
Edit: /snap/gh/640/usr/share/perl/5.38.2/stable.pm (4657B)
package stable; $stable::VERSION = '0.031'; use strict; use warnings; use version (); use experimental (); use Carp qw/croak carp/; my %allow_at = ( bitwise => 5.022000, isa => 5.032000, lexical_subs => 5.022000, postderef => 5.020000, ); sub import { my ($self, @pragmas) = @_; for my $pragma (@pragmas) { my $min_ver = $allow_at{$pragma}; croak "unknown stablized experiment $pragma" unless defined $min_ver; croak "requested stablized experiment $pragma, which is stable at $min_ver but this is $]" unless $] >= $min_ver; } experimental->import(@pragmas); return; } sub unimport { my ($self, @pragmas) = @_; # Look, we could say "You can't unimport stable experiment 'bitwise' on # 5.20" but it just seems weird. -- rjbs, 2022-03-05 experimental->unimport(@pragmas); return; } 1; #ABSTRACT: Experimental features made easy, once we know they're stable __END__ =pod =encoding UTF-8 =head1 NAME stable - Experimental features made easy, once we know they're stable =head1 VERSION version 0.031 =head1 SYNOPSIS use stable 'lexical_subs', 'bitwise'; my sub is_odd($value) { $value & 1 } =head1 DESCRIPTION The L pragma makes it easy to turn on experimental while turning off associated warnings. You should read about it, if you don't already know what it does. Seeing C in code might be scary. In fact, it probably should be! Code that uses experimental features might break in the future if the perl development team decides that the experiment needs to be altered. When experiments become stable, because the developers decide they're a success, the warnings associated with them go away. When that happens, they can generally be turned on with C. This is great, if you are using a version of perl where the feature you want is already stable. If you're using an older perl, though, it might be the case that you want to use an experimental feature that still warns, even though there's no risk in using it, because subsequent versions of perl have that feature unchanged and now stable. Here's an example: The C feature was added in perl 5.20.0. In perl 5.24.0, it was marked stable. Using it would no longer trigger a warning. The behavior of the feature didn't change between 5.20.0 and 5.24.0. That means that it's perfectly safe to use the feature on 5.20 or 5.22, even though there's a warning. In that case, you could very justifiably add C but the casual reader may still be worried at seeing that. The C pragma exists to turn on experimental features only when it's known that their behavior in the running perl is their stable behavior. If you try to use an experimental feature that isn't stable or available on the running version of perl, an exception will be thrown. You should also take care that you've required the version of C that you need! If it's not immediately obvious why, here's a bit of explanation: =over 4 =item * C comes with perl, starting with perl v5.38. =item * Imagine that v5.38 adds a feature called "florps". It will stop being experimental in v5.42. =item * The version of C that comes with perl v5.38 can't know that the I experiment will succeed, so you can't C on the version of stable ships with v5.38, because it can't see the future! =item * You'll need to write C to say that you need version 1.234 of stable, which is when I became known to stable. =back Sure, it's a little weird, but it's worth it! The documentation of this pragma will tell you what version of C you need to require in order to use various features. See below. At present there are only a few "stable" features: =over 4 =item * C - stable as of perl 5.22, available via stable 0.031 =item * C - stable as of perl 5.32, available via stable 0.031 =item * C - stable as of perl 5.22, available via stable 0.031 Lexical subroutines were actually added in 5.18, and their design did not change, but significant bugs makes them unsafe to use before 5.22. =item * C - stable as of perl 5.20, available via stable 0.031 =back =head1 SEE ALSO L contains more information about experimental features. =head1 AUTHOR Leon Timmermans =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2013 by Leon Timmermans. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. =cut