summaryrefslogtreecommitdiff
path: root/pod/perlpolicy.pod
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2014-04-21 10:21:31 -0600
committerKarl Williamson <khw@cpan.org>2014-05-04 10:39:58 -0600
commit5c5fd8eb3a4647ffaad50a888312898b98c2d0e9 (patch)
tree9c1cdcff0a711c71c667e3126cee67cd8fd08898 /pod/perlpolicy.pod
parent299b62cf95304fb5b35228680584ebfc90acba8e (diff)
downloadperl-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.pod13
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.