Blame etc/build.usage

Lucio Andrés Illanes Albornoz 1793b7
usage: ./build.sh [-a nt32|nt64]  [-b debug|release]    [-C dir[,..]]  [-D kind[,..]]
Lucio Andrés Illanes Albornoz 1793b7
                  [-F ipv4|ipv6|offline]   [-h|--help] [-p jobs] [-P]   [-r ALL|LAST]
Lucio Andrés Illanes Albornoz 1793b7
                  [-r [*[*[*]]]name[,..][:[^|<|<=|>|>=]step,..]] [-R] [-v[v[v]]] [-x]
Lucio Andrés Illanes Albornoz 1793b7
                  [--as-needed]  [--debug-minipix] [--dump-on-abort]  [--reset-state]
Lucio Andrés Illanes Albornoz 1793b7
                  [--roar]      [[=]<group>|<variable name>=<variable override>[ ..]]
Lucio Andrés Illanes Albornoz bf9edf
Lucio Andrés Illanes Albornoz d279a9
        -a nt32|nt64      Selects 32-bit or 64-bit architecture; defaults to nt64.
Lucio Andrés Illanes Albornoz a6970c
        -b debug|release  Selects debug or release build kind; defaults to debug.
Lucio Andrés Illanes Albornoz d279a9
        -C dir[,..]       Clean build directory (build,) ${PREFIX} before processing build
Lucio Andrés Illanes Albornoz 5b1e55
                          scripts (prefix,) source directory (src,) and/or destination
Lucio Andrés Illanes Albornoz 5b1e55
                          directory (dest) after successful package builds.
Lucio Andrés Illanes Albornoz 5b1e55
        -D kind[,..]      Produce minimal midipix distribution directory (minipix,) RPM
Lucio Andrés Illanes Albornoz 5b1e55
                          binary packages (rpm,) and/or deployable distribution ZIP
Lucio Andrés Illanes Albornoz 5b1e55
                          archive (zipdist.) zipdist implies minipix.
Lucio Andrés Illanes Albornoz d279a9
        -F ipv4|ipv6|offline
Lucio Andrés Illanes Albornoz 5b1e55
                          Force IPv4 (ipv4) or IPv6 (ipv6) when downloading package
Lucio Andrés Illanes Albornoz 5b1e55
                          archives and/or Git repositories or don't download either at all
Lucio Andrés Illanes Albornoz 5b1e55
                          (offline.)
Lucio Andrés Illanes Albornoz 370e98
        -h|--help         Show short/full help screen, respectively.
Lucio Andrés Illanes Albornoz 8f50a3
        -p jobs           Enables parallelisation at group-level, whenever applicable.
Lucio Andrés Illanes Albornoz 8f50a3
        -P                The maximum count of jobs defaults to the number of logical
Lucio Andrés Illanes Albornoz bf9edf
                          processors on the host system divided by two (2.)
Lucio Andrés Illanes Albornoz 5b1e55
Lucio Andrés Illanes Albornoz 5b1e55
                          If -R is not specified and at least one (1) package fails to
Lucio Andrés Illanes Albornoz 5b1e55
                          build, all remaining package builds will be forcibly aborted.
Lucio Andrés Illanes Albornoz 5b1e55
Lucio Andrés Illanes Albornoz 5b1e55
        -r ALL|LAST       Restart all packages or the last failed package and resume
Lucio Andrés Illanes Albornoz 5b1e55
                          build, resp.
Lucio Andrés Illanes Albornoz 370e98
        -r [*[*[*]]]name[,..][:ALL|LAST|[^|<|<=|>|>=]step,..]
Lucio Andrés Illanes Albornoz 370e98
                          Restart the specified comma-separated package(s) w/ inhibition
Lucio Andrés Illanes Albornoz 370e98
                          of package build step state resetting completely (`ALL',) starting
Lucio Andrés Illanes Albornoz 370e98
                          at the resp. last successfully executed build steps (`LAST',) or the
Lucio Andrés Illanes Albornoz 370e98
                          specified comma-separated list of build steps, optionally subject
Lucio Andrés Illanes Albornoz 370e98
                          concerning package name(s) and/or build step(s) to the below modifiers:
Lucio Andrés Illanes Albornoz 5b1e55
Lucio Andrés Illanes Albornoz 370e98
                          Prepend name w/ `*' to automatically include dependencies, `**'
Lucio Andrés Illanes Albornoz 370e98
                          to forcibly rebuild all dependencies, and `***` to forcibly
Lucio Andrés Illanes Albornoz 370e98
                          rebuild all packages that depend on the specified package(s).
Lucio Andrés Illanes Albornoz 370e98
Lucio Andrés Illanes Albornoz 370e98
                          Prepend step w/ `^' to filter build steps with, `<' or `<='
Lucio Andrés Illanes Albornoz 370e98
                          to constrain build steps to below or below or equal with, resp.,
Lucio Andrés Illanes Albornoz 370e98
                          `>' or `>=' to constrain build steps to above or above or equal
Lucio Andrés Illanes Albornoz 370e98
                          with, resp.
Lucio Andrés Illanes Albornoz b7d16e
Lucio Andrés Illanes Albornoz 5b1e55
                          Currently defined build steps are:
Lucio Andrés Illanes Albornoz 3e5303
                          fetch_clean, fetch_download, fetch_extract, configure_clean,
Lucio Andrés Illanes Albornoz 3e5303
                          configure_patch_pre, configure_autotools, configure_patch,
Lucio Andrés Illanes Albornoz 3e5303
                          configure, build_clean, build, install_clean, install_subdirs,
Lucio Andrés Illanes Albornoz 3e5303
                          install_make, install_files, install_libs, install, install_rpm,
Lucio Andrés Illanes Albornoz 3e5303
                          and clean.
Lucio Andrés Illanes Albornoz 3e5303
Lucio Andrés Illanes Albornoz 3e5303
                          Additionally, the following virtual steps are provided:
Lucio Andrés Illanes Albornoz 3e5303
                          @fetch, @configure, @build, @install, @clean, and finish.
Lucio Andrés Illanes Albornoz 5b1e55
Lucio Andrés Illanes Albornoz d279a9
        -R                Ignore build failures, skip printing package logs, and continue
Lucio Andrés Illanes Albornoz d279a9
                          building (relaxed mode.)
Lucio Andrés Illanes Albornoz 1793b7
        -v[v[v]]          Be verbose; -vv: always print package logs; -vvv: logs fileops.
Lucio Andrés Illanes Albornoz 1793b7
        -x                Set xtrace during package builds.
Lucio Andrés Illanes Albornoz 1793b7
Lucio Andrés Illanes Albornoz 5b1e55
        --as-needed       Don't build unless the midipix_build repository has received
Lucio Andrés Illanes Albornoz 5b1e55
                          new commits.
Lucio Andrés Illanes Albornoz 03dd23
        --debug-minipix   Don't strip(1) minipix binaries to facilitate debugging minipix.
Lucio Andrés Illanes Albornoz 8a27f9
        --dump-on-abort   Produce package environment dump files on build failure to be
Lucio Andrés Illanes Albornoz 5f8a15
                          used in conjuction with pkg_shell.sh script (excludes -R.)
Lucio Andrés Illanes Albornoz 370e98
        --reset-state     Reset package build step state on exit.
Lucio Andrés Illanes Albornoz 1793b7
Lucio Andrés Illanes Albornoz 5b1e55
        <group>[ ..]      One of: dev_packages, dist, host_deps, host_deps_rpm,
Lucio Andrés Illanes Albornoz 7bed88
                          host_toolchain, host_tools, minipix, native_packages,
Lucio Andrés Illanes Albornoz 5b1e55
                          native_runtime, native_toolchain, native_tools.
Lucio Andrés Illanes Albornoz 487c40
Lucio Andrés Illanes Albornoz b6a9a1
                          Prepend w/ `=' to inhibit group-group dependency expansion.
Lucio Andrés Illanes Albornoz 8a27f9
Lucio Andrés Illanes Albornoz 8a27f9
        <variable name>=<variable override>[ ..]
Lucio Andrés Illanes Albornoz 8a27f9
                          Override build or package variable.