Autogenerated HTML docs for v2.47.1-492-g2ccc89

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-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -540,7 +540,7 @@ <h2 id="_other_discussion_venues">Other Discussion Venues</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-10-05 07:34:09 +0900
+Last updated 2024-10-04 15:34:09 -0700
 </div>
 </div>
 </body>

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-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -2241,7 +2241,7 @@ <h3 id="after-approval"><a class="anchor" href="#after-approval"></a>After Revie
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-05-02 02:56:52 +0900
+Last updated 2024-05-01 10:56:52 -0700
 </div>
 </div>
 </body>

MyFirstObjectWalk.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>My First Object Walk</h1>
 <div class="details">
-<span id="revdate">2024-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -1677,7 +1677,7 @@ <h2 id="_wrapping_up">Wrapping Up</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-04-10 06:45:01 +0900
+Last updated 2024-04-09 14:45:01 -0700
 </div>
 </div>
 </body>

RelNotes/2.48.0.txt

@@ -24,6 +24,10 @@ UI, Workflows & Features
  * End-user experience of "git mergetool" when the command errors out
    has been improved.
 
+ * "git bundle --unbundle" and "git clone" running on a bundle file
+   both learned to trigger fsck over the new objects with configurable
+   fck check levels.
+
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -118,6 +122,13 @@ Performance, Internal Implementation, Development Support etc.
  * Optimize reading random references out of the reftable backend by
    allowing reuse of iterator objects.
 
+ * Backport oss-fuzz tests for us to our codebase.
+
+ * Introduce a new repository extension to prevent older Git versions
+   from mis-interpreting worktrees created with relative paths.
+
+ * Yet another "pass the repository through the callchain" topic.
+
 
 Fixes since v2.47
 -----------------
@@ -224,8 +235,19 @@ Fixes since v2.47
    first step to inspect it".
    (merge 0ffb5a6bf1 bc/allow-upload-pack-from-other-people later to maint).
 
+ * "git fast-import" learned to reject paths with ".."  and "." as
+   their components to avoid creating invalid tree objects.
+   (merge 8cb4c6e62f en/fast-import-verify-path later to maint).
+
+ * The --ancestry-path option is designed to be given a commit that is
+   on the path, which was not documented, which has been corrected.
+   (merge bc1a980759 kk/doc-ancestry-path later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge 77af53f56f aa/t7300-modernize later to maint).
    (merge dcd590a39d bf/t-readme-mention-reftable later to maint).
    (merge 68e3c69efa kh/trailer-in-glossary later to maint).
    (merge 91f88f76e6 tb/boundary-traversal-fix later to maint).
+   (merge 168ebb7159 jc/doc-error-message-guidelines later to maint).
+   (merge 18693d7d65 kh/doc-bundle-typofix later to maint).
+   (merge e2f5d3b491 kh/doc-update-ref-grammofix 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-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -685,7 +685,7 @@ <h2 id="_see_also">See Also</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-08-02 03:26:42 +0900
+Last updated 2024-08-01 11:26:42 -0700
 </div>
 </div>
 </body>

SubmittingPatches.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Submitting Patches</h1>
 <div class="details">
-<span id="revdate">2024-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -1582,7 +1582,7 @@ <h3 id="_gnus">Gnus</h3>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-11-02 14:46:57 +0900
+Last updated 2024-11-01 22:46:57 -0700
 </div>
 </div>
 </body>

ToolsForGit.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>Tools for developing Git</h1>
 <div class="details">
-<span id="revdate">2024-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -522,7 +522,7 @@ <h4 id="_httpswww_kernel_orgdochtmlv4_10processcoding_style_htmlyou_ve_made_a_me
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2023-10-24 06:43:46 +0900
+Last updated 2023-10-23 14:43:46 -0700
 </div>
 </div>
 </body>

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-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -459,7 +459,7 @@ <h1>Everyday Git With 20 Commands Or So</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2020-03-11 07:02:33 +0900
+Last updated 2020-03-10 15:02:33 -0700
 </div>
 </div>
 </body>

git-bundle.html

@@ -479,7 +479,7 @@ <h2 id="_description">DESCRIPTION</h2>
 possible <a href="git-clone.html">git-clone(1)</a> a new repository from a bundle, to use
 <a href="git-fetch.html">git-fetch(1)</a> to fetch from one, and to list the references
 contained within it with <a href="git-ls-remote.html">git-ls-remote(1)</a>. There&#8217;s no
-corresponding "write" support, i.e.a <em>git push</em> into a bundle is not
+corresponding "write" support, i.e. a <em>git push</em> into a bundle is not
 supported.</p>
 </div>
 </div>
@@ -919,7 +919,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-11-27 08:30:33 +0900
+Last updated 2024-12-13 08:40:02 -0800
 </div>
 </div>
 </body>

git-bundle.txt

@@ -32,7 +32,7 @@ Git commands that fetch or otherwise "read" via protocols such as
 possible linkgit:git-clone[1] a new repository from a bundle, to use
 linkgit:git-fetch[1] to fetch from one, and to list the references
 contained within it with linkgit:git-ls-remote[1]. There's no
-corresponding "write" support, i.e.a 'git push' into a bundle is not
+corresponding "write" support, i.e. a 'git push' into a bundle is not
 supported.
 
 BUNDLE FORMAT

git-config.html

@@ -4490,6 +4490,13 @@ <h3 id="_variables">Variables</h3>
 work and will produce hard-to-diagnose issues.</p>
 </div>
 </dd>
+<dt class="hdlist1">relativeWorktrees</dt>
+<dd>
+<p>If enabled, indicates at least one worktree has been linked with
+relative paths. Automatically set if a worktree has been created or
+repaired with either the <code>--relative-paths</code> option or with the
+<code>worktree.useRelativePaths</code> config set to <code>true</code>.</p>
+</dd>
 <dt class="hdlist1">worktreeConfig</dt>
 <dd>
 <p>If enabled, then worktrees will load config settings from the
@@ -9333,6 +9340,18 @@ <h3 id="_variables">Variables</h3>
 for the new branch.  If no such match can be found, it falls
 back to creating a new branch from the current HEAD.</p>
 </dd>
+<dt class="hdlist1">worktree.useRelativePaths</dt>
+<dd>
+<p>Link worktrees using relative paths (when "true") or absolute
+paths (when "false"). This is particularly useful for setups
+where the repository and worktrees may be moved between
+different locations or environments. Defaults to "false".</p>
+<div class="paragraph">
+<p>Note that setting <code>worktree.useRelativePaths</code> to "true" implies enabling the
+<code>extension.relativeWorktrees</code> config (see <a href="git-config.html">git-config(1)</a>),
+thus making it incompatible with older versions of Git.</p>
+</div>
+</dd>
 </dl>
 </div>
 </div>
@@ -9376,7 +9395,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-11-02 14:46:55 +0900
+Last updated 2024-11-01 22:46:55 -0700
 </div>
 </div>
 </body>

git-log.html

@@ -1128,7 +1128,8 @@ <h3 id="_history_simplification">History Simplification</h3>
 <dt class="hdlist1">--ancestry-path[=&lt;commit&gt;]</dt>
 <dd>
 <p>When given a range of commits to display (e.g. <em>commit1..commit2</em>
-or <em>commit2 ^commit1</em>), only display commits in that range
+or <em>commit2 ^commit1</em>), and a commit &lt;commit&gt; in that range,
+only display commits in that range
 that are ancestors of &lt;commit&gt;, descendants of &lt;commit&gt;, or
 &lt;commit&gt; itself.  If no commit is specified, use <em>commit1</em> (the
 excluded part of the range) as &lt;commit&gt;.  Can be passed multiple
@@ -4403,7 +4404,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2023-10-24 06:43:46 +0900
+Last updated 2023-10-23 14:43:46 -0700
 </div>
 </div>
 </body>

git-remote-helpers.html

@@ -442,7 +442,7 @@
 <div id="header">
 <h1>git-remote-helpers</h1>
 <div class="details">
-<span id="revdate">2024-12-10</span>
+<span id="revdate">2024-12-13</span>
 </div>
 </div>
 <div id="content">
@@ -459,7 +459,7 @@ <h1>git-remote-helpers</h1>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2020-03-11 07:02:33 +0900
+Last updated 2020-03-10 15:02:33 -0700
 </div>
 </div>
 </body>

git-replay.html

@@ -957,7 +957,8 @@ <h3 id="_history_simplification">History Simplification</h3>
 <dt class="hdlist1">--ancestry-path[=&lt;commit&gt;]</dt>
 <dd>
 <p>When given a range of commits to display (e.g. <em>commit1..commit2</em>
-or <em>commit2 ^commit1</em>), only display commits in that range
+or <em>commit2 ^commit1</em>), and a commit &lt;commit&gt; in that range,
+only display commits in that range
 that are ancestors of &lt;commit&gt;, descendants of &lt;commit&gt;, or
 &lt;commit&gt; itself.  If no commit is specified, use <em>commit1</em> (the
 excluded part of the range) as &lt;commit&gt;.  Can be passed multiple

git-rev-list.html

@@ -995,7 +995,8 @@ <h3 id="_history_simplification">History Simplification</h3>
 <dt class="hdlist1">--ancestry-path[=&lt;commit&gt;]</dt>
 <dd>
 <p>When given a range of commits to display (e.g. <em>commit1..commit2</em>
-or <em>commit2 ^commit1</em>), only display commits in that range
+or <em>commit2 ^commit1</em>), and a commit &lt;commit&gt; in that range,
+only display commits in that range
 that are ancestors of &lt;commit&gt;, descendants of &lt;commit&gt;, or
 &lt;commit&gt; itself.  If no commit is specified, use <em>commit1</em> (the
 excluded part of the range) as &lt;commit&gt;.  Can be passed multiple

git-shortlog.html

@@ -1050,7 +1050,8 @@ <h3 id="_history_simplification">History Simplification</h3>
 <dt class="hdlist1">--ancestry-path[=&lt;commit&gt;]</dt>
 <dd>
 <p>When given a range of commits to display (e.g. <em>commit1..commit2</em>
-or <em>commit2 ^commit1</em>), only display commits in that range
+or <em>commit2 ^commit1</em>), and a commit &lt;commit&gt; in that range,
+only display commits in that range
 that are ancestors of &lt;commit&gt;, descendants of &lt;commit&gt;, or
 &lt;commit&gt; itself.  If no commit is specified, use <em>commit1</em> (the
 excluded part of the range) as &lt;commit&gt;.  Can be passed multiple

git-update-ref.html

@@ -560,12 +560,12 @@ <h2 id="_description">DESCRIPTION</h2>
 </dd>
 <dt class="hdlist1">create</dt>
 <dd>
-<p>Create &lt;ref&gt; with &lt;new-oid&gt; after verifying it does not
+<p>Create &lt;ref&gt; with &lt;new-oid&gt; after verifying that it does not
 exist.  The given &lt;new-oid&gt; may not be zero.</p>
 </dd>
 <dt class="hdlist1">delete</dt>
 <dd>
-<p>Delete &lt;ref&gt; after verifying it exists with &lt;old-oid&gt;, if
+<p>Delete &lt;ref&gt; after verifying that it exists with &lt;old-oid&gt;, if
 given.  If given, &lt;old-oid&gt; may not be zero.</p>
 </dd>
 <dt class="hdlist1">symref-update</dt>
@@ -583,14 +583,14 @@ <h2 id="_description">DESCRIPTION</h2>
 </div>
 <div class="paragraph">
 <p>symref-create:
-	Create symbolic ref &lt;ref&gt; with &lt;new-target&gt; after verifying
+	Create symbolic ref &lt;ref&gt; with &lt;new-target&gt; after verifying that
 	it does not exist.</p>
 </div>
 <div class="dlist">
 <dl>
 <dt class="hdlist1">symref-delete</dt>
 <dd>
-<p>Delete &lt;ref&gt; after verifying it exists with &lt;old-target&gt;, if given.</p>
+<p>Delete &lt;ref&gt; after verifying that it exists with &lt;old-target&gt;, if given.</p>
 </dd>
 <dt class="hdlist1">symref-verify</dt>
 <dd>
@@ -714,7 +714,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-11-01 22:46:55 -0700
+Last updated 2024-12-13 08:40:02 -0800
 </div>
 </div>
 </body>

git-update-ref.txt

@@ -93,11 +93,11 @@ update::
 	ref does not exist before the update.
 
 create::
-	Create <ref> with <new-oid> after verifying it does not
+	Create <ref> with <new-oid> after verifying that it does not
 	exist.  The given <new-oid> may not be zero.
 
 delete::
-	Delete <ref> after verifying it exists with <old-oid>, if
+	Delete <ref> after verifying that it exists with <old-oid>, if
 	given.  If given, <old-oid> may not be zero.
 
 symref-update::
@@ -110,11 +110,11 @@ verify::
 	<old-oid> is zero or missing, the ref must not exist.
 
 symref-create:
-	Create symbolic ref <ref> with <new-target> after verifying
+	Create symbolic ref <ref> with <new-target> after verifying that
 	it does not exist.
 
 symref-delete::
-	Delete <ref> after verifying it exists with <old-target>, if given.
+	Delete <ref> after verifying that it exists with <old-target>, if given.
 
 symref-verify::
 	Verify symbolic <ref> against <old-target> but do not change it.