--- App-Staticperl/staticperl.pod	2010/12/21 19:32:34	1.27
+++ App-Staticperl/staticperl.pod	2010/12/21 19:44:43	1.28
@@ -391,11 +391,14 @@
 
    staticperl mkbundle --use AnyEvent --use AnyEvent::Impl::Perl
 
-Sometimes you want to load old-style "perl libraries" (F<.pl> files), or
-maybe other weirdly named files. To do that, you need to quote the name in
-single or double quotes. When given on the command line, you probably need
-to quote once more to avoid your shell interpreting it. Common cases that
-need this are F<Config_heavy.pl> and F<utf8_heavy.pl>.
+Sometimes you want to load old-style "perl libraries" (F<.pl> files),
+or maybe other weirdly named files. To do that, you need to quote
+the name in single or double quotes (this is because F<staticperl>
+I<literally> just adds the string after the C<require> - which acts
+different when confronted with quoted vs. unquoted strings). When given on
+the command line, you probably need to quote once more to avoid your shell
+interpreting it. Common cases that need this are F<Config_heavy.pl> and
+F<utf8_heavy.pl>.
 
 Example: include the required files for F<perl -V> to work in all its
 glory (F<Config.pm> is included automatically by this).
@@ -406,9 +409,10 @@
    # bundle specification file
    use "Config_heavy.pl"
 
-The C<-M>module syntax is included as an alias that might be easier to
-remember than C<--use>. Or maybe it confuses people. Time will tell. Or
-maybe not. Sigh.
+The C<-M>module syntax is included as a convenience that might be easier
+to remember than C<--use> - it's the same switch as perl itself uses
+to load modules. Or maybe it confuses people. Time will tell. Or maybe
+not. Sigh.
 
 =item C<--eval> "perl code" | C<-e> "perl code"
 
@@ -457,7 +461,7 @@
    --incglob '*'
 
 It is also useful for including perl libraries, or trees of those, such as
-the unicode database files needed by some perl builtins, the regex engine
+the unicode database files needed by some perl built-ins, the regex engine
 and other modules.
 
    --incglob '/unicore/**.pl'
@@ -467,7 +471,7 @@
 Adds the given (perl) file into the bundle (and optionally call it
 "alias"). The F<file> is either an absolute path or a path relative to
 the current directory. If an alias is specified, then this is the name it
-will use for C<@INC> searches, otherfile the F<file> will be used as the
+will use for C<@INC> searches, otherwise the F<file> will be used as the
 internal name.
 
 This switch is used to include extra files into the bundle.
@@ -520,7 +524,7 @@
 
 After all candidate files and modules are added, they are I<filtered>
 by a combination of C<--include> and C<--exclude> patterns (there is an
-implicit C<--include **> at the end, so if no filters are specified, all
+implicit C<--include *> at the end, so if no filters are specified, all
 files are included).
 
 All that this step does is potentially reduce the number of files that are
@@ -633,7 +637,7 @@
 mistreated, you can specify C<none> to not mangle included perl sources in
 any way.
 
-=item --perl
+=item C<--perl>
 
 After writing out the bundle files, try to link a new perl interpreter. It
 will be called F<perl> and will be left in the current working
@@ -648,7 +652,7 @@
 
    staticperl mkperl -Mcommon::sense
 
-=item --app name
+=item C<--app> F<name>
 
 After writing out the bundle files, try to link a new standalone
 program. It will be called C<name>, and the bundle files get removed after
@@ -671,7 +675,7 @@
 
    staticperl mkbundle --app myexe --boot appfile
 
-=item --static
+=item C<--static>
 
 Add C<-static> to F<bundle.ldopts>, which means a fully static (if
 supported by the OS) executable will be created. This is not immensely
@@ -688,10 +692,10 @@
 executables, or try the C<--staticlib> option to link only some libraries
 statically.
 
-=item --staticlib libname
+=item C<--staticlib> libname
 
 When not linking fully statically, this option allows you to link specific
-libraries statically. What it does is simply replace all occurances of
+libraries statically. What it does is simply replace all occurrences of
 C<-llibname> with the GCC-specific C<-Wl,-Bstatic -llibname -Wl,-Bdynamic>
 option.
 
@@ -699,7 +703,7 @@
 specifically, C<--staticlib> will not link against the named library
 unless it would be linked against anyway.
 
-Example: link libcrypt statically into the binary.
+Example: link libcrypt statically into the final binary.
 
    staticperl mkperl -MIO::AIO --staticlib crypt