diff options
| -rw-r--r-- | README.md | 4 | ||||
| -rw-r--r-- | docs/qemu-test-matrix.md | 3 | ||||
| -rw-r--r-- | docs/testing.md | 12 |
3 files changed, 17 insertions, 2 deletions
@@ -26,6 +26,10 @@ bun ./bin/bnu.js --help bun ./bin/bnu.js COMMAND --help ``` +The GNU compatibility harness also needs the coreutils 9.11 source tarball, +which is not stored in Git. See [Testing](docs/testing.md#gnu-command-tests) for +the download command. + ## Command wrappers The CLI can generate command-name wrappers for use in a separate directory: diff --git a/docs/qemu-test-matrix.md b/docs/qemu-test-matrix.md index 0632ba0..90448b7 100644 --- a/docs/qemu-test-matrix.md +++ b/docs/qemu-test-matrix.md @@ -42,6 +42,9 @@ scripts/setup-qemu-environments.sh --dry-run scripts/run-gnu-qemu-matrix.sh --dry-run ``` +The matrix payload also requires `coreutils-9.11.tar.xz` in the repository +root. Follow the download instructions in [Testing](testing.md#gnu-command-tests). + There is no software-emulation fallback. The scripts require KVM and use `-cpu host`. diff --git a/docs/testing.md b/docs/testing.md index 0f6b89e..0610995 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -31,8 +31,16 @@ BNU_FACTOR_WORKERS=2 \ ## GNU command tests -The repository includes `coreutils-9.11.tar.xz` and a harness that extracts -and adapts its command tests to invoke BNU. +The source tarball is ignored by Git. Download +[GNU coreutils 9.11](https://ftp.gnu.org/gnu/coreutils/coreutils-9.11.tar.xz) +into the repository root before using the harness: + +```sh +curl -fL https://ftp.gnu.org/gnu/coreutils/coreutils-9.11.tar.xz \ + -o coreutils-9.11.tar.xz +``` + +The harness extracts the tarball and adapts its command tests to invoke BNU. With no paths, the harness runs a maintained default selection: |
