[prev in list] [next in list] [prev in thread] [next in thread] 

List:       git
Subject:    Re: [RFC PATCH 0/2] Teach how to discard changes in the working directory
From:       Pieter de Bie <pieter () frim ! nl>
Date:       2008-09-07 23:09:05
Message-ID: B391BF4E-22D3-4083-8DDC-CF5823467813 () frim ! nl
[Download RAW message or body]


On 8 sep 2008, at 00:48, Junio C Hamano wrote:

> 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
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
[prev in list] [next in list] [prev in thread] [next in thread]