Autogenerated HTML docs for v2.46.0-212-g87a17

DecisionMaking.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Decision-Making Process in the Git Project</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

MyFirstContribution.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>My First Contribution to the Git Project</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

MyFirstObjectWalk.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>My First Object Walk</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

RelNotes/2.47.0.txt

@@ -21,6 +21,12 @@ UI, Workflows & Features
    discard it when we taught proxy auth code path to use the
    credential helpers, which has been corrected.
 
+ * The code paths to compact multiple reftable files have been updated
+   to correctly deal with multiple compaction triggering at the same
+   time.
+
+ * Support to specify ref backend for submodules has been enhanced.
+
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -51,6 +57,16 @@ Performance, Internal Implementation, Development Support etc.
    less likely to cause trouble by lengthening the expiry value it
    uses.
 
+ * An existing test of hashmap API has been rewritten with the
+   unit-test framework.
+
+ * A policy document that describes platform support levels and
+   expectation on platform stakeholders has been introduced.
+
+ * The refs API has been taught to give symref target information to
+   the users of ref iterators, allowing for-each-ref and friends to
+   avoid an extra ref_resolve_* API call per a symbolic ref.
+
 
 Fixes since v2.46
 -----------------
@@ -118,6 +134,14 @@ Fixes since v2.46
    fixed.
    (merge ec60bb9fc4 kl/test-fixes later to maint).
 
+ * Follow-up on 2.45.1 regression fix.
+   (merge ee0be850b0 jc/safe-directory later to maint).
+
+ * "git rev-list ... | git diff-tree -p --remerge-diff --stdin" should
+   behave more or less like "git log -p --remerge-diff" but instead it
+   crashed, forgetting to prepare a temporary object store needed.
+   (merge a77554ea09 xx/diff-tree-remerge-diff-fix later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge 8db8786fc2 jt/doc-post-receive-hook-update later to maint).
    (merge 1c473dd6af tn/doc-commit-fix later to maint).
@@ -131,3 +155,4 @@ Fixes since v2.46
    (merge e2e373ba82 ss/packed-ref-store-leakfix later to maint).
    (merge 0c4d5aa22d rs/use-decimal-width later to maint).
    (merge 67be8c4de5 jc/document-use-of-local later to maint).
+   (merge 098be29f5b rs/t-example-simplify later to maint).

ReviewingGuidelines.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Reviewing Patches in the Git Project</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

SubmittingPatches.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Submitting Patches</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

ToolsForGit.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Tools for developing Git</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

everyday.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Everyday Git With 20 Commands Or So</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

git-remote-helpers.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>git-remote-helpers</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">

git-submodule.html

@@ -486,7 +486,7 @@ <h2 id="_commands">COMMANDS</h2>
 </div>
 <div class="dlist">
 <dl>
-<dt class="hdlist1">add [-b &lt;branch&gt;] [-f|--force] [--name &lt;name&gt;] [--reference &lt;repository&gt;] [--depth &lt;depth&gt;] [--] &lt;repository&gt; [&lt;path&gt;]</dt>
+<dt class="hdlist1">add [-b &lt;branch&gt;] [-f|--force] [--name &lt;name&gt;] [--reference &lt;repository&gt;] [--ref-format &lt;format&gt;] [--depth &lt;depth&gt;] [--] &lt;repository&gt; [&lt;path&gt;]</dt>
 <dd>
 <p>Add the given repository as a submodule at the given path
 to the changeset to be committed next to the current
@@ -528,6 +528,10 @@ <h2 id="_commands">COMMANDS</h2>
 git-submodule will correctly locate the submodule using the relative
 URL in <code>.gitmodules</code>.</p>
 </div>
+<div class="paragraph">
+<p>If <code>--ref-format &lt;format&gt;</code>  is specified, the ref storage format of newly
+cloned submodules will be set accordingly.</p>
+</div>
 </dd>
 <dt class="hdlist1">status [--cached] [--recursive] [--] [&lt;path&gt;&#8230;&#8203;]</dt>
 <dd>
@@ -606,7 +610,7 @@ <h2 id="_commands">COMMANDS</h2>
 options.</p>
 </div>
 </dd>
-<dt class="hdlist1">update [--init] [--remote] [-N|--no-fetch] [--[no-]recommend-shallow] [-f|--force] [--checkout|--rebase|--merge] [--reference &lt;repository&gt;] [--depth &lt;depth&gt;] [--recursive] [--jobs &lt;n&gt;] [--[no-]single-branch] [--filter &lt;filter-spec&gt;] [--] [&lt;path&gt;&#8230;&#8203;]</dt>
+<dt class="hdlist1">update [--init] [--remote] [-N|--no-fetch] [--[no-]recommend-shallow] [-f|--force] [--checkout|--rebase|--merge] [--reference &lt;repository&gt;] [--ref-format &lt;format&gt;] [--depth &lt;depth&gt;] [--recursive] [--jobs &lt;n&gt;] [--[no-]single-branch] [--filter &lt;filter-spec&gt;] [--] [&lt;path&gt;&#8230;&#8203;]</dt>
 <dd>
 <div class="openblock">
 <div class="content">
@@ -680,6 +684,10 @@ <h2 id="_commands">COMMANDS</h2>
 registered submodules, and update any nested submodules within.</p>
 </div>
 <div class="paragraph">
+<p>If <code>--ref-format &lt;format&gt;</code>  is specified, the ref storage format of newly
+cloned submodules will be set accordingly.</p>
+</div>
+<div class="paragraph">
 <p>If <code>--filter &lt;filter-spec&gt;</code> is specified, the given partial clone filter will be
 applied to the submodule. See <a href="git-rev-list.html">git-rev-list(1)</a> for details on filter
 specifications.</p>
@@ -1031,7 +1039,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-02-08 15:45:59 -0800
+Last updated 2024-08-16 10:28:44 -0700
 </div>
 </div>
 </body>

git-submodule.txt

@@ -34,7 +34,7 @@ COMMANDS
 With no arguments, shows the status of existing submodules.  Several
 subcommands are available to perform operations on the submodules.
 
-add [-b <branch>] [-f|--force] [--name <name>] [--reference <repository>] [--depth <depth>] [--] <repository> [<path>]::
+add [-b <branch>] [-f|--force] [--name <name>] [--reference <repository>] [--ref-format <format>] [--depth <depth>] [--] <repository> [<path>]::
 	Add the given repository as a submodule at the given path
 	to the changeset to be committed next to the current
 	project: the current project is termed the "superproject".
@@ -71,6 +71,9 @@ submodule repositories will be kept together in the same relative
 location, and only the superproject's URL needs to be provided.
 git-submodule will correctly locate the submodule using the relative
 URL in `.gitmodules`.
++
+If `--ref-format <format>`  is specified, the ref storage format of newly
+cloned submodules will be set accordingly.
 
 status [--cached] [--recursive] [--] [<path>...]::
 	Show the status of the submodules. This will print the SHA-1 of the
@@ -136,7 +139,7 @@ If you really want to remove a submodule from the repository and commit
 that use linkgit:git-rm[1] instead. See linkgit:gitsubmodules[7] for removal
 options.
 
-update [--init] [--remote] [-N|--no-fetch] [--[no-]recommend-shallow] [-f|--force] [--checkout|--rebase|--merge] [--reference <repository>] [--depth <depth>] [--recursive] [--jobs <n>] [--[no-]single-branch] [--filter <filter-spec>] [--] [<path>...]::
+update [--init] [--remote] [-N|--no-fetch] [--[no-]recommend-shallow] [-f|--force] [--checkout|--rebase|--merge] [--reference <repository>] [--ref-format <format>] [--depth <depth>] [--recursive] [--jobs <n>] [--[no-]single-branch] [--filter <filter-spec>] [--] [<path>...]::
 +
 --
 Update the registered submodules to match what the superproject
@@ -185,6 +188,9 @@ submodule with the `--init` option.
 If `--recursive` is specified, this command will recurse into the
 registered submodules, and update any nested submodules within.
 
+If `--ref-format <format>`  is specified, the ref storage format of newly
+cloned submodules will be set accordingly.
+
 If `--filter <filter-spec>` is specified, the given partial clone filter will be
 applied to the submodule. See linkgit:git-rev-list[1] for details on filter
 specifications.

howto/keep-canonical-history-correct.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Keep authoritative canonical history correct with git pull</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -705,7 +705,7 @@ <h1>Keep authoritative canonical history correct with git pull</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:18 -0700
+Last updated 2024-08-16 10:29:08 -0700
 </div>
 </div>
 </body>

howto/maintain-git.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to maintain Git</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -1235,7 +1235,7 @@ <h3 id="_preparing_a_merge_fix">Preparing a "merge-fix"</h3>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:18 -0700
+Last updated 2024-08-16 10:29:08 -0700
 </div>
 </div>
 </body>

howto/new-command.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to integrate new subcommands</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -584,7 +584,7 @@ <h2 id="_integrating_a_command">Integrating a command</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:16 -0700
+Last updated 2024-08-16 10:29:07 -0700
 </div>
 </div>
 </body>

howto/rebase-from-internal-branch.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to rebase from an internal branch</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -656,7 +656,7 @@ <h1>How to rebase from an internal branch</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:08 -0700
 </div>
 </div>
 </body>

howto/rebuild-from-update-hook.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to rebuild from update hook</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -563,7 +563,7 @@ <h1>How to rebuild from update hook</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:08 -0700
 </div>
 </div>
 </body>

howto/recover-corrupted-blob-object.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to recover a corrupted blob object</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -641,7 +641,7 @@ <h1>How to recover a corrupted blob object</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:07 -0700
 </div>
 </div>
 </body>

howto/recover-corrupted-object-harder.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to recover an object from scratch</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -967,7 +967,7 @@ <h2 id="_the_adventure_continues">The adventure continues&#8230;&#8203;</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:07 -0700
 </div>
 </div>
 </body>

howto/revert-a-faulty-merge.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to revert a faulty merge</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -829,7 +829,7 @@ <h1>How to revert a faulty merge</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:07 -0700
 </div>
 </div>
 </body>

howto/revert-branch-rebase.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to revert an existing commit</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -649,7 +649,7 @@ <h1>How to revert an existing commit</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:07 -0700
 </div>
 </div>
 </body>

howto/separating-topic-branches.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to separate topic branches</h1>
 <div class="details">
-<span id="revdate">2024-08-14</span>
+<span id="revdate">2024-08-15</span>
 </div>
 </div>
 <div id="content">
@@ -568,7 +568,7 @@ <h1>How to separate topic branches</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-14 15:46:17 -0700
+Last updated 2024-08-16 10:29:07 -0700
 </div>
 </div>
 </body>