From 4d20d1828729eb038434a003a55e5e4864428073 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lucio=20Andr=C3=A9s=20Illanes=20Albornoz?= Date: Sat, 29 Feb 2020 14:16:26 +0000 Subject: etc/README.md: renamed from etc/README. README.md: update symlink. --- etc/README | 80 -------------------------------------------------------------- 1 file changed, 80 deletions(-) delete mode 100644 etc/README (limited to 'etc/README') diff --git a/etc/README b/etc/README deleted file mode 100644 index 7d9f7737..00000000 --- a/etc/README +++ /dev/null @@ -1,80 +0,0 @@ -> N.B. If you're interested in building Midipix using this script, please join the project's -IRC channel #midipix on Freenode and ask for the address of the internal repositories. - -> N.B. If in doubt, consult the fault-tolerant & highly optimised 3D laser show-equipped -usage screen w/ ./build.sh -h or a hungry lion might eat you alive. - -A Midipix distribution consists of the following: -* the native Midipix toolchain, consisting of perk, gcc, its dependencies, - and binutils, -* musl, a lightweight, fast, simple, and free libc[1] used by Midipix, -* the Midipix runtime components that bridge the gap between the libc and the - executive subsystems of all Windows NT-derived Windows OS starting with and - including Windows XP, and -* a steadily increasing number of 3rd party open source packages, as expected in - any modern POSIX-compliant \*nix environment, including GNU coreutils, shells, - libraries such as ncurses, libressl, as well as Perl and Python. - -## Build-time dependencies -* **Alpine Linux**: binutils bzip2 cmake coreutils curl findutils g++ gawk gcc git grep gzip libc-dev linux-headers lzip make musl-dev net-tools patch perl perl-xml-parser procps sed tar util-linux wget xz zip -* **Debian/-derived Linux**: binutils bzip2 clzip cmake coreutils curl findutils g++ gawk gcc git grep gzip hostname libc6-dev libxml-parser-perl lzma make patch perl procps sed tar util-linux wget xz-utils zip -* **OpenSUSE Linux**: binutils bzip2 cmake coreutils curl findutils gawk gcc gcc-c++ git grep gzip hostname linux-glibc-devel lzip make patch perl perl-XML-Parser procps sed tar util-linux wget xz zip - -> N.B. Busybox is not supported. - -> N.B. Some packages (*coreutils*, *grep*, and *tar*, among others) override -Alpine's BusyBox utilities of the same name, as the latter are either non- -conformant or defective. - -## Building a midipix distribution -Install the above listed build-time dependencies, clone this repository, and run the -following command line within the latter: - -```shell -./build.sh -a nt64 -b release -D minipix,zipdist -P -v -``` - -## Non-exhaustive list of build variables -The following variables are primarily defined in ``midipix.env`` and may be overriden -on a per-build basis on the command-line after the last argument, if any, e.g.: - -```shell -./build.sh -a nt64 -b release -D minipix,zipdist -P -v PREFIX_ROOT="${HOME}/midipix_tmp" -``` - -Furthermore, ``${HOME}/midipix_build.vars``, ``${HOME}/.midipix_build.vars``, and/or -``../midipix_build.vars`` are sourced during build initialisation and may contain -additional overrides, particularly ``${DEFAULT_GITROOT_HEAD}``. - -| Variable name | Default value | Description | -| ---------------- | ------------------------------- | ----------------------------------------------------------------------------- | -| ARCH | nt64 | Target 32-bit (nt32) or 64-bit (nt64) architecture | -| BUILD | debug | Build w/ debugging (debug) or release compiler flags | -| BUILD_DLCACHEDIR | ${PREFIX_ROOT}/dlcache | Absolute pathname to package downloads cache root directory | -| BUILD_WORKDIR | ${PREFIX}/tmp | Absolute pathname to temporary package build root directory | -| PREFIX | ${PREFIX_ROOT}/${ARCH}/${BUILD} | Absolute pathname to architecture- & build type-specific build root directory | -| PREFIX_CROSS | ${PREFIX}/${DEFAULT_TARGET} | Absolute pathname to toolchain root directory | -| PREFIX_MINGW32 | ${PREFIX}/x86_64-w64-mingw32 | Absolute pathname to MinGW toolchain root directory | -| PREFIX_MINIPIX | ${PREFIX}/minipix | Absolute pathname to minipix distribution root directory | -| PREFIX_NATIVE | ${PREFIX}/native | Absolute pathname to cross-compiled packages root directory | -| PREFIX_ROOT | ${HOME}/midipix | Absolute pathname to top-level directory | -| PREFIX_RPM | ${PREFIX}/rpm | Absolute pathname to package RPM archive root directory | - -## Common tasks -Rebuild set of packages in isolation, along w/ their dependencies, if any, as needed, -or forcibly, respectively: -```shell -./build.sh [ ... ] -r mc,zsh -./build.sh [ ... ] -r \*mc,zsh -./build.sh [ ... ] -r \*\*mc,zsh -``` - -Rebuild entire build group: -```shell -./build.sh [ ... ] -r ALL native_runtime -``` - -## References -* ``Sun, 25 Apr 2016 09:04:08 +0000 [1]`` musl FAQ - -vim:tw=0 -- cgit v1.2.3