--- App-Staticperl/staticperl.pod	2011/07/13 17:47:40	1.50
+++ App-Staticperl/staticperl.pod	2012/03/03 07:39:32	1.54
@@ -1,6 +1,6 @@
 =head1 NAME
 
-staticperl - perl, libc, 100 modules, all in one 500kb file
+staticperl - perl, libc, 100 modules, all in one standalone 500kb file
 
 =head1 SYNOPSIS
 
@@ -350,7 +350,7 @@
 All options that specify modules or files to be added are processed in the
 order given on the command line.
 
-=head3 BUNDLE CREATION WORKFLOW / STATICPELR MKBUNDLE OPTIONS
+=head3 BUNDLE CREATION WORKFLOW / STATICPERL MKBUNDLE OPTIONS
 
 F<staticperl mkbundle> works by first assembling a list of candidate
 files and modules to include, then filtering them by include/exclude
@@ -754,7 +754,7 @@
 
 Specifically, these are removed:
 
-C<PERL_HASH_SEED_DEBUG> and C<PERL_DEBUG_MSTATS> can cause underaible
+C<PERL_HASH_SEED_DEBUG> and C<PERL_DEBUG_MSTATS> can cause undesirable
 output, C<PERL5OPT>, C<PERL_DESTRUCT_LEVEL>, C<PERL_HASH_SEED> and
 C<PERL_SIGNALS> can alter execution significantly, and C<PERL_UNICODE>,
 C<PERLIO_DEBUG> and C<PERLIO> can affect input and output.
@@ -951,10 +951,23 @@
 Most of the variables override (or modify) the corresponding F<Configure>
 variable, except C<PERL_CCFLAGS>, which gets appended.
 
-You should have a look near the beginning of the F<staticperl> script -
-staticperl tries to default C<PERL_OPTIMIZE> to some psace-saving options
-suitable for newer gcc versions. For other compilers or older versions you
-need to adjust these, for example, in your F<~/.staticperlrc>.
+The default for C<PERL_OPTIMIZE> is C<-Os> (assuming gcc), and for
+C<PERL_LIBS> is C<-lm -lcrypt>, which should be good for most (but not
+all) systems.
+
+For other compilers or more customised optimisation settings, you need to
+adjust these, e.g. in your F<~/.staticperlrc>.
+
+With gcc on x86 and amd64, you can get more space-savings by using:
+
+   -Os -ffunction-sections -fdata-sections -finline-limit=8 -mpush-args
+   -mno-inline-stringops-dynamically -mno-align-stringops
+
+And on x86 and pentium3 and newer (basically everything you might ever
+want to run on), adding these is even better for space-savings (use
+-mtune=core2 or something newer for much faster code, too):
+
+   -fomit-frame-pointer -march=pentium3 -mtune=i386
 
 =back