Re: [RFC PATCH 0/2] Teach how to discard changes in the working directory
- From
- Pieter de Bie <pieter@frim.nl>
- Date
- Sep 7, 2008, 23:09 UTC
- Message-ID
- <B391BF4E-22D3-4083-8DDC-CF5823467813@frim.nl>
- In-Reply-To
- <7vtzcrk1wt.fsf@gitster.siamese.dyndns.org>
On 8 sep 2008, at 00:48, Junio C Hamano wrote:
Show 14 quoted lines
> I would agree that "hint is often given in #git" is an indication that > people do not know "git checkout" to check out the path from the > index to > get rid of the change. I further suspect that "I modified my file > and git > status says 'Changed but not updated'; what should I do" may not be > asked > often anymore, which might owe the hint we have in status output. > Even > then, I do not necessarily agree that the status output (yes, I am > also > questioning the existing hints as well) is the best place to teach > these > people.
Yes, this seems unclear to a lot of people. How about a small and focused man-page or similar to help people explain the differences between the working directory, the index and HEAD? Then we can just add something like
If you are unsure what to do, run `git help stage-changes`
or so. This would differ from the git-commit man-page in that there is less clutter and most likely contains the information the user needs at the top of the page.
- Pieter