Re: Hyphens and hiding core commands

Carl Worth [off-list ref] writes:

On Mon, 27 Nov 2006 16:42:14 -0800, Junio C Hamano wrote:

quoted

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.