From 523a42e6f09c9a73219efa90960e1c90f5519619 Mon Sep 17 00:00:00 2001
From: Ailin Nemui <ailin@d5421s.localdomain>
Date: Mon, 4 Sep 2023 21:42:18 +0200
Subject: [PATCH] document meson apple workaround

workaround for https://github.com/mesonbuild/meson/issues/11165
---
 INSTALL                 | 8 ++++++++
 docs/meson-macos-ar.txt | 6 ++++++
 2 files changed, 14 insertions(+)
 create mode 100644 docs/meson-macos-ar.txt

diff --git a/INSTALL b/INSTALL
index 69bd6aa8..9c88325d 100644
--- a/INSTALL
+++ b/INSTALL
@@ -108,3 +108,11 @@ would call:
 Getting perl scripting to work needs a few things:
 
  - TODO
+
+
+ Apple MacOS / Darwin
+
+At the time of writing, meson has an open issue with correctly linking
+libraries on macos.
+
+See docs/meson-macos-ar.txt for a workaround.
diff --git a/docs/meson-macos-ar.txt b/docs/meson-macos-ar.txt
new file mode 100644
index 00000000..77e5cb8e
--- /dev/null
+++ b/docs/meson-macos-ar.txt
@@ -0,0 +1,6 @@
+;; manual workaround for meson bug https://github.com/mesonbuild/meson/issues/11165
+;; fixes compilation with meson on apple macos
+;; usage: meson --native-file ./docs/meson-macos-ar.txt ...
+
+[binaries]
+ar = ['/bin/sh', '-c', 'ar=${AR:-ar}; ranlib=${RANLIB:-ranlib -c -}; case "x$1" in xcsr*) $ar "$@" && $ranlib "$2" || exit $?; ;; *) exec $ar "$@"; ;; esac;', 'ar']