Skip to main content

Maintainer's Guide

GitHub issues GitHub pulls

note

Work in progress.

Clone​

To clone the repo with its submodule:

rm -rf ~/Work/xpack-build-box.git; \
git clone \
  --branch master \
  https://github.com/xpack/xpack-build-box.git \
  ~/Work/xpack-build-box.git; \
git -C ~/Work/xpack-build-box.git submodule update --init --recursive

For the development version use the develop branch:

rm -rf ~/Work/xpack-build-box.git; \
git clone \
  --branch develop \
  https://github.com/xpack/xpack-build-box.git \
  ~/Work/xpack-build-box.git; \
git -C ~/Work/xpack-build-box.git submodule update --init --recursive

To do a quick update:

git -C ~/Work/xpack-build-box.git pull

TeX​

TeX support was removed.

TeX 2019 failed on AArch64 with a CRC error.

TeX 2020 and 2021 failed with:

re-running mktexlsr /opt/texlive/texmf-var /opt/texlive/texmf-config ...
setting up ConTeXt cache: running mtxrun --generate .../root/Work/install-tl-20210324/install-tl: mtxrun --generate failed (status 1):
failed
pre-generating all format files, be patient...
running fmtutil-sys --no-error-if-no-engine=luajithbtex,luajittex,mfluajit --no-strict --all ...done
running package-specific postactions

/root/Work/install-tl-20210324/install-tl: errors in installation reported above

Summary of warnings:
/root/Work/install-tl-20210324/install-tl: mtxrun --generate failed (status 1):
finished with package-specific postactions

TeX 2021 installer also complains if environment variables contain tex:

Summary of warnings:
/root/Work/install-tl-20210324/install-tl: mtxrun --generate failed (status 1):

 ----------------------------------------------------------------------
 The following environment variables contain the string "tex"
 (case-independent).  If you're doing anything but adding personal
 directories to the system paths, they may well cause trouble somewhere
 while running TeX.  If you encounter problems, try unsetting them.
 Please ignore spurious matches unrelated to TeX.

    XBB_LAYER=tex
 ----------------------------------------------------------------------

TODO​

Things to be considered for future versions:

  • add gdb (for macOS)
  • add doxygen
  • cleanup man folder
  • investigate why isl_test_cpp fails
  • gnutls requires several other libs
  • gnutls certificates folder

Maybe

  • build nodejs

Fixed

  • use patchelf 0.12 (in v3.3)
  • use automake 1.16.2 (in v3.3)
  • -D_FILE_OFFSET_BITS=64 for 32-bit machine
  • libtool to use xbb gcc, not bootstrap
  • rename gcc-xbb, gcc-xbs
  • link gcc, cc, g++, c++
  • add objc, objc++, fortran support to gcc
  • build Python 3 in bootstrap
  • guille (1 test disabled)
  • autogen (1 test disabled)
  • add bash

Current status​

XBB v5.0.0 and up are more modular, using binary xPacks.

GNU/Linux​

There will be 3 Docker images (no i386) with Ubuntu 18.04 LTS, basic development tools and node/npm.

The toolchains and other tools will be installed as binary xPacks.

macOS​

For macOS the only prerequisite is the Command Line Tools (CLT) package.

realpath is provided as a separate binary xPack.

Future work​

When node 18.x will be needed, the base system must be upgraded to GLIBC 2.28, which is available since Debian 10.

The scripts to create Debian 10 Docker images are already added.