From 3d575534d43802552f59eb1b990939cb3412d4e9 Mon Sep 17 00:00:00 2001
From: Daniel Fleischer <danflscr@gmail.com>
Date: Sun, 19 Sep 2021 00:17:49 +0300
Subject: [PATCH] Native compilation on macOS: libgccjit not found

* etc/PROBLEMS: Describe the problem with libgccjit setup on
macOS.  (Bug#50411)
---
 etc/PROBLEMS | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index f90418798d8..42d714bf1e7 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -2671,6 +2671,24 @@ something like the following in your init file:
 
 (push "\\`-[^-]*-monaco-bold-" face-ignored-fonts)
 
+** Native Compilation on macOS
+
+Native complitation requires the libgccjit library to be installed and
+its path available to Emacs.  Errors such as:
+
+    libgccjit.so: error: error invoking gcc driver
+    Error: Internal native compiler error failed to compile
+
+indicate Emacs can't find the library in running time.  One can set
+the "LIBRARY_PATH" environment variable in the early initalization
+file; for example:
+
+(setenv "LIBRARY_PATH"
+  (string-join
+    '("/usr/local/opt/gcc/lib/gcc/11"
+      "/usr/local/opt/libgccjit/lib/gcc/11"
+      "/usr/local/opt/gcc/lib/gcc/11/gcc/x86_64-apple-darwin20/11.2.0") ":"))
+
 * Build-time problems
 
 ** Configuration
-- 
2.39.5