From: Matt S Trout Date: Mon, 18 Feb 2019 13:40:25 +0000 (+0000) Subject: doc improvements X-Git-Tag: v0.010008~3 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit%2FApp-FatPacker.git;a=commitdiff_plain;h=f21949d5fdbd19b7b90d67cf9ac28bc8627dde37 doc improvements --- diff --git a/Changes b/Changes index 332d45c..47207d1 100644 --- a/Changes +++ b/Changes @@ -1,5 +1,6 @@ Revision history for App-FatPacker + - documentation improvements - switch to letting EUMM rewrite fatpack's #! 0.010007 - 2017-01-22 diff --git a/lib/App/FatPacker.pm b/lib/App/FatPacker.pm index 28e7c07..d448fbe 100644 --- a/lib/App/FatPacker.pm +++ b/lib/App/FatPacker.pm @@ -346,15 +346,32 @@ Or, with more step-by-step control: $ fatpack tree `cat packlists` $ fatpack file myscript.pl >myscript.packed.pl -See the documentation for the L script itself for more information. +Each command is designed to be simple and self-contained so that you can modify +the input/output of each step as needed. See the documentation for the +L script itself for more information. The programmatic API for this code is not yet fully decided, hence the 0.x release version. Expect that to be cleaned up for 1.0. +=head1 CAVEATS + +As dependency module code is copied into the resulting file as text, only +pure-perl dependencies can be packed, not compiled XS code. + +The currently-installed dependencies to pack are found via F<.packlist> files, +which are generally only included in non-core distributions that were installed +by a CPAN installer. This is a feature; see L for +details. (a notable exception to this is FreeBSD, which, since its packaging +system is designed to work equivalently to a source install, does preserve +the packlist files) + =head1 SEE ALSO L
+L - PAR Packager, a much more complex architecture-dependent packer that +can pack compiled code and even a Perl interpreter + =head1 SUPPORT Bugs may be submitted through L