From 30cdf7382b1816ee6544a9527d426f2e09008dc0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lucio=20Andr=C3=A9s=20Illanes=20Albornoz?= Date: Wed, 25 Aug 2021 18:16:46 +0200 Subject: Implements ./build.sh -V {notice,verbose,build,fileops,install,xtrace}. --- etc/README.md | 19 ++++++++++++++----- etc/build.usage | 20 +++++++++++++++----- etc/build.usage.short | 13 ++++++++++--- 3 files changed, 39 insertions(+), 13 deletions(-) (limited to 'etc') diff --git a/etc/README.md b/etc/README.md index abdf2597..56a5a81f 100644 --- a/etc/README.md +++ b/etc/README.md @@ -494,8 +494,9 @@ env ARCH=nt64 BUILD_KIND=release PREFIX_ROOT="${HOME}/midipix_tmp" ./build.sh -D ``` 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]]] [-x] + [-F ipv4|ipv6|offline] [-h|--help] [-p jobs|-P] [-r ALL|LAST] + [-r [*[*[*]]]name[,..][:[^|<|<=|>|>=]step,..]] + [-R] [-v[v]] [-V level[,..]] [-x] [--as-needed] [--debug-minipix] [--dump-on-abort] [--reset-state] [--roar] [[=]|=[ ..]] @@ -512,8 +513,8 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[ archives and/or Git repositories or don't download either at all (offline.) -h|--help Show short/full help screen, respectively. - -p jobs Enables parallelisation at group-level, whenever applicable. - -P The maximum count of jobs defaults to the number of logical + -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.) If -R is not specified and at least one (1) package fails to @@ -549,7 +550,15 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[ -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. + + -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. --as-needed Don't build unless the midipix_build repository has received diff --git a/etc/build.usage b/etc/build.usage index 9d0ccbf5..7440dc15 100644 --- a/etc/build.usage +++ b/etc/build.usage @@ -1,6 +1,8 @@ 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]]] [-x] + [-F ipv4|ipv6|offline] [-h|--help] [-p jobs|-P] [-r ALL|LAST] + [-r [*[*[*]]]name[,..][:[^|<|<=|>|>=]step,..]] + [-R] [-v[v]] [-V level[,..]] [-x] + [--as-needed] [--debug-minipix] [--dump-on-abort] [--reset-state] [--roar] [[=]|=[ ..]] @@ -17,8 +19,8 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[ archives and/or Git repositories or don't download either at all (offline.) -h|--help Show short/full help screen, respectively. - -p jobs Enables parallelisation at group-level, whenever applicable. - -P The maximum count of jobs defaults to the number of logical + -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.) If -R is not specified and at least one (1) package fails to @@ -54,7 +56,15 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-D kind[ -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. + + -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. --as-needed Don't build unless the midipix_build repository has received diff --git a/etc/build.usage.short b/etc/build.usage.short index 24778221..bbcc046d 100644 --- a/etc/build.usage.short +++ b/etc/build.usage.short @@ -1,11 +1,18 @@ 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]]] [-x] + [-F ipv4|ipv6|offline] [-h|--help] [-p jobs|-P] [-r ALL|LAST] + [-r [*[*[*]]]name[,..][:[^|<|<=|>|>=]step,..]] + [-R] [-v[v]] [-V level[,..]] [-x] + [--as-needed] [--debug-minipix] [--dump-on-abort] [--reset-state] [--roar] [[=]|=[ ..]] + -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. - -v[v[v]] Be verbose; -vv: always print package logs; -vvv: logs fileops. + -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. [ ..] One of: dev_packages, dist, host_deps, host_deps_rpm, -- cgit v1.2.3