| … | |
… | |
| 285 | add eg/httpd httpd.pm |
285 | add eg/httpd httpd.pm |
| 286 | |
286 | |
| 287 | All options that specify modules or files to be added are processed in the |
287 | All options that specify modules or files to be added are processed in the |
| 288 | order given on the command line (that affects the C<--use> and C<--eval> |
288 | order given on the command line (that affects the C<--use> and C<--eval> |
| 289 | options at the moment). |
289 | options at the moment). |
|
|
290 | |
|
|
291 | =head3 PACKAGE SELECTION WORKFLOW |
|
|
292 | |
|
|
293 | F<staticperl mkbundle> has a number of options to control package |
|
|
294 | selection. This section describes how they interact with each other. Also, |
|
|
295 | since I am still a newbie w.r.t. these issues, maybe future versions of |
|
|
296 | F<staticperl> will change this, so watch out :) |
|
|
297 | |
|
|
298 | The idiom "in order" means "in order that they are specified on the |
|
|
299 | commandline". If you use a bundle specification file, then the options |
|
|
300 | will be processed as if they were given in place of the bundle file name. |
|
|
301 | |
|
|
302 | =over 4 |
|
|
303 | |
|
|
304 | =item 1. apply all C<--use>, C<--eval>, C<--add>, C<--addbin> and |
|
|
305 | C<--incglob> options, in order. |
|
|
306 | |
|
|
307 | In addition, C<--use> and C<--eval> dependencies will be added when the |
|
|
308 | options are processed. |
|
|
309 | |
|
|
310 | =item 2. apply all C<--include> and C<--exclude> options, in order. |
|
|
311 | |
|
|
312 | All this step does is potentially reduce the number of files already |
|
|
313 | selected or found in phase 1. |
|
|
314 | |
|
|
315 | =item 3. find all modules (== F<.pm> files), gather their static archives |
|
|
316 | (F<.a>) and AutoLoader splitfiles (F<.ix> and F<.al> files) and find any |
|
|
317 | extra libraries they need for linking (F<extralibs.ld>). |
|
|
318 | |
|
|
319 | This step is required to link against XS extensions and also adds files |
|
|
320 | required for L<AutoLoader> to do it's job. |
|
|
321 | |
|
|
322 | =back |
|
|
323 | |
|
|
324 | After this, all the files selected for bundling will be read and processed |
|
|
325 | (stripped), the bundle files will be written, and optionally a new F<perl> |
|
|
326 | or application binary will be linked. |
| 290 | |
327 | |
| 291 | =head3 MKBUNDLE OPTIONS |
328 | =head3 MKBUNDLE OPTIONS |
| 292 | |
329 | |
| 293 | =over 4 |
330 | =over 4 |
| 294 | |
331 | |
