Re: [RFC/PATCH 0/2] New 'stage' command

From: "Octavio Alvarez" <alvarezp@alvarezp.ods.org>
To: "Junio C Hamano" <gitster@pobox.com>,
	"David Kågedal" <davidk@lysator.liu.se>
Cc: git@vger.kernel.org, "David Aguilar" <davvid@gmail.com>,
	"Sverre Rabbelier" <srabbelier@gmail.com>,
	markus.heidelberg@web.de,
	"Felipe Contreras" <felipe.contreras@gmail.com>
Subject: Re: [RFC/PATCH 0/2] New 'stage' command
Date: Tue, 07 Apr 2009 00:38:18 -0700	[thread overview]
Message-ID: <op.urz95k0q4oyyg1@localhost.localdomain> (raw)
In-Reply-To: <7vy6ud4otd.fsf@gitster.siamese.dyndns.org>

On Mon, 06 Apr 2009 11:30:54 -0700, Junio C Hamano <gitster@pobox.com> wrote:
>    - when you want to work with the index, you say --cached;
>
>    - when you want to work with both the index and the work tree at the
>      same time, you say --index.

This is where I also think the options are messed up.

If I want to work with the "index", shouldn't I use... uhh... "--index"?

If I want to work with both, shouldn't I use something like "--both"?

"And if --index works with the workcopy and index, will --cache use both,
the workcopy and the cache?"

To a new user like me, these options don't look like they refer to different
actions, but to different existing things. Those options say that there is
an index, and there is a cache.

(Now I learned all of this through reading the docs which is not hard, but
reading this from the man pages is not intuitive at all.)