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 development branch:

rm -rf ~/Work/xpack-build-box.git; \
git clone \
  --branch development \
  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 xpm packages.

GNU/Linux​

There are two Docker images (x64 and arm64) with Debian 10, basic development tools and node/npm.

The toolchains and other tools are installed as binary xpm development dependencies.

macOS​

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

realpath is provided as a separate binary xpm package.

tree is compiled from sources; in the future it should be a separate xpm package.

Future work​

The current Debian 10 base is expected to last 1-2 years.

The next major moment might be 2027, when RedHat 9 will enter extended support.

The next probable upgrade will be to Debian 11; however, the date for this upgrade remains to be decided.