--- App-Staticperl/staticperl.pod	2010/12/13 17:25:17	1.22
+++ App-Staticperl/staticperl.pod	2010/12/21 12:59:29	1.25
@@ -149,12 +149,17 @@
 
    staticperl install
 
-Is normally all you need: It installs the perl interpreter in
+is normally all you need: It installs the perl interpreter in
 F<~/.staticperl/perl>. It downloads, configures, builds and installs the
 perl interpreter if required.
 
-Most of the following commands simply run one or more steps of this
-sequence.
+Most of the following F<staticperl> subcommands simply run one or more
+steps of this sequence.
+
+If it fails, then most commonly because the compiler options I selected
+are not supported by your compiler - either edit the F<staticperl> script
+yourself or create F<~/.staticperl> shell script where your set working
+C<PERL_CCFLAGS> etc. variables.
 
 To force recompilation or reinstallation, you need to run F<staticperl
 distclean> first.
@@ -211,11 +216,12 @@
 
 Deletes the perl source directory (and potentially cleans up other
 intermediate files). This can be used to clean up files only needed for
-building perl, without removing the installed perl interpreter, or to
-force a re-build from scratch.
+building perl, without removing the installed perl interpreter.
 
 At the moment, it doesn't delete downloaded tarballs.
 
+The exact semantics of this command will probably change.
+
 =item F<staticperl distclean>
 
 This wipes your complete F<~/.staticperl> directory. Be careful with this,
@@ -274,13 +280,45 @@
    # run it
    ./app
 
+Here are the three phase 2 commands:
+
+=over 4
+
+=item F<staticperl mkbundle> args...
+
+The "default" bundle command - it interprets the given bundle options and
+writes out F<bundle.h>, F<bundle.c>, F<bundle.ccopts> and F<bundle.ldopts>
+files, useful for embedding.
+
+=item F<staticperl mkperl> args...
+
+Creates a bundle just like F<staticperl mkbundle> (in fact, it's the same
+as invoking F<staticperl mkbundle --perl> args...), but then compiles and
+links a new perl interpreter that embeds the created bundle, then deletes
+all intermediate files.
+
+=item F<staticperl mkapp> filename args...
+
+Does the same as F<staticperl mkbundle> (in fact, it's the same as
+invoking F<staticperl mkbundle --app> filename args...), but then compiles
+and links a new standalone application that simply initialises the perl
+interpreter.
+
+The difference to F<staticperl mkperl> is that the standalone application
+does not act like a perl interpreter would - in fact, by default it would
+just do nothing and exit immediately, so you should specify some code to
+be executed via the F<--boot> option.
+
+=back
+
 =head3 OPTION PROCESSING
 
 All options can be given as arguments on the command line (typically
 using long (e.g. C<--verbose>) or short option (e.g. C<-v>) style). Since
-specifying a lot of modules can make the command line very cumbersome,
-you can put all long options into a "bundle specification file" (with or
-without C<--> prefix) and specify this bundle file instead.
+specifying a lot of modules can make the command line very cumbersome, you
+can put all long options into a "bundle specification file" (one option
+per line, with or without C<--> prefix) and specify this bundle file
+instead.
 
 For example, the command given earlier could also look like this:
 
@@ -295,8 +333,7 @@
    add eg/httpd httpd.pm
 
 All options that specify modules or files to be added are processed in the
-order given on the command line (that affects the C<--use> and C<--eval>
-options at the moment).
+order given on the command line.
 
 =head3 PACKAGE SELECTION WORKFLOW
 
@@ -705,13 +742,17 @@
 (C<-Duse64bitint>), or disable large files support (-Uuselargefiles), to
 reduce filesize further.
 
-=item C<PERL_CC>, C<PERL_CPPFLAGS>, C<PERL_OPTIMIZE>, C<PERL_LDFLAGS>, C<PERL_LIBS>
+=item C<PERL_CC>, C<PERL_CCFLAGS>, C<PERL_OPTIMIZE>, C<PERL_LDFLAGS>, C<PERL_LIBS>
 
 These flags are passed to perl's F<Configure> script, and are generally
 optimised for small size (at the cost of performance). Since they also
 contain subtle workarounds around various build issues, changing these
-usually requires understanding their default values - best look at the top
-of the F<staticperl> script for more info on these.
+usually requires understanding their default values - best look at
+the top of the F<staticperl> script for more info on these, and use a
+F<~/.staticperlrc> to override them.
+
+Most of the variables override (or modify) the corresponding F<Configure>
+variable, except C<PERL_CCFLAGS>, which gets appended.
 
 =back
 
@@ -719,6 +760,10 @@
 
 =over 4
 
+=item C<MAKE>
+
+The make command to use - default is C<make>.
+
 =item C<MKBUNDLE>
 
 Where F<staticperl> writes the C<mkbundle> command to