diff options
author | Lucio Andrés Illanes Albornoz (arab, vxp) <l.illanes@gmx.de> | 2016-11-14 23:02:47 +0100 |
---|---|---|
committer | Lucio Andrés Illanes Albornoz (arab, vxp) <l.illanes@gmx.de> | 2016-11-15 20:40:50 +0100 |
commit | 59765f508225998d8a73b1da8380ff06b4a6b79c (patch) | |
tree | 9397850a4ab5bac51ec373558722c45be4fe7258 /etc/build.usage | |
parent | 8739dbe67d82f90d1c3b63a8d07af291c4ace600 (diff) | |
download | midipix_build-59765f508225998d8a73b1da8380ff06b4a6b79c.tar.bz2 midipix_build-59765f508225998d8a73b1da8380ff06b4a6b79c.tar.xz |
1) Replaces the SysV-style build script link mechanism w/ build {,meta-}targets,
2) splits build.{subr,sh}} into subr/{build,pkg,rtl}.subr and build.sh,
3) replaces {997.strip,998.midipix_sh,999.tarballs}.build with subr/{strip,tarball}.subr,
4) moves patches to patches/, vars files to vars/, and everything else to etc/,
5) renames `Create `Midipix mintty shell' shortcut.vbs' to midipix_shortcut.vbs,
6) fixes a Weechat configure issue, and
7) updates etc/{build.usage,README}.
Diffstat (limited to 'etc/build.usage')
-rw-r--r-- | etc/build.usage | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/etc/build.usage b/etc/build.usage new file mode 100644 index 00000000..c513c82c --- /dev/null +++ b/etc/build.usage @@ -0,0 +1,49 @@ +usage: ./build.sh [-x] [-a nt32|nt64] [-b debug|release] [-c] [-h] [-n] + [-r package[,...][:step]] [-t[.gz|.bz2|.xz] [-v] + [<target>[ ...]] + -x Set the xtrace sh(1)ell option for debugging purposes. + -a nt32|nt64 Selects 32-bit or 64-bit architecture; defaults to nt64. + -b debug|release Selects debug or release build; defaults to debug. + This currently only controls CFLAGS. + -c Clean ${PREFIX} before processing build scripts. + -h Show this screen. + -n Perform dry run. + -r package[,...][:step] Restart the specified comma-separated build(s) completely or at + the optionally specified step. Currently defined steps are: + fetch extract build_dir autoconf patch configure clean build install + -t[.gz|.bz2|.xz] Produce binary distribution and source tarballs containing ${PREFIX} + sans ${WORKDIR} and ${PREFIX}/src/midipix_build and ${WORKDIR} sans top- + level regular files at the end of a build with zero failures. The + tarballs will be compressed with either gzip, bzip2, or xz and signed + with GPG; the default compression is xz. + -v Be verbose; this currently only affects secure_{cd,rm}() and insecure_mkdir(). + <target>[ ...] One of: + host_toolchain, native_toolchain, runtime, lib_packages, + leaf_packages, world, or devroot. + + ${HOME}/midipix_build.vars, ../midipix_build.vars, and build.vars are sourced + if they exist. + + Packages that are built by pkg.build will apply local patches in ${WORKDIR} + named ${PKG_SUBDIR}.local.patch. + + Examples: + ./build.sh -r coreutils + Completely restart the coreutils build. + + ./build.sh -r coreutils:configure,build,install + Restart the configure, build, and install steps of the coreutils build. + + ./build.sh -r psxscl GITROOT_HEAD=... PKG_PSXSCL_CFLAGS_CONFIGURE_EXTRA=-DPSX_INTERNAL_STRACE + Build psxscl from the internal repository with strace enabled. + + ./build.sh -c -r ALL GITROOT_HEAD=... + Clean ${PREFIX} and forcibly rebuild everything. + +This script has been tested on the following platforms: +Alpine v3.4 (20160917_17:50) (x86_64) +Arch Linux 2016.02.01 (x86_64) +CentOS v7.2.1511 (Core) (x86_64) +Debian GNU/Linux v8.5 (stable) (jessie) (x86_64) +Exherbo Linux (x86_64-pc-linux-musl) (x86_64) +openSUSE 20150612 (Tumbleweed) (x86_64) |