update README (#5)
- remove mentions of wine and aarch64 - contributions are now straightforward - update maintainers (do we need this section at all?)
This commit is contained in:
parent
3f4b4ef88e
commit
95ee5b0d3a
67
README.md
67
README.md
@ -381,20 +381,7 @@ This repository is used on the following (host) platforms:
|
|||||||
- `darwin_arm64`, the M1.
|
- `darwin_arm64`, the M1.
|
||||||
- `windows_amd64`, a.k.a. `x64`.
|
- `windows_amd64`, a.k.a. `x64`.
|
||||||
|
|
||||||
The tests are running (CId) on linux-amd64, and are assuming the kernel is
|
The tests are running (CId) on linux-amd64.
|
||||||
configured to run `linux_arm64` and `windows_amd64` binaries.
|
|
||||||
|
|
||||||
There are two reasonably convenient ways to configure `linux_arm64` emulation:
|
|
||||||
|
|
||||||
1. Install and configure [`binfmt_misc`][binfmt_misc]:
|
|
||||||
```
|
|
||||||
apt install qemu-user-static binfmt-support
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Magic of the internet:
|
|
||||||
```
|
|
||||||
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
|
|
||||||
```
|
|
||||||
|
|
||||||
## Transient docker environment
|
## Transient docker environment
|
||||||
|
|
||||||
@ -402,44 +389,17 @@ A standalone Docker environment to play with bazel-zig-cc:
|
|||||||
|
|
||||||
```
|
```
|
||||||
$ docker run -e CC=/usr/bin/false -ti --rm -v "$PWD:/x" -w /x debian:bullseye-slim
|
$ docker run -e CC=/usr/bin/false -ti --rm -v "$PWD:/x" -w /x debian:bullseye-slim
|
||||||
# apt update
|
# apt update && apt install --no-install-recommends -y shellcheck ca-certificates python3
|
||||||
# apt install --no-install-recommends -y direnv git shellcheck ca-certificates
|
|
||||||
# eval "$(direnv hook bash)" && direnv allow
|
|
||||||
# ./ci/lint
|
# ./ci/lint
|
||||||
# ./ci/launcher
|
# ./ci/launcher
|
||||||
# ./ci/test
|
# ./ci/test
|
||||||
```
|
```
|
||||||
|
|
||||||
Some of the tests rely on `qemu-aarch64` to run arm64 binaries and wine for
|
# Communication
|
||||||
Windows binaries. Therefore, with the setup above, these tests will fail.
|
|
||||||
To install *all* dependencies, so all tests can pass:
|
|
||||||
|
|
||||||
```
|
We maintain two channels for comms:
|
||||||
$ docker run -e CC=/usr/bin/false -ti --rm -v "$PWD:/x" -w /x debian:bullseye-slim
|
- Github issues and pull requests.
|
||||||
# dpkg --add-architecture arm64 && apt update
|
- Slack: `#zig` in bazel.slack.com.
|
||||||
# apt install --no-install-recommends -y direnv git shellcheck ca-certificates libc6:arm64 qemu-user-static wine64
|
|
||||||
# eval "$(direnv hook bash)" && direnv allow
|
|
||||||
<... run the ci/ commands as above>
|
|
||||||
```
|
|
||||||
|
|
||||||
# Questions & Contributions
|
|
||||||
|
|
||||||
Project's mailing list is [~motiejus/bazel-zig-cc@lists.sr.ht][mailing-list].
|
|
||||||
Used for:
|
|
||||||
|
|
||||||
- announcements (I am aiming to send an email with every release).
|
|
||||||
- user discussions.
|
|
||||||
- raising issues.
|
|
||||||
- contributions.
|
|
||||||
|
|
||||||
I will generally respond to emails about issues. I may even be able to fix
|
|
||||||
them. However, no promises: you are much more likely (and welcome!) to get it
|
|
||||||
fixed by submitting a patch.
|
|
||||||
|
|
||||||
To contribute, send your patches to the mailing list, as described in
|
|
||||||
[git-send-email.io][git-send-email] or via [Sourcehut web UI][video].
|
|
||||||
|
|
||||||
Copyright is retained by the contributors.
|
|
||||||
|
|
||||||
# Maintainers
|
# Maintainers
|
||||||
|
|
||||||
@ -447,14 +407,9 @@ This section lists the driving forces behind bazel-zig-cc. Committers have push
|
|||||||
access, maintainers have their areas. Should make it easier to understand our
|
access, maintainers have their areas. Should make it easier to understand our
|
||||||
interests when reading patches or mailing lists.
|
interests when reading patches or mailing lists.
|
||||||
|
|
||||||
- Owner: Motiejus Jakštys. Applies others' patches, writes documentation,
|
- Maintainers: Motiejus Jakštys, Laurynas Lubys, Zhongpeng Lin and Sung Yoon
|
||||||
emails, and occasionally contributes. Signs releases.
|
Whang.
|
||||||
- Committer: Laurynas Lubys. Bazel expert with regards to tests, transitions
|
- Committer for Windows: Fabian Hahn. If you make a change that breaks
|
||||||
and overall structure. Rewrote bazel-zig-cc to cater for platforms when libc
|
|
||||||
platforms were added.
|
|
||||||
- Committer: Ken Micklas. Ken was leading hermetic toolchain effort at Uber
|
|
||||||
throughout 2022, of which bazel-zig-cc is a part of.
|
|
||||||
- Maintainer for Windows: Fabian Hahn. If you make a change that breaks
|
|
||||||
Windows, Fabian will find you. Please don't break Windows, so Fabian doesn't
|
Windows, Fabian will find you. Please don't break Windows, so Fabian doesn't
|
||||||
have to look for you. Instead, send him your patches first.
|
have to look for you. Instead, send him your patches first.
|
||||||
|
|
||||||
@ -486,11 +441,7 @@ the issues promptly.
|
|||||||
|
|
||||||
[^1]: a [mathematical subset][subset]: both can be equal.
|
[^1]: a [mathematical subset][subset]: both can be equal.
|
||||||
|
|
||||||
[binfmt_misc]: https://en.wikipedia.org/wiki/Binfmt_misc
|
|
||||||
[mailing-list]: https://lists.sr.ht/~motiejus/bazel-zig-cc
|
|
||||||
[ajbouh]: https://github.com/ajbouh/bazel-zig-cc/
|
[ajbouh]: https://github.com/ajbouh/bazel-zig-cc/
|
||||||
[git-send-email]: https://git-send-email.io/
|
|
||||||
[video]: https://spacepub.space/w/no6jnhHeUrt2E5ST168tRL
|
|
||||||
[sysroot]: https://github.com/ziglang/zig/issues/10299#issuecomment-989153750
|
[sysroot]: https://github.com/ziglang/zig/issues/10299#issuecomment-989153750
|
||||||
[ubsan1]: https://github.com/ziglang/zig/issues/4830#issuecomment-605491606
|
[ubsan1]: https://github.com/ziglang/zig/issues/4830#issuecomment-605491606
|
||||||
[ubsan2]: https://github.com/ziglang/zig/issues/5163
|
[ubsan2]: https://github.com/ziglang/zig/issues/5163
|
||||||
|
Loading…
Reference in New Issue
Block a user