Autogenerated HTML docs for v2.40.0-315-g0607f

21 files changed, 101 insertions, 20 deletions

diff --git a/RelNotes/2.41.0.txt b/RelNotes/2.41.0.txt
index 1e9b6a66e..1568b9d16 100644
--- a/RelNotes/2.41.0.txt
+++ b/RelNotes/2.41.0.txt
@@ -66,6 +66,20 @@ Performance, Internal Implementation, Development Support etc.
  * Code clean-up to include and/or uninclude parse-options.h file as
    needed.
 
+ * The code path that reports what "git fetch" did to each ref has
+   been cleaned up.
+
+ * Assorted config API updates.
+
+ * A few configuration variables to tell the cURL library that
+   different types of ssl-cert and ssl-key are in use have been added.
+
+ * Split key function and data structure definitions out of cache.h to
+   new header files and adjust the users.
+
+ * "git fetch --all" does not have to download and handle the same
+   bundleURI over and over, which has been corrected.
+
 
 Fixes since v2.40
 -----------------
@@ -155,6 +169,12 @@ Fixes since v2.40
    output are for and what they mean.
    (merge 15364d2a3c jk/document-rev-list-object-name later to maint).
 
+ * Fix unnecessary truncation of generation numbers used in-core.
+   (merge d3af1c193d ps/ahead-behind-truncation-fix later to maint).
+
+ * Code clean-up around the use of the_repository.
+   (merge 4a93b899c1 ab/remove-implicit-use-of-the-repository later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge f7111175df as/doc-markup-fix later to maint).
    (merge 90ff7c9898 fc/test-aggregation-clean-up later to maint).
@@ -167,3 +187,5 @@ Fixes since v2.40
    (merge 2da2cc9b28 ob/rollback-after-commit-lock-failure later to maint).
    (merge 54dbd0933b ob/sequencer-save-head-simplify later to maint).
    (merge a93cbe8d78 ar/test-cleanup-unused-file-creation later to maint).
+   (merge cc48ddd937 jk/chainlint-fixes later to maint).
+   (merge 4833b08426 ow/ref-format-remove-unused-member later to maint).
diff --git a/git-for-each-ref.html b/git-for-each-ref.html
index 7dec9fd1a..6eac2e17d 100644
--- a/git-for-each-ref.html
+++ b/git-for-each-ref.html
@@ -750,7 +750,8 @@ git-for-each-ref(1) Manual Page
 <div class="sectionbody">

 <div class="verseblock">

 <pre class="content"><em>git for-each-ref</em> [--count=&lt;count&gt;] [--shell|--perl|--python|--tcl]

-                   [(--sort=&lt;key&gt;)&#8230;] [--format=&lt;format&gt;] [&lt;pattern&gt;&#8230;]

+                   [(--sort=&lt;key&gt;)&#8230;] [--format=&lt;format&gt;]

+                   [ --stdin | &lt;pattern&gt;&#8230; ]

                    [--points-at=&lt;object&gt;]

                    [--merged[=&lt;object&gt;]] [--no-merged[=&lt;object&gt;]]

                    [--contains[=&lt;object&gt;]] [--no-contains[=&lt;object&gt;]]</pre>

@@ -785,6 +786,15 @@ host language allowing their direct evaluation in that language.</p></div>
 </p>

 </dd>

 <dt class="hdlist1">

+--stdin

+</dt>

+<dd>

+<p>

+        If <code>--stdin</code> is supplied, then the list of patterns is read from

+        standard input instead of from the argument list.

+</p>

+</dd>

+<dt class="hdlist1">

 --count=&lt;count&gt;

 </dt>

 <dd>

@@ -1096,6 +1106,16 @@ worktreepath
         otherwise.

 </p>

 </dd>

+<dt class="hdlist1">

+ahead-behind:&lt;committish&gt;

+</dt>

+<dd>

+<p>

+        Two integers, separated by a space, demonstrating the number of

+        commits ahead and behind, respectively, when comparing the output

+        ref to the <code>&lt;committish&gt;</code> specified in the format.

+</p>

+</dd>

 </dl></div>

 <div class="paragraph"><p>In addition to the above, for commit and tag objects, the header

 field names (<code>tree</code>, <code>parent</code>, <code>object</code>, <code>type</code>, and <code>tag</code>) can

@@ -1338,7 +1358,7 @@ commits and from none of the <code>--no-merged</code> commits are shown.</p></di
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2021-08-24 17:58:56 PDT

+ 2023-04-06 13:56:57 PDT

 </div>

 </div>

 </body>

diff --git a/git-for-each-ref.txt b/git-for-each-ref.txt
index 6da899c62..0713e49b4 100644
--- a/git-for-each-ref.txt
+++ b/git-for-each-ref.txt
@@ -9,7 +9,8 @@ SYNOPSIS
 --------
 [verse]
 'git for-each-ref' [--count=<count>] [--shell|--perl|--python|--tcl]
-		   [(--sort=<key>)...] [--format=<format>] [<pattern>...]
+		   [(--sort=<key>)...] [--format=<format>]
+		   [ --stdin | <pattern>... ]
 		   [--points-at=<object>]
 		   [--merged[=<object>]] [--no-merged[=<object>]]
 		   [--contains[=<object>]] [--no-contains[=<object>]]
@@ -32,6 +33,10 @@ OPTIONS
 	literally, in the latter case matching completely or from the
 	beginning up to a slash.
 
+--stdin::
+	If `--stdin` is supplied, then the list of patterns is read from
+	standard input instead of from the argument list.
+
 --count=<count>::
 	By default the command shows all refs that match
 	`<pattern>`.  This option makes it stop after showing
@@ -217,6 +222,11 @@ worktreepath::
 	out, if it is checked out in any linked worktree. Empty string
 	otherwise.
 
+ahead-behind:<committish>::
+	Two integers, separated by a space, demonstrating the number of
+	commits ahead and behind, respectively, when comparing the output
+	ref to the `<committish>` specified in the format.
+
 In addition to the above, for commit and tag objects, the header
 field names (`tree`, `parent`, `object`, `type`, and `tag`) can
 be used to specify the value in the header field.
diff --git a/git-pack-redundant.html b/git-pack-redundant.html
index 46a10b30e..92bfb27ba 100644
--- a/git-pack-redundant.html
+++ b/git-pack-redundant.html
@@ -755,6 +755,21 @@ git-pack-redundant(1) Manual Page
 </div>

 </div>

 <div class="sect1">

+<h2 id="_warning">WARNING</h2>

+<div class="sectionbody">

+<div class="paragraph"><p><code>git pack-redundant</code> has been deprecated and is scheduled for removal in

+a future version of Git. Because it can only remove entire duplicate

+packs and not individual duplicate objects, it is generally not a useful

+tool for reducing repository size. You are better off using <code>git gc</code> to

+do so, which will put objects into a new pack, removing duplicates.</p></div>

+<div class="paragraph"><p>Running <code>pack-redundant</code> without the <code>--i-still-use-this</code> flag will fail

+in this release. If you believe you have a use case for which

+<code>pack-redundant</code> is better suited and oppose this removal, please

+contact the Git mailing list at <a href="mailto:git@vger.kernel.org">git@vger.kernel.org</a>. More information

+about the list is available at <a href="https://git-scm.com/community">https://git-scm.com/community</a>.</p></div>

+</div>

+</div>

+<div class="sect1">

 <h2 id="_description">DESCRIPTION</h2>

 <div class="sectionbody">

 <div class="paragraph"><p>This program computes which packs in your repository

@@ -819,7 +834,7 @@ git pack-redundant --all | xargs rm</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2022-11-11 23:55:30 PST

+ 2023-04-06 13:56:57 PDT

 </div>

 </div>

 </body>

diff --git a/git-pack-redundant.txt b/git-pack-redundant.txt
index 99ef13839..13c3eb5ec 100644
--- a/git-pack-redundant.txt
+++ b/git-pack-redundant.txt
@@ -11,6 +11,20 @@ SYNOPSIS
 [verse]
 'git pack-redundant' [--verbose] [--alt-odb] (--all | <pack-filename>...)
 
+WARNING
+-------
+`git pack-redundant` has been deprecated and is scheduled for removal in
+a future version of Git. Because it can only remove entire duplicate
+packs and not individual duplicate objects, it is generally not a useful
+tool for reducing repository size. You are better off using `git gc` to
+do so, which will put objects into a new pack, removing duplicates.
+
+Running `pack-redundant` without the `--i-still-use-this` flag will fail
+in this release. If you believe you have a use case for which
+`pack-redundant` is better suited and oppose this removal, please
+contact the Git mailing list at git@vger.kernel.org. More information
+about the list is available at https://git-scm.com/community.
+
 DESCRIPTION
 -----------
 This program computes which packs in your repository
diff --git a/howto/coordinate-embargoed-releases.html b/howto/coordinate-embargoed-releases.html
index dcd920c3d..279a89454 100644
--- a/howto/coordinate-embargoed-releases.html
+++ b/howto/coordinate-embargoed-releases.html
@@ -1038,7 +1038,7 @@ Thanks,
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:33 PDT

 </div>

 </div>

 </body>

diff --git a/howto/keep-canonical-history-correct.html b/howto/keep-canonical-history-correct.html
index b2e6b75b2..f72d8f831 100644
--- a/howto/keep-canonical-history-correct.html
+++ b/howto/keep-canonical-history-correct.html
@@ -938,7 +938,7 @@ tip of your <em>master</em> again and redo the two merges:</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:33 PDT

 </div>

 </div>

 </body>

diff --git a/howto/maintain-git.html b/howto/maintain-git.html
index 14f30acaf..97d668813 100644
--- a/howto/maintain-git.html
+++ b/howto/maintain-git.html
@@ -1478,7 +1478,7 @@ $ git update-ref -d $mf/ai/topic</code></pre>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:33 PDT

 </div>

 </div>

 </body>

diff --git a/howto/new-command.html b/howto/new-command.html
index 6448f189b..291f4f4d3 100644
--- a/howto/new-command.html
+++ b/howto/new-command.html
@@ -863,7 +863,7 @@ letter [PATCH 0/n].
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:32 PDT

+ 2023-04-06 13:57:31 PDT

 </div>

 </div>

 </body>

diff --git a/howto/rebase-from-internal-branch.html b/howto/rebase-from-internal-branch.html
index ab3d34646..f8eb8ffb3 100644
--- a/howto/rebase-from-internal-branch.html
+++ b/howto/rebase-from-internal-branch.html
@@ -895,7 +895,7 @@ the #1' commit.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:33 PDT

 </div>

 </div>

 </body>

diff --git a/howto/rebuild-from-update-hook.html b/howto/rebuild-from-update-hook.html
index 3b94545d9..c76ba9015 100644
--- a/howto/rebuild-from-update-hook.html
+++ b/howto/rebuild-from-update-hook.html
@@ -847,7 +847,7 @@ This is still crude and does not protect against simultaneous
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:33 PDT

 </div>

 </div>

 </body>

diff --git a/howto/recover-corrupted-blob-object.html b/howto/recover-corrupted-blob-object.html
index 75c2b0ee5..a91e06033 100644
--- a/howto/recover-corrupted-blob-object.html
+++ b/howto/recover-corrupted-blob-object.html
@@ -880,7 +880,7 @@ thing.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:32 PDT

 </div>

 </div>

 </body>

diff --git a/howto/recover-corrupted-object-harder.html b/howto/recover-corrupted-object-harder.html
index cfae755bc..cb7e8664d 100644
--- a/howto/recover-corrupted-object-harder.html
+++ b/howto/recover-corrupted-object-harder.html
@@ -1189,7 +1189,7 @@ int main(int argc, char **argv)
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:32 PDT

 </div>

 </div>

 </body>

diff --git a/howto/revert-a-faulty-merge.html b/howto/revert-a-faulty-merge.html
index c4939952f..d8fffb5c9 100644
--- a/howto/revert-a-faulty-merge.html
+++ b/howto/revert-a-faulty-merge.html
@@ -1025,7 +1025,7 @@ P---o---o---M---x---x---W---x---M2
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:34 PDT

+ 2023-04-06 13:57:32 PDT

 </div>

 </div>

 </body>

diff --git a/howto/revert-branch-rebase.html b/howto/revert-branch-rebase.html
index 99c99d7c0..4b93d91b4 100644
--- a/howto/revert-branch-rebase.html
+++ b/howto/revert-branch-rebase.html
@@ -907,7 +907,7 @@ Committed merge 7fb9b7262a1d1e0a47bbfdcbbcf50ce0635d3f8f
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:32 PDT

+ 2023-04-06 13:57:31 PDT

 </div>

 </div>

 </body>

diff --git a/howto/separating-topic-branches.html b/howto/separating-topic-branches.html
index b55df27c8..372bc4ea7 100644
--- a/howto/separating-topic-branches.html
+++ b/howto/separating-topic-branches.html
@@ -841,7 +841,7 @@ o---o"master"</code></pre>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:33 PDT

+ 2023-04-06 13:57:32 PDT

 </div>

 </div>

 </body>

diff --git a/howto/setup-git-server-over-http.html b/howto/setup-git-server-over-http.html
index 028ccaa76..10b045bef 100644
--- a/howto/setup-git-server-over-http.html
+++ b/howto/setup-git-server-over-http.html
@@ -1071,7 +1071,7 @@ help diagnosing the problem, but removes security checks.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:33 PDT

+ 2023-04-06 13:57:32 PDT

 </div>

 </div>

 </body>

diff --git a/howto/update-hook-example.html b/howto/update-hook-example.html
index f653bf6ce..36a663c1b 100644
--- a/howto/update-hook-example.html
+++ b/howto/update-hook-example.html
@@ -930,7 +930,7 @@ that JC can make non-fast-forward pushes on it.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:33 PDT

+ 2023-04-06 13:57:32 PDT

 </div>

 </div>

 </body>

diff --git a/howto/use-git-daemon.html b/howto/use-git-daemon.html
index ef014c36c..4a85fd22a 100644
--- a/howto/use-git-daemon.html
+++ b/howto/use-git-daemon.html
@@ -791,7 +791,7 @@ a good practice to put the paths after a "--" separator.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:33 PDT

+ 2023-04-06 13:57:31 PDT

 </div>

 </div>

 </body>

diff --git a/howto/using-merge-subtree.html b/howto/using-merge-subtree.html
index d3dda1331..8274041ed 100644
--- a/howto/using-merge-subtree.html
+++ b/howto/using-merge-subtree.html
@@ -848,7 +848,7 @@ Please note that if the other project merges from you, then it will
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:33 PDT

+ 2023-04-06 13:57:31 PDT

 </div>

 </div>

 </body>

diff --git a/howto/using-signed-tag-in-pull-request.html b/howto/using-signed-tag-in-pull-request.html
index c70be7be5..daafc1593 100644
--- a/howto/using-signed-tag-in-pull-request.html
+++ b/howto/using-signed-tag-in-pull-request.html
@@ -952,7 +952,7 @@ as part of the merge commit.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-04-04 16:17:33 PDT

+ 2023-04-06 13:57:31 PDT

 </div>

 </div>

 </body>