From: Octavio Alvarez <alvarezp@alvarezp.ods.org>
Date: Tue, 07 Apr 2009 07:38:18 GMT
Subject: Re: [RFC/PATCH 0/2] New 'stage' command
Message-ID: <op.urz95k0q4oyyg1@localhost.localdomain>
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.)