From be24bd5d7d5dbaac3d8a2d242830e0f969852112 Mon Sep 17 00:00:00 2001
From: Bruno Alexandre Rosa <1791393+brunoalr@users.noreply.github.com>
Date: Sat, 14 Mar 2026 17:33:42 -0300
Subject: [PATCH] add readme, improve comment

---
 utils/macos_fix_codesign.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/utils/macos_fix_codesign.sh b/utils/macos_fix_codesign.sh
index 6ff3305a4..38089c357 100755
--- a/utils/macos_fix_codesign.sh
+++ b/utils/macos_fix_codesign.sh
@@ -1,7 +1,11 @@
 #!/bin/bash
-# Fix code signing for unsigned macOS app bundles (mainly used to test packages from PRs on CI).
+# Fixes code signing for unsigned macOS app bundles. Use after installing an unsigned build (e.g. from a PR artifact) to `/Applications` so the apps can be opened without Gatekeeper blocking them.
 # Run from project root: ./utils/macos_fix_codesign.sh [path/to/app.app ...]
 #
+# Example usage:
+# ./utils/macos_fix_codesign.sh # fixes cockatrice, oracle, and servatrice in /Applications
+# ./utils/macos_fix_codesign.sh /Applications/cockatrice.app # fixes only cockatrice
+#
 # Steps:
 #   1. Remove quarantine extended attribute
 #   2. Ad-hoc sign all dylibs, frameworks and executables inside the bundle