From e7977b8c495de1b4a77c2170e7f04260fc59d3ef Mon Sep 17 00:00:00 2001 From: Alyssa Rosenzweig Date: Sat, 10 Apr 2021 07:44:14 +0530 Subject: docs: Add some notes on building for macOS I intend this page to grow as I explore more about Mesa/Darwin. Signed-off-by: Alyssa Rosenzweig Part-of: --- docs/macos.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 docs/macos.rst (limited to 'docs/macos.rst') diff --git a/docs/macos.rst b/docs/macos.rst new file mode 100644 index 00000000000..fa7e0d471e3 --- /dev/null +++ b/docs/macos.rst @@ -0,0 +1,17 @@ +Notes for macOS +================ + +Mesa builds on macOS without modifications. However, there are some details to +be aware of. + +- Mesa has a number of build-time dependencies. Most dependencies, including + Meson itself, are available in `homebrew `, which has a + Mesa package for reference. The exception seems to be Mako, a Python module + used for templating, which you can install as `pip3 install mako`. +- macOS's default C compiler doesn't play nice with some C11 idioms used in + Mesa. To workaround, set `-Dc_std=c11`. +- macOS is picky about its build-time environment. Type `brew sh` before + building to get the Homebrew dependencies in your path. + +At the moment, only the software rasterizers are supported on macOS. Stay tuned +for updates here! -- cgit v1.2.3