Re: Call Me Gitless

[Tarmigan <tarmigan+git@gmail.com>]

On Mon, Aug 18, 2008 at 1:20 PM, Junio C Hamano <gitster@pobox.com> wrote:
> (2) Some concepts in git are different from what they are used to, without
>    any good reason.  IOW, the concepts have room for improvement, and our
>    UI is based on these faulty concepts.
>
> (3) Some concepts in git may be exactly the same with other systems, yet
>    our UI may operate differently from them without any good reason.

One confusing part of the porcelain may be the way that git's revert
is different from other systems' revert.  What would people think
about something like this somewhere in git-revert(1)?

+DISCUSSION
+----------
+If you are more familiar with another SCM, 'git revert' may not do what you
+expect.  Specifically, if you want to throw away all changes in your working
+directory, you should read the man page for 'git reset', particulary the
+'--hard' option.  If you want to extract specific files as they were in a
+previous commit, you should read the man page for 'git checkout -- <filename>'.
+

asciidoc probably won't like that as is, but if people like the idea,
I can make up a real patch.

Thanks,
Tarmigan