diff options
-rw-r--r-- | etc/build.usage | 140 | ||||
-rw-r--r-- | etc/build.usage.short | 40 | ||||
-rw-r--r-- | etc/pkgtool.usage | 36 |
3 files changed, 108 insertions, 108 deletions
diff --git a/etc/build.usage b/etc/build.usage index 7440dc15..93b9702a 100644 --- a/etc/build.usage +++ b/etc/build.usage @@ -1,84 +1,84 @@ -usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[,..]] - [-F ipv4|ipv6|offline] [-h|--help] [-p jobs|-P] [-r ALL|LAST] - [-r [*[*[*]]]name[,..][:[^|<|<=|>|>=]step,..]] - [-R] [-v[v]] [-V level[,..]] [-x] +[97musage[90m: [33m./[93mbuild.sh [90m[[33m-[93ma nt32[90m|[93mnt64[90m] [[33m-[93mb debug[90m|[93mrelease[90m] [[33m-[93mC dir[90m[[93m,[90m..]] [[33m-[93mD kind[90m[[93m,[90m..]][0m + [90m[[33m-[93mF ipv4[90m|[93mipv6[90m|[93moffline[90m] [[33m-[93mh[90m|[33m--[93mhelp[90m] [[33m-[93mp jobs[90m|[33m-[93mP[90m] [[33m-[93mr ALL[90m|[93mLAST[90m][0m + [90m[[33m-[93mr [90m[[93m*[90m[[93m*[90m[[93m*[90m]]][93mname[90m[[93m,[90m..][[93m:ALL[90m|[93mLAST[90m|[[93m^[90m|[93m<[90m|[93m<=[90m|[93m>[90m|[93m>=[90m][93mstep,[90m..]][0m + [90m[[33m-[93mR[90m] [[33m-[93mv[90m[[93mv[90m]] [[33m-[93mV level[90m[[93m,[90m..[90m]] [90m[[33m-[93mx[90m][0m - [--as-needed] [--debug-minipix] [--dump-on-abort] [--reset-state] - [--roar] [[=]<group>|<variable name>=<variable override>[ ..]] + [90m[[33m--[93mas-needed[90m] [90m[[33m--[93mdebug-minipix[90m] [[33m--[93mdump-on-abort[90m] [90m[[33m--[93mreset-state[90m][0m + [90m[[33m--[93mroar[90m] [[[93m=[90m][90m<[93mgroup[90m>|<[93mvariable name[90m>[93m=[90m<[93mvariable override[90m>[ ..]][0m - -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64. - -b debug|release Selects debug or release build kind; 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,) RPM - binary packages (rpm,) and/or deployable distribution ZIP - archive (zipdist.) zipdist implies 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|--help Show short/full help screen, respectively. - -p jobs|-P Enables parallelisation at group-level, whenever applicable. - The maximum count of jobs defaults to the number of logical - processors on the host system divided by two (2.) + [33m-[93ma nt32[90m|[93mnt64[0m [96mSelects 32-bit or 64-bit architecture; defaults to [93mnt64[96m.[0m + [33m-[93mb debug[90m|[93mrelease[0m [96mSelects debug or release build kind; defaults to [93mdebug[96m.[0m + [33m-[93mC dir[90m[[93m,[90m..][0m [96mClean build directory ([93mbuild[96m,) [93m${PREFIX}[96m before processing build[0m + [96mscripts ([93mprefix[96m,) source directory ([93msrc[96m,) and/or destination[0m + [96mdirectory ([93mdest[96m) after successful package builds.[0m + [33m-[93mD kind[90m[[93m,[90m..][0m [96mProduce minimal midipix distribution directory ([93mminipix[96m,) RPM[0m + [96mbinary packages ([93mrpm[96m,) and/or deployable distribution ZIP[0m + [96marchive ([93mzipdist[96m.) [93mzipdist[96m implies [93mminipix[96m.[0m + [33m-[93mF ipv4[90m|[93mipv6[90m|[93moffline[0m + [96mForce IPv4 ([93mipv4[96m) or IPv6 ([93mipv6[96m) when downloading package[0m + [96marchives and/or Git repositories or don't download either at all[0m + [96m([93moffline[96m.)[0m + [33m-[93mh[90m|[93m--help[0m [96mShow short/full help screen, respectively.[0m + [33m-[93mp jobs[90m|[93m-P[0m [96mEnables parallelisation at group-level, whenever applicable.[0m + [96mThe maximum count of jobs defaults to the number of logical[0m + [96mprocessors on the host system divided by two (2.)[0m - If -R is not specified and at least one (1) package fails to - build, all remaining package builds will be forcibly aborted. + [96mIf [33m-[93mR[96m is not specified and at least one (1) package fails to[0m + [96mbuild, all remaining package builds will be forcibly aborted.[0m - -r ALL|LAST Restart all packages or the last failed package and resume - build, resp. - -r [*[*[*]]]name[,..][:ALL|LAST|[^|<|<=|>|>=]step,..] - Restart the specified comma-separated package(s) w/ inhibition - of package build step state resetting completely (`ALL',) starting - at the resp. last successfully executed build steps (`LAST',) or the - specified comma-separated list of build steps, optionally subject - concerning package name(s) and/or build step(s) to the below modifiers: + [33m-[93mr ALL[90m|[93mLAST[0m [96mRestart all packages or the last failed package and resume[0m + [96mbuild, resp.[0m + [33m-[93mr [90m[[93m*[90m[[93m*[90m[[93m*[90m]]][93mname[90m[[93m,[90m..][[93m:ALL[90m|[93mLAST[90m|[[93m^[90m|[93m<[90m|[93m<=[90m|[93m>[90m|[93m>=[90m][93mstep,[90m..][0m + [96mRestart the specified comma-separated package(s) w/ inhibition[0m + [96mof package build step state resetting completely ([90m`[93mALL[90m'[96m,) starting[0m + [96mat the resp. last successfully executed build steps ([90m`[93mLAST[90m'[96m,) or the[0m + [96mspecified comma-separated list of build steps, optionally subject[0m + [96mconcerning package name(s) and/or build step(s) to the below modifiers:[0m - Prepend name w/ `*' to automatically include dependencies, `**' - to forcibly rebuild all dependencies, and `***` to forcibly - rebuild all packages that depend on the specified package(s). + [96mPrepend name w/ [90m`[93m*[90m'[96m to automatically include dependencies, [90m`[93m**[90m'[0m + [96mto forcibly rebuild all dependencies, and [90m`[93m***[90m'[96m to forcibly[0m + [96mrebuild all packages that depend on the specified package(s).[0m - Prepend step w/ `^' to filter build steps with, `<' or `<=' - to constrain build steps to below or below or equal with, resp., - `>' or `>=' to constrain build steps to above or above or equal - with, resp. + [96mPrepend step w/ [90m`[93m^[90m'[96m to filter build steps with, [90m`[93m<[90m'[96m or [90m`[93m<=[90m'[0m + [96mto constrain build steps to below or below or equal with, resp.,[0m + [90m`[93m>[90m'[96m or [90m`[93m>=[90m'[96m to constrain build steps to above or above or equal[0m + [96mwith, resp.[0m - Currently defined build steps are: - fetch_clean, fetch_download, fetch_extract, configure_clean, - configure_patch_pre, configure_autotools, configure_patch, - configure, build_clean, build, install_clean, install_subdirs, - install_make, install_files, install_libs, install, install_rpm, - and clean. + [96mCurrently defined build steps are:[0m + [93mfetch_clean[90m,[93m fetch_download[90m,[93m fetch_extract[90m,[93m configure_clean[90m,[0m + [93mconfigure_patch_pre[90m,[93m configure_autotools[90m,[93m configure_patch[90m,[0m + [93mconfigure[90m,[93m build_clean[90m,[93m build[90m,[93m install_clean[90m,[93m install_subdirs[90m,[0m + [93minstall_make[90m,[93m install_files[90m,[93m install_libs[90m,[93m install[90m,[93m install_rpm[90m,[0m + [96mand [93mclean[90m.[0m - Additionally, the following virtual steps are provided: - @fetch, @configure, @build, @install, @clean, and finish. + [96mAdditionally, the following virtual steps are provided:[0m + [93m@fetch[90m,[93m @configure[90m,[93m @build[90m,[93m @install[90m,[93m @clean[90m,[96m and [93mfinish[90m.[0m - -R Ignore build failures, skip printing package logs, and continue - building (relaxed mode.) + [33m-[93mR[0m [96mIgnore build failures, skip printing package logs, and continue[0m + [96mbuilding (relaxed mode.)[0m - -v[v] -v: log at notice, -vv: log at verbose level. - -V level[,..] Be verbose concerning any of: - notice...: log at notice level (-v,) - verbose..: log at verbose level (-vv,) - build....: always print package build logs, - fileops..: log RTL file operations, - install..: log RTL installation DSL operations, - xtrace...: set xtrace during package builds (-x.) - -x Set xtrace during package builds. + [33m-[93mv[90m[[93mv[90m][96m [33m-[93mv[96m: log at notice, [33m-[93mvv[96m: log at verbose level.[0m + [33m-[93mV level[90m[[93m,[90m..][0m [96mBe verbose concerning any of:[0m + [93mnotice[90m...: [96mlog at notice level ([33m-[93mv[96m,)[0m + [93mverbose[90m..: [96mlog at verbose level ([33m-[93mvv[96m,)[0m + [93mbuild[90m....: [96malways print package build logs,[0m + [93mfileops[90m..: [96mlog RTL file operations,[0m + [93minstall[90m..: [96mlog RTL installation DSL operations,[0m + [93mxtrace[90m...: [96mset [93mxtrace[96m during package builds ([33m-[93mx[96m.)[0m + [33m-[93mx[96m Set [93mxtrace[96m during package builds.[0m - --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. - --dump-on-abort Produce package environment dump files on build failure to be - used in conjuction with pkg_shell.sh script (excludes -R.) - --reset-state Reset package build step state on exit. + [33m--[93mas-needed[0m [96mDon't build unless the midipix_build repository has received[0m + [96mnew commits.[0m + [33m--[93mdebug-minipix[0m [96mDon't [93mstrip(1)[96m minipix binaries to facilitate debugging minipix.[0m + [33m--[93mdump-on-abort[0m [96mProduce package environment dump files on build failure to be[0m + [96mused in conjuction with pkg_shell.sh script (excludes [33m-[93mR[96m.)[0m + [33m--[93mreset-state[0m [96mReset package build step state on exit.[0m - <group>[ ..] One of: dev_packages, dist, host_deps, host_deps_rpm, - host_toolchain, host_tools, minipix, native_packages, - native_runtime, native_toolchain, native_tools. + [90m<[93mgroup[90m>[ ..][96m One of: [93mdev_packages[90m,[93m dist[90m,[93m host_deps[90m,[93m host_deps_rpm[90m,[0m + [93mhost_toolchain[90m,[93m host_tools[90m,[93m minipix[90m,[93m native_packages[90m,[0m + [93mnative_runtime[90m,[93m native_toolchain[90m,[93m native_tools[90m.[0m - Prepend w/ `=' to inhibit group-group dependency expansion. + [96mPrepend w/ [90m`[93m=[90m'[96m to inhibit group-group dependency expansion.[0m - <variable name>=<variable override>[ ..] - Override build or package variable. + [90m<[93mvariable name[90m>[93m=[90m<[93mvariable override[90m>[ ..][0m + [96mOverride build or package variable.[0m diff --git a/etc/build.usage.short b/etc/build.usage.short index bbcc046d..b55b4900 100644 --- a/etc/build.usage.short +++ b/etc/build.usage.short @@ -1,25 +1,25 @@ -usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[,..]] - [-F ipv4|ipv6|offline] [-h|--help] [-p jobs|-P] [-r ALL|LAST] - [-r [*[*[*]]]name[,..][:[^|<|<=|>|>=]step,..]] - [-R] [-v[v]] [-V level[,..]] [-x] +[97musage[90m: [33m./[93mbuild.sh [90m[[33m-[93ma nt32[90m|[93mnt64[90m] [[33m-[93mb debug[90m|[93mrelease[90m] [[33m-[93mC dir[90m[[93m,[90m..]] [[33m-[93mD kind[90m[[93m,[90m..]][0m + [90m[[33m-[93mF ipv4[90m|[93mipv6[90m|[93moffline[90m] [[33m-[93mh[90m|[33m--[93mhelp[90m] [[33m-[93mp jobs[90m|[33m-[93mP[90m] [[33m-[93mr ALL[90m|[93mLAST[90m][0m + [90m[[33m-[93mr [90m[[93m*[90m[[93m*[90m[[93m*[90m]]][93mname[90m[[93m,[90m..][[93m:ALL[90m|[93mLAST[90m|[[93m^[90m|[93m<[90m|[93m<=[90m|[93m>[90m|[93m>=[90m][93mstep,[90m..]][0m + [90m[[33m-[93mR[90m] [[33m-[93mv[90m[[93mv[90m]] [[33m-[93mV level[90m[[93m,[90m..[90m]] [90m[[33m-[93mx[90m][0m - [--as-needed] [--debug-minipix] [--dump-on-abort] [--reset-state] - [--roar] [[=]<group>|<variable name>=<variable override>[ ..]] + [90m[[33m--[93mas-needed[90m] [90m[[33m--[93mdebug-minipix[90m] [[33m--[93mdump-on-abort[90m] [90m[[33m--[93mreset-state[90m][0m + [90m[[33m--[93mroar[90m] [[[93m=[90m][90m<[93mgroup[90m>|<[93mvariable name[90m>[93m=[90m<[93mvariable override[90m>[ ..]][0m - -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64. - -b debug|release Selects debug or release build kind; defaults to debug. - -h|--help Show short/full help screen, respectively. - -p jobs|-P Enables parallelisation at group-level, whenever applicable. - -r ALL|LAST Restart all/the last failed/the specified comma-separated package(s). - -r [*[*[*]]]name[,..][:ALL|LAST|[^|<|<=|>|>=]step,..] - -v[v] -v: log at notice, -vv: log at verbose level. - -x Set xtrace during package builds. + [33m-[93ma nt32[90m|[93mnt64[0m [96mSelects 32-bit or 64-bit architecture; defaults to [93mnt64[96m.[0m + [33m-[93mb debug[90m|[93mrelease[0m [96mSelects debug or release build kind; defaults to [93mdebug[96m.[0m + [33m-[93mh[90m|[33m--[93mhelp[96m Show short/full help screen, respectively.[0m + [33m-[93mp jobs[90m|[93m-P[96m Enables parallelisation at group-level, whenever applicable.[0m + [33m-[93mr ALL[90m|[93mLAST[96m Restart all/the last failed/the specified comma-separated package(s).[0m + [33m-[93mr [90m[[93m*[90m[[93m*[90m[[93m*[90m]]][93mname[90m[[93m,[90m..][[93m:ALL[90m|[93mLAST[90m|[[93m^[90m|[93m<[90m|[93m<=[90m|[93m>[90m|[93m>=[90m][93mstep,[90m..][0m + [33m-[93mv[90m[[93mv[90m][96m [33m-[93mv[96m: log at notice, [33m-[93mvv[96m: log at verbose level.[0m + [33m-[93mx[96m Set [93mxtrace[96m during package builds.[0m - <group>[ ..] One of: dev_packages, dist, host_deps, host_deps_rpm, - host_toolchain, host_tools, minipix, native_packages, - native_runtime, native_toolchain, native_tools. + [90m<[93mgroup[90m>[ ..][96m One of: [93mdev_packages[90m,[93m dist[90m,[93m host_deps[90m,[93m host_deps_rpm[90m,[0m + [93mhost_toolchain[90m,[93m host_tools[90m,[93m minipix[90m,[93m native_packages[90m,[0m + [93mnative_runtime[90m,[93m native_toolchain[90m,[93m native_tools[90m.[0m - Prepend w/ `=' to inhibit group-group dependency expansion. + [96mPrepend w/ [90m`[93m=[90m'[96m to inhibit group-group dependency expansion.[0m - <variable name>=<variable override>[ ..] - Override build or package variable. + [90m<[93mvariable name[90m>=<[93mvariable override[90m>[ ..][0m + [96mOverride build or package variable.[0m diff --git a/etc/pkgtool.usage b/etc/pkgtool.usage index a91c6670..48126908 100644 --- a/etc/pkgtool.usage +++ b/etc/pkgtool.usage @@ -1,20 +1,20 @@ -usage: ./pkgtool.sh [-a nt32|nt64] [-b debug|release] [-i|-m <dname> -M <dname>|-r|-s|-t] [-v] - [<variable name>=<variable override>[ ..]] name +[97musage[90m: [33m./[93mpkgtool.sh [90m[[33m-[93ma nt32[90m|[93mnt64[90m] [[33m-[93mb [93mdebug[90m|[93mrelease[90m] [[33m-[93mi[90m|[33m-[93mm [90m<[93mdname[90m> [33m-[93mM [90m<[93mdname[90m>|[33m-[93mr[90m|[33m-[93ms[90m|[33m-[93mt[90m] [[33m-[93mv[90m][0m + [90m[<[93mvariable name[90m>[93m=[90m<[93mvariable override[90m>[ ..]] [93mname[90m - -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64. - -b debug|release Selects debug or release build kind; defaults to debug. - -i List package variables and dependencies of single named package. - -m <dname> Setup package archives mirror in <dname> and/or - -M <dname> Setup Git repositories mirror in <dname> - -r List reverse dependencies of single named package. - -s Enter interactive package build shell environment for single - named package; requires a package dump file. If the package - has not been built yet or built successfully, it will be rebuilt - at build steps up until, by default, the `build' build step and - forcibly aborted and dumped prior to enterting the shell. - -t Produce tarball of package build root directory and build log - file for the purpose of distribution given build failure. - -v Increase verbosity. + [33m-[93ma nt32[90m|[93mnt64[0m [96mSelects 32-bit or 64-bit architecture; defaults to [93mnt64[96m.[0m + [33m-[93mb debug[90m|[93mrelease[0m [96mSelects debug or release build kind; defaults to [93mdebug[96m.[0m + [33m-[93mi [96mList package variables and dependencies of single named package.[0m + [33m-[93mm [90m<[93mdname[90m> [96mSetup package archives mirror in [90m<[93mdname[90m>[96m and/or[0m + [33m-[93mM [90m<[93mdname[90m> [96mSetup Git repositories mirror in [90m<[93mdname[90m>[0m + [33m-[93mr [96mList reverse dependencies of single named package.[0m + [33m-[93ms [96mEnter interactive package build shell environment for single[0m + [96mnamed package; requires a package dump file. If the package[0m + [96mhas not been built yet or built successfully, it will be rebuilt[0m + [96mat build steps up until, by default, the [90m`[93mbuild[90m'[96m build step and[0m + [96mforcibly aborted and dumped prior to enterting the shell.[0m + [33m-[93mt [96mProduce tarball of package build root directory and build log[0m + [96mfile for the purpose of distribution given build failure.[0m + [33m-[93mv [96mIncrease verbosity.[0m - <variable name>=<variable override>[ ..] - Override build variable. + [90m<[93mvariable name[90m>[93m=[90m<[93mvariable override[90m>[ ..][0m + [96mOverride build or package variable.[0m |