Junio C Hamano <gitster@xxxxxxxxx> writes: > The current state of affairs is that there is no remedy if teachers find > "git checkout -- path" or "git revert HEAD~24" is confusing to new people. > By introducing "git unstage path" or "git cherry-pick -r HEAD~24", > teachers can choose to teach what they feel less confusing, and they do > not have to teach "git checkout -- path" or "git revert HEAD~24". We > should stop there. I think you should go half a step further: officially deprecate "revert", but keep it supported forever. The reason is just to help documentation to be homogeneous (I foresee questions of users having read here about "cherry-pick -R" and there about "revert" and asking "should I use one or the other"). At least, the man page for "revert" should state explicitly "this is a convenience alias for ...". But I agree that removing support for "revert" is probably useless and somehow harmfull. (my 2 cents ...) -- Matthieu -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html