| 1 | =head1 NAME |
|---|
| 2 | |
|---|
| 3 | fcm make |
|---|
| 4 | |
|---|
| 5 | =head1 SYNOPSIS |
|---|
| 6 | |
|---|
| 7 | Invokes the FCM make system. See the user guide for detail. |
|---|
| 8 | |
|---|
| 9 | fcm make [OPTIONS] [DECLARATION ...] |
|---|
| 10 | |
|---|
| 11 | =head1 ARGUMENTS |
|---|
| 12 | |
|---|
| 13 | Each argument is considered to be a declaration line to append to the |
|---|
| 14 | configuration file. |
|---|
| 15 | |
|---|
| 16 | =head1 OPTIONS |
|---|
| 17 | |
|---|
| 18 | =over 4 |
|---|
| 19 | |
|---|
| 20 | =item --archive, -a |
|---|
| 21 | |
|---|
| 22 | Switch on archive mode. In archive mode, intermediate files will be put into |
|---|
| 23 | TAR-GZIP archives on completion, e.g. extract system: |
|---|
| 24 | C<.fcm-make/cache/extract/>, and build system: C<build/include/> and |
|---|
| 25 | C<build/o/>. |
|---|
| 26 | |
|---|
| 27 | The archive mode is not suitable for a make that will be inherited or used by |
|---|
| 28 | other makes. |
|---|
| 29 | |
|---|
| 30 | =item --config-file-path=PATH, -F PATH |
|---|
| 31 | |
|---|
| 32 | Specify paths for searching configuration files specified in relative paths. |
|---|
| 33 | |
|---|
| 34 | =item --config-file=PATH, --file=PATH, -f PATH |
|---|
| 35 | |
|---|
| 36 | Specify paths to the configuration files. (default = fcm-make.cfg in the |
|---|
| 37 | current working directory) |
|---|
| 38 | |
|---|
| 39 | =item --directory=PATH, -C PATH |
|---|
| 40 | |
|---|
| 41 | Change directory to C<PATH> before doing anything. (default = $PWD) |
|---|
| 42 | |
|---|
| 43 | =item --ignore-lock |
|---|
| 44 | |
|---|
| 45 | Ignore lock file. When the system is invoked, it sets up a lock file in the |
|---|
| 46 | destination. The lock is normally removed when the system completes the make. |
|---|
| 47 | While the lock file is in place, another make invoked in the same destination |
|---|
| 48 | will fail. This option can be used to bypass this check. |
|---|
| 49 | |
|---|
| 50 | =item --jobs=N, -j N |
|---|
| 51 | |
|---|
| 52 | Specify the number of (child) processes that can be run simultaneously. |
|---|
| 53 | |
|---|
| 54 | =item --name=NAME, -n NAME |
|---|
| 55 | |
|---|
| 56 | Specify a name for the make, so that the command will search for |
|---|
| 57 | fcm-makeC<NAME>.cfg instead of fcm-make.cfg, and will write context files in |
|---|
| 58 | .fcm-makeC<NAME>/ and log files as fcm-makeC<NAME>.log, etc. |
|---|
| 59 | |
|---|
| 60 | =item --new, -N |
|---|
| 61 | |
|---|
| 62 | Remove items in the destination created by the previous make, and starts a new |
|---|
| 63 | make. |
|---|
| 64 | |
|---|
| 65 | =item --quiet, -q |
|---|
| 66 | |
|---|
| 67 | Decrease the verbosity level. |
|---|
| 68 | |
|---|
| 69 | =item --verbose, -v |
|---|
| 70 | |
|---|
| 71 | Increase the verbosity level. |
|---|
| 72 | |
|---|
| 73 | =back |
|---|
| 74 | |
|---|
| 75 | =cut |
|---|
