[ViewVC] Diff of: cvs/App-Staticperl/staticperl.pod

Comparing App-Staticperl/staticperl.pod (file contents):
Revision 1.27 by root, Tue Dec 21 19:32:34 2010 UTC vs.
Revision 1.28 by root, Tue Dec 21 19:44:43 2010 UTC

 Example: include AnyEvent and AnyEvent::Impl::Perl.
    staticperl mkbundle --use AnyEvent --use AnyEvent::Impl::Perl
-Sometimes you want to load old-style "perl libraries" (F<.pl> files), or
+Sometimes you want to load old-style "perl libraries" (F<.pl> files),
-maybe other weirdly named files. To do that, you need to quote the name in
+or maybe other weirdly named files. To do that, you need to quote
-single or double quotes. When given on the command line, you probably need
+the name in single or double quotes (this is because F<staticperl>
-to quote once more to avoid your shell interpreting it. Common cases that
+I<literally> just adds the string after the C<require> - which acts
-need this are F<Config_heavy.pl> and F<utf8_heavy.pl>.
+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).
    # bourne shell
    staticperl mkbundle --use '"Config_heavy.pl"'
    # bundle specification file
    use "Config_heavy.pl"
-The C<-M>module syntax is included as an alias that might be easier to
+The C<-M>module syntax is included as a convenience that might be easier
-remember than C<--use>. Or maybe it confuses people. Time will tell. Or
+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
-maybe not. Sigh.
+not. Sigh.
 =item C<--eval> "perl code" | C<-e> "perl code"
 Sometimes it is easier (or necessary) to specify dependencies using perl
 code, or maybe one of the modules you use need a special use statement. In
 This is very useful to include "everything":
    --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'
 =item C<--add> F<file> | C<--add> "F<file> alias"
 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.
 Example: embed the file F<httpd> in the current directory as F<httpd.pm>
 =item Step 2: filter all files using C<--include> and C<--exclude> options.
 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
 to be included - no new files are added during this step.
 Last not least, if you need accurate line numbers in error messages,
 or in the unlikely case where C<pod> is too slow, or some module gets
 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
 directory. The bundle files will be removed.
 it will be even smaller than the standard perl interpreter as none of the
 modules of the base distribution (such as L<Fcntl>) will be included.
    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
 linking it.
 Example: create a standalone perl binary called F<./myexe> that will
 execute F<appfile> when it is started.
    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
 useful when just creating the bundle files, but is most useful when
 linking a binary with the C<--perl> or C<--app> options.
 systems based on GNU libc don't really support it in a very usable
 fashion either. Try uClibc if you want to create fully statically linked
 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.
 This will have no effect unless the library is actually linked against,
 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
    # ldopts might now contain:
    # -lm -Wl,-Bstatic -lcrypt -Wl,-Bdynamic -lpthread

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing App-Staticperl/staticperl.pod (file contents): Revision 1.27 by root, Tue Dec 21 19:32:34 2010 UTC vs. Revision 1.28 by root, Tue Dec 21 19:44:43 2010 UTC

Diff Legend

Comparing App-Staticperl/staticperl.pod (file contents):
Revision 1.27 by root, Tue Dec 21 19:32:34 2010 UTC vs.
Revision 1.28 by root, Tue Dec 21 19:44:43 2010 UTC