diff --git a/docs/markdown/snippets/b_lundef_on_apple.md b/docs/markdown/snippets/b_lundef_on_apple.md
new file mode 100644
index 000000000..850a412c8
--- /dev/null
+++ b/docs/markdown/snippets/b_lundef_on_apple.md
@@ -0,0 +1,5 @@
+## Meson's builtin b_lundef is now supported on macOS
+
+This has always been possible, but there are some addtional restrictions on
+macOS (mainly do to Apple only features). With the linker internal
+re-architecture this has become possible
\ No newline at end of file