From 5b0f395bf9b3cf42add248a6f03a3283d5182094 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Asger=20Geel=20Weirs=C3=B8e?= <cla@weircon.dk>
Date: Wed, 6 May 2026 20:21:55 +0200
Subject: [PATCH] docs: clarify PAM config is a file entry; add uninstall
 instructions

---
 Formula/ahfail.rb | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/Formula/ahfail.rb b/Formula/ahfail.rb
index 5c74455..4139165 100644
--- a/Formula/ahfail.rb
+++ b/Formula/ahfail.rb
@@ -32,12 +32,15 @@ class Ahfail < Formula
       "/etc/pam.d/screensaver"
     end
     <<~EOS
-      Add this line to #{pam_file} after the existing auth entries (requires sudo):
+      To activate, add this line to #{pam_file} after the existing auth entries
+      (requires sudo — this is a config file entry, not a shell command):
 
         auth optional #{lib}/ahfail/libahfail_pam.so
 
-      After upgrading ahfail, re-run `brew install ahfail` and update the path
-      in #{pam_file} if it changed.
+      To uninstall cleanly, remove that line before running `brew uninstall ahfail`:
+
+        sudo sed -i '' '/ahfail/d' #{pam_file}
+        brew uninstall ahfail
     EOS
   end