On 03/13, Duy Nguyen wrote: > On Wed, Mar 13, 2019 at 6:30 AM Thomas Gummerer <t.gummerer@xxxxxxxxx> 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@xxxxxxxxx> > > Signed-off-by: Thomas Gummerer <t.gummerer@xxxxxxxxx> > > --- > > > > 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@xxxxxxxxxxxxxxxxxxxxxxxxx/
