diff options
author | Karl Williamson <khw@cpan.org> | 2014-04-21 10:21:31 -0600 |
---|---|---|
committer | Karl Williamson <khw@cpan.org> | 2014-05-04 10:39:58 -0600 |
commit | 5c5fd8eb3a4647ffaad50a888312898b98c2d0e9 (patch) | |
tree | 9c1cdcff0a711c71c667e3126cee67cd8fd08898 /pod/perlpolicy.pod | |
parent | 299b62cf95304fb5b35228680584ebfc90acba8e (diff) | |
download | perl-5c5fd8eb3a4647ffaad50a888312898b98c2d0e9.tar.gz |
perlpolicy: We generally deprecate for 2 major releases
Update perlpolicy to reflect the current policy,
Diffstat (limited to 'pod/perlpolicy.pod')
-rw-r--r-- | pod/perlpolicy.pod | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/pod/perlpolicy.pod b/pod/perlpolicy.pod index ed02fca885..8120cd847d 100644 --- a/pod/perlpolicy.pod +++ b/pod/perlpolicy.pod @@ -205,7 +205,12 @@ an experimental feature useful and want to help shape its future. =item deprecated If something in the Perl core is marked as B<deprecated>, we may remove it -from the core in the next stable release series, though we may not. As of +from the core in the future, though we might not. Generally, backward +incompatible changes will have deprecation warnings for two release +cycles before being removed, but may be removed after just one cycle if +the risk seems quite low or the benefits quite high. + +As of Perl 5.12, deprecated features and modules warn the user as they're used. When a module is deprecated, it will also be made available on CPAN. Installing it from CPAN will silence deprecation warnings for that module. @@ -221,14 +226,14 @@ features. From time to time, we may mark language constructs and features which we consider to have been mistakes as B<discouraged>. Discouraged features -aren't candidates for removal in the next major release series, but +aren't currently candidates for removal, but we may later deprecate them if they're found to stand in the way of a significant improvement to the Perl core. =item removed -Once a feature, construct or module has been marked as deprecated for a -stable release cycle, we may remove it from the Perl core. Unsurprisingly, +Once a feature, construct or module has been marked as deprecated, we +may remove it from the Perl core. Unsurprisingly, we say we've B<removed> these things. When a module is removed, it will no longer ship with Perl, but will continue to be available on CPAN. |