* Synced the perlfaq

[p5sagit/p5-mst-13.2.git] / lib / newgetopt.pl

diff --git a/lib/newgetopt.pl b/lib/newgetopt.pl
index d284b5b..e21d396 100644 (file)
--- a/lib/newgetopt.pl
+++ b/lib/newgetopt.pl
@@ -1,6 +1,19 @@
-# newgetopt.pl -- new options parsing.
-# Now just a wrapper around the Getopt::Long module.
-# $Id: newgetopt.pl,v 1.16 1996/03/16 11:46:08 jv Exp $
+# $Id: newgetopt.pl,v 1.18 2001/09/21 13:34:59 jv Exp $
+
+# This library is no longer being maintained, and is included for backward
+# compatibility with Perl 4 programs which may require it.
+# It is now just a wrapper around the Getopt::Long module.
+# 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 alternative: Getopt::Long
+
+warn( "The 'newgetopt.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl. Please use the"
+      . " Getopt::Long module instead." );
 
 {   package newgetopt;
 
@@ -16,6 +29,7 @@
        $option_start = "(--|-)";
        $order = $REQUIRE_ORDER;
        $bundling = 0;
+       $passthrough = 0;
     }
     else {
        $autoabbrev = 1;        # automatic abbrev of options
@@ -23,6 +37,7 @@
        $option_start = "(--|-|\\+)";
        $order = $PERMUTE;
        $bundling = 0;
+       $passthrough = 0;
     }
 
     # Other configurable settings.
@@ -51,6 +66,10 @@ sub NGetOpt {
        if defined $newgetopt::bundling;
     $Getopt::Long::ignorecase = $newgetopt::ignorecase 
        if defined $newgetopt::ignorecase;
+    $Getopt::Long::ignorecase = $newgetopt::ignorecase 
+       if defined $newgetopt::ignorecase;
+    $Getopt::Long::passthrough = $newgetopt::passthrough 
+       if defined $newgetopt::passthrough;
 
     &GetOptions;
 }