From 9d90ef29eb5094167c7e70e7f5e086ca529dc653 Mon Sep 17 00:00:00 2001
From: Mike McQuaid <mike@mikemcquaid.com>
Date: Mon, 7 Dec 2020 15:23:08 +0000
Subject: [PATCH] cmd/update: improve shallow clone message.

---
 Library/Homebrew/cmd/update.sh | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/Library/Homebrew/cmd/update.sh b/Library/Homebrew/cmd/update.sh
index c024047f4b..d557ad2f3d 100644
--- a/Library/Homebrew/cmd/update.sh
+++ b/Library/Homebrew/cmd/update.sh
@@ -390,23 +390,29 @@ EOS
     fi
   fi
 
-  # Homebrew/homebrew-core is extremely expensive to perform shallow clones on
-  # so, on GitHub's request, don't allow it.
   if [[ -f "$HOMEBREW_LIBRARY/Taps/homebrew/homebrew-core/.git/shallow" ]]
   then
     odie <<EOS
 homebrew-core is a shallow clone. To \`brew update\` first run:
   git -C "$HOMEBREW_LIBRARY/Taps/homebrew/homebrew-core" fetch --unshallow
+This restriction has been made on GitHub's request because updating shallow
+clones is an extremely expensive operation due to the tree layout and traffic of
+Homebrew/homebrew-core. We don't do this for you automatically to avoid
+repeatedly performing an expensive unshallow operation in CI systems (which
+should instead be fixed to not use shallow clones). Sorry for the inconvenience!
 EOS
   fi
 
-  # Homebrew/homebrew-cask is also extremely expensive to perform shallow clones
-  # on so, on GitHub's request, don't allow it.
   if [[ -f "$HOMEBREW_LIBRARY/Taps/homebrew/homebrew-cask/.git/shallow" ]]
   then
     odie <<EOS
 homebrew-cask is a shallow clone. To \`brew update\` first run:
   git -C "$HOMEBREW_LIBRARY/Taps/homebrew/homebrew-cask" fetch --unshallow
+This restriction has been made on GitHub's request because updating shallow
+clones is an extremely expensive operation due to the tree layout and traffic of
+Homebrew/homebrew-cask. We don't do this for you automatically to avoid
+repeatedly performing an expensive unshallow operation in CI systems (which
+should instead be fixed to not use shallow clones). Sorry for the inconvenience!
 EOS
   fi