git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 1/2] Doc: explain submodule.alternateErrorStrategy

From
Junio C Hamano <gitster@pobox.com>
Date
Nov 27, 2019, 12:30 UTC
Message-ID
<xmqqo8wxv6vk.fsf@gitster-ct.c.googlers.com>
In-Reply-To
<a8125b946227d918865fde0dcbec516474b42386.1574731649.git.jonathantanmy@google.com>
Jonathan Tan <jonathantanmy@google.com> writes:
Show 10 quoted lines
> Commit 31224cbdc7 ("clone: recursive and reference option triggers
> submodule alternates", 2016-08-17) taught Git to support the
> configuration options "submodule.alternateLocation" and
> "submodule.alternateErrorStrategy" on a superproject.
> ...
> The "submodule.alternateErrorStrategy" option determines what happens
> if that alternate cannot be referenced. However, it is not clear that
> the clone proceeds as if no alternate was specified when that option is
> not set to "die" (as can be seen in the tests in 31224cbdc7). Therefore,
> document it accordingly.

Given that for everyday use (cf. sha1-file.c::link_alt_odb_entry()) of an alternate is best-effort basis, I have a feeling that it was a design mistake to have the "error strategy" configuration option in the first place, and "clone --reference-if-able" was the result of the same design mistake. We would have been better off if we made these the best-effort features as well.

But the ship has sailed long ago---so I think these two are the best we can do at this point. Perhaps flipping the default to warn may be a longer term improvement, too.

Previous: Jeff KingNext: Jonathan Tan
Message 4 of 11 in “Advice upon clone --recurse-submodules --reference”
  1. 0/2 Advice upon clone --recurse-submodules --referenceJonathan Tan, Nov 26, 2019
  2. 1/2 Doc: explain submodule.alternateErrorStrategyJonathan Tan, Nov 26, 2019
  3. Jeff KingNov 27, 2019
  4. Junio C HamanoNov 27, 2019
  5. 2/2 submodule--helper: advise on fatal alternate errorJonathan Tan, Nov 26, 2019
  6. Jeff KingNov 27, 2019
  7. 0/2 Advice upon clone --recurse-submodules --referenceJonathan Tan, Dec 2, 2019
  8. 1/2 Doc: explain submodule.alternateErrorStrategyJonathan Tan, Dec 2, 2019
  9. 2/2 submodule--helper: advise on fatal alternate errorJonathan Tan, Dec 2, 2019
  10. Jeff KingDec 3, 2019
  11. Junio C HamanoDec 3, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.