master 3d57553: Native compilation on macOS: libgccjit not found

[Eli Zaretskii]

branch: master
commit 3d575534d43802552f59eb1b990939cb3412d4e9
Author: Daniel Fleischer <danflscr@gmail.com>
Commit: Eli Zaretskii <eliz@gnu.org>

    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 f904187..42d714b 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