more aggressively deprecate L<section> and L<"section">

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

diff --git a/lib/getcwd.pl b/lib/getcwd.pl
index 9dd6945..571b319 100644 (file)
--- a/lib/getcwd.pl
+++ b/lib/getcwd.pl
@@ -1,5 +1,19 @@
 # By Brandon S. Allbery
 #
+# 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: Cwd
+
+warn( "The 'getcwd.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl. Please use the"
+      . " Cwd module instead." );
+
+#
 # Usage: $cwd = &getcwd;
 
 sub getcwd