Autogenerated HTML docs for v2.46.1-506-ged155

Author: gitster

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

RelNotes/2.46.1.txt

@@ -63,4 +63,13 @@ Fixes since Git 2.46
  * "git bundle unbundle" outside a repository triggered a BUG()
    unnecessarily, which has been corrected.
 
+ * 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.
+
+ * "git verify-pack" and "git index-pack" started dying outside a
+   repository, which has been corrected.
+
+ * A corner case bug in "git stash" was fixed.
+
 Also contains minor documentation updates and code clean-ups.

RelNotes/2.47.0.txt

@@ -59,6 +59,11 @@ UI, Workflows & Features
    added by these helper functions, but many existing messages had an
    unnecessary LF at the end, which have been corrected.
 
+ * The "scalar clone" command learned the "--no-tags" option.
+
+ * The environment GIT_ADVICE has been intentionally kept undocumented
+   to discourage its use by interactive users.  Add documentation to
+   help tool writers.
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -157,7 +162,6 @@ Fixes since v2.46
    corrected.
 
  * More leakfixes.
-   (merge f30bfafcd4 ps/leakfixes-part-3 later to maint).
 
  * The credential helper to talk to OSX keychain sometimes sent
    garbage bytes after the username, which has been corrected.
@@ -167,7 +171,6 @@ Fixes since v2.46
 
  * The patch parser in 'git apply' has been a bit more lenient against
    unexpected mode bits, like 100664, recorded on extended header lines.
-   (merge e95d515141 jk/apply-patch-mode-check-fix later to maint).
 
  * "git config --value=foo --fixed-value section.key newvalue" barfed
    when the existing value in the configuration file used the
@@ -176,7 +179,6 @@ Fixes since v2.46
  * The patch parser in "git patch-id" has been tightened to avoid
    getting confused by lines that look like a patch header in the log
    message.
-   (merge a6e9429f72 jc/patch-id later to maint).
 
  * "git reflog expire" failed to honor annotated tags when computing
    reachable commits.
@@ -192,7 +194,6 @@ Fixes since v2.46
 
  * "git bundle unbundle" outside a repository triggered a BUG()
    unnecessarily, which has been corrected.
-   (merge 96a9a3e42e ps/bundle-outside-repo-fix later to maint).
 
  * Maintenance tasks other than "gc" now properly go background when
    "git maintenance" runs them.
@@ -210,11 +211,9 @@ Fixes since v2.46
  * 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).
 
  * "git verify-pack" and "git index-pack" started dying outside a
    repository, which has been corrected.
-   (merge b2dbf97f47 ps/index-pack-outside-repo-fix later to maint).
 
  * A data corruption bug when multi-pack-index is used and the same
    objects are stored in multiple packfiles has been corrected.
@@ -223,15 +222,22 @@ Fixes since v2.46
    which has been a bit tamed.
    (merge c3459ae9ef ps/pack-refs-auto-heuristics later to maint).
 
+ * A file descriptor left open is now properly closed when "git
+   sparse-checkout" updates the sparse patterns.
+
+ * In a few corner cases "git diff --exit-code" failed to report
+   "changes" (e.g., renamed without any content change), which has
+   been corrected.
+   (merge 11591850dd rs/diff-exit-code-fix later to maint).
+
+ * Cygwin does have /dev/tty support that is needed by things like
+   single-key input mode.
+   (merge 39ba986b0e rj/cygwin-has-dev-tty later to maint).
+
+ * The interpret-trailers command failed to recognise the end of the
+   message when the commit log ends in an incomplete line.
+   (merge c02414a997 bl/trailers-and-incomplete-last-line-fix 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).
-   (merge 170cdfc5a4 jc/grammo-fixes later to maint).
-   (merge 983555a1f2 jc/how-to-maintain-updates later to maint).
-   (merge e3209bd4df ps/stash-keep-untrack-empty-fix later to maint).
-   (merge 44db6f75cc jc/coding-style-c-operator-with-spaces later to maint).
-   (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).
    (merge be10ac7037 jc/mailinfo-header-cleanup later to maint).
+   (merge 9a36ea37ae jc/doc-skip-fetch-all-and-prefetch 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-12</span>
+<span id="revdate">2024-09-13</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-12</span>
+<span id="revdate">2024-09-13</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-12</span>
+<span id="revdate">2024-09-13</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-12</span>
+<span id="revdate">2024-09-13</span>
 </div>
 </div>
 <div id="content">

fetch-options.txt

@@ -1,6 +1,7 @@
 --[no-]all::
-	Fetch all remotes. This overrides the configuration variable
-	`fetch.all`.
+	Fetch all remotes, except for the ones that has the
+	`remote.<name>.skipFetchAll` configuration variable set.
+	This overrides the configuration variable fetch.all`.
 
 -a::
 --append::

git-config.html

@@ -1713,7 +1713,14 @@ <h3 id="_variables">Variables</h3>
 <p>These variables control various optional help messages designed to
 aid new users.  When left unconfigured, Git will give the message
 alongside instructions on how to squelch it.  You can tell Git
-that you do not need the help message by setting these to <code>false</code>:</p>
+that you have understood the issue and no longer need a specific
+help message by setting the corresponding variable to <code>false</code>.</p>
+<div class="paragraph">
+<p>As they are intended to help human users, these messages are output to
+the standard error. When tools that run Git as a subprocess find them
+disruptive, they can set <code>GIT_ADVICE=0</code> in the environment to squelch
+all advice messages.</p>
+</div>
 <div class="openblock">
 <div class="content">
 <div class="dlist">
@@ -7949,15 +7956,16 @@ <h3 id="_variables">Variables</h3>
 </dd>
 <dt class="hdlist1">remote.&lt;name&gt;.skipDefaultUpdate</dt>
 <dd>
-<p>If true, this remote will be skipped by default when updating
-using <a href="git-fetch.html">git-fetch(1)</a> or the <code>update</code> subcommand of
-<a href="git-remote.html">git-remote(1)</a>.</p>
+<p>A deprecated synonym to <code>remote.&lt;name&gt;.skipFetchAll</code> (if
+both are set in the configuration files with different
+values, the value of the last occurrence will be used).</p>
 </dd>
 <dt class="hdlist1">remote.&lt;name&gt;.skipFetchAll</dt>
 <dd>
-<p>If true, this remote will be skipped by default when updating
-using <a href="git-fetch.html">git-fetch(1)</a> or the <code>update</code> subcommand of
-<a href="git-remote.html">git-remote(1)</a>.</p>
+<p>If true, this remote will be skipped when updating
+using <a href="git-fetch.html">git-fetch(1)</a>, the <code>update</code> subcommand of
+<a href="git-remote.html">git-remote(1)</a>, and ignored by the prefetch task
+of <code>git maitenance</code>.</p>
 </dd>
 <dt class="hdlist1">remote.&lt;name&gt;.receivepack</dt>
 <dd>

git-fetch.html

@@ -500,8 +500,9 @@ <h2 id="_options">OPTIONS</h2>
 <dl>
 <dt class="hdlist1">--[no-]all</dt>
 <dd>
-<p>Fetch all remotes. This overrides the configuration variable
-<code>fetch.all</code>.</p>
+<p>Fetch all remotes, except for the ones that has the
+<code>remote.&lt;name&gt;.skipFetchAll</code> configuration variable set.
+This overrides the configuration variable fetch.all`.</p>
 </dd>
 <dt class="hdlist1">-a</dt>
 <dt class="hdlist1">--append</dt>

git-maintenance.html

@@ -590,6 +590,10 @@ <h2 id="_tasks">TASKS</h2>
 it will just become an update to a bunch of remote-tracking branches without
 any object transfer.</p>
 </div>
+<div class="paragraph">
+<p>The <code>remote.&lt;name&gt;.skipFetchAll</code> configuration can be used to
+exclude a particular remote from getting prefetched.</p>
+</div>
 </dd>
 <dt class="hdlist1">gc</dt>
 <dd>
@@ -1056,7 +1060,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2023-10-23 14:43:46 -0700
+Last updated 2024-09-14 09:09:36 -0700
 </div>
 </div>
 </body>

git-maintenance.txt

@@ -107,6 +107,9 @@ with the prefetch task, the objects necessary to complete a later real fetch
 would already be obtained, making the real fetch faster.  In the ideal case,
 it will just become an update to a bunch of remote-tracking branches without
 any object transfer.
++
+The `remote.<name>.skipFetchAll` configuration can be used to
+exclude a particular remote from getting prefetched.
 
 gc::
 	Clean up unnecessary files and optimize the local repository. "GC"

git-pull.html

@@ -822,8 +822,9 @@ <h3 id="_options_related_to_fetching">Options related to fetching</h3>
 <dl>
 <dt class="hdlist1">--[no-]all</dt>
 <dd>
-<p>Fetch all remotes. This overrides the configuration variable
-<code>fetch.all</code>.</p>
+<p>Fetch all remotes, except for the ones that has the
+<code>remote.&lt;name&gt;.skipFetchAll</code> configuration variable set.
+This overrides the configuration variable fetch.all`.</p>
 </dd>
 <dt class="hdlist1">-a</dt>
 <dt class="hdlist1">--append</dt>

git-remote-helpers.html

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

git.html

@@ -2471,6 +2471,18 @@ <h3 id="_other">other</h3>
 adequate and support for it is likely to be removed in the
 foreseeable future (along with the variable).</p>
 </dd>
+<dt class="hdlist1"><code>GIT_ADVICE</code></dt>
+<dd>
+<p>If set to <code>0</code>, then disable all advice messages. These messages are
+intended to provide hints to human users that may help them get out of
+problematic situations or take advantage of new features. Users can
+disable individual messages using the <code>advice.*</code> config keys. These
+messages may be disruptive to tools that execute Git processes, so this
+variable is available to disable the messages. (The <code>--no-advice</code>
+global option is also available, but old Git versions may fail when
+this option is not understood. The environment variable will be ignored
+by Git versions that do not understand it.)</p>
+</dd>
 </dl>
 </div>
 </div>
@@ -2663,7 +2675,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-06-20 16:27:24 -0700
+Last updated 2024-09-14 09:09:36 -0700
 </div>
 </div>
 </body>

git.txt

@@ -1027,6 +1027,17 @@ standard output.
 	adequate and support for it is likely to be removed in the
 	foreseeable future (along with the variable).
 
+`GIT_ADVICE`::
+	If set to `0`, then disable all advice messages. These messages are
+	intended to provide hints to human users that may help them get out of
+	problematic situations or take advantage of new features. Users can
+	disable individual messages using the `advice.*` config keys. These
+	messages may be disruptive to tools that execute Git processes, so this
+	variable is available to disable the messages. (The `--no-advice`
+	global option is also available, but old Git versions may fail when
+	this option is not understood. The environment variable will be ignored
+	by Git versions that do not understand it.)
+
 Discussion[[Discussion]]
 ------------------------
 

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-12</span>
+<span id="revdate">2024-09-13</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-12 12:34:29 -0700
+Last updated 2024-09-14 09:09:57 -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-12</span>
+<span id="revdate">2024-09-13</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-12 12:34:29 -0700
+Last updated 2024-09-14 09:09:57 -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-12</span>
+<span id="revdate">2024-09-13</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-12 12:34:28 -0700
+Last updated 2024-09-14 09:09:56 -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-12</span>
+<span id="revdate">2024-09-13</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-12 12:34:29 -0700
+Last updated 2024-09-14 09:09:57 -0700
 </div>
 </div>
 </body>