Re: git reset --merge documentation improvments

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Op 23-11-2011 9:31, Philippe Vaucher schreef:
Hello,

The current documentation for --merge is:

"Resets the index [1] and updates the files in the working tree that
are different between<commit>  and HEAD, but keeps those which are
different between the index [2] and working tree"

I think this is confusing, because [1] is the *after-reset* index and
[2] is the *before-reset* index.

You mean that you read that the *after-reset* index is reset ? They both refer to the *before-reset* index.

  If you fail to realise this it looks
like this "resets index (so index is empty) and then updates worktree
but skip files staged from index" -->  "but there's nothing staged, the
index was reset!"

The misunderstanding comes from the added "then".


I think a better sentence would be:

"Updates the files in the working tree that are different between
<commit>  and HEAD, but keeps those which are different between the
index and working tree, and finally resets the index."

There is nothing to update as long as the index is not reset.

Vincent
--
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


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]