> the help text in every ‘git status’ message explicitly states to use ‘restore’ Good point. This makes no sense. There should either be a warning in the docum

> the help text in every ‘git status’ message explicitly states to use ‘restore’ Good point. This makes no sense. There should either be a warning in the documentation and `git status` should not recommend it, or there should not be a warning in the documentation and `git status` should recommend it. It’s either ready for use or not, it shouldn’t be inconsistent about it. I agree it’s a positive change, but the current state is ambiguous when it shouldn’t be. You don’t need the “weird -- flag” in most cases, by the way, it’s not Git to blame for that, and it’s the same for both checkout and restore. The `--` is the standard POSIX way to distinguish between options and filenames. If there’s no ambiguity (e.g. `git checkout .`) then you can skip it. You only need it if the pathspec could be interpreted as an option.