]> git.ipfire.org Git - thirdparty/git.git/commitdiff
Documentation: fix default value for core.maxTreeDepth
authorTaylor Blau <me@ttaylorr.com>
Wed, 17 Jul 2024 13:17:31 +0000 (09:17 -0400)
committerJunio C Hamano <gitster@pobox.com>
Wed, 17 Jul 2024 15:51:14 +0000 (08:51 -0700)
When `core.maxTreeDepth` was originally introduced via be20128bfa (add
core.maxTreeDepth config, 2023-08-31), its default value was 4096.

There have since been a couple of updates to its default value that were
not reflected in the documentation for `core.maxTreeDepth`:

  - 4d5693ba05 (lower core.maxTreeDepth default to 2048, 2023-08-31)
  - b64d78ad02 (max_tree_depth: lower it for MSVC to avoid stack
    overflows, 2023-11-01)

Commit 4d5693ba05 lowers the default to 2048 for platforms with smaller
stack sizes, and commit b64d78ad02 lowers the default even further when
Git is compiled with MSVC.

Neither of these changes were reflected in the documentation, which I
noticed while merging newer releases back into GitHub's private fork
(which contained the original implementation of `core.maxTreeDepth`).

Update the documentation to reflect what the platform-specific default
values are.

Noticed-by: Keith W. Campbell <keithc@ca.ibm.com>
Signed-off-by: Taylor Blau <me@ttaylorr.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/config/core.txt

index 0e8c2832bf9b8a5251c51f346ecfcf47c7e8d530..0b57a6730d868a955c51ccaa00f5008c422479ea 100644 (file)
@@ -741,4 +741,5 @@ core.maxTreeDepth::
        The maximum depth Git is willing to recurse while traversing a
        tree (e.g., "a/b/cde/f" has a depth of 4). This is a fail-safe
        to allow Git to abort cleanly, and should not generally need to
-       be adjusted. The default is 4096.
+       be adjusted. When Git is compiled with MSVC, the default is 512.
+       Otherwise, the default is 2048.