git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] prepare deprecation of git-revert

From
Matthieu Moy <matthieu.moy@imag.fr>
Date
Nov 1, 2008, 23:01 UTC
Message-ID
<vpqr65voxti.fsf@bauges.imag.fr>
In-Reply-To
<7vej1w73nr.fsf@gitster.siamese.dyndns.org>
Junio C Hamano <gitster@pobox.com> writes:
Show 6 quoted lines
> 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
Previous: Junio C HamanoNext: Nguyen Thai Ngoc Duy
Message 12 of 16 in “prepare deprecation of git-revert”
  1. prepare deprecation of git-revertPierre Habouzit, Oct 31, 2008
  2. Pierre HabouzitOct 31, 2008
  3. Jakub NarebskiOct 31, 2008
  4. Pierre HabouzitOct 31, 2008
  5. Theodore TsoOct 31, 2008
  6. Andreas EricssonNov 1, 2008
  7. Alex RiesenOct 31, 2008
  8. Pierre HabouzitOct 31, 2008
  9. Alex RiesenOct 31, 2008
  10. Johannes SchindelinOct 31, 2008
  11. Junio C HamanoOct 31, 2008
  12. Matthieu MoyNov 1, 2008
  13. Nguyen Thai Ngoc DuyNov 2, 2008
  14. Johannes SchindelinNov 2, 2008
  15. Jeff KingNov 2, 2008
  16. Pierre HabouzitNov 2, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.