From: Steffen Mueller <smueller@cpan.org>
Date: Wed, 2 Sep 2009 18:02:21 +0000 (+0200)
Subject: Deprecate flush.pl with a warning
X-Git-Tag: v5.11.0~572
X-Git-Url: https://perl5.git.perl.org/perl5.git/commitdiff_plain/b2f4098f3f52450ba205d18eedf89072e222abf1?hp=2f8d2bfaceb99a65b65f6a843236685417122387

Deprecate flush.pl with a warning
---

diff --git a/lib/flush.pl b/lib/flush.pl
index 8aa6d55..577f7c7 100644
--- a/lib/flush.pl
+++ b/lib/flush.pl
@@ -1,12 +1,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 alternative: IO::Handle
-#
+
+warn( "The 'flush.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl. Please use the"
+      . " IO::Handle module instead." );
+
 ;# Usage: &flush(FILEHANDLE)
 ;# flushes the named filehandle