Conan_Kudo / build / midipix_build

Forked from build/midipix_build 4 years ago
Clone

Blame etc/README.md

Lucio Andrés Illanes Albornoz 6d9a3c
> N.B. If you're interested in building Midipix using this script, please join
Lucio Andrés Illanes Albornoz 6d9a3c
the project's IRC channel #midipix on Freenode and ask for the address of the
Lucio Andrés Illanes Albornoz 6d9a3c
internal repositories required in order to build Midipix.
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ Table of contents"
Lucio Andrés Illanes Albornoz 6d9a3c
# Table of Contents  
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
1. [What is midipix, and how is it different?](#1-what-is-midipix-and-how-is-it-different)  
Lucio Andrés Illanes Albornoz 6d9a3c
2. [Building a midipix distribution](#2-building-a-midipix-distribution)  
Lucio Andrés Illanes Albornoz 23f3c2
	2.1. [Build-time dependencies](#21-build-time-dependencies)  
Lucio Andrés Illanes Albornoz 23f3c2
		2.1.1. [Alpine-specific notate bene](#211-alpine-specific-notate-bene)  
Lucio Andrés Illanes Albornoz 23f3c2
	2.2. [Deployment](#22-deployment)  
Lucio Andrés Illanes Albornoz 23f3c2
	2.3. [System requirements](#23-system-requirements)  
Lucio Andrés Illanes Albornoz 6d9a3c
3. [Common tasks](#3-common-tasks)  
Lucio Andrés Illanes Albornoz 23f3c2
	3.1. [Fault-tolerant & highly optimised 3D laser show-equipped usage screen](#31-fault-tolerant--highly-optimised-3d-laser-show-equipped-usage-screen)  
Lucio Andrés Illanes Albornoz 5b1e55
	3.2. [Adding a package](#32-adding-a-package)  
Lucio Andrés Illanes Albornoz 5b1e55
	3.3. [Addressing build failure](#33-addressing-build-failure)  
Lucio Andrés Illanes Albornoz 5b1e55
	3.4. [Patches and ``vars`` files](#34-patches-and-vars-files)  
Lucio Andrés Illanes Albornoz 23f3c2
4. [Build variables](#4-build-variables)  
Lucio Andrés Illanes Albornoz 5b1e55
	4.1. [Build steps](#41-build-steps)  
Lucio Andrés Illanes Albornoz 5b1e55
	4.2. [Package variables](#42-package-variables)  
Lucio Andrés Illanes Albornoz 23f3c2
5. [References](#5-references)  
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 1. What is midipix, and how is it different?"
Lucio Andrés Illanes Albornoz 23f3c2
## 1. What is midipix, and how is it different?
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 2a4027
midipix is a development environment that lets you create programs
Lucio Andrés Illanes Albornoz 2a4027
for Windows using the standard C and POSIX APIs. No compromises made,
Lucio Andrés Illanes Albornoz 2a4027
no shortcuts taken.  
Lucio Andrés Illanes Albornoz 2a4027
  
Lucio Andrés Illanes Albornoz 2a4027
If you are interested in cross-platform programming that reclaims
Lucio Andrés Illanes Albornoz 2a4027
the notion of write once, compile everywhere; if you believe that the
Lucio Andrés Illanes Albornoz 2a4027
'standard' in the C Standard Library should not be a null signifier;
Lucio Andrés Illanes Albornoz 2a4027
and if you like cooking your code without #ifdef hell and low-level
Lucio Andrés Illanes Albornoz 2a4027
minutiae, then this page is for you.  
Lucio Andrés Illanes Albornoz 2a4027
  
Lucio Andrés Illanes Albornoz 6d9a3c
midipix makes cross-platform programming better, simpler and faster,
Lucio Andrés Illanes Albornoz 2a4027
specifically by bringing a modern, conforming C Runtime Library to the
Lucio Andrés Illanes Albornoz 2a4027
Windows platform. While the idea itself is not new, the approach taken
Lucio Andrés Illanes Albornoz 2a4027
in midipix to code portability is radically different from that found
Lucio Andrés Illanes Albornoz 2a4027
in other projects.  
Lucio Andrés Illanes Albornoz 2a4027
  
Lucio Andrés Illanes Albornoz 5b1e55
*(reproduced from [\[2](#r2)])*
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 2. Building a midipix distribution"
Lucio Andrés Illanes Albornoz 6d9a3c
## 2. Building a midipix distribution
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
A Midipix distribution consists of the following:
Lucio Andrés Illanes Albornoz 6d9a3c
* the native Midipix toolchain, consisting of perk, gcc, its dependencies,
Lucio Andrés Illanes Albornoz 6d9a3c
  and binutils,
Lucio Andrés Illanes Albornoz 6d9a3c
* musl, a lightweight, fast, simple, and free libc[\[1](#r1)] used by Midipix,
Lucio Andrés Illanes Albornoz 6d9a3c
* the Midipix runtime components that bridge the gap between the libc and the
Lucio Andrés Illanes Albornoz 6d9a3c
  executive subsystems of all Windows NT-derived Windows OS starting with and
Lucio Andrés Illanes Albornoz 6d9a3c
  including Windows XP, and
Lucio Andrés Illanes Albornoz 6d9a3c
* a steadily increasing number of 3rd party open source packages, as expected in
Lucio Andrés Illanes Albornoz 6d9a3c
  any modern POSIX-compliant \*nix environment, including GNU coreutils, shells,
Lucio Andrés Illanes Albornoz 6d9a3c
  libraries such as ncurses, libressl, as well as Perl and Python.
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 23f3c2
Install the build-time dependencies listed in section [2.1](#21-build-time-dependencies),
Lucio Andrés Illanes Albornoz 6d9a3c
clone this repository, and run the following command line:
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
```shell
Lucio Andrés Illanes Albornoz 9d2842
./build.sh -a nt64 -b release -P -v
Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
By default, the build will take place within ``${HOME}/midipix/nt64/release``
Lucio Andrés Illanes Albornoz 6d9a3c
and package archive files and/or Git repositores will be downloaded into
Lucio Andrés Illanes Albornoz 5b1e55
``${HOME}/midipix/dlcache``. Consult sections [3.1](#31-fault-tolerant--highly-optimised-3d-laser-show-equipped-usage-screen), [4](#4-build-variables), and [4.1](#42-package-variables)
Lucio Andrés Illanes Albornoz 2a4027
for the list of available build variables and how to override them.  
Lucio Andrés Illanes Albornoz 5b1e55
Parallelisation is enabled by the above command line for both packages that can
Lucio Andrés Illanes Albornoz 5b1e55
be built independently of each other and ``make(1)`` via ``-j``, limited to the
Lucio Andrés Illanes Albornoz 5b1e55
amount of logical processors on the build host divided by two (2).
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 2.1. Build-time dependencies"
Lucio Andrés Illanes Albornoz 6d9a3c
### 2.1. Build-time dependencies
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
* **Alpine Linux**: binutils bzip2 cmake coreutils curl findutils g++ gawk gcc
Lucio Andrés Illanes Albornoz 6d9a3c
		    git grep gzip libc-dev linux-headers lzip make musl-dev
Lucio Andrés Illanes Albornoz 6d9a3c
		    net-tools patch perl perl-xml-parser procps sed tar
Lucio Andrés Illanes Albornoz 6d9a3c
		    util-linux wget xz zip
Lucio Andrés Illanes Albornoz 6d9a3c
* **Debian/-derived Linux**: binutils bzip2 clzip cmake coreutils curl findutils
Lucio Andrés Illanes Albornoz 6d9a3c
			     g++ gawk gcc git grep gzip hostname libc6-dev
Lucio Andrés Illanes Albornoz 6d9a3c
			     libxml-parser-perl lzma make patch perl procps sed
Lucio Andrés Illanes Albornoz 6d9a3c
			     tar util-linux wget xz-utils zip
Lucio Andrés Illanes Albornoz 6d9a3c
* **OpenSUSE Linux**: binutils bzip2 cmake coreutils curl findutils gawk gcc
Lucio Andrés Illanes Albornoz 6d9a3c
		      gcc-c++ git grep gzip hostname linux-glibc-devel lzip make
Lucio Andrés Illanes Albornoz 6d9a3c
		      patch perl perl-XML-Parser procps sed tar util-linux wget
Lucio Andrés Illanes Albornoz 6d9a3c
		      xz zip
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
> N.B. Busybox is not supported.
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 2.1.1. Alpine-specific notate bene"
Lucio Andrés Illanes Albornoz 6d9a3c
#### 2.1.1. Alpine-specific notate bene
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
Some packages (*coreutils*, *grep*, and *tar*, among others) override Alpine's
Lucio Andrés Illanes Albornoz 6d9a3c
BusyBox utilities of the same name, as the latter are either non-conformant or
Lucio Andrés Illanes Albornoz 6d9a3c
defective.
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 2.2. Deployment"
Lucio Andrés Illanes Albornoz 6d9a3c
### 2.2. Deployment
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
On successful completion of the build, a ZIP archive containing the Midipix
Lucio Andrés Illanes Albornoz 5b1e55
distribution will be created inside ``${PREFIX}`` (see section [4](#4-build-variables).)
Lucio Andrés Illanes Albornoz 5b1e55
Extract its contents on the target machine, run ``bash.bat``, and then
Lucio Andrés Illanes Albornoz 5b1e55
``/install.sh`` inside the resulting self-contained Midipix installation shell
Lucio Andrés Illanes Albornoz 5b1e55
window.
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 2.3. System requirements"
Lucio Andrés Illanes Albornoz 6d9a3c
### 2.3. System requirements
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
The following system requirements are assessed on build hosts equipped with the
Lucio Andrés Illanes Albornoz 6d9a3c
following hardware at minimum:
Lucio Andrés Illanes Albornoz 6d9a3c
* Intel(R) Xeon(R) CPU W3520 @ 2.67GHz (8 cores)
Lucio Andrés Illanes Albornoz 6d9a3c
* 7200 RPM SATA 3.1 HDD
Lucio Andrés Illanes Albornoz 6d9a3c
* 6 GB RAM
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 5b1e55
| Target architecture | Build type | Distribution kinds selected | Average build time | Disk space required | Peak RAM usage |
Lucio Andrés Illanes Albornoz 5b1e55
| ------------------- | ---------- | --------------------------- | ------------------ | ------------------- | -------------- |
Lucio Andrés Illanes Albornoz 5b1e55
| nt64                | debug      | (none)                      | 2 hours            | 57.62 GB            | 3.55 GB        |
Lucio Andrés Illanes Albornoz 5b1e55
| nt64                | release    | (none)                      | 1 hours 45 minutes | 36.51 GB            | 3.21 GB        |
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
Package archive files and/or Git repositories additionally consume at least
Lucio Andrés Illanes Albornoz 5b1e55
1.82 GB.
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 5b1e55
*(last update: Thu, 05 Mar 2020 09:25:41 +0000)*
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 3. Common tasks"
Lucio Andrés Illanes Albornoz 6d9a3c
## 3. Common tasks
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
Rebuild set of packages in isolation, along w/ their dependencies, if any, as
Lucio Andrés Illanes Albornoz 6d9a3c
needed, or forcibly, respectively:
Lucio Andrés Illanes Albornoz 6d9a3c
```shell
Lucio Andrés Illanes Albornoz 6d9a3c
./build.sh [ ... ] -r mc,zsh
Lucio Andrés Illanes Albornoz 6d9a3c
./build.sh [ ... ] -r \*mc,zsh
Lucio Andrés Illanes Albornoz 6d9a3c
./build.sh [ ... ] -r \*\*mc,zsh
Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
Restart the ``configure``, ``build``, and ``install`` steps of the ``coreutils``
Lucio Andrés Illanes Albornoz 6d9a3c
package.
Lucio Andrés Illanes Albornoz 6d9a3c
```shell
Lucio Andrés Illanes Albornoz 6d9a3c
./build.sh -r coreutils:configure,build,install
Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
Rebuild entire build group:
Lucio Andrés Illanes Albornoz 6d9a3c
```shell
Lucio Andrés Illanes Albornoz 6d9a3c
./build.sh [ ... ] -r ALL native_runtime
Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "{{{ 3.1. Fault-tolerant & highly optimised 3D laser show-equipped usage screen"
Lucio Andrés Illanes Albornoz 6d9a3c
## 3.1. Fault-tolerant & highly optimised 3D laser show-equipped usage screen
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 487c40
usage: ./build.sh [-a nt32|nt64]   [-b debug|release]   [-C dir[,..]] [-D kind[,..]]
Lucio Andrés Illanes Albornoz 487c40
                  [-F ipv4|ipv6|offline]    [-h]    [-p jobs]   [-P]   [-r ALL|LAST]
Lucio Andrés Illanes Albornoz 487c40
                  [-r [*[*[*]]]name[,..][:step,..]] [-R] [-v[v[v[v]]]] [--as-needed]
Lucio Andrés Illanes Albornoz 487c40
                  [--debug-minipix] [[*]<group>|<variable name>=<variable override>[ ..]]
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
        -a nt32|nt64      Selects 32-bit or 64-bit architecture; defaults to nt64.
Lucio Andrés Illanes Albornoz 6d9a3c
        -b debug|release  Selects debug or release build; defaults to debug.
Lucio Andrés Illanes Albornoz 6d9a3c
        -C dir[,..]       Clean build directory (build,) ${PREFIX} before processing build
Lucio Andrés Illanes Albornoz 5b1e55
                          scripts (prefix,) source directory (src,) and/or destination
Lucio Andrés Illanes Albornoz 5b1e55
                          directory (dest) after successful package builds.
Lucio Andrés Illanes Albornoz 5b1e55
        -D kind[,..]      Produce minimal midipix distribution directory (minipix,) RPM
Lucio Andrés Illanes Albornoz 5b1e55
                          binary packages (rpm,) and/or deployable distribution ZIP
Lucio Andrés Illanes Albornoz 5b1e55
                          archive (zipdist.) zipdist implies minipix.
Lucio Andrés Illanes Albornoz 6d9a3c
        -F ipv4|ipv6|offline
Lucio Andrés Illanes Albornoz 5b1e55
                          Force IPv4 (ipv4) or IPv6 (ipv6) when downloading package
Lucio Andrés Illanes Albornoz 5b1e55
                          archives and/or Git repositories or don't download either at all
Lucio Andrés Illanes Albornoz 5b1e55
                          (offline.)
Lucio Andrés Illanes Albornoz 6d9a3c
        -h                Show this screen.
Lucio Andrés Illanes Albornoz 6d9a3c
        -p jobs           Enables parallelisation at group-level, whenever applicable.
Lucio Andrés Illanes Albornoz 6d9a3c
        -P                The maximum count of jobs defaults to the number of logical
Lucio Andrés Illanes Albornoz 6d9a3c
                          processors on the host system divided by two (2.)
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
                          If -R is not specified and at least one (1) package fails to
Lucio Andrés Illanes Albornoz 5b1e55
                          build, all remaining package builds will be forcibly aborted.
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
        -r ALL|LAST       Restart all packages or the last failed package and resume
Lucio Andrés Illanes Albornoz 5b1e55
                          build, resp.
Lucio Andrés Illanes Albornoz 487c40
        -r [*[*[*]]]name[,..][:step,..]
Lucio Andrés Illanes Albornoz 5b1e55
                          Restart the specified comma-separated package(s) completely or
Lucio Andrés Illanes Albornoz 5b1e55
                          at optionally specified comma-separated list of build steps.
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 7bed88
                          Prepend w/ `*' to automatically include dependencies, `**' to
Lucio Andrés Illanes Albornoz 7bed88
                          forcibly rebuild all dependencies, and `***` to forcibly rebuild
Lucio Andrés Illanes Albornoz 7bed88
                          all packages that depend on the specified package(s).
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 5b1e55
                          Currently defined build steps are:
Lucio Andrés Illanes Albornoz 5b1e55
                          fetch_wget, fetch_git, fetch_extract, configure_patch_pre,
Lucio Andrés Illanes Albornoz 5b1e55
                          configure_autotools, configure_patch, configure, build,
Lucio Andrés Illanes Albornoz 5b1e55
                          install_subdirs, install_make, install_files, install_libs,
Lucio Andrés Illanes Albornoz 5b1e55
                          install, and install_rpm.
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 6d9a3c
        -R                Ignore build failures, skip printing package logs, and continue
Lucio Andrés Illanes Albornoz 6d9a3c
                          building (relaxed mode.)
Lucio Andrés Illanes Albornoz 5b1e55
        -v[v[v[v]]]       Be verbose; -vv: always print package logs; -vvv: set xtrace
Lucio Andrés Illanes Albornoz 5b1e55
                          during package builds; -vvvv: logs fileops.
Lucio Andrés Illanes Albornoz 5b1e55
        --as-needed       Don't build unless the midipix_build repository has received
Lucio Andrés Illanes Albornoz 5b1e55
                          new commits.
Lucio Andrés Illanes Albornoz 6d9a3c
        --debug-minipix   Don't strip(1) minipix binaries to facilitate debugging minipix.
Lucio Andrés Illanes Albornoz 5b1e55
        <group>[ ..]      One of: dev_packages, dist, host_deps, host_deps_rpm,
Lucio Andrés Illanes Albornoz 7bed88
                          host_toolchain, host_tools, minipix, native_packages,
Lucio Andrés Illanes Albornoz 5b1e55
                          native_runtime, native_toolchain, native_tools.
Lucio Andrés Illanes Albornoz 487c40

Lucio Andrés Illanes Albornoz 487c40
                          Prepend w/ `*' to inhibit group-group dependency expansion.
Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "{{{ 3.2. Adding a package"
Lucio Andrés Illanes Albornoz 5b1e55
## 3.2. Adding a package
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
Packages are grouped into *build groups* according to sets of common package
Lucio Andrés Illanes Albornoz 5b1e55
variable defaults, such as ``${PKG_CFLAGS_CONFIGURE}, ${PKG_LDFLAGS_CONFIGURE}``
Lucio Andrés Illanes Albornoz 5b1e55
and ``${PKG_CONFIGURE_ARGS}``, and semantic associativity, such as the ``native_runtime``
Lucio Andrés Illanes Albornoz 5b1e55
build group comprising the Midipix runtime components. Packages may belong to
Lucio Andrés Illanes Albornoz 5b1e55
more than one build group such as when subsumed by a shorthand build group e.g.
Lucio Andrés Illanes Albornoz 5b1e55
the ``dev_packages`` build group, as long as the default set of build groups or
Lucio Andrés Illanes Albornoz 5b1e55
as overriden on the command line does not entail group membership conflicts.  
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
Build groups files beneath ``groups/`` named ``[0-9][0-9][0-9].<group name>.group``
Lucio Andrés Illanes Albornoz 5b1e55
contain package variable defaults, the alphabetically sorted list of contained
Lucio Andrés Illanes Albornoz 5b1e55
packages in ``<upper case group name>_PACKAGES``, and their package variables
Lucio Andrés Illanes Albornoz 5b1e55
sorted alphabetically with the exception of ``${PKG_DEPENDS}`` (if present,)
Lucio Andrés Illanes Albornoz 5b1e55
``${PKG_SHA256SUM}``, ``${PKG_URL}``, and ``${PKG_VERSION}``, and/or ``${PKG_URLS_GIT}``,
Lucio Andrés Illanes Albornoz 5b1e55
which are specified in this order.  
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
Pick a build group according to the criteria mentioned, add the package to the
Lucio Andrés Illanes Albornoz 5b1e55
build group's list of contained packages in its corresponding file, and add the
Lucio Andrés Illanes Albornoz 5b1e55
set of package variables required (see above and section [4.2](#42-package-variables).)  
Lucio Andrés Illanes Albornoz 5b1e55
Consult section [3.4](#34-patches-and-vars-files) if the package to be added
Lucio Andrés Illanes Albornoz 5b1e55
requires patches or additional code amending or replacing package build steps
Lucio Andrés Illanes Albornoz 5b1e55
or the entire package build. Consult section [4.1](#41-build-steps) for a list
Lucio Andrés Illanes Albornoz 5b1e55
of package build steps and how they are overriden.
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "{{{ 3.3. Addressing build failure"
Lucio Andrés Illanes Albornoz 5b1e55
## 3.3. Addressing build failure
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "{{{ 3.4. Patches and ``vars`` files"
Lucio Andrés Illanes Albornoz 5b1e55
## 3.4. Patches and ``vars`` files
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
Package patches are applied prior and/or subsequent to (GNU autotools or simular) package
Lucio Andrés Illanes Albornoz 5b1e55
configuration during the ``configure_patch_pre`` and/or ``configure_patch`` build steps,
Lucio Andrés Illanes Albornoz 5b1e55
respectively (see section [4.1](#41-build-steps).) Patch files are searched for beneath
Lucio Andrés Illanes Albornoz 5b1e55
``patches/`` with the following globs and in-order:
Lucio Andrés Illanes Albornoz 5b1e55
* ``${PKG_NAME}-${PKG_VERSION}_pre.local.patch``
Lucio Andrés Illanes Albornoz 5b1e55
  or ``${PKG_NAME}_pre.local.patch`` (for packages lacking ``${PKG_VERSION}``)
Lucio Andrés Illanes Albornoz 5b1e55
* ``${PKG_NAME}-${PKG_VERSION}_pre.local@${BUILD_HNAME}.patch``
Lucio Andrés Illanes Albornoz 5b1e55
  or ``${PKG_NAME}_pre.local@${BUILD_HNAME}.patch`` (for packages lacking ``${PKG_VERSION}``)
Lucio Andrés Illanes Albornoz 5b1e55
* ``${PKG_NAME}/*.patch``
Lucio Andrés Illanes Albornoz 5b1e55
* ``${PKG_NAME}-${PKG_VERSION}.local.patch``
Lucio Andrés Illanes Albornoz 5b1e55
  or ``${PKG_NAME}.local.patch`` (for packages lacking ``${PKG_VERSION}``)
Lucio Andrés Illanes Albornoz 5b1e55
* ``${PKG_NAME}-${PKG_VERSION}.local@${BUILD_HNAME}.patch``
Lucio Andrés Illanes Albornoz 5b1e55
  or ``${PKG_NAME}.local@${BUILD_HNAME}.patch`` (for packages lacking ``${PKG_VERSION}``)
Lucio Andrés Illanes Albornoz 5b1e55
* ``${PKG_PATCHES_EXTRA}`` (if set)
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
If the default set of package build steps does not suffice, such as if additional commands
Lucio Andrés Illanes Albornoz 5b1e55
must be executed after package configuration or prior to building, or if an entire or all
Lucio Andrés Illanes Albornoz 5b1e55
build step must be replaced, overrides may be specified in the form of functions in the
Lucio Andrés Illanes Albornoz 5b1e55
package's ``vars/${PKG_NAME}.vars`` ``vars`` file. Consult section [4.1](#41-build-steps)
Lucio Andrés Illanes Albornoz 5b1e55
for a list of package build steps and how they are overriden.
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 23f3c2
[//]: # "{{{ 4. Build variables"
Lucio Andrés Illanes Albornoz 23f3c2
## 4. Build variables
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
The following variables are primarily defined in ``midipix.env`` and may be
Lucio Andrés Illanes Albornoz 5b1e55
overriden on a per-build basis on the command-line after the last option
Lucio Andrés Illanes Albornoz 5b1e55
argument, if any, e.g.:
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
```shell
Lucio Andrés Illanes Albornoz 6d9a3c
./build.sh -a nt64 -b release -D minipix,zipdist -P -v PREFIX_ROOT="${HOME}/midipix_tmp"
Lucio Andrés Illanes Albornoz 6d9a3c
```
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
Furthermore, ``${HOME}/midipix_build.vars``, ``${HOME}/.midipix_build.vars``,
Lucio Andrés Illanes Albornoz 6d9a3c
and/or ``../midipix_build.vars`` are sourced during build initialisation and
Lucio Andrés Illanes Albornoz 6d9a3c
may contain additional overrides, particularly ``${DEFAULT_GITROOT_HEAD}``.
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
| Variable name    | Default value                   | Description                                                                   |
Lucio Andrés Illanes Albornoz 6d9a3c
| ---------------- | ------------------------------- | ----------------------------------------------------------------------------- |
Lucio Andrés Illanes Albornoz 6d9a3c
| ARCH             | nt64                            | Target 32-bit (nt32) or 64-bit (nt64) architecture                            |
Lucio Andrés Illanes Albornoz 6d9a3c
| BUILD            | debug                           | Build w/ debugging (debug) or release compiler flags                          |
Lucio Andrés Illanes Albornoz 6d9a3c
| BUILD_DLCACHEDIR | ${PREFIX_ROOT}/dlcache          | Absolute pathname to package downloads cache root directory                   |
Lucio Andrés Illanes Albornoz 6d9a3c
| BUILD_WORKDIR    | ${PREFIX}/tmp                   | Absolute pathname to temporary package build root directory                   |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX           | ${PREFIX_ROOT}/${ARCH}/${BUILD} | Absolute pathname to architecture- & build type-specific build root directory |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX_CROSS     | ${PREFIX}/${DEFAULT_TARGET}     | Absolute pathname to toolchain root directory                                 |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX_MINGW32   | ${PREFIX}/x86_64-w64-mingw32    | Absolute pathname to MinGW toolchain root directory                           |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX_MINIPIX   | ${PREFIX}/minipix               | Absolute pathname to minipix distribution root directory                      |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX_NATIVE    | ${PREFIX}/native                | Absolute pathname to cross-compiled packages root directory                   |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX_ROOT      | ${HOME}/midipix                 | Absolute pathname to top-level directory                                      |
Lucio Andrés Illanes Albornoz 6d9a3c
| PREFIX_RPM       | ${PREFIX}/rpm                   | Absolute pathname to package RPM archive root directory                       |
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "{{{ 4.1. Build steps"
Lucio Andrés Illanes Albornoz 5b1e55
## 4.1. Build steps
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
Package builds are divided up into consecutively executed build steps until
Lucio Andrés Illanes Albornoz 5b1e55
completion or aborted on failure unless relaxed mode is enabled by passing
Lucio Andrés Illanes Albornoz 5b1e55
``-R``.  
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
Each build step corresponds to a function in the corresponding ``subr/pkg_*.subr``
Lucio Andrés Illanes Albornoz 5b1e55
script and may be overriden entirely by a function named ``pkg_<package name>_<build step>()``
Lucio Andrés Illanes Albornoz 5b1e55
or composed in terms of prior and/or subsequent execution by a function named
Lucio Andrés Illanes Albornoz 5b1e55
``pkg_<package name>_<build step>_pre()`` and/or ``pkg_<package name>_<build step>_post()``,
Lucio Andrés Illanes Albornoz 5b1e55
respectively, in the package's ``vars`` file. If a function named ``pkg_<package name>_all()``
Lucio Andrés Illanes Albornoz 5b1e55
exists, it will override all build steps.  
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
Build step status is tracked on a per-package basis by state files beneath
Lucio Andrés Illanes Albornoz 5b1e55
``${BUILD_WORKDIR}`` following the format ``.<package name>.<build step>``;
Lucio Andrés Illanes Albornoz 5b1e55
package build completion corresponds to the pseudo-build step ``finish``.
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
| Name                | Description                                                                                                                                                                           |
Lucio Andrés Illanes Albornoz 5b1e55
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Lucio Andrés Illanes Albornoz 5b1e55
| fetch_download      | Download package archive & verify w/ SHA-256 message digest and/or clone Git repository/ies                                                                                           |
Lucio Andrés Illanes Albornoz 5b1e55
| fetch_extract       | Extract package archive, if any                                                                                                                                                       |
Lucio Andrés Illanes Albornoz 5b1e55
| configure_patch_pre | Apply ``chainport`` patches and/or patches beneath ``patches/`` prior to (GNU autotools or similar) configuration                                                                     |
Lucio Andrés Illanes Albornoz 5b1e55
| configure_autotools | Bootstrap (GNU autools or similar) environment, and install ``config.sub`` and ``config.cache``                                                                                       |
Lucio Andrés Illanes Albornoz 5b1e55
| configure_patch     | Apply patches beneath ``patches/`` and/or set in ``${PKG_PATCHES_EXTRA}`` after (GNU autotools or similar) configuration                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| configure           | Perform package (GNU autools or similar) configuration w/ configuration-time set of environment variables                                                                             |
Lucio Andrés Illanes Albornoz 5b1e55
| build               | Call ``make(1)`` w/ build-time set of make variables                                                                                                                                  |
Lucio Andrés Illanes Albornoz 5b1e55
| install_subdirs     | Create default directory hierarchy in ``${PKG_DESTDIR}``, optionally amended w/ ``${PKG_INSTALL_FILES_DESTDIR_EXTRA}``                                                                |
Lucio Andrés Illanes Albornoz 5b1e55
| install_make        | Call ``make(1)`` w/ ``${PKG_INSTALL_TARGET}`` (defaults to ``install``) and installation-time set of make variables                                                                   |
Lucio Andrés Illanes Albornoz 5b1e55
| install_files       | Install ``${PKG_INSTALL_FILES}``, ``pkgconf(1)`` package files, and/or stripped binaries within ``${PKG_DESTDIR}``                                                                    |
Lucio Andrés Illanes Albornoz 5b1e55
| install_libs        | Purge libtool ``.la`` files and install shared objects within ``${PKG_DESTDIR}`` w/ ``perk`` and corresponding symbolic links                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| install             | Fix directory and file mode bits within ``${PKG_DESTDIR}``, install into ``${PKG_PREFIX}`` under mutex, and add package to ``${PREFIX}/pkglist.${PKG_BUILD_TYPE}`` (unless inhibited) |
Lucio Andrés Illanes Albornoz 5b1e55
| install_rpm         | Build package RPM w/ auto-generated specifiation file based on ``etc/package.spec`` beneath ``${PREFIX_RPM}``                                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| clean               | Clean ``${PKG_BUILD_DIR}`` and/or ``${PKG_DESTDIR}`` and/or ``${PKG_BASE_DIR}/${PKG_SUBDIR}`` as per ``-C build,dest,src``, resp., if any                                             |
Lucio Andrés Illanes Albornoz 5b1e55
  
Lucio Andrés Illanes Albornoz 5b1e55
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 5b1e55

Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 5b1e55
[//]: # "{{{ 4.2. Package variables"
Lucio Andrés Illanes Albornoz 5b1e55
## 4.2. Package variables
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
The following variables are package-specific and receive their value from either
Lucio Andrés Illanes Albornoz 6d9a3c
top-level defaults defined in ``midipix.env``, build group-specific defaults
Lucio Andrés Illanes Albornoz 6d9a3c
from the build group the package pertains to and defined in its corresponding
Lucio Andrés Illanes Albornoz 6d9a3c
file beneath ``groups/``, or package-specific overrides defined either in the
Lucio Andrés Illanes Albornoz 5b1e55
latter and/or in its corresponding file beneath ``vars/``.  
Lucio Andrés Illanes Albornoz 5b1e55
Additionally, overrides may be specified on a per-build basis on the command-
Lucio Andrés Illanes Albornoz 5b1e55
line after the last argument, with each variable prefixed w/ ``PKG_``, e.g.:
Lucio Andrés Illanes Albornoz 5b1e55
``./build.sh [ ... ] PKG_ZSH_CC="/usr/bin/clang"``.  
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
The minimum set of package variables that must be provided is ``SHA256SUM, URL,
Lucio Andrés Illanes Albornoz 6d9a3c
VERSION`` and/or ``URLS_GIT``, respectively.
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 5b1e55
| Package variable name       | Description                                                                                                                                 |
Lucio Andrés Illanes Albornoz 5b1e55
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
Lucio Andrés Illanes Albornoz 5b1e55
| AR                          | Command- or pathname of toolchain library archive editor ``ar(1)``)                                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| BASE_DIR                    | Absolute pathname to package build root directory beneath ``${BUILD_WORKDIR}``                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| BUILD_DIR                   | Directory name of package build directory beneath ``${PKG_BASE_DIR}``                                                                       |
Lucio Andrés Illanes Albornoz 5b1e55
| BUILD_STEPS_DISABLE         | List of build steps to disable during package build                                                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| BUILD_TYPE                  | Cross-compiled toolchain (``cross``,) host (``host```,) or cross-compiled package (``native``) build type                                   |
Lucio Andrés Illanes Albornoz 5b1e55
| CC                          | Command- or pathname of toolchain C compiler ``cc(1)``)                                                                                     |
Lucio Andrés Illanes Albornoz 5b1e55
| CFLAGS_BUILD_EXTRA          | Additional C compiler flags during package ``make(1)``) build                                                                               |
Lucio Andrés Illanes Albornoz 5b1e55
| CFLAGS_CONFIGURE            | C compiler flags during package (GNU autotools or similar) configuration                                                                    |
Lucio Andrés Illanes Albornoz 5b1e55
| CFLAGS_CONFIGURE_EXTRA      | Additional C compiler flags during package (GNU autotools or similar) configuration                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| CONFIG_CACHE                | List of GNU autotools configuration cache variables                                                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| CONFIG_CACHE_EXTRA          | Additional list of GNU autotools configuration cache variables                                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| CONFIG_CACHE_LOCAL          | Additional list of GNU autotools configuration cache variables                                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| CONFIGURE                   | Command- or pathname to package (GNU autotools or similar) configuration script                                                             |
Lucio Andrés Illanes Albornoz 5b1e55
| CONFIGURE_ARGS              | List of arguments to package (GNU autotools or similar) configuration script                                                                |
Lucio Andrés Illanes Albornoz 5b1e55
| CONFIGURE_ARGS_EXTRA        | Additional list of arguments to package (GNU autotools or similar) configuration script                                                     |
Lucio Andrés Illanes Albornoz 5b1e55
| CXX                         | Command- or pathname of toolchain C++ compiler ``c++(1)``)                                                                                  |
Lucio Andrés Illanes Albornoz 5b1e55
| CXXFLAGS_CONFIGURE          | List of C++ compiler flags during package (GNU autotools or similar) configuration                                                          |
Lucio Andrés Illanes Albornoz 5b1e55
| CXXFLAGS_CONFIGURE_EXTRA    | Additional list of C++ compiler flags during package (GNU autotools or similar) configuration                                               |
Lucio Andrés Illanes Albornoz 5b1e55
| DEPENDS                     | List of package-package dependencies                                                                                                        |
Lucio Andrés Illanes Albornoz 5b1e55
| DESTDIR                     | Directory name of package installation destination directory beneath ``${PKG_BASE_DIR}``                                                    |
Lucio Andrés Illanes Albornoz 5b1e55
| DISABLED                    | Disable package                                                                                                                             |
Lucio Andrés Illanes Albornoz 5b1e55
| ENV_VARS_EXTRA              | List of double colon-separated environment variable equality sign-separated name-value pairs to set during package build                    |
Lucio Andrés Illanes Albornoz 5b1e55
| FNAME                       | Filename of package archive file                                                                                                            |
Lucio Andrés Illanes Albornoz 5b1e55
| FORCE_AUTORECONF            | Forcibly run ``autoreconf -fiv`` prior to package (GNU autotools or similar) configuration                                                  |
Lucio Andrés Illanes Albornoz 5b1e55
| GITROOT                     | midipix packages Git URL prefix                                                                                                             |
Lucio Andrés Illanes Albornoz 5b1e55
| INHERIT_FROM                | Inherit variables from named package                                                                                                        |
Lucio Andrés Illanes Albornoz 5b1e55
| INSTALL_FILES               | Whitespace-separated list of files to manually install into the package installation destination directory beneath ``${PKG_BASE_DIR}``      |
Lucio Andrés Illanes Albornoz 5b1e55
| INSTALL_FILES_DESTDIR       | Whitespace-separated list of files to initialise the package installation destination directory beneath ``${PKG_BASE_DIR}`` with            |
Lucio Andrés Illanes Albornoz 5b1e55
| INSTALL_FILES_DESTDIR_EXTRA | Additional whitespace-separated list of files to initialise the package installation destination directory beneath ``${PKG_BASE_DIR}`` with |
Lucio Andrés Illanes Albornoz 5b1e55
| INSTALL_TARGET              | Name of package build ``make(1)`` installation target                                                                                       |
Lucio Andrés Illanes Albornoz 5b1e55
| INSTALL_TARGET_EXTRA        | Additional name of package build ``make(1)`` installation target                                                                            |
Lucio Andrés Illanes Albornoz 5b1e55
| IN_TREE                     | Build package in-tree within ``${PKG_SUBDIR}``                                                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| LDFLAGS_BUILD_EXTRA         | Additional linker flags during package ``make(1)``) build                                                                                   |
Lucio Andrés Illanes Albornoz 5b1e55
| LDFLAGS_CONFIGURE           | Linker flags during package (GNU autotools or similar) configuration                                                                        |
Lucio Andrés Illanes Albornoz 5b1e55
| LDFLAGS_CONFIGURE_EXTRA     | Additional linker flags during package (GNU autotools or similar) configuration                                                             |
Lucio Andrés Illanes Albornoz 5b1e55
| LIBTOOL                     | Command- or pathname of ``libtool(1)`` (defaults to ``slibtool``)                                                                           |
Lucio Andrés Illanes Albornoz 5b1e55
| MAKE                        | Command line of ``make(1)``                                                                                                                 |
Lucio Andrés Illanes Albornoz 5b1e55
| MAKEFLAGS_BUILD             | List of ``make(1)`` flags during package ``make(1)``) build                                                                                 |
Lucio Andrés Illanes Albornoz 5b1e55
| MAKEFLAGS_BUILD_EXTRA       | Additional list of ``make(1)`` flags during package ``make(1)``) build                                                                      |
Lucio Andrés Illanes Albornoz 5b1e55
| MAKEFLAGS_INSTALL           | List of ``make(1)`` flags during package ``make(1)``) installation                                                                          |
Lucio Andrés Illanes Albornoz 5b1e55
| MAKEFLAGS_INSTALL_EXTRA     | Additional list of ``make(1)`` flags during package ``make(1)``) installation                                                               |
Lucio Andrés Illanes Albornoz 5b1e55
| MAKE_INSTALL_VNAME          | Variable name of ``make(1)`` installation destination directory variable during package ``make(1)``) installation                           |
Lucio Andrés Illanes Albornoz 5b1e55
| NO_CLEAN                    | Inhibit cleaning of package build directory beneath ``${PKG_BASE_DIR}`` pre-finish                                                          |
Lucio Andrés Illanes Albornoz 5b1e55
| NO_CLEAN_BASE_DIR           | Inhibit cleaning of package build root directory beneath ``${BUILD_WORKDIR}``                                                               |
Lucio Andrés Illanes Albornoz 5b1e55
| NO_LOG_VARS                 | Inhibit logging of build & package variables pre-package build                                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| PATCHES_EXTRA               | Additional list of patches to apply                                                                                                         |
Lucio Andrés Illanes Albornoz 5b1e55
| PKG_CONFIG                  | Command- or pathname of ``pkg-config(1)``                                                                                                   |
Lucio Andrés Illanes Albornoz 5b1e55
| PKG_CONFIG_PATH             | ``pkg-config(1)`` search path                                                                                                               |
Lucio Andrés Illanes Albornoz 5b1e55
| PKGLIST_DISABLE             | Inhibit inclusion into ``${PREFIX}/pkglist.${PKG_BUILD_TYPE}``                                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| PREFIX                      | Absolute pathname of top-level installation directory and package search path                                                               |
Lucio Andrés Illanes Albornoz 5b1e55
| PYTHON                      | Command- or pathname of Python                                                                                                              |
Lucio Andrés Illanes Albornoz 5b1e55
| RANLIB                      | Command- or pathname of toolchain library archive index generator ``ranlib(1)``)                                                            |
Lucio Andrés Illanes Albornoz 5b1e55
| RPM_DISABLE                 | Inhibit creation of RPM archive                                                                                                             |
Lucio Andrés Illanes Albornoz 5b1e55
| SHA256SUM                   | SHA-256 message digest of package archive                                                                                                   |
Lucio Andrés Illanes Albornoz 5b1e55
| SUBDIR                      | Name of extracted archive or git-{clone,pull}(1)'d directory                                                                                |
Lucio Andrés Illanes Albornoz 5b1e55
| TARGET                      | Dash-separated {build,host,target} triplet                                                                                                  |
Lucio Andrés Illanes Albornoz 5b1e55
| URL                         | URL to package archive                                                                                                                      |
Lucio Andrés Illanes Albornoz 5b1e55
| URLS_GIT                    | List of package Git URL(s) (``*name*=*URL*@*branch*``)                                                                                      |
Lucio Andrés Illanes Albornoz 5b1e55
| VERSION                     | Package version                                                                                                                             |
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 23f3c2
[//]: # "{{{ 5. References"
Lucio Andrés Illanes Albornoz 23f3c2
## 5. References
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
* ``Sun, 25 Apr 2016 09:04:08 +0000 [1]`` musl FAQ  
Lucio Andrés Illanes Albornoz 5b1e55
* ``Wed, 04 Mar 2020 13:36:19 +0000 [2]`` midipix - what is midipix, and how is it different?  
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[Back to top](#table-of-contents)
Lucio Andrés Illanes Albornoz 6d9a3c

Lucio Andrés Illanes Albornoz 6d9a3c
[//]: # "}}}"
Lucio Andrés Illanes Albornoz 6d9a3c
  
Lucio Andrés Illanes Albornoz 6d9a3c
[modeline]: # ( vim: set ff=dos tw=0: )