Deprecate abbrev.pl with a warning

diff --git a/lib/abbrev.pl b/lib/abbrev.pl
index c505a6f..eac0053 100644 (file)
--- a/lib/abbrev.pl
+++ b/lib/abbrev.pl
@@ -7,6 +7,8 @@
 #
 # This library is no longer being maintained, and is included for backward
 # compatibility with Perl 4 programs which may require it.
+# This legacy library is deprecated and will be removed in a future
+# release of perl.
 #
 # In particular, this should not be used as an example of modern Perl
 # programming techniques.
@@ -16,6 +18,10 @@
 
 package abbrev;
 
+warn( "The 'abbrev.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl. Please use the"
+      . " Text::Abbrev module instead." );
+
 sub main'abbrev {
     local(*domain) = @_;
     shift(@_);