From: Stas Bekman <stas@stason.org>
Date: Tue, 9 Oct 2001 23:57:10 +0000 (+0800)
Subject: Message-Id: <3BC31E56.60805@stason.org>
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=11cd456717832dc5bfb7473a0667ecb3cbb5071b;p=p5sagit%2Fp5-mst-13.2.git

Message-Id: <3BC31E56.60805@stason.org>

p4raw-id: //depot/perl@12395
---

diff --git a/lib/FindBin.pm b/lib/FindBin.pm
index 41cd0fa..8be9cb6 100644
--- a/lib/FindBin.pm
+++ b/lib/FindBin.pm
@@ -39,9 +39,23 @@ directory.
  $RealBin     - $Bin with all links resolved
  $RealScript  - $Script with all links resolved
 
+=head1 KNOWN ISSUES
+
+If there are two modules using C<FindBin> from different directories
+under the same interpreter, this won't work. Since C<FindBin> uses
+C<BEGIN> block, it'll be executed only once, and only the first caller
+will get it right. This is a problem under mod_perl and other persistent
+Perl environments, where you shouldn't use this module. Which also means
+that you should avoid using C<FindBin> in modules that you plan to put
+on CPAN. The only way to make sure that C<FindBin> will work is to force
+the C<BEGIN> block to be executed again:
+
+  delete $INC{'FindBin.pm'};
+  require FindBin;
+
 =head1 KNOWN BUGS
 
-if perl is invoked as
+If perl is invoked as
 
    perl filename