From b6a9a1a3c8b98077cce47d579069c42080d17da5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lucio=20Andr=C3=A9s=20Illanes=20Albornoz?= Date: Sun, 15 Mar 2020 09:14:23 +0000 Subject: General cleanup. --- etc/README.md | 33 +++++++++++++++++++++------------ etc/build.usage | 4 ++-- 2 files changed, 23 insertions(+), 14 deletions(-) (limited to 'etc') diff --git a/etc/README.md b/etc/README.md index 290a6dd3..b51a447a 100644 --- a/etc/README.md +++ b/etc/README.md @@ -157,24 +157,33 @@ Package archive files and/or Git repositories additionally consume at least [//]: # "{{{ 3. Common tasks" ## 3. Common tasks -Rebuild set of packages in isolation, along w/ their dependencies, if any, as -needed, or forcibly, respectively: +Rebuild set of packages in isolation: ```shell ./build.sh [ ... ] -r mc,zsh +``` + +Rebuild set of packages along w/ their dependencies, if any, as needed, or forcibly, +respectively: +```shell ./build.sh [ ... ] -r \*mc,zsh ./build.sh [ ... ] -r \*\*mc,zsh ``` - + +Forcibly rebuild all reverse dependencies of a set of packages: +```shell +./build.sh [ ... ] -r \*\*\*glib,libflac +``` + Restart the ``configure``, ``build``, and ``install`` steps of the ``coreutils`` package: ```shell ./build.sh -r coreutils:configure,build,install ``` - + Rebuild entire build groups including or excluding group dependencies, respectively: ```shell ./build.sh [ ... ] -r ALL native_runtime -./build.sh [ ... ] -r ALL \*native_runtime +./build.sh [ ... ] -r ALL =native_runtime ``` [Back to top](#table-of-contents) @@ -188,7 +197,7 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-d] [-D kind[ [-F ipv4|ipv6|offline] [-h] [-p jobs] [-P] [-r ALL|LAST] [-r [*[*[*]]]name[,..][:step,..]] [-R] [-v[v[v[v]]]] [--as-needed] [--debug-minipix] [--dump-on-abort] - [[*]|=[ ..]] + [[=]|=[ ..]] -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64. -b debug|release Selects debug or release build; defaults to debug. @@ -239,7 +248,7 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-d] [-D kind[ host_toolchain, host_tools, minipix, native_packages, native_runtime, native_toolchain, native_tools. - Prepend w/ `*' to inhibit group-group dependency expansion. + Prepend w/ `=' to inhibit group-group dependency expansion. =[ ..] Override build or package variable. @@ -253,11 +262,11 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-d] [-D kind[ Packages are grouped into *build groups* according to sets of common package variable defaults, such as ``${PKG_CFLAGS_CONFIGURE}, ${PKG_LDFLAGS_CONFIGURE}`` -and ``${PKG_CONFIGURE_ARGS}``, and semantic associativity, such as the ``native_runtime`` -build group comprising the Midipix runtime components. Packages may belong to -more than one build group such as when subsumed by a shorthand build group e.g. -the ``dev_packages`` build group, as long as the default set of build groups or -as overriden on the command line does not entail group membership conflicts. +and ``${PKG_CONFIGURE_ARGS}``, and semantic interrelatedness, such as the +``native_runtime`` build group comprising the Midipix runtime components. +Packages may belong to more than one build group such as when subsumed by a shorthand +build group e.g. the ``dev_packages`` build group, as long as the default set of build +groups or as overriden on the command line does not entail group membership conflicts. Build groups files beneath ``groups/`` named ``[0-9][0-9][0-9]..group`` contain package variable defaults, the alphabetically sorted list of contained diff --git a/etc/build.usage b/etc/build.usage index f287b98c..2c272a7c 100644 --- a/etc/build.usage +++ b/etc/build.usage @@ -2,7 +2,7 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-d] [-D kind[ [-F ipv4|ipv6|offline] [-h] [-p jobs] [-P] [-r ALL|LAST] [-r [*[*[*]]]name[,..][:step,..]] [-R] [-v[v[v[v]]]] [--as-needed] [--debug-minipix] [--dump-on-abort] - [[*]|=[ ..]] + [[=]|=[ ..]] -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64. -b debug|release Selects debug or release build; defaults to debug. @@ -53,7 +53,7 @@ usage: ./build.sh [-a nt32|nt64] [-b debug|release] [-C dir[,..]] [-d] [-D kind[ host_toolchain, host_tools, minipix, native_packages, native_runtime, native_toolchain, native_tools. - Prepend w/ `*' to inhibit group-group dependency expansion. + Prepend w/ `=' to inhibit group-group dependency expansion. =[ ..] Override build or package variable. -- cgit v1.2.3