--- App-Staticperl/staticperl.pod 2011/05/01 09:29:47 1.40 +++ App-Staticperl/staticperl.pod 2011/06/27 21:56:51 1.45 @@ -41,7 +41,7 @@ With F and F on x86, you can create a single 500kb binary that contains perl and 100 modules such as POSIX, AnyEvent, EV, IO::AIO, -Coro and so on. Or any other choice of modules. +Coro and so on. Or any other choice of modules (and some other size :). To see how this turns out, you can try out smallperl and bigperl, two pre-built static and compressed perl binaries with many and even more @@ -884,11 +884,11 @@ The directory where staticperl stores all its files (default: F<~/.staticperl>). -=item C, C, ... +=item C -Usually set to C<1> to make modules "less inquisitive" during their -installation, you can set any environment variable you want - some modules -(such as L or L) use environment variables for further tweaking. +The path to a directory (will be created if it doesn't exist) where +downloaded perl sources are being cached, to avoid downloading them +again. The default is empty, which means there is no cache. =item C @@ -896,6 +896,13 @@ is also a good choice (5.8.9 is much smaller than 5.12.3, while 5.10.1 is about as big as 5.12.3). +=item C, C, ... + +Usually set to C<1> to make modules "less inquisitive" during their +installation. You can set (and export!) any environment variable you want +- some modules (such as L or L) use environment variables for +further tweaking. + =item C The prefix where perl gets installed (default: F<$STATICPERL/perl>), @@ -1157,7 +1164,7 @@ To minimise code size, I used C<-pipe -ffunction-sections -fdata-sections -finline-limit=8 -fno-builtin-strlen -mtune=i386>. The C<-mtune=i386> doesn't decrease codesize much, but it makes the file much more -compressible. +compressible (and the execution a lot slower...). If you don't need Coro or threads, you can go with "linuxthreads.old" (or no thread support). For Coro, it is highly recommended to switch to a @@ -1169,7 +1176,7 @@ If you use C, then you should also be aware that uClibc shares C between all threads when statically linking. See L for a -workaround (And L for discussion). +workaround (and L for discussion). C support is also recommended, especially if you want to play around with buildroot options. Enabling the C @@ -1187,12 +1194,12 @@ built-in ash shell. Finally, you need F inside the chroot for many scripts to work -- F or bind-mounting your F will -both provide this. +- either F or bind-mounting your F +will provide this. After you have compiled and set up your buildroot target, you can copy F from the C distribution or from your -perl f directory (if you installed it) into the F +perl F directory (if you installed it) into the F filesystem, chroot inside and run it. =head1 RECIPES / SPECIFIC MODULES