On 10/16/2019 3:00 PM, Elijah Newren wrote: > On Tue, Oct 15, 2019 at 6:56 AM Derrick Stolee via GitGitGadget > <gitgitgadget@xxxxxxxxx> wrote: >> +DESCRIPTION >> +----------- >> + >> +Initialize and modify the sparse-checkout configuration, which reduces >> +the checkout to a set of directories given by a list of prefixes. >> + >> +THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE. > > I think the wording needs to be a bit more detailed; you copied the > wording from git-switch.txt, but usage of git-switch is not expected > to modify the behavior of other commands. sparse-checkout, by > contrast, is designed to affect other commands: at the very least > checkout & switch, and likely will affect grep, diff, log, and a host > of others. Perhaps something like: > > THIS COMMAND IS EXPERIMENTAL. ITS BEHAVIOR, AND THE BEHAVIOR OF OTHER > COMMANDS IN THE PRESENCE OF SPARSE-CHECKOUTS, WILL LIKELY CHANGE IN > THE FUTURE. Thanks. I was taking your comment to mean "this builtin is experimental" but what you really mean is "the sparse-checkout feature is (still) experimental". -Stolee
