Re: [PATCH v2] glossary: add definition for overlay

From: Thomas Gummerer <t.gummerer@gmail.com>
Date: Mar 15, 2019, 22:31 UTC
Message-ID: <20190315223125.GG16414@hank.intra.tgummerer.com>
In-Reply-To: <CACsJy8B4gEwuyVV_T+vYdMNjs-01rxCk5G9yxbJOSkKWHGgnSg@mail.gmail.com>

On 03/13, Duy Nguyen wrote:

Show 16 quoted lines

> On Wed, Mar 13, 2019 at 6:30 AM Thomas Gummerer <t.gummerer@gmail.com> wrote:
> >
> > Add a definition for what overlay means in the context of git, to
> > clarify the recently introduced overlay-mode in git checkout.
> >
> > Helped-by: Elijah Newren <newren@gmail.com>
> > Signed-off-by: Thomas Gummerer <t.gummerer@gmail.com>
> > ---
> >
> > v2 addresses Elijah's comments (thanks!), using the wording he
> > suggested in [*1*], which I agree is slightly better, as no-overlay
> > mode doesn't touch untracked files.
> 
> It could overwrite untracked files (e.g. the file is present in the
> source, but not tracked) but never delete them. But I think it's the
> little detail that we could skip.

Right, we decided to go without that detail in the documentation for the command line option as well [*1*]. I think the argument that an overly precise description would make the description harder to understand is also valid here. Though if someone can come up with a nice phrasing for that I'd be happy to add that.

*1*: https://public-inbox.org/git/xmqqo98yiq8i.fsf@gitster-ct.c.googlers.com/