Autogenerated HTML docs for v2.51.0-414-g5099f6

Author: gitster

BreakingChanges.adoc

@@ -241,7 +241,7 @@ These features will be removed.
  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.
+ when they do so.
 +
 The command will be removed.
 

BreakingChanges.html

@@ -789,7 +789,7 @@ <h3 id="_removals">Removals</h3>
 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>
+when they do so.</p>
 <divclass="paragraph">
 <p>The command will be removed.</p>
 </div>
@@ -839,7 +839,7 @@ <h2 id="_superseded_features_that_will_not_be_deprecated">Superseded features th
 </div>
 <divid="footer">
 <divid="footer-text">
-Last updated 2025-09-29 13:02:52 -0700
+Last updated 2025-10-02 14:07:14 -0700
 </div>
 </div>
 </body>

RelNotes/2.52.0.adoc

@@ -44,6 +44,9 @@ UI, Workflows & Features
  * The stash.index configuration variable can be set to make "git stash
  pop/apply" pretend that it was invoked with "--index".
 
+ * "git fast-import" learned that "--signed-commits=<how>" option that
+ corresponds to that of "git fast-export".
+
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -83,6 +86,10 @@ Performance, Internal Implementation, Development Support etc.
  singleton variable, which has been updated to pass an instance
  throughout the callchain.
 
+ * The work to build on the bulk-checkin infrastructure to create many
+ objects at once in a transaction and to abstract it into the
+ generic object layer continues.
+
  * CodingGuidelines now spells out how bitfields are to be written.
 
  * Adjust to the way newer versions of cURL selectivel enables tracing
@@ -102,6 +109,10 @@ Performance, Internal Implementation, Development Support etc.
  while the code has been cleaned up to prevent similar bugs in the
  future.
 
+ * The build procedure based on meson learned a target to only build
+ documentation, similar to "make doc".
+ (merge ff4ec8ded0 ps/meson-build-docs later to maint).
+
 
 Fixes since v2.51
 -----------------
@@ -259,6 +270,16 @@ including security updates, are included in this release.
  * "git last-modified" operating in non-recursive mode used to trigger
  a BUG(), which has been corrected.
 
+ * The use of "git config get" command to learn how ANSI color
+ sequence is for a particular type, e.g., "git config get
+ --type=color --default=reset no.such.thing", isn't very ergonomic.
+ (merge e4dabf4fd6 ps/config-get-color-fixes later to maint).
+
+ * The "do you still use it?" message given by a command that is
+ deeply deprecated and allow us to suggest alternatives has been
+ updated.
+ (merge 54a60e5b38 kh/you-still-use-whatchanged-fix later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
  (merge 823d537fa7 kh/doc-git-log-markup-fix later to maint).
  (merge cf7efa4f33 rj/t6137-cygwin-fix later to maint).

git-config.html

@@ -1994,7 +1994,8 @@ <h3 id="_variables">Variables</h3>
 after defining <code>alias.last</code><code>=</code><code>cat-file</code><code>commit</code><code>HEAD</code>, the invocation
 <code>git</code><code>last</code> is equivalent to <code>git</code><code>cat-file</code><code>commit</code><code>HEAD</code>. To avoid
 confusion and troubles with script usage, aliases that
-hide existing Git commands are ignored. Arguments are split by
+hide existing Git commands are ignored except for deprecated
+commands. Arguments are split by
 spaces, the usual shell quoting and escaping are supported.
 A quote pair or a backslash can be used to quote them.</p>
 <divclass="paragraph">

git-fast-import.adoc

@@ -66,6 +66,11 @@ fast-import stream! This option is enabled automatically for
 remote-helpers that use the `import` capability, as they are
 already trusted to run their own code.
 
+--signed-commits=(verbatim|warn-verbatim|warn-strip|strip|abort)::
+ Specify how to handle signed commits. Behaves in the same way
+ as the same option in linkgit:git-fast-export[1], except that
+ default is 'verbatim' (instead of 'abort').
+
 Options for Frontends
 ~~~~~~~~~~~~~~~~~~~~~
 

git-fast-import.html

@@ -523,6 +523,12 @@ <h2 id="_options">OPTIONS</h2>
 already trusted to run their own code.</p>
 </div>
 </dd>
+<dtclass="hdlist1">--signed-commits=(verbatim|warn-verbatim|warn-strip|strip|abort)</dt>
+<dd>
+<p>Specify how to handle signed commits. Behaves in the same way
+as the same option in <ahref="git-fast-export.html">git-fast-export(1)</a>, except that
+default is <em>verbatim</em> (instead of <em>abort</em>).</p>
+</dd>
 </dl>
 </div>
 <divclass="sect2">
@@ -2607,7 +2613,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <divid="footer">
 <divid="footer-text">
-Last updated 2025-09-23 13:59:22 -0700
+Last updated 2025-10-02 14:07:14 -0700
 </div>
 </div>
 </body>

git-pack-refs.adoc

@@ -45,58 +45,7 @@ unpacked.
 OPTIONS
 -------
 
---all::
-
-The command by default packs all tags and refs that are already
-packed, and leaves other refs
-alone. This is because branches are expected to be actively
-developed and packing their tips does not help performance.
-This option causes all refs to be packed as well, with the exception
-of hidden refs, broken refs, and symbolic refs. Useful for a repository
-with many branches of historical interests.
-
---no-prune::
-
-The command usually removes loose refs under `$GIT_DIR/refs`
-hierarchy after packing them. This option tells it not to.
-
---auto::
-
-Pack refs as needed depending on the current state of the ref database. The
-behavior depends on the ref format used by the repository and may change in the
-future.
-+
- - "files": Loose references are packed into the `packed-refs` file
- based on the ratio of loose references to the size of the
-`packed-refs` file. The bigger the `packed-refs` file, the more loose
- references need to exist before we repack.
-+
- - "reftable": Tables are compacted such that they form a geometric
- sequence. For two tables N and N+1, where N+1 is newer, this
- maintains the property that N is at least twice as big as N+1. Only
- tables that violate this property are compacted.
-
---include <pattern>::
-
-Pack refs based on a `glob(7)` pattern. Repetitions of this option
-accumulate inclusion patterns. If a ref is both included in `--include` and
-`--exclude`, `--exclude` takes precedence. Using `--include` will preclude all
-tags from being included by default. Symbolic refs and broken refs will never
-be packed. When used with `--all`, it will be a noop. Use `--no-include` to clear
-and reset the list of patterns.
-
---exclude <pattern>::
-
-Do not pack refs matching the given `glob(7)` pattern. Repetitions of this option
-accumulate exclusion patterns. Use `--no-exclude` to clear and reset the list of
-patterns. If a ref is already packed, including it with `--exclude` will not
-unpack it.
-+
-When used with `--all`, pack only loose refs which do not match any of
-the provided `--exclude` patterns.
-+
-When used with `--include`, refs provided to `--include`, minus refs that are
-provided to `--exclude` will be packed.
+include::pack-refs-options.adoc[]
 
 
 BUGS

git-refs.adoc

@@ -19,6 +19,7 @@ git refs list [--count=<count>] [--shell|--perl|--python|--tcl]
  [(--exclude=<pattern>)...] [--start-after=<marker>]
  [ --stdin | (<pattern>...)]
 git refs exists <ref>
+git refs optimize [--all] [--no-prune] [--auto] [--include <pattern>] [--exclude <pattern>]
 
 DESCRIPTION
 -----------
@@ -45,6 +46,11 @@ exists::
  failed with an error other than the reference being missing. This does
  not verify whether the reference resolves to an actual object.
 
+optimize::
+ Optimizes references to improve repository performance and reduce disk
+ usage. This subcommand is an alias for linkgit:git-pack-refs[1] and
+ offers identical functionality.
+
 OPTIONS
 -------
 
@@ -80,6 +86,10 @@ The following options are specific to 'git refs list':
 
 include::for-each-ref-options.adoc[]
 
+The following options are specific to 'git refs optimize':
+
+include::pack-refs-options.adoc[]
+
 KNOWN LIMITATIONS
 -----------------
 

git-refs.html

@@ -461,7 +461,8 @@ <h2 id="_synopsis">SYNOPSIS</h2>
  [<code>--contains</code>[<code>=</code><em>&lt;object&gt;</em>]] [<code>--no-contains</code>[<code>=</code><em>&lt;object&gt;</em>]]
  [(<code>--exclude=</code><em>&lt;pattern&gt;</em>)&#8230;&#8203;] [<code>--start-after=</code><em>&lt;marker&gt;</em>]
  [ <code>--stdin</code> | (<em>&lt;pattern&gt;</em><code>...</code>)]
-<code>git</code><code>refs</code><code>exists</code><em>&lt;ref&gt;</em></pre>
+<code>git</code><code>refs</code><code>exists</code><em>&lt;ref&gt;</em>
+<code>git</code><code>refs</code><code>optimize</code> [<code>--all</code>] [<code>--no-prune</code>] [<code>--auto</code>] [<code>--include</code><em>&lt;pattern&gt;</em>] [<code>--exclude</code><em>&lt;pattern&gt;</em>]</pre>
 </div>
 </div>
 </div>
@@ -499,6 +500,12 @@ <h2 id="_commands">COMMANDS</h2>
 failed with an error other than the reference being missing. This does
 not verify whether the reference resolves to an actual object.</p>
 </dd>
+<dtclass="hdlist1">optimize</dt>
+<dd>
+<p>Optimizes references to improve repository performance and reduce disk
+usage. This subcommand is an alias for <ahref="git-pack-refs.html">git-pack-refs(1)</a> and
+offers identical functionality.</p>
+</dd>
 </dl>
 </div>
 </div>
@@ -673,6 +680,74 @@ <h2 id="_options">OPTIONS</h2>
 </dd>
 </dl>
 </div>
+<divclass="paragraph">
+<p>The following options are specific to <em>git refs optimize</em>:</p>
+</div>
+<divclass="dlist">
+<dl>
+<dtclass="hdlist1">--all</dt>
+<dd>
+<p>The command by default packs all tags and refs that are already
+packed, and leaves other refs
+alone. This is because branches are expected to be actively
+developed and packing their tips does not help performance.
+This option causes all refs to be packed as well, with the exception
+of hidden refs, broken refs, and symbolic refs. Useful for a repository
+with many branches of historical interests.</p>
+</dd>
+<dtclass="hdlist1">--no-prune</dt>
+<dd>
+<p>The command usually removes loose refs under <code>$GIT_DIR/refs</code>
+hierarchy after packing them. This option tells it not to.</p>
+</dd>
+<dtclass="hdlist1">--auto</dt>
+<dd>
+<p>Pack refs as needed depending on the current state of the ref database. The
+behavior depends on the ref format used by the repository and may change in the
+future.</p>
+<divclass="ulist">
+<ul>
+<li>
+<p>"files": Loose references are packed into the <code>packed-refs</code> file
+based on the ratio of loose references to the size of the
+<code>packed-refs</code> file. The bigger the <code>packed-refs</code> file, the more loose
+references need to exist before we repack.</p>
+</li>
+<li>
+<p>"reftable": Tables are compacted such that they form a geometric
+sequence. For two tables N and N+1, where N+1 is newer, this
+maintains the property that N is at least twice as big as N+1. Only
+tables that violate this property are compacted.</p>
+</li>
+</ul>
+</div>
+</dd>
+<dtclass="hdlist1">--include &lt;pattern&gt;</dt>
+<dd>
+<p>Pack refs based on a <code>glob</code>(<code>7</code>) pattern. Repetitions of this option
+accumulate inclusion patterns. If a ref is both included in <code>--include</code> and
+<code>--exclude</code>, <code>--exclude</code> takes precedence. Using <code>--include</code> will preclude all
+tags from being included by default. Symbolic refs and broken refs will never
+be packed. When used with <code>--all</code>, it will be a noop. Use <code>--no-include</code> to clear
+and reset the list of patterns.</p>
+</dd>
+<dtclass="hdlist1">--exclude &lt;pattern&gt;</dt>
+<dd>
+<p>Do not pack refs matching the given <code>glob</code>(<code>7</code>) pattern. Repetitions of this option
+accumulate exclusion patterns. Use <code>--no-exclude</code> to clear and reset the list of
+patterns. If a ref is already packed, including it with <code>--exclude</code> will not
+unpack it.</p>
+<divclass="paragraph">
+<p>When used with <code>--all</code>, pack only loose refs which do not match any of
+the provided <code>--exclude</code> patterns.</p>
+</div>
+<divclass="paragraph">
+<p>When used with <code>--include</code>, refs provided to <code>--include</code>, minus refs that are
+provided to <code>--exclude</code> will be packed.</p>
+</div>
+</dd>
+</dl>
+</div>
 </div>
 </div>
 <divclass="sect1">
@@ -711,7 +786,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <divid="footer">
 <divid="footer-text">
-Last updated 2025-09-12 12:13:52 -0700
+Last updated 2025-10-02 14:07:14 -0700
 </div>
 </div>
 </body>

git-whatchanged.adoc

@@ -15,7 +15,7 @@ WARNING
 -------
 `git whatchanged` has been deprecated and is scheduled for removal in
 a future version of Git, as it is merely `git log` with different
-default; `whatchanged` is not even shorter to type than `log --raw`.
+defaults.
 
 DESCRIPTION
 -----------
@@ -24,7 +24,11 @@ Shows commit logs and diff output each commit introduces.
 
 New users are encouraged to use linkgit:git-log[1] instead. The
 `whatchanged` command is essentially the same as linkgit:git-log[1]
-but defaults to showing the raw format diff output and skipping merges.
+but defaults to showing the raw format diff output and skipping merges:
+
+----
+git log --raw --no-merges
+----
 
 The command is primarily kept for historical reasons; fingers of
 many people who learned Git long before `git log` was invented by