From: Chris Torek <chris.torek@gmail.com>
Date: Tue, 12 Aug 2025 20:51:20 GMT
Subject: Re: [PATCH 5/5] doc: git-add: explain inconsistent terminology
Message-ID: <CAPx1GveEX_r8thqpux0jcbEsEyLpNOvRWEvogUp4m_cNC5=dbw@mail.gmail.com>
In-Reply-To: <f7e8e4c63a1205740c2d54368d7bcdd686882680.1755029249.git.gitgitgadget@gmail.com>

On Tue, Aug 12, 2025 at 1:35 PM Julia Evans via GitGitGadget
<gitgitgadget@gmail.com> wrote:
> +TERMINOLOGY NOTE
> +----------------
> +
> +Git uses the terms "staging area", "index" and "cache" interchangeably
> +for historical reasons. Many commands have flags like `--staged`,
> +`--index`, or `--cached`, and they all refer to the index.
> +

I think this is also a good idea. Unfortunately, `git apply` has two
different meanings for `--index` vs `--cached` (I believe it's the
*only* exception to the "means the same thing" rule...).

Chris