Re: Hyphens and hiding core commands

From: Junio C Hamano <junkio@cox.net>
Date: Nov 28, 2006, 02:18 UTC
Message-ID: <7vk61gcnzl.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <878xhwwdyj.wl%cworth@cworth.org>

Carl Worth <cworth@cworth.org> writes:

Show 5 quoted lines

> On Mon, 27 Nov 2006 16:42:14 -0800, Junio C Hamano wrote:
>> I think you are teaching backwards.  Couldn't you start like this?
>>
>> 	"git commit" takes the list of paths you want to commit.
> ...

> If the "commit the index" operation were moved to a non-default
> command-line option of git-commit, then the commit command could be
> explained without having to introduce the notion of the index at
> all.

Read what I wrote again. You can explain it without talking about index at all. I really do not think you need to break "git commit" nor rename "update-index" to "resolve" to explain things to new people.

The tutorial might be better reworked not to start talking about -a but start building small project from a newly created hello.c, git add it, and "git commit" (the first commit), then edit hello.c and "git commit hello.c" (the second commit).

Perhaps.

Enough about "git commit -a" for tonight.