From 75c5769e7550e42964d5f8fdee27e2395ea032bd Mon Sep 17 00:00:00 2001
From: Adrian Ho <aho+bruteforce@03s.net>
Date: Thu, 15 Sep 2022 21:51:27 +0800
Subject: [PATCH] shellenv: add explanatory MANPATH comment

Resolves #13867 and (hopefully) future attempts to correct the intended functionality.
---
 Library/Homebrew/cmd/shellenv.sh | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Library/Homebrew/cmd/shellenv.sh b/Library/Homebrew/cmd/shellenv.sh
index 97c630e470..a19a2223d5 100644
--- a/Library/Homebrew/cmd/shellenv.sh
+++ b/Library/Homebrew/cmd/shellenv.sh
@@ -9,6 +9,8 @@
 
 # HOMEBREW_CELLAR and HOMEBREW_PREFIX are set by extend/ENV/super.rb
 # HOMEBREW_REPOSITORY is set by bin/brew
+# Trailing colon in MANPATH adds default man dirs to search path in Linux, does no harm in macOS.
+# Please do not submit PRs to remove it!
 # shellcheck disable=SC2154
 homebrew-shellenv() {
   if [[ "${HOMEBREW_PATH%%:"${HOMEBREW_PREFIX}"/sbin*}" == "${HOMEBREW_PREFIX}/bin" ]]