summaryrefslogtreecommitdiff
path: root/pod/perldeprecation.pod
diff options
context:
space:
mode:
authorAbigail <abigail@abigail.be>2016-11-14 19:08:12 +0100
committerAbigail <abigail@abigail.be>2017-01-16 19:18:11 +0100
commita0e213fcb5aa6690f639123c7aedb590e790907b (patch)
tree8726bcc75004041a1af95835c3fb7ec3a7422697 /pod/perldeprecation.pod
parentc4d8d6a210eeb43ce8a86793561fb5c56d47f482 (diff)
downloadperl-a0e213fcb5aa6690f639123c7aedb590e790907b.tar.gz
Actively deprecate File::Glob::glob().
This function has been deprecated since 5.8. However, no deprecation message was issued; only perl5.008delta.pod and a comment in the file mention its deprecation. This patch issues a deprecation message, and warns the user it will be gone in perl 5.30. Since all this method does is calling File::Glob::bsd_glob anyway, code calling this is easily fixed.
Diffstat (limited to 'pod/perldeprecation.pod')
-rw-r--r--pod/perldeprecation.pod16
1 files changed, 16 insertions, 0 deletions
diff --git a/pod/perldeprecation.pod b/pod/perldeprecation.pod
index 931933fe0e..c9e75f9c08 100644
--- a/pod/perldeprecation.pod
+++ b/pod/perldeprecation.pod
@@ -14,6 +14,22 @@ features are available.
The deprecated features will be grouped by the version of Perl in
which they will be removed.
+=head2 Perl 5.30
+
+=head3 C<< File::Glob::glob() >> will disappear
+
+C<< File::Glob >> has a function called C<< glob >>, which just calls
+C<< bsd_glob >>. However, its prototype is different from the prototype
+of C<< CORE::glob >>, and hence, C<< File::Glob::glob >> should not
+be used.
+
+C<< File::Glob::glob() >> was deprecated in perl 5.8.0. A deprecation
+message was issued from perl 5.26.0 onwards, and the function will
+disappear in perl 5.30.0.
+
+Code using C<< File::Glob::glob() >> should call
+C<< File::Glob::bsd_glob() >> instead.
+
=head2 Perl 5.24
=head3 Use of C<< *glob{FILEHANDLE} >>