openslide
Incomplete instructions for building for macOS
Instructions in README.md state building on macOS is simply "./bintool bdist" with "macOS SDK" installed.
This is insufficient. Python3 must be a recent version supporting 'Self' from module 'typing', and the most recent system version of Python (3.9) does not support this, so a recent Python (3.11+) is prerequisite. It is not "macOS SDK", it is "Command Line Tools for Xcode". Also, Meson and Ninja are not installed. And the build system requires pkg-config and glib-compile-resources, which are also not available on at least current Apple Silicon Macs. Build scripts and/or instructions should be updated accordingly.
macOS is in a bit of an awkward place because we can't provide a builder container image, unlike on the other platforms. We generally assume the tooling available in the GitHub Actions runner image, but we do indeed install a couple extra things. The documentation should absolutely be improved here.
