From 4632b9d086a7a85cc501cca9284cac9ced17b121 Mon Sep 17 00:00:00 2001
From: Landon Curt Noll <github-mail@asthe.com>
Date: Sun, 17 Mar 2024 12:48:10 -0700
Subject: [PATCH] improve message to macOS users with a too old bash version

---
 bin/all-run.sh                | 6 +++---
 bin/all-years.sh              | 6 +++---
 bin/chk-entry.sh              | 6 +++---
 bin/gen-authors.sh            | 6 +++---
 bin/gen-location.sh           | 6 +++---
 bin/gen-other-html.sh         | 6 +++---
 bin/gen-sitemap.sh            | 6 +++---
 bin/gen-status.sh             | 6 +++---
 bin/gen-top-html.sh           | 6 +++---
 bin/gen-year-index.sh         | 6 +++---
 bin/gen-years.sh              | 6 +++---
 bin/md2html.sh                | 6 +++---
 bin/output-index-author.sh    | 6 +++---
 bin/output-index-inventory.sh | 6 +++---
 bin/output-year-index.sh      | 6 +++---
 bin/pandoc-wrapper.sh         | 6 +++---
 bin/quick-readme2index.sh     | 6 +++---
 bin/readme2index.sh           | 6 +++---
 bin/sort.gitignore.sh         | 6 +++---
 bin/status2html.sh            | 6 +++---
 bin/subst.default.sh          | 6 +++---
 bin/subst.entry-index.sh      | 6 +++---
 bin/subst.year-index.sh       | 6 +++---
 bin/tar-all.sh                | 6 +++---
 bin/tar-entry.sh              | 6 +++---
 bin/tar-year.sh               | 6 +++---
 26 files changed, 78 insertions(+), 78 deletions(-)

diff --git a/bin/all-run.sh b/bin/all-run.sh
index 8525d1e22..fa122f499 100755
--- a/bin/all-run.sh
+++ b/bin/all-run.sh
@@ -90,9 +90,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/all-years.sh b/bin/all-years.sh
index 9869e7946..ba6599a30 100755
--- a/bin/all-years.sh
+++ b/bin/all-years.sh
@@ -89,9 +89,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/chk-entry.sh b/bin/chk-entry.sh
index 239382708..ce75445d7 100755
--- a/bin/chk-entry.sh
+++ b/bin/chk-entry.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-authors.sh b/bin/gen-authors.sh
index 1f1dbaa88..30cc39cfb 100755
--- a/bin/gen-authors.sh
+++ b/bin/gen-authors.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-location.sh b/bin/gen-location.sh
index 920f71e05..8421e513d 100755
--- a/bin/gen-location.sh
+++ b/bin/gen-location.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-other-html.sh b/bin/gen-other-html.sh
index f3e317e37..496a777b2 100755
--- a/bin/gen-other-html.sh
+++ b/bin/gen-other-html.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-sitemap.sh b/bin/gen-sitemap.sh
index ecf65f1a7..c55707e1d 100755
--- a/bin/gen-sitemap.sh
+++ b/bin/gen-sitemap.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-status.sh b/bin/gen-status.sh
index fcf78a1c0..fd369f585 100755
--- a/bin/gen-status.sh
+++ b/bin/gen-status.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-top-html.sh b/bin/gen-top-html.sh
index bedcfb574..f75143b10 100755
--- a/bin/gen-top-html.sh
+++ b/bin/gen-top-html.sh
@@ -65,9 +65,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-year-index.sh b/bin/gen-year-index.sh
index 569e09954..64018d676 100755
--- a/bin/gen-year-index.sh
+++ b/bin/gen-year-index.sh
@@ -63,9 +63,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/gen-years.sh b/bin/gen-years.sh
index c0b310898..62ea0db05 100755
--- a/bin/gen-years.sh
+++ b/bin/gen-years.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/md2html.sh b/bin/md2html.sh
index 49d213743..e04b2e402 100755
--- a/bin/md2html.sh
+++ b/bin/md2html.sh
@@ -113,9 +113,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/output-index-author.sh b/bin/output-index-author.sh
index aea3d11e1..d00c5db6a 100755
--- a/bin/output-index-author.sh
+++ b/bin/output-index-author.sh
@@ -67,9 +67,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/output-index-inventory.sh b/bin/output-index-inventory.sh
index 3391f699f..bf882e08c 100755
--- a/bin/output-index-inventory.sh
+++ b/bin/output-index-inventory.sh
@@ -67,9 +67,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/output-year-index.sh b/bin/output-year-index.sh
index 27e35d3e0..360bdc0a6 100755
--- a/bin/output-year-index.sh
+++ b/bin/output-year-index.sh
@@ -68,9 +68,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/pandoc-wrapper.sh b/bin/pandoc-wrapper.sh
index 53ef3537d..0e0f7b8c9 100755
--- a/bin/pandoc-wrapper.sh
+++ b/bin/pandoc-wrapper.sh
@@ -68,9 +68,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/quick-readme2index.sh b/bin/quick-readme2index.sh
index 505ec587c..5fbd5b693 100755
--- a/bin/quick-readme2index.sh
+++ b/bin/quick-readme2index.sh
@@ -70,9 +70,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/readme2index.sh b/bin/readme2index.sh
index d6c82b859..1cd600f25 100755
--- a/bin/readme2index.sh
+++ b/bin/readme2index.sh
@@ -64,9 +64,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/sort.gitignore.sh b/bin/sort.gitignore.sh
index bb1ff54c1..262f0be8e 100755
--- a/bin/sort.gitignore.sh
+++ b/bin/sort.gitignore.sh
@@ -76,9 +76,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/status2html.sh b/bin/status2html.sh
index ecfd06da2..1f347f61e 100755
--- a/bin/status2html.sh
+++ b/bin/status2html.sh
@@ -65,9 +65,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/subst.default.sh b/bin/subst.default.sh
index a44f66bc9..bdef4e2f8 100755
--- a/bin/subst.default.sh
+++ b/bin/subst.default.sh
@@ -70,9 +70,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/subst.entry-index.sh b/bin/subst.entry-index.sh
index a5ab0100d..5dde32ae0 100755
--- a/bin/subst.entry-index.sh
+++ b/bin/subst.entry-index.sh
@@ -70,9 +70,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/subst.year-index.sh b/bin/subst.year-index.sh
index e68725866..c43a50867 100755
--- a/bin/subst.year-index.sh
+++ b/bin/subst.year-index.sh
@@ -70,9 +70,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/tar-all.sh b/bin/tar-all.sh
index 244a29c13..b571fd9d0 100755
--- a/bin/tar-all.sh
+++ b/bin/tar-all.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/tar-entry.sh b/bin/tar-entry.sh
index 8465c2d0b..58866e01c 100755
--- a/bin/tar-entry.sh
+++ b/bin/tar-entry.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi
 
diff --git a/bin/tar-year.sh b/bin/tar-year.sh
index 782cbcfef..a0071d89f 100755
--- a/bin/tar-year.sh
+++ b/bin/tar-year.sh
@@ -61,9 +61,9 @@ if [[ -z ${BASH_VERSINFO[0]} ||
 	 ${BASH_VERSINFO[0]} -eq 5 && ${BASH_VERSINFO[1]} -eq 1 && ${BASH_VERSINFO[1]} -lt 8 ]]; then
     echo "$0: ERROR: bash version needs to be >= 5.1.8: $BASH_VERSION" 1>&2
     echo "$0: Warning: bash version >= 4.2 might work but 5.1.8 was the minimum we tested" 1>&2
-    echo "$0: Notice: For macOS users, install homebrew (see https://brew.sh)," \
-	 "then install homebrew bash (usually in /opt/homebrew/bin/bash)," \
-	 "and then arrange \$PATH so that /opt/homebrew/bin is ahead of /bin" 1>&2
+    echo "$0: Notice: For macOS users: install homebrew (see https://brew.sh)," \
+	 "then install homebrew bash, and then modify your \$PATH so that \"#!/usr/bin/env bash\"" \
+	 "finds the homebrew installed (usually /opt/homebrew/bin/bash) version of bash" 1>&2
     exit 4
 fi