update Fatpack doc to recommend against it

perl-carton · May 4, 2018 · 9122643 · 9122643
1 parent 9d08521
commit 9122643
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 2 deletions.
diff --git a/lib/Carton/Doc/Bundle.pod b/lib/Carton/Doc/Bundle.pod
@@ -18,5 +18,3 @@ C<carton install --cached>, or a plain cpanm command with:
 
   cpanm --from file://$PWD/vendor/cache -L local --installdeps .
 
-See also C<carton fatpack> that generates C<carton> executable in
-C<vendor/bin>.
diff --git a/lib/Carton/Doc/Fatpack.pod b/lib/Carton/Doc/Fatpack.pod
@@ -8,6 +8,12 @@ Carton::Doc::Fatpack - Fatpack carton executable into vendor/bin
 
 =head1 DESCRIPTION
 
+B<WARNING>: It is known for this command to create an executable that
+is not sufficient to run standalone in some environments, especially
+when L<local::lib> is enabled. It is recommended to use the standard
+C<cpanm> command to install bundle created by C<carton bundle>
+command. See C<carton -h bundle> for more details.
+
 This command creates a fatpack executable of C<carton> in
 C<vendor/bin> directory, so that it can be used to bootstrap
 deployment process, combined with C<carton bundle> and C<carton