Autogenerated HTML docs for v2.23.0-256-g4c861

1 files changed, 90 insertions, 6 deletions

diff --git a/git-config.html b/git-config.html
index 2441c88a3..d5da0fd64 100644
--- a/git-config.html
+++ b/git-config.html
@@ -2203,7 +2203,9 @@ core.untrackedCache
         it will automatically be removed, if set to <code>false</code>. Before

         setting it to <code>true</code>, you should check that mtime is working

         properly on your system.

-        See <a href="git-update-index.html">git-update-index(1)</a>. <code>keep</code> by default.

+        See <a href="git-update-index.html">git-update-index(1)</a>. <code>keep</code> by default, unless

+        <code>feature.manyFiles</code> is enabled which sets this setting to

+        <code>true</code> by default.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -2899,7 +2901,7 @@ core.commitGraph
 <dd>

 <p>

         If true, then git will read the commit-graph file (if it exists)

-        to parse the graph structure of commits. Defaults to false. See

+        to parse the graph structure of commits. Defaults to true. See

         <a href="git-commit-graph.html">git-commit-graph(1)</a> for more information.

 </p>

 </dd>

@@ -4446,7 +4448,7 @@ diff.indentHeuristic
 </dt>

 <dd>

 <p>

-        Set this option to <code>true</code> to enable experimental heuristics

+        Set this option to <code>false</code> to disable the default heuristics

         that shift diff hunk boundaries to make patches easier to read.

 </p>

 </dd>

@@ -4578,6 +4580,67 @@ fastimport.unpackLimit
 </p>

 </dd>

 <dt class="hdlist1">

+feature.*

+</dt>

+<dd>

+<p>

+        The config settings that start with <code>feature.</code> modify the defaults of

+        a group of other config settings. These groups are created by the Git

+        developer community as recommended defaults and are subject to change.

+        In particular, new config options may be added with different defaults.

+</p>

+</dd>

+<dt class="hdlist1">

+feature.experimental

+</dt>

+<dd>

+<p>

+        Enable config options that are new to Git, and are being considered for

+        future defaults. Config settings included here may be added or removed

+        with each release, including minor version updates. These settings may

+        have unintended interactions since they are so new. Please enable this

+        setting if you are interested in providing feedback on experimental

+        features. The new default values are:

+</p>

+<div class="ulist"><ul>

+<li>

+<p>

+<code>pack.useSparse=true</code> uses a new algorithm when constructing a pack-file

+which can improve <code>git push</code> performance in repos with many files.

+</p>

+</li>

+<li>

+<p>

+<code>fetch.negotiationAlgorithm=skipping</code> may improve fetch negotiation times by

+skipping more commits at a time, reducing the number of round trips.

+</p>

+</li>

+</ul></div>

+</dd>

+<dt class="hdlist1">

+feature.manyFiles

+</dt>

+<dd>

+<p>

+        Enable config options that optimize for repos with many files in the

+        working directory. With many files, commands such as <code>git status</code> and

+        <code>git checkout</code> may be slow and these new defaults improve performance:

+</p>

+<div class="ulist"><ul>

+<li>

+<p>

+<code>index.version=4</code> enables path-prefix compression in the index.

+</p>

+</li>

+<li>

+<p>

+<code>core.untrackedCache=true</code> enables the untracked cache. This setting assumes

+that mtime is working on your machine.

+</p>

+</li>

+</ul></div>

+</dd>

+<dt class="hdlist1">

 fetch.recurseSubmodules

 </dt>

 <dd>

@@ -4682,7 +4745,8 @@ fetch.negotiationAlgorithm
         effort to converge faster, but may result in a larger-than-necessary

         packfile; The default is "default" which instructs Git to use the default algorithm

         that never skips commits (unless the server has acknowledged it or one

-        of its descendants).

+        of its descendants). If <code>feature.experimental</code> is enabled, then this

+        setting defaults to "skipping".

         Unknown values will cause <em>git fetch</em> to error out.

 </p>

 <div class="paragraph"><p>See also the <code>--negotiation-tip</code> option for <a href="git-fetch.html">git-fetch(1)</a>.</p></div>

@@ -5061,7 +5125,7 @@ gc.writeCommitGraph
         If true, then gc will rewrite the commit-graph file when

         <a href="git-gc.html">git-gc(1)</a> is run. When using <code>git gc --auto</code>

         the commit-graph will be updated if housekeeping is

-        required. Default is false. See <a href="git-commit-graph.html">git-commit-graph(1)</a>

+        required. Default is true. See <a href="git-commit-graph.html">git-commit-graph(1)</a>

         for details.

 </p>

 </dd>

@@ -6362,6 +6426,7 @@ index.version
 <p>

         Specify the version with which new index files should be

         initialized.  This does not affect existing repositories.

+        If <code>feature.manyFiles</code> is enabled, then the default is 4.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -7284,7 +7349,8 @@ pack.useSparse
         objects. This can have significant performance benefits when

         computing a pack to send a small change. However, it is possible

         that extra objects are added to the pack-file if the included

-        commits contain certain types of direct renames.

+        commits contain certain types of direct renames. Default is <code>false</code>

+        unless <code>feature.experimental</code> is enabled.

 </p>

 </dd>

 <dt class="hdlist1">

@@ -8129,6 +8195,24 @@ remote.&lt;name&gt;.pruneTags
 <a href="git-fetch.html">git-fetch(1)</a>.</p></div>

 </dd>

 <dt class="hdlist1">

+remote.&lt;name&gt;.promisor

+</dt>

+<dd>

+<p>

+        When set to true, this remote will be used to fetch promisor

+        objects.

+</p>

+</dd>

+<dt class="hdlist1">

+remote.&lt;name&gt;.partialclonefilter

+</dt>

+<dd>

+<p>

+        The filter that will be applied when fetching from this

+        promisor remote.

+</p>

+</dd>

+<dt class="hdlist1">

 remotes.&lt;group&gt;

 </dt>

 <dd>