summaryrefslogtreecommitdiffhomepage
path: root/etc/build.usage
diff options
context:
space:
mode:
authorLucio Andrés Illanes Albornoz <lucio@lucioillanes.de>2019-01-19 14:38:21 +0000
committerLucio Andrés Illanes Albornoz <lucio@lucioillanes.de>2019-01-19 15:28:07 +0000
commitd279a98da1aae886a4b4201122ce5614a185f008 (patch)
tree0800eca320fced59a554b02507cc009c555407f3 /etc/build.usage
parente402f659b8e40a27d6ce64ea1a8f08be9f28c848 (diff)
downloadmidipix_build-d279a98da1aae886a4b4201122ce5614a185f008.tar.bz2
midipix_build-d279a98da1aae886a4b4201122ce5614a185f008.tar.xz
etc/build.usage, subr/build_{args,checks}.subr: merges -c into -C as -C prefix.
etc/build.usage, subr/build_{args,init}.subr: merges -[46N] into -F as ipv4|ipv6|offline. subr/ex_rtl_fetch.subr: honour ${{ARG_FETCH_FORCE,DEFAULT_GIT_ARGS}}. subr/pkg_install_strip.subr: correctly strip non-release build binaries. subr/pkg_install_strip.subr:pkg_install_strip(): honour ${ARG_DEBUG_MINIPIX}. vars/env.vars, subr/pkg_fetch_{download,git,wget}.subr: merges fetch_{git,wget} into fetch_download. vars/midipix.vars: adds ${DEFAULT_GIT_ARGS}. vars/{musl,python[23]{,_host}}.vars: updated concerning fetch_download.
Diffstat (limited to 'etc/build.usage')
-rw-r--r--etc/build.usage86
1 files changed, 43 insertions, 43 deletions
diff --git a/etc/build.usage b/etc/build.usage
index bd77ae37..4a0a0d1b 100644
--- a/etc/build.usage
+++ b/etc/build.usage
@@ -1,45 +1,45 @@
-usage: ./build.sh [-4|6] [-a nt32|nt64] [-b debug|release] [-c] [-C dir[,..]]
- [-D kind[,..]] [-h] [-N] [-P [jobs]] [-r ALL[:step,..]]
- [-r name[,..][:step,..]] [-R] [-v[v[v]]] [-x]
- [--as-needed] [--debug-minipix] [<target>[ ..]]
- -4|-6 Force IPv[46] when downloading files.
- -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64.
- -b debug|release Selects debug or release build; defaults to debug.
- -c Clean ${PREFIX} before processing build scripts.
- -C dir[,..] Clean build directory (build,) source directory (src,) and/or
- destination directory (dest) after successful package builds.
- -D kind[,..] Produce minimal midipix distribution directory (minipix,) package
- tarballs (pkg,) RPM binary packages (rpm,) compressed and optionally
- signed binary and source tarballs containing ${PREFIX} sans ${BUILD_WORKDIR}
- (t{bz2,gz,xz},) and/or deployable distribution ZIP archive (zipdist.)
- {t{bz2,gz,xz},zipdist} imply minipix.
- -h Show this screen.
- -N Offline mode: no {wget,git-{clone,pull}}(1) calls.
- -P [jobs] Enables parallelisation at target-level, whenever applicable.
- The maximum count of jobs defaults to the number of logical
- processors on the host system.
- If -R is not specified and at least one (1) package fails to build,
- all remaining package builds will be forcibly aborted for convenience.
- -r ALL[:step,..]
- -r name[,..][:step,..] Restart all packages/the specified comma-separated package(s)
- completely or at optionally specified comma-separated step(s).
- Currently defined steps are:
- fetch_wget, fetch_git, fetch_extract,
- configure_patch_pre, configure_autotools, configure_patch,
- configure, build, install_subdirs, install_make,
- install_files, install_libs, install_pkgconfig, install_purge_la,
- install_strip, install, and install_rpm.
- -R Ignore build failures, skip printing package logs, and continue
- building (relaxed mode.)
- -v[v[v]] Be verbose; -vv: always print package logs; -vvv: logs fileops.
- -x Set xtrace during package builds; implies -vv.
- --as-needed Don't build unless the midipix_build repository has received new commits.
- --debug-minipix Don't strip(1) minipix binaries to facilitate debugging minipix.
- <target>[ ..] One of:
- host or host_tools, host_tools_deps, host_tools_rpm, host_toolchain_deps, host_toolchain, host_toolchain_mingw32,
- native or native_tools, native_toolchain_deps, native_toolchain, native_toolchain_mingw32, native_runtime,
- packages_deps or host_packages_deps, native_packages_deps, native_packages_deps_x11,
- packages or native_packages.
+usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[,..]]
+ [-F ipv4|ipv6|offline] [-h] [-P [jobs]] [-r ALL|name[,..][:step,..]]
+ [-R] [-v[v[v]]] [-x] [--as-needed] [--debug-minipix] [<target>[ ..]]
+ -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64.
+ -b debug|release Selects debug or release build; defaults to debug.
+ -C dir[,..] Clean build directory (build,) ${PREFIX} before processing build
+ scripts (prefix,) source directory (src,) and/or destination directory
+ (dest) after successful package builds.
+ -D kind[,..] Produce minimal midipix distribution directory (minipix,) package
+ tarballs (pkg,) RPM binary packages (rpm,) compressed and optionally
+ signed binary and source tarballs containing ${PREFIX} sans ${BUILD_WORKDIR}
+ (t{bz2,gz,xz},) and/or deployable distribution ZIP archive (zipdist.)
+ {t{bz2,gz,xz},zipdist} imply minipix.
+ -F ipv4|ipv6|offline
+ Force IPv4 (ipv4) or IPv6 (ipv6) when downloading package archives
+ and/or Git repositories or don't download either at all (offline.)
+ -h Show this screen.
+ -P [jobs] Enables parallelisation at target-level, whenever applicable.
+ The maximum count of jobs defaults to the number of logical
+ processors on the host system.
+ If -R is not specified and at least one (1) package fails to build,
+ all remaining package builds will be forcibly aborted for convenience.
+ -r ALL|name[,..][:step,..]
+ Restart all packages/the specified comma-separated package(s)
+ completely or at optionally specified comma-separated step(s).
+ Currently defined steps are:
+ fetch_wget, fetch_git, fetch_extract,
+ configure_patch_pre, configure_autotools, configure_patch,
+ configure, build, install_subdirs, install_make,
+ install_files, install_libs, install_pkgconfig, install_purge_la,
+ install_strip, install, and install_rpm.
+ -R Ignore build failures, skip printing package logs, and continue
+ building (relaxed mode.)
+ -v[v[v]] Be verbose; -vv: always print package logs; -vvv: logs fileops.
+ -x Set xtrace during package builds; implies -vv.
+ --as-needed Don't build unless the midipix_build repository has received new commits.
+ --debug-minipix Don't strip(1) minipix binaries to facilitate debugging minipix.
+ <target>[ ..] One of:
+ host or host_tools, host_tools_deps, host_tools_rpm, host_toolchain_deps, host_toolchain, host_toolchain_mingw32,
+ native or native_tools, native_toolchain_deps, native_toolchain, native_toolchain_mingw32, native_runtime,
+ packages_deps or host_packages_deps, native_packages_deps, native_packages_deps_x11,
+ packages or native_packages.
${HOME}/midipix_build.vars, ${HOME}/.midipix_build.vars, and/or ../midipix_build.vars will be sourced if present.
@@ -50,5 +50,5 @@ usage: ./build.sh [-4|6] [-a nt32|nt64] [-b debug|release] [-c] [-C dir[,..]]
./build.sh -r coreutils:configure,build,install
Restart the configure, build, and install steps of the coreutils build.
- ./build.sh -c -r ALL DEFAULT_GITROOT_HEAD=...
+ ./build.sh -C prefix -r ALL DEFAULT_GITROOT_HEAD=...
Clean ${PREFIX} and forcibly rebuild everything.