From 75dc47157e2c4c4f76d53fc65ccef707a8201de5 Mon Sep 17 00:00:00 2001
From: Pushkinist <4850452+Pushkinist@users.noreply.github.com>
Date: Thu, 18 Jun 2026 09:29:35 +0700
Subject: [PATCH] docs: add 'brew trust' step to Homebrew install instructions

Recent Homebrew versions refuse to load formulae from untrusted third-party
taps; a fresh 'brew install rmlx' fails with 'Refusing to load formula ...
from untrusted tap' until 'brew trust Pushkinist/rmlx' is run once. Add the
step to README and RELEASING so new users (and the release verify path) don't
trip on it.
---
 README.md         | 1 +
 docs/RELEASING.md | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/README.md b/README.md
index 4427e37..9e2cef4 100644
--- a/README.md
+++ b/README.md
@@ -96,6 +96,7 @@ less install.sh && bash install.sh
 
 ```sh
 brew tap Pushkinist/rmlx
+brew trust Pushkinist/rmlx   # one-time: Homebrew now requires explicitly trusting third-party taps
 brew install rmlx
 ```
 
diff --git a/docs/RELEASING.md b/docs/RELEASING.md
index c781925..86eabba 100644
--- a/docs/RELEASING.md
+++ b/docs/RELEASING.md
@@ -110,10 +110,14 @@ cosign verify-blob \
 **Homebrew (build from source):**
 ```sh
 brew tap Pushkinist/rmlx
+brew trust Pushkinist/rmlx   # one-time: Homebrew refuses to load formulae from untrusted third-party taps
 brew install rmlx
 brew test rmlx
 rmlx --version
 ```
+> Recent Homebrew versions block third-party taps until trusted — a fresh
+> `brew install rmlx` fails with `Refusing to load formula … from untrusted tap`
+> until `brew trust Pushkinist/rmlx` is run once.
 
 Local formula check before publishing:
 ```sh