From: Abhijit Menon-Sen <ams@toroid.org>
Date: Wed, 2 Sep 2009 18:39:44 +0000 (+0530)
Subject: Deprecate lib/find{,depth}.pl with a warning
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=19aca64933c801470dbac7c3262f00a8f0d0310b;p=p5sagit%2Fp5-mst-13.2.git

Deprecate lib/find{,depth}.pl with a warning
---

diff --git a/lib/find.pl b/lib/find.pl
index ee5dc5d..e8e4eb7 100644
--- a/lib/find.pl
+++ b/lib/find.pl
@@ -1,3 +1,12 @@
+# This library is deprecated and unmaintained. It is included for
+# compatibility with Perl 4 scripts which may use it, but it will be
+# removed in a future version of Perl. Please use the File::Find module
+# instead.
+
+warn( "Please use the File::Find module instead of the deprecated"
+     ." 'find.pl' library, which will be removed in the next major"
+     ." release of perl" );
+
 # Usage:
 #	require "find.pl";
 #
@@ -10,11 +19,11 @@
 #		to $dir when the function is called.  The function may
 #		set $prune to prune the tree.
 #
-# This library is primarily for find2perl, which, when fed
+# For example,
 #
-#   find2perl / -name .nfs\* -mtime +7 -exec rm -f {} \; -o -fstype nfs -prune
+#   find / -name .nfs\* -mtime +7 -exec rm -f {} \; -o -fstype nfs -prune
 #
-# spits out something like this
+# corresponds to this
 #
 #	sub wanted {
 #	    /^\.nfs.*$/ &&
diff --git a/lib/finddepth.pl b/lib/finddepth.pl
index bfa44bb..6a177c6 100644
--- a/lib/finddepth.pl
+++ b/lib/finddepth.pl
@@ -1,3 +1,12 @@
+# This library is deprecated and unmaintained. It is included for
+# compatibility with Perl 4 scripts which may use it, but it will be
+# removed in a future version of Perl. Please use the File::Find module
+# instead.
+
+warn( "Please use the File::Find module instead of the deprecated"
+     ." 'finddepth.pl' library, which will be removed in the next"
+     ." major release of perl" );
+
 # Usage:
 #	require "finddepth.pl";
 #
@@ -10,11 +19,11 @@
 #		to $dir when the function is called.  The function may
 #		set $prune to prune the tree.
 #
-# This library is primarily for find2perl, which, when fed
+# For example,
 #
-#   find2perl / -name .nfs\* -mtime +7 -exec rm -f {} \; -o -fstype nfs -prune
+#   find / -name .nfs\* -mtime +7 -exec rm -f {} \; -o -fstype nfs -prune
 #
-# spits out something like this
+# corresponds to this
 #
 #	sub wanted {
 #	    /^\.nfs.*$/ &&