I think I have implemented most suggestions in PatchV2. Thanks!
I am not sure if we want to repeat this all over the place.
We do not say "For details about the <commit> syntax, see the
'SPECIFYING REVISIONS' section of linkgit:git-rev-parse[1]" for
every command that takes <commit> from the command line.
Is your urge to suggest adding this sentence coming from that you
are much more familiar with <commit> than <pathspec>? In other
words, if you were more familiar with Git, would you still be adding
this (and not corresponding one for <commit>)?
Commit is a well known term, dating from ancient times like CVS or even
older.
Pathspec, however, is something new. When I pretend to be someone new to
git, I see it this way:
1) Let's read "git commit" documentation
2) Where on this commandline do I put my filename?!
So yes, I would repeat it in every location that could be popular for
new users.