Thanks. This is going to be so useful, but it pains me to know I could have been using —update-refs for the last three years.
I used to dutifully read release notes for every git release, but stopped at some point. Apparently that point was more than three years ago.
discoverability is a big problem, especially for CLI tools which can't afford to show small hints or "what's new" popups. I myself learned it from someone else, not docs.