Autogenerated HTML docs for v2.46.0-551-gc5ee8

Author: gitster

BreakingChanges.txt

@@ -115,6 +115,26 @@ info/grafts as outdated, 2014-03-05) and will be removed.
 +
 Cf. <[email protected]>.
 
+* The git-pack-redundant(1) command can be used to remove redundant pack files.
+  The subcommand is unusably slow and the reason why nobody reports it as a
+  performance bug is suspected to be the absense of users. We have nominated
+  the command for removal and have started to emit a user-visible warning in
+  c3b58472be (pack-redundant: gauge the usage before proposing its removal,
+  2020-08-25) whenever the command is executed.
++
+So far there was a single complaint about somebody still using the command, but
+that complaint did not cause us to reverse course. On the contrary, we have
+doubled down on the deprecation and starting with 4406522b76 (pack-redundant:
+escalate deprecation warning to an error, 2023-03-23), the command dies unless
+the user passes the `--i-still-use-this` option.
++
+There have not been any subsequent complaints, so this command will finally be
+removed.
++
+Cf. <[email protected]>,
+    <CAKvOHKAFXQwt4D8yUCCkf_TQL79mYaJ=KAKhtpDNTvHJFuX1NA@mail.gmail.com>,
+    <[email protected]>,
+
 == Superseded features that will not be deprecated
 
 Some features have gained newer replacements that aim to improve the design in

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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06</span>
+<span id="revdate">2024-09-10</span>
 </div>
 </div>
 <div id="content">

RelNotes/2.47.0.txt

@@ -51,6 +51,10 @@ UI, Workflows & Features
  * "git send-email" learned "--mailmap" option to allow rewriting the
    recipient addresses.
 
+ * "git mergetool" learned to use VSCode as a merge backend.
+
+ * "git pack-redundant" has been marked for removal in Git 3.0.
+
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -196,6 +200,11 @@ Fixes since v2.46
  * The code path for compacting reftable files saw some bugfixes
    against concurrent operation.
 
+ * The code forgot to discard unnecessary in-core commit buffer data
+   for commits that "git log --skip=<number>" traversed but omitted
+   from the output, which has been corrected.
+   (merge 6bd2ae67a5 jk/free-commit-buffer-of-skipped-commits later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge bb0498b1bb jc/how-to-maintain-updates later to maint).
    (merge 0d66f601a9 jc/tests-no-useless-tee later to maint).
@@ -206,3 +215,4 @@ Fixes since v2.46
    (merge 596f4ff6ad cl/config-regexp-docfix later to maint).
    (merge 4881328617 aa/cat-file-batch-output-doc later to maint).
    (merge 1609470409 jc/config-doc-update later to maint).
+   (merge d4dc0efd7d rj/compat-terminal-unused-fix 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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06</span>
+<span id="revdate">2024-09-10</span>
 </div>
 </div>
 <div id="content">

git-config.html

@@ -4256,6 +4256,10 @@ <h3 id="_variables">Variables</h3>
 <dd>
 <p>Use Vim</p>
 </dd>
+<dt class="hdlist1"><code>vscode</code></dt>
+<dd>
+<p>Use Visual Studio Code (requires a graphical session)</p>
+</dd>
 <dt class="hdlist1"><code>winmerge</code></dt>
 <dd>
 <p>Use WinMerge (requires a graphical session)</p>
@@ -6763,6 +6767,10 @@ <h3 id="_variables">Variables</h3>
 <dd>
 <p>Use Vim where only the MERGED file is shown</p>
 </dd>
+<dt class="hdlist1"><code>vscode</code></dt>
+<dd>
+<p>Use Visual Studio Code (requires a graphical session)</p>
+</dd>
 <dt class="hdlist1"><code>winmerge</code></dt>
 <dd>
 <p>Use WinMerge (requires a graphical session)</p>

git-diff.html

@@ -2623,6 +2623,10 @@ <h2 id="_configuration">CONFIGURATION</h2>
 <dd>
 <p>Use Vim</p>
 </dd>
+<dt class="hdlist1"><code>vscode</code></dt>
+<dd>
+<p>Use Visual Studio Code (requires a graphical session)</p>
+</dd>
 <dt class="hdlist1"><code>winmerge</code></dt>
 <dd>
 <p>Use WinMerge (requires a graphical session)</p>

git-merge.html

@@ -1636,6 +1636,10 @@ <h2 id="_configuration">CONFIGURATION</h2>
 <dd>
 <p>Use Vim where only the MERGED file is shown</p>
 </dd>
+<dt class="hdlist1"><code>vscode</code></dt>
+<dd>
+<p>Use Visual Studio Code (requires a graphical session)</p>
+</dd>
 <dt class="hdlist1"><code>winmerge</code></dt>
 <dd>
 <p>Use WinMerge (requires a graphical session)</p>

git-remote-helpers.html

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

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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</span>
 </div>
 </div>
 <div id="content">
@@ -1242,7 +1242,7 @@ <h3 id="_preparing_a_merge_fix">Preparing a "merge-fix"</h3>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:11 -0700
+Last updated 2024-09-10 13:23:32 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:11 -0700
+Last updated 2024-09-10 13:23:32 -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-09-06</span>
+<span id="revdate">2024-09-10</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-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:33 -0700
 </div>
 </div>
 </body>

howto/setup-git-server-over-http.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to setup Git server over http</h1>
 <div class="details">
-<span id="revdate">2024-09-06</span>
+<span id="revdate">2024-09-10</span>
 </div>
 </div>
 <div id="content">
@@ -882,7 +882,7 @@ <h2 id="_troubleshooting">Troubleshooting:</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:32 -0700
 </div>
 </div>
 </body>

howto/update-hook-example.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>How to use the update hook</h1>
 <div class="details">
-<span id="revdate">2024-09-06</span>
+<span id="revdate">2024-09-10</span>
 </div>
 </div>
 <div id="content">
@@ -648,7 +648,7 @@ <h1>How to use the update hook</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-09-06 10:41:12 -0700
+Last updated 2024-09-10 13:23:32 -0700
 </div>
 </div>
 </body>