summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/source/user/building.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/source/user/building.rst b/doc/source/user/building.rst
index d2608f357..3e775ea8a 100644
--- a/doc/source/user/building.rst
+++ b/doc/source/user/building.rst
@@ -163,6 +163,12 @@ will prefer to use ATLAS, then OpenBLAS and as a last resort MKL.
If neither of these exists the build will fail (names are compared
lower case).
+The native libraries on macOS, provided by Accelerate, are not fit for use
+in NumPy since they have bugs that cause wrong output under easily reproducable
+conditions. If the vendor fixes those bugs, the library could be reinstated,
+but until then users compiling for themselves should use another linear
+library or use the built-in (but slower) default, see the next section.
+
Disabling ATLAS and other accelerated libraries
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~