結論
まずは、homebrewのトラブルシューティング機能で自己診断する。
（この記事を見ている段階で、困ってweb検索しているかもしれないが・・・）
具体的なコマンドは下記の通り。
comand
user@host ~ % brew doctor
実際に経験したトラブル（エラー事例）
brew update を実行したら、いつもと違うメッセージが・・・
fatal: revision walk setup failed.
error: https://github.com/Homebrew/homebrew-cask did not send all necessary objects
いざ、トラブルシューティング！！（事例）
brew doctor コマンドを発行すると、今回は原因と修復の手順が示された。
（ちなみ、その手順を実行することで、すぐに修復できた）
user@host ~ % brew doctor
Please note that these warnings are just used to help the Homebrew maintainers
with debugging if you file an issue. If everything you use Homebrew for is
working fine: please don't worry or file an issue; just ignore this. Thanks!
Warning: The following directories do not exist:
/usr/local/sbin
You should create these directories and change their ownership to your user.
sudo mkdir -p /usr/local/sbin
sudo chown -R $(whoami) /usr/local/sbin
Warning: You have an unnecessary local Cask tap.
This can cause problems installing up-to-date casks.
Please remove it by running:
brew untap homebrew/cask
Warning: You have an unnecessary local Core tap!
This can cause problems installing up-to-date formulae.
Please remove it by running:
brew untap homebrew/core
あとがき
- 多くの場合、トラブルが発生するとすぐにgoogle検索などで調べるという行為に走りがちであるが、もともとトラブルシューティング機能がプログラムについているなら、まずはそれを試すのが妥当だろう。
- 検索で引っかかってくる玉石混交の情報を精査するにも時間がかかる。また、homebrewのトラブルシューティング機能の方が安全性（信頼性）も高いと思われる。
- 無論これはhomebrew自体は動作することが前提であるし、homebrewのトラブルシューティング機能では解決できない事もあるだろう。
- 実のところ、上記のことは自戒を込めて書いている。初手でgoogle検索したものの、出てくる解決方法がいまいち違う気がしていた。その時、自己診断機能みたいのながあったような気がと・・・ふと思い出し、homebrewのヘルプを参照し、そこから今回の問題の解決に至った。というのがことの顛末だったりする。