Autogenerated HTML docs for v2.40.1-423-g2807b

19 files changed, 83 insertions, 17 deletions

diff --git a/RelNotes/2.41.0.txt b/RelNotes/2.41.0.txt
index abbaff309..63345b959 100644
--- a/RelNotes/2.41.0.txt
+++ b/RelNotes/2.41.0.txt
@@ -69,6 +69,10 @@ UI, Workflows & Features
    learns "--omit-empty" to hide refs that whose formatting result
    becomes an empty string from the output.
 
+ * The sendemail-validate validate hook learned to pass the total
+   number of input files and where in the sequence each invocation is
+   via environment variables.
+
 
 Performance, Internal Implementation, Development Support etc.
 
@@ -240,6 +244,15 @@ Fixes since v2.40
    paths outside the current directory.
    (merge 92b1dd1b9e rs/archive-from-subdirectory-fixes later to maint).
 
+ * The code to parse capability list for v0 on-wire protocol fell into
+   an infinite loop when a capability appears multiple times, which
+   has been corrected.
+
+ * Geometric repacking ("git repack --geometric=<n>") in a repository
+   that borrows from an alternate object database had various corner
+   case bugs, which have been corrected.
+   (merge d85cd18777 ps/fix-geom-repack-with-alternates 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).
diff --git a/githooks.html b/githooks.html
index 06e09a6a4..0a81d1fe0 100644
--- a/githooks.html
+++ b/githooks.html
@@ -1290,6 +1290,37 @@ processed by rebase.</p></div>
 the name of the file that holds the e-mail to be sent.  Exiting with a

 non-zero status causes <code>git send-email</code> to abort before sending any

 e-mails.</p></div>

+<div class="paragraph"><p>The following environment variables are set when executing the hook.</p></div>

+<div class="dlist"><dl>

+<dt class="hdlist1">

+<code>GIT_SENDEMAIL_FILE_COUNTER</code>

+</dt>

+<dd>

+<p>

+        A 1-based counter incremented by one for every file holding an e-mail

+        to be sent (excluding any FIFOs). This counter does not follow the

+        patch series counter scheme. It will always start at 1 and will end at

+        GIT_SENDEMAIL_FILE_TOTAL.

+</p>

+</dd>

+<dt class="hdlist1">

+<code>GIT_SENDEMAIL_FILE_TOTAL</code>

+</dt>

+<dd>

+<p>

+        The total number of files that will be sent (excluding any FIFOs). This

+        counter does not follow the patch series counter scheme. It will always

+        be equal to the number of files being sent, whether there is a cover

+        letter or not.

+</p>

+</dd>

+</dl></div>

+<div class="paragraph"><p>These variables may for instance be used to validate patch series.</p></div>

+<div class="paragraph"><p>The sample <code>sendemail-validate</code> hook that comes with Git checks that all sent

+patches (excluding the cover letter) can be applied on top of the upstream

+repository default branch without conflicts. Some placeholders are left for

+additional validation steps to be performed after all patches of a given series

+have been applied.</p></div>

 </div>

 <div class="sect2">

 <h3 id="_fsmonitor_watchman">fsmonitor-watchman</h3>

@@ -1394,7 +1425,7 @@ running passing "1", "1" should not be possible.</p></div>
 <div id="footer">

 <div id="footer-text">

 Last updated

- 2023-01-21 17:52:14 PST

+ 2023-04-25 14:39:23 PDT

 </div>

 </div>

 </body>

diff --git a/githooks.txt b/githooks.txt
index 62908602e..c8e55b261 100644
--- a/githooks.txt
+++ b/githooks.txt
@@ -600,6 +600,28 @@ the name of the file that holds the e-mail to be sent.  Exiting with a
 non-zero status causes `git send-email` to abort before sending any
 e-mails.
 
+The following environment variables are set when executing the hook.
+
+`GIT_SENDEMAIL_FILE_COUNTER`::
+	A 1-based counter incremented by one for every file holding an e-mail
+	to be sent (excluding any FIFOs). This counter does not follow the
+	patch series counter scheme. It will always start at 1 and will end at
+	GIT_SENDEMAIL_FILE_TOTAL.
+
+`GIT_SENDEMAIL_FILE_TOTAL`::
+	The total number of files that will be sent (excluding any FIFOs). This
+	counter does not follow the patch series counter scheme. It will always
+	be equal to the number of files being sent, whether there is a cover
+	letter or not.
+
+These variables may for instance be used to validate patch series.
+
+The sample `sendemail-validate` hook that comes with Git checks that all sent
+patches (excluding the cover letter) can be applied on top of the upstream
+repository default branch without conflicts. Some placeholders are left for
+additional validation steps to be performed after all patches of a given series
+have been applied.
+
 fsmonitor-watchman
 ~~~~~~~~~~~~~~~~~~
 
diff --git a/howto/coordinate-embargoed-releases.html b/howto/coordinate-embargoed-releases.html
index d565e5f5d..0ea1856f8 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-25 09:59:43 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/keep-canonical-history-correct.html b/howto/keep-canonical-history-correct.html
index 7efc7e7c5..c4435cb2a 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-25 09:59:43 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/maintain-git.html b/howto/maintain-git.html
index 1a6acd296..14acf5ad9 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-25 09:59:43 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/new-command.html b/howto/new-command.html
index 28987fd42..9c5f9ff8c 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-25 09:59:41 PDT

+ 2023-04-25 14:39:56 PDT

 </div>

 </div>

 </body>

diff --git a/howto/rebase-from-internal-branch.html b/howto/rebase-from-internal-branch.html
index 76d3e2b24..c61ca83ad 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-25 09:59:43 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/rebuild-from-update-hook.html b/howto/rebuild-from-update-hook.html
index d688208fc..a57da6fc7 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-25 09:59:42 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/recover-corrupted-blob-object.html b/howto/recover-corrupted-blob-object.html
index f4bd57941..eeb9d7208 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-25 09:59:42 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/recover-corrupted-object-harder.html b/howto/recover-corrupted-object-harder.html
index a3483d17e..61bd983fe 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-25 09:59:42 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/revert-a-faulty-merge.html b/howto/revert-a-faulty-merge.html
index a4525a0ea..89b04b086 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-25 09:59:42 PDT

+ 2023-04-25 14:39:58 PDT

 </div>

 </div>

 </body>

diff --git a/howto/revert-branch-rebase.html b/howto/revert-branch-rebase.html
index d4bdb6319..128b122de 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-25 09:59:41 PDT

+ 2023-04-25 14:39:56 PDT

 </div>

 </div>

 </body>

diff --git a/howto/separating-topic-branches.html b/howto/separating-topic-branches.html
index 1bf8d732b..191e1ac7d 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-25 09:59:42 PDT

+ 2023-04-25 14:39:57 PDT

 </div>

 </div>

 </body>

diff --git a/howto/setup-git-server-over-http.html b/howto/setup-git-server-over-http.html
index 742e239ae..0d526e39c 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-25 09:59:42 PDT

+ 2023-04-25 14:39:57 PDT

 </div>

 </div>

 </body>

diff --git a/howto/update-hook-example.html b/howto/update-hook-example.html
index d1373a946..2207624f7 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-25 09:59:41 PDT

+ 2023-04-25 14:39:57 PDT

 </div>

 </div>

 </body>

diff --git a/howto/use-git-daemon.html b/howto/use-git-daemon.html
index 9b60d0071..f384c5811 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-25 09:59:41 PDT

+ 2023-04-25 14:39:57 PDT

 </div>

 </div>

 </body>

diff --git a/howto/using-merge-subtree.html b/howto/using-merge-subtree.html
index 6fe6a1bbb..f00056347 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-25 09:59:41 PDT

+ 2023-04-25 14:39:56 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 2f769c2e1..9b4e840a1 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-25 09:59:41 PDT

+ 2023-04-25 14:39:57 PDT

 </div>

 </div>

 </body>