ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/App-Staticperl/staticperl.pod
(Generate patch)

Comparing App-Staticperl/staticperl.pod (file contents):
Revision 1.23 by root, Mon Dec 13 18:08:01 2010 UTC vs.
Revision 1.24 by root, Wed Dec 15 00:17:47 2010 UTC

… …
147 147
148The command 148The command
149 149
150 staticperl install 150 staticperl install
151 151
152Is normally all you need: It installs the perl interpreter in 152is normally all you need: It installs the perl interpreter in
153F<~/.staticperl/perl>. It downloads, configures, builds and installs the 153F<~/.staticperl/perl>. It downloads, configures, builds and installs the
154perl interpreter if required. 154perl interpreter if required.
155 155
156Most of the following commands simply run one or more steps of this 156Most of the following F<staticperl> subcommands simply run one or more
157sequence. 157steps of this sequence.
158
159If it fails, then most commonly because the compiler options I selected
160are not supported by your compiler - either edit the F<staticperl> script
161yourself or create F<~/.staticperl> shell script where your set working
162C<PERL_CCFLAGS> etc. variables.
158 163
159To force recompilation or reinstallation, you need to run F<staticperl 164To force recompilation or reinstallation, you need to run F<staticperl
160distclean> first. 165distclean> first.
161 166
162=over 4 167=over 4
… …
209 214
210=item F<staticperl clean> 215=item F<staticperl clean>
211 216
212Deletes the perl source directory (and potentially cleans up other 217Deletes the perl source directory (and potentially cleans up other
213intermediate files). This can be used to clean up files only needed for 218intermediate files). This can be used to clean up files only needed for
214building perl, without removing the installed perl interpreter, or to 219building perl, without removing the installed perl interpreter.
215force a re-build from scratch.
216 220
217At the moment, it doesn't delete downloaded tarballs. 221At the moment, it doesn't delete downloaded tarballs.
222
223The exact semantics of this command will probably change.
218 224
219=item F<staticperl distclean> 225=item F<staticperl distclean>
220 226
221This wipes your complete F<~/.staticperl> directory. Be careful with this, 227This wipes your complete F<~/.staticperl> directory. Be careful with this,
222it nukes your perl download, perl sources, perl distribution and any 228it nukes your perl download, perl sources, perl distribution and any
… …
703 709
704More commonly, you would either activate 64 bit integer support 710More commonly, you would either activate 64 bit integer support
705(C<-Duse64bitint>), or disable large files support (-Uuselargefiles), to 711(C<-Duse64bitint>), or disable large files support (-Uuselargefiles), to
706reduce filesize further. 712reduce filesize further.
707 713
708=item C<PERL_CC>, C<PERL_CPPFLAGS>, C<PERL_OPTIMIZE>, C<PERL_LDFLAGS>, C<PERL_LIBS> 714=item C<PERL_CC>, C<PERL_CCFLAGS>, C<PERL_OPTIMIZE>, C<PERL_LDFLAGS>, C<PERL_LIBS>
709 715
710These flags are passed to perl's F<Configure> script, and are generally 716These flags are passed to perl's F<Configure> script, and are generally
711optimised for small size (at the cost of performance). Since they also 717optimised for small size (at the cost of performance). Since they also
712contain subtle workarounds around various build issues, changing these 718contain subtle workarounds around various build issues, changing these
713usually requires understanding their default values - best look at the top 719usually requires understanding their default values - best look at
714of the F<staticperl> script for more info on these. 720the top of the F<staticperl> script for more info on these, and use a
721F<~/.staticperlrc> to override them.
722
723Most of the variables override (or modify) the corresponding F<Configure>
724variable, except C<PERL_CCFLAGS>, which gets appended.
715 725
716=back 726=back
717 727
718=head4 Variables you probably I<do not want> to override 728=head4 Variables you probably I<do not want> to override
719 729

Diff Legend

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