Autogenerated HTML docs for v2.40.0-71-g95026

25 files changed, 122 insertions, 44 deletions

diff --git a/RelNotes/2.41.0.txt b/RelNotes/2.41.0.txt
new file mode 100644
index 000000000..71c9342aa
--- /dev/null
+++ b/RelNotes/2.41.0.txt
@@ -0,0 +1,36 @@
+Git v2.41 Release Notes
+=======================
+
+UI, Workflows & Features
+
+ * Allow information carried on the WWW-AUthenticate header to be
+   passed to the credential helpers.
+
+ * A new "fetch.hideRefs" option can be used to exclude specified refs
+   from "rev-list --objects --stdin --not --all" traversal for
+   checking object connectivity, most useful when there are many
+   unrelated histories in a single repository.
+
+
+Performance, Internal Implementation, Development Support etc.
+
+ * Code clean-up to clarify directory traversal API.
+
+ * Code clean-up to clarify the rule that "git-compat-util.h" must be
+   the first to be included.
+
+ * More work towards -Wunused.
+
+ * Instead of forcing each command to choose to honor GPG related
+   configuration variables, make the subsystem lazily initialize
+   itself.
+
+
+Fixes since v2.40
+-----------------
+
+ * "git fsck" learned to check the index files in other worktrees,
+   just like "git gc" honors them as anchoring points.
+   (merge 8d3e7eac52 jk/fsck-indices-in-worktrees later to maint).
+
+ * Other code cleanup, docfix, build fix, etc.
diff --git a/git-credential.html b/git-credential.html
index 6956f32e7..f8f552f6b 100644
--- a/git-credential.html
+++ b/git-credential.html
@@ -864,7 +864,12 @@ attribute per line. Each attribute is specified by a key-value pair,
 separated by an <code>=</code> (equals) sign, followed by a newline.</p></div>

 <div class="paragraph"><p>The key may contain any bytes except <code>=</code>, newline, or NUL. The value may

 contain any bytes except newline or NUL.</p></div>

-<div class="paragraph"><p>In both cases, all bytes are treated as-is (i.e., there is no quoting,

+<div class="paragraph"><p>Attributes with keys that end with C-style array brackets <code>[]</code> can have

+multiple values. Each instance of a multi-valued attribute forms an

+ordered list of values - the order of the repeated attributes defines

+the order of the values. An empty multi-valued attribute (<code>key[]=\n</code>)

+acts to clear any previous entries and reset the list.</p></div>

+<div class="paragraph"><p>In all cases, all bytes are treated as-is (i.e., there is no quoting,

 and one cannot transmit a value with newline or NUL in it). The list of

 attributes is terminated by a blank line or end-of-file.</p></div>

 <div class="paragraph"><p>Git understands the following attributes:</p></div>

@@ -942,6 +947,20 @@ empty string.</p></div>
 <div class="paragraph"><p>Components which are missing from the URL (e.g., there is no

 username in the example above) will be left unset.</p></div>

 </dd>

+<dt class="hdlist1">

+<code>wwwauth[]</code>

+</dt>

+<dd>

+<p>

+        When an HTTP response is received by Git that includes one or more

+        <em>WWW-Authenticate</em> authentication headers, these will be passed by Git

+        to credential helpers.

+</p>

+<div class="paragraph"><p>Each <em>WWW-Authenticate</em> header value is passed as a multi-valued

+attribute <em>wwwauth[]</em>, where the order of the attributes is the same as

+they appear in the HTTP response. This attribute is <em>one-way</em> from Git

+to pass additional information to credential helpers.</p></div>

+</dd>

 </dl></div>

 <div class="paragraph"><p>Unrecognised attributes are silently discarded.</p></div>

 </div>

@@ -957,7 +976,7 @@ username in the example above) will be left unset.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-02-27 10:47:08 PST

+ 2023-03-17 14:32:36 PDT

 </div>

 </div>

 </body>

diff --git a/git-credential.txt b/git-credential.txt
index 29d184ab8..3394c0361 100644
--- a/git-credential.txt
+++ b/git-credential.txt
@@ -113,7 +113,13 @@ separated by an `=` (equals) sign, followed by a newline.
 The key may contain any bytes except `=`, newline, or NUL. The value may
 contain any bytes except newline or NUL.
 
-In both cases, all bytes are treated as-is (i.e., there is no quoting,
+Attributes with keys that end with C-style array brackets `[]` can have
+multiple values. Each instance of a multi-valued attribute forms an
+ordered list of values - the order of the repeated attributes defines
+the order of the values. An empty multi-valued attribute (`key[]=\n`)
+acts to clear any previous entries and reset the list.
+
+In all cases, all bytes are treated as-is (i.e., there is no quoting,
 and one cannot transmit a value with newline or NUL in it). The list of
 attributes is terminated by a blank line or end-of-file.
 
@@ -166,6 +172,17 @@ empty string.
 Components which are missing from the URL (e.g., there is no
 username in the example above) will be left unset.
 
+`wwwauth[]`::
+
+	When an HTTP response is received by Git that includes one or more
+	'WWW-Authenticate' authentication headers, these will be passed by Git
+	to credential helpers.
++
+Each 'WWW-Authenticate' header value is passed as a multi-valued
+attribute 'wwwauth[]', where the order of the attributes is the same as
+they appear in the HTTP response. This attribute is 'one-way' from Git
+to pass additional information to credential helpers.
+
 Unrecognised attributes are silently discarded.
 
 GIT
diff --git a/git-log.html b/git-log.html
index 05f764d72..d40a02e99 100644
--- a/git-log.html
+++ b/git-log.html
@@ -1334,13 +1334,14 @@ or <code>--all</code>. If a trailing <em>/&#42;</em> is intended, it must be giv
 explicitly.</p></div>

 </dd>

 <dt class="hdlist1">

---exclude-hidden=[receive|uploadpack]

+--exclude-hidden=[fetch|receive|uploadpack]

 </dt>

 <dd>

 <p>

-        Do not include refs that would be hidden by <code>git-receive-pack</code> or

-        <code>git-upload-pack</code> by consulting the appropriate <code>receive.hideRefs</code> or

-        <code>uploadpack.hideRefs</code> configuration along with <code>transfer.hideRefs</code> (see

+        Do not include refs that would be hidden by <code>git-fetch</code>,

+        <code>git-receive-pack</code> or <code>git-upload-pack</code> by consulting the appropriate

+        <code>fetch.hideRefs</code>, <code>receive.hideRefs</code> or <code>uploadpack.hideRefs</code>

+        configuration along with <code>transfer.hideRefs</code> (see

         <a href="git-config.html">git-config(1)</a>). This option affects the next pseudo-ref option

         <code>--all</code> or <code>--glob</code> and is cleared after processing them.

 </p>

diff --git a/git-rev-list.html b/git-rev-list.html
index c59de2209..3ce99e5c0 100644
--- a/git-rev-list.html
+++ b/git-rev-list.html
@@ -1150,13 +1150,14 @@ or <code>--all</code>. If a trailing <em>/&#42;</em> is intended, it must be giv
 explicitly.</p></div>

 </dd>

 <dt class="hdlist1">

---exclude-hidden=[receive|uploadpack]

+--exclude-hidden=[fetch|receive|uploadpack]

 </dt>

 <dd>

 <p>

-        Do not include refs that would be hidden by <code>git-receive-pack</code> or

-        <code>git-upload-pack</code> by consulting the appropriate <code>receive.hideRefs</code> or

-        <code>uploadpack.hideRefs</code> configuration along with <code>transfer.hideRefs</code> (see

+        Do not include refs that would be hidden by <code>git-fetch</code>,

+        <code>git-receive-pack</code> or <code>git-upload-pack</code> by consulting the appropriate

+        <code>fetch.hideRefs</code>, <code>receive.hideRefs</code> or <code>uploadpack.hideRefs</code>

+        configuration along with <code>transfer.hideRefs</code> (see

         <a href="git-config.html">git-config(1)</a>). This option affects the next pseudo-ref option

         <code>--all</code> or <code>--glob</code> and is cleared after processing them.

 </p>

diff --git a/git-rev-parse.html b/git-rev-parse.html
index b2a4ddfad..bcff2e06e 100644
--- a/git-rev-parse.html
+++ b/git-rev-parse.html
@@ -1064,13 +1064,14 @@ or <code>--all</code>. If a trailing <em>/&#42;</em> is intended, it must be giv
 explicitly.</p></div>

 </dd>

 <dt class="hdlist1">

---exclude-hidden=[receive|uploadpack]

+--exclude-hidden=[fetch|receive|uploadpack]

 </dt>

 <dd>

 <p>

-        Do not include refs that would be hidden by <code>git-receive-pack</code> or

-        <code>git-upload-pack</code> by consulting the appropriate <code>receive.hideRefs</code> or

-        <code>uploadpack.hideRefs</code> configuration along with <code>transfer.hideRefs</code> (see

+        Do not include refs that would be hidden by <code>git-fetch</code>,

+        <code>git-receive-pack</code> or <code>git-upload-pack</code> by consulting the appropriate

+        <code>fetch.hideRefs</code>, <code>receive.hideRefs</code> or <code>uploadpack.hideRefs</code>

+        configuration along with <code>transfer.hideRefs</code> (see

         <a href="git-config.html">git-config(1)</a>). This option affects the next pseudo-ref option

         <code>--all</code> or <code>--glob</code> and is cleared after processing them.

 </p>

@@ -2076,7 +2077,7 @@ Similar to above:
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2022-11-22 19:59:10 PST

+ 2023-03-17 14:32:36 PDT

 </div>

 </div>

 </body>

diff --git a/git-rev-parse.txt b/git-rev-parse.txt
index bcd806928..f26a7591e 100644
--- a/git-rev-parse.txt
+++ b/git-rev-parse.txt
@@ -197,10 +197,11 @@ respectively, and they must begin with `refs/` when applied to `--glob`
 or `--all`. If a trailing '/{asterisk}' is intended, it must be given
 explicitly.
 
---exclude-hidden=[receive|uploadpack]::
-	Do not include refs that would be hidden by `git-receive-pack` or
-	`git-upload-pack` by consulting the appropriate `receive.hideRefs` or
-	`uploadpack.hideRefs` configuration along with `transfer.hideRefs` (see
+--exclude-hidden=[fetch|receive|uploadpack]::
+	Do not include refs that would be hidden by `git-fetch`,
+	`git-receive-pack` or `git-upload-pack` by consulting the appropriate
+	`fetch.hideRefs`, `receive.hideRefs` or `uploadpack.hideRefs`
+	configuration along with `transfer.hideRefs` (see
 	linkgit:git-config[1]). This option affects the next pseudo-ref option
 	`--all` or `--glob` and is cleared after processing them.
 
diff --git a/git-shortlog.html b/git-shortlog.html
index b28c04066..8d6a9253c 100644
--- a/git-shortlog.html
+++ b/git-shortlog.html
@@ -1273,13 +1273,14 @@ or <code>--all</code>. If a trailing <em>/&#42;</em> is intended, it must be giv
 explicitly.</p></div>

 </dd>

 <dt class="hdlist1">

---exclude-hidden=[receive|uploadpack]

+--exclude-hidden=[fetch|receive|uploadpack]

 </dt>

 <dd>

 <p>

-        Do not include refs that would be hidden by <code>git-receive-pack</code> or

-        <code>git-upload-pack</code> by consulting the appropriate <code>receive.hideRefs</code> or

-        <code>uploadpack.hideRefs</code> configuration along with <code>transfer.hideRefs</code> (see

+        Do not include refs that would be hidden by <code>git-fetch</code>,

+        <code>git-receive-pack</code> or <code>git-upload-pack</code> by consulting the appropriate

+        <code>fetch.hideRefs</code>, <code>receive.hideRefs</code> or <code>uploadpack.hideRefs</code>

+        configuration along with <code>transfer.hideRefs</code> (see

         <a href="git-config.html">git-config(1)</a>). This option affects the next pseudo-ref option

         <code>--all</code> or <code>--glob</code> and is cleared after processing them.

 </p>

diff --git a/howto/coordinate-embargoed-releases.html b/howto/coordinate-embargoed-releases.html
index 1ac5dd46f..339d0f151 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:51 PDT

 </div>

 </div>

 </body>

diff --git a/howto/keep-canonical-history-correct.html b/howto/keep-canonical-history-correct.html
index 9413a219c..3bbe486af 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:51 PDT

 </div>

 </div>

 </body>

diff --git a/howto/maintain-git.html b/howto/maintain-git.html
index 02523742e..2e2877b1c 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:51 PDT

 </div>

 </div>

 </body>

diff --git a/howto/new-command.html b/howto/new-command.html
index ea76b59a8..0a57896d8 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-03-12 23:48:39 PDT

+ 2023-03-17 14:33:46 PDT

 </div>

 </div>

 </body>

diff --git a/howto/rebase-from-internal-branch.html b/howto/rebase-from-internal-branch.html
index f0658ea37..9f2ad5219 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:51 PDT

 </div>

 </div>

 </body>

diff --git a/howto/rebuild-from-update-hook.html b/howto/rebuild-from-update-hook.html
index 4c4ffb593..4722d7b1e 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:51 PDT

 </div>

 </div>

 </body>

diff --git a/howto/recover-corrupted-blob-object.html b/howto/recover-corrupted-blob-object.html
index c294cc867..614b658bb 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:50 PDT

 </div>

 </div>

 </body>

diff --git a/howto/recover-corrupted-object-harder.html b/howto/recover-corrupted-object-harder.html
index 1c3007bcc..e2f4ee1b9 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-03-12 23:48:41 PDT

+ 2023-03-17 14:33:50 PDT

 </div>

 </div>

 </body>

diff --git a/howto/revert-a-faulty-merge.html b/howto/revert-a-faulty-merge.html
index c4bd0de7d..98d7e0187 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-03-12 23:48:40 PDT

+ 2023-03-17 14:33:49 PDT

 </div>

 </div>

 </body>

diff --git a/howto/revert-branch-rebase.html b/howto/revert-branch-rebase.html
index 6f2f985c7..9ec7d74b1 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-03-12 23:48:39 PDT

+ 2023-03-17 14:33:46 PDT

 </div>

 </div>

 </body>

diff --git a/howto/separating-topic-branches.html b/howto/separating-topic-branches.html
index 4f082ebcf..006788ae0 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-03-12 23:48:40 PDT

+ 2023-03-17 14:33:49 PDT

 </div>

 </div>

 </body>

diff --git a/howto/setup-git-server-over-http.html b/howto/setup-git-server-over-http.html
index 111b83f5b..3367ebd85 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-03-12 23:48:40 PDT

+ 2023-03-17 14:33:48 PDT

 </div>

 </div>

 </body>

diff --git a/howto/update-hook-example.html b/howto/update-hook-example.html
index e3d8682ee..865314165 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-03-12 23:48:40 PDT

+ 2023-03-17 14:33:48 PDT

 </div>

 </div>

 </body>

diff --git a/howto/use-git-daemon.html b/howto/use-git-daemon.html
index 85be287bb..857bf5f6c 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-03-12 23:48:40 PDT

+ 2023-03-17 14:33:48 PDT

 </div>

 </div>

 </body>

diff --git a/howto/using-merge-subtree.html b/howto/using-merge-subtree.html
index f5fb97b64..ade144d42 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-03-12 23:48:39 PDT

+ 2023-03-17 14:33:47 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 cc8c53094..1dcd1ee29 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-03-12 23:48:40 PDT

+ 2023-03-17 14:33:47 PDT

 </div>

 </div>

 </body>

diff --git a/rev-list-options.txt b/rev-list-options.txt
index 0d90d5b15..90c73d670 100644
--- a/rev-list-options.txt
+++ b/rev-list-options.txt
@@ -195,10 +195,11 @@ respectively, and they must begin with `refs/` when applied to `--glob`
 or `--all`. If a trailing '/{asterisk}' is intended, it must be given
 explicitly.
 
---exclude-hidden=[receive|uploadpack]::
-	Do not include refs that would be hidden by `git-receive-pack` or
-	`git-upload-pack` by consulting the appropriate `receive.hideRefs` or
-	`uploadpack.hideRefs` configuration along with `transfer.hideRefs` (see
+--exclude-hidden=[fetch|receive|uploadpack]::
+	Do not include refs that would be hidden by `git-fetch`,
+	`git-receive-pack` or `git-upload-pack` by consulting the appropriate
+	`fetch.hideRefs`, `receive.hideRefs` or `uploadpack.hideRefs`
+	configuration along with `transfer.hideRefs` (see
 	linkgit:git-config[1]). This option affects the next pseudo-ref option
 	`--all` or `--glob` and is cleared after processing them.