summaryrefslogtreecommitdiff
path: root/docs/macos.rst
diff options
context:
space:
mode:
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>2021-04-10 07:44:14 +0530
committerMarge Bot <eric+marge@anholt.net>2021-04-13 19:09:13 +0000
commite7977b8c495de1b4a77c2170e7f04260fc59d3ef (patch)
treeebec54cffae0f034ac42ab9b2e92d271ce2fb7d9 /docs/macos.rst
parentb6a28aaa8bacebf0ff78f2d811a80d3e77a8ef3a (diff)
downloadmesa-e7977b8c495de1b4a77c2170e7f04260fc59d3ef.tar.gz
mesa-e7977b8c495de1b4a77c2170e7f04260fc59d3ef.tar.bz2
mesa-e7977b8c495de1b4a77c2170e7f04260fc59d3ef.zip
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 <alyssa@rosenzweig.io> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10152>
Diffstat (limited to 'docs/macos.rst')
-rw-r--r--docs/macos.rst17
1 files changed, 17 insertions, 0 deletions
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 <https://brew.sh>`, 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!