Autogenerated HTML docs for v2.50.0-145-g83014

Author: gitster

BreakingChanges.adoc

@@ -183,6 +183,14 @@ These features will be removed.
   timeframe, in preference to its synonym "--annotate-stdin".  Git 3.0
   removes the support for "--stdin" altogether.
 
+* The git-whatchanged(1) command has outlived its usefulness more than
+  10 years ago, and takes more keystrokes to type than its rough
+  equivalent `git log --raw`.  We have nominated the command for
+  removal, have changed the command to refuse to work unless the
+  `--i-still-use-this` option is given, and asked the users to report
+  when they do so.  So far there hasn't been a single complaint.
++
+The command will be removed.
 
 == Superseded features that will not be deprecated
 

BreakingChanges.html

@@ -709,6 +709,17 @@ <h3 id="_removals">Removals</h3>
 timeframe, in preference to its synonym "--annotate-stdin".  Git 3.0
 removes the support for "--stdin" altogether.</p>
 </li>
+<li>
+<p>The git-whatchanged(1) command has outlived its usefulness more than
+10 years ago, and takes more keystrokes to type than its rough
+equivalent <code>git</code> <code>log</code> <code>--raw</code>.  We have nominated the command for
+removal, have changed the command to refuse to work unless the
+<code>--i-still-use-this</code> option is given, and asked the users to report
+when they do so.  So far there hasn&#8217;t been a single complaint.</p>
+<div class="paragraph">
+<p>The command will be removed.</p>
+</div>
+</li>
 </ul>
 </div>
 </div>
@@ -747,7 +758,7 @@ <h2 id="_superseded_features_that_will_not_be_deprecated">Superseded features th
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-04-07 15:21:58 -0700
+Last updated 2025-06-30 16:59:08 -0700
 </div>
 </div>
 </body>

MyFirstObjectWalk.adoc

@@ -83,13 +83,13 @@ int cmd_walken(int argc, const char **argv, const char *prefix)
 }
 ----
 
-Also add the relevant line in `builtin.h` near `cmd_whatchanged()`:
+Also add the relevant line in `builtin.h` near `cmd_version()`:
 
 ----
 int cmd_walken(int argc, const char **argv, const char *prefix, struct repository *repo);
 ----
 
-Include the command in `git.c` in `commands[]` near the entry for `whatchanged`,
+Include the command in `git.c` in `commands[]` near the entry for `version`,
 maintaining alphabetical ordering:
 
 ----

MyFirstObjectWalk.html

@@ -560,15 +560,15 @@ <h2 id="_setting_up">Setting Up</h2>
 </div>
 </div>
 <div class="paragraph">
-<p>Also add the relevant line in <code>builtin.h</code> near <code>cmd_whatchanged</code>():</p>
+<p>Also add the relevant line in <code>builtin.h</code> near <code>cmd_version</code>():</p>
 </div>
 <div class="listingblock">
 <div class="content">
 <pre>int cmd_walken(int argc, const char **argv, const char *prefix, struct repository *repo);</pre>
 </div>
 </div>
 <div class="paragraph">
-<p>Include the command in <code>git.c</code> in <code>commands</code>[] near the entry for <code>whatchanged</code>,
+<p>Include the command in <code>git.c</code> in <code>commands</code>[] near the entry for <code>version</code>,
 maintaining alphabetical ordering:</p>
 </div>
 <div class="listingblock">
@@ -1701,7 +1701,7 @@ <h2 id="_wrapping_up">Wrapping Up</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-06-18 14:54:41 -0700
+Last updated 2025-06-30 16:59:08 -0700
 </div>
 </div>
 </body>

RelNotes/2.51.0.adoc

@@ -20,6 +20,17 @@ UI, Workflows & Features
 
  * "git subtree" (in contrib/) learned to grok GPG signing its commits.
 
+ * "git whatchanged" that is longer to type than "git log --raw"
+   which is its modern rough equivalent has outlived its usefulness
+   more than 10 years ago.  Plan to deprecate and remove it.
+
+ * An interchange format for stash entries is defined, and subcommand
+   of "git stash" to import/export has been added.
+
+ * "git merge/pull" has been taught the "--compact-summary" option to
+   use the compact-summary format, intead of diffstat, when showing
+   the summary of the incoming changes.
+
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -37,6 +48,9 @@ Performance, Internal Implementation, Development Support etc.
  * "Do not explicitly initialize to zero" rule has been clarified in
    the CodingGuidelines document.
 
+ * A test helper "test_seq" function learned the "-f <fmt>" option,
+   which allowed us to simplify a lot of test scripts.
+
 
 Fixes since v2.50
 -----------------
@@ -69,6 +83,16 @@ Fixes since v2.50
    correctly parsed and replaced, which has been corrected.
    (merge abf94a283f sa/multi-mailmap-fix later to maint).
 
+ * "git maintenance" lacked the care "git gc" had to avoid holding
+   onto the repository lock for too long during packing refs, which
+   has been remedied.
+   (merge 1b5074e614 ps/maintenance-ref-lock later to maint).
+
+ * Avoid regexp_constraint and instead use comparison_constraint when
+   listing functions to exclude from application of coccinelle rules,
+   as spatch can be built with different regexp engine X-<.
+   (merge f2ad545813 jc/cocci-avoid-regexp-constraint later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge b257adb571 lo/my-first-ow-doc-update later to maint).
    (merge 8b34b6a220 ly/sequencer-update-squash-is-fixup-only later to maint).
@@ -82,3 +106,4 @@ Fixes since v2.50
    (merge 1fde1c5daf ac/preload-index-wo-the-repository later to maint).
    (merge 855cfc65ae rm/t2400-modernize later to maint).
    (merge 2939494284 ly/run-builtin-use-passed-in-repo later to maint).
+   (merge ff73f375bb jg/mailinfo-leakfix later to maint).

git-config.html

@@ -6479,8 +6479,10 @@ <h3 id="_variables">Variables</h3>
 </dd>
 <dt class="hdlist1">log.abbrevCommit</dt>
 <dd>
-<p>If true, makes <a href="git-log.html">git-log(1)</a>, <a href="git-show.html">git-show(1)</a>, and
-<a href="git-whatchanged.html">git-whatchanged(1)</a> assume <code>--abbrev-commit</code>. You may
+<p>If true, makes
+<a href="git-log.html">git-log(1)</a>, <a href="git-show.html">git-show(1)</a>, and
+<a href="git-whatchanged.html">git-whatchanged(1)</a>
+assume <code>--abbrev-commit</code>. You may
 override this option with <code>--no-abbrev-commit</code>.</p>
 </dd>
 <dt class="hdlist1">log.date</dt>
@@ -6862,8 +6864,33 @@ <h3 id="_variables">Variables</h3>
 </dd>
 <dt class="hdlist1"><code>merge.stat</code></dt>
 <dd>
-<p>Whether to print the diffstat between <code>ORIG_HEAD</code> and the merge result
-at the end of the merge.  True by default.</p>
+<p>What, if anything, to print between <code>ORIG_HEAD</code> and the merge result
+at the end of the merge.  Possible values are:</p>
+<div class="openblock">
+<div class="content">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>false</code></dt>
+<dd>
+<p>Show nothing.</p>
+</dd>
+<dt class="hdlist1"><code>true</code></dt>
+<dd>
+<p>Show <code>git</code> <code>diff</code> <code>--diffstat</code> <code>--summary</code> <code>ORIG_HEAD</code>.</p>
+</dd>
+<dt class="hdlist1"><code>compact</code></dt>
+<dd>
+<p>Show <code>git</code> <code>diff</code> <code>--compact-summary</code> <code>ORIG_HEAD</code>.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>but any unrecognised value (e.g., a value added by a future version of
+Git) is taken as <code>true</code> instead of triggering an error.  Defaults to
+<code>true</code>.</p>
+</div>
 </dd>
 <dt class="hdlist1"><code>merge.autoStash</code></dt>
 <dd>
@@ -9787,7 +9814,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-02-21 13:44:53 -0800
+Last updated 2025-06-20 18:10:42 -0700
 </div>
 </div>
 </body>

git-log.html

@@ -4231,8 +4231,10 @@ <h2 id="_configuration">CONFIGURATION</h2>
 <dl>
 <dt class="hdlist1">log.abbrevCommit</dt>
 <dd>
-<p>If true, makes <a href="git-log.html">git-log(1)</a>, <a href="git-show.html">git-show(1)</a>, and
-<a href="git-whatchanged.html">git-whatchanged(1)</a> assume <code>--abbrev-commit</code>. You may
+<p>If true, makes
+<a href="git-log.html">git-log(1)</a>, <a href="git-show.html">git-show(1)</a>, and
+<a href="git-whatchanged.html">git-whatchanged(1)</a>
+assume <code>--abbrev-commit</code>. You may
 override this option with <code>--no-abbrev-commit</code>.</p>
 </dd>
 <dt class="hdlist1">log.date</dt>
@@ -4405,7 +4407,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-02-14 21:38:14 -0800
+Last updated 2025-06-20 18:10:42 -0700
 </div>
 </div>
 </body>

git-merge.adoc

@@ -9,7 +9,7 @@ git-merge - Join two or more development histories together
 SYNOPSIS
 --------
 [synopsis]
-git merge [-n] [--stat] [--no-commit] [--squash] [--[no-]edit]
+git merge [-n] [--stat] [--compact-summary] [--no-commit] [--squash] [--[no-]edit]
 	[--no-verify] [-s <strategy>] [-X <strategy-option>] [-S[<keyid>]]
 	[--[no-]allow-unrelated-histories]
 	[--[no-]rerere-autoupdate] [-m <msg>] [-F <file>]

git-merge.html

@@ -452,7 +452,7 @@ <h2 id="_name">NAME</h2>
 <h2 id="_synopsis">SYNOPSIS</h2>
 <div class="sectionbody">
 <div class="verseblock">
-<pre class="content"><code>git</code> <code>merge</code> [<code>-n</code>] [<code>--stat</code>] [<code>--no-commit</code>] [<code>--squash</code>] [<code>--</code>[<code>no-</code>]<code>edit</code>]
+<pre class="content"><code>git</code> <code>merge</code> [<code>-n</code>] [<code>--stat</code>] [<code>--compact-summary</code>] [<code>--no-commit</code>] [<code>--squash</code>] [<code>--</code>[<code>no-</code>]<code>edit</code>]
 	[<code>--no-verify</code>] [<code>-s</code> <em>&lt;strategy&gt;</em>] [<code>-X</code> <em>&lt;strategy-option&gt;</em>] [<code>-S</code>[<em>&lt;keyid&gt;</em>]]
 	[<code>--</code>[<code>no-</code>]<code>allow-unrelated-histories</code>]
 	[<code>--</code>[<code>no-</code>]<code>rerere-autoupdate</code>] [<code>-m</code> <em>&lt;msg&gt;</em>] [<code>-F</code> <em>&lt;file&gt;</em>]
@@ -650,6 +650,10 @@ <h2 id="_options">OPTIONS</h2>
 merge.</p>
 </div>
 </dd>
+<dt class="hdlist1"><code>--compact-summary</code></dt>
+<dd>
+<p>Show a compact-summary at the end of the merge.</p>
+</dd>
 <dt class="hdlist1"><code>--squash</code></dt>
 <dt class="hdlist1"><code>--no-squash</code></dt>
 <dd>
@@ -1509,8 +1513,33 @@ <h2 id="_configuration">CONFIGURATION</h2>
 </dd>
 <dt class="hdlist1"><code>merge.stat</code></dt>
 <dd>
-<p>Whether to print the diffstat between <code>ORIG_HEAD</code> and the merge result
-at the end of the merge.  True by default.</p>
+<p>What, if anything, to print between <code>ORIG_HEAD</code> and the merge result
+at the end of the merge.  Possible values are:</p>
+<div class="openblock">
+<div class="content">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><code>false</code></dt>
+<dd>
+<p>Show nothing.</p>
+</dd>
+<dt class="hdlist1"><code>true</code></dt>
+<dd>
+<p>Show <code>git</code> <code>diff</code> <code>--diffstat</code> <code>--summary</code> <code>ORIG_HEAD</code>.</p>
+</dd>
+<dt class="hdlist1"><code>compact</code></dt>
+<dd>
+<p>Show <code>git</code> <code>diff</code> <code>--compact-summary</code> <code>ORIG_HEAD</code>.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>but any unrecognised value (e.g., a value added by a future version of
+Git) is taken as <code>true</code> instead of triggering an error.  Defaults to
+<code>true</code>.</p>
+</div>
 </dd>
 <dt class="hdlist1"><code>merge.autoStash</code></dt>
 <dd>
@@ -1730,7 +1759,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-06-02 12:42:06 -0700
+Last updated 2025-06-30 16:59:08 -0700
 </div>
 </div>
 </body>

git-pull.html

@@ -687,6 +687,10 @@ <h3 id="_options_related_to_merging">Options related to merging</h3>
 merge.</p>
 </div>
 </dd>
+<dt class="hdlist1"><code>--compact-summary</code></dt>
+<dd>
+<p>Show a compact-summary at the end of the merge.</p>
+</dd>
 <dt class="hdlist1"><code>--squash</code></dt>
 <dt class="hdlist1"><code>--no-squash</code></dt>
 <dd>
@@ -1871,7 +1875,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2025-02-14 21:38:14 -0800
+Last updated 2025-06-20 18:10:42 -0700
 </div>
 </div>
 </body>