Deprecate getopt.pl with a warning

diff --git a/lib/getopt.pl b/lib/getopt.pl
index 77d8d89..be393c4 100644 (file)
--- a/lib/getopt.pl
+++ b/lib/getopt.pl
@@ -2,12 +2,18 @@
 #
 # 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.
 #
 # Suggested alternatives: Getopt::Long or Getopt::Std
-#
+
+warn( "The 'getopt.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl. Please use the"
+      . " Getopt::Long or Getopt::Std modules instead." );
+
 ;# Process single-character switches with switch clustering.  Pass one argument
 ;# which is a string containing all switches that take an argument.  For each
 ;# switch found, sets $opt_x (where x is the switch name) to the value of the