Added POD section about known issues

diff --git a/Changes b/Changes
index 6e67bd0..33f90a4 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,5 +1,8 @@
 Revision history for App-FatPacker
 
+  - added "KNOWN ISSUES" section to POD about multiple copies of a
+    module in @INC
+
 0.010001 - 2014-03-18
   - include 'lib' in @INC for packlists_containing's require() calls
 

diff --git a/bin/fatpack b/bin/fatpack
index 1dfc7d8..84928c1 100755 (executable)
--- a/bin/fatpack
+++ b/bin/fatpack
@@ -76,6 +76,20 @@ Current basic recipe for packing:
   $ fatpack tree `cat packlists`
   $ fatpack file myscript.pl >myscript.packed.pl
 
+=head1 KNOWN ISSUES
+
+Be aware that if there multiple copies of a module in your @INC
+(including the lib subdirectory of your current working directory),
+then fatpack may not be able to find the packlist file for that
+module. A workaround is to run fatpack from an empty directory with an
+empty PEL5LIB:
+
+  $ cd `mktemp -d`
+  $ env PERL5LIB= fatpack trace myscript.pl
+  $ env PERL5LIB= fatpack packlists-for `cat fatpacker.trace` >packlists
+  $ env PERL5LIB= fatpack tree `cat packlists`
+  $ env PERL5LIB= fatpack file myscript.pl >myscript.packed.pl
+
 =head1 COPYRIGHT, LICENSE, AUTHOR
 
 See the corresponding sections in L<App::FatPacker>.

diff --git a/lib/App/FatPacker.pm b/lib/App/FatPacker.pm
index c127ca7..5fd3e41 100644 (file)
--- a/lib/App/FatPacker.pm
+++ b/lib/App/FatPacker.pm
@@ -378,6 +378,8 @@ djerius - Diab Jerius (cpan:DJERIUS) <djerius@cpan.org>
 
 haarg - Graham Knop (cpan:HAARG> <haarg@haarg.org>
 
+rrwo - Robert Rothenberg (cpan:RRWO) <rrwo@cpan.org>
+
 Many more people are probably owed thanks for ideas. Yet
 another doc nit to fix.