Autogenerated HTML docs for v2.47.1-440-gcaacd

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

RelNotes/2.48.0.txt

@@ -21,6 +21,9 @@ UI, Workflows & Features
 
  * Drop support for older libcURL and Perl.
 
+ * End-user experience of "git mergetool" when the command errors out
+   has been improved.
+
 
 Performance, Internal Implementation, Development Support etc.
 --------------------------------------------------------------
@@ -107,6 +110,14 @@ Performance, Internal Implementation, Development Support etc.
  * Built-in Git subcommands are supplied the repository object to work
    with; they learned to do the same when they invoke sub-subcommands.
 
+ * Drop support for ancient environments in various CI jobs.
+
+ * Isolates the reftable subsystem from the rest of Git's codebase by
+   using fewer pieces of Git's infrastructure.
+
+ * Optimize reading random references out of the reftable backend by
+   allowing reuse of iterator objects.
+
 
 Fixes since v2.47
 -----------------
@@ -204,6 +215,15 @@ Fixes since v2.47
 
  * The sequencer failed to honor core.commentString in some places.
 
+ * Describe a case where an option value needs to be spelled as a
+   separate argument, i.e. "--opt val", not "--opt=val".
+   (merge 1bc1e94091 jc/doc-opt-tilde-expand later to maint).
+
+ * Loosen overly strict ownership check introduced in the recent past,
+   to keep the promise "cloning a suspicious repository is a safe
+   first step to inspect it".
+   (merge 0ffb5a6bf1 bc/allow-upload-pack-from-other-people 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).

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

git-clone.html

@@ -517,6 +517,10 @@ <h2 id="_options">OPTIONS</h2>
 links.</p>
 </div>
 <div class="paragraph">
+<p>This option does not work with repositories owned by other users for security
+reasons, and <code>--no-local</code> must be specified for the clone to succeed.</p>
+</div>
+<div class="paragraph">
 <p><strong>NOTE</strong>: this operation can race with concurrent modification to the
 source repository, similar to running <code>cp</code> <code>-r</code> <em>&lt;src&gt;</em> <em>&lt;dst&gt;</em> while modifying
 <em>&lt;src&gt;</em>.</p>
@@ -1054,6 +1058,14 @@ <h2 id="_examples">EXAMPLES</h2>
 </div>
 </div>
 </li>
+<li>
+<p>Clone a local repository from a different user:</p>
+<div class="listingblock">
+<div class="content">
+<pre>$ git clone --no-local /home/otheruser/proj.git /pub/scm/proj.git</pre>
+</div>
+</div>
+</li>
 </ul>
 </div>
 </div>
@@ -1124,7 +1136,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-11-16 17:03:36 +0900
+Last updated 2024-12-10 21:07:44 +0900
 </div>
 </div>
 </body>

git-clone.txt

@@ -63,6 +63,9 @@ symbolic link, the clone will fail. This is a security measure to
 prevent the unintentional copying of files by dereferencing the symbolic
 links.
 +
+This option does not work with repositories owned by other users for security
+reasons, and `--no-local` must be specified for the clone to succeed.
++
 *NOTE*: this operation can race with concurrent modification to the
 source repository, similar to running `cp -r <src> <dst>` while modifying
 _<src>_.
@@ -384,6 +387,12 @@ $ cd my-linux
 $ git clone --bare -l /home/proj/.git /pub/scm/proj.git
 ------------
 
+* Clone a local repository from a different user:
++
+------------
+$ git clone --no-local /home/otheruser/proj.git /pub/scm/proj.git
+------------
+
 CONFIGURATION
 -------------
 

git-remote-helpers.html

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

gitcli.html

@@ -557,6 +557,16 @@ <h2 id="_description">DESCRIPTION</h2>
 written in the <em>stuck</em> form.</p>
 </li>
 <li>
+<p>Despite the above suggestion, when Arg is a path relative to the
+home directory of a user, e.g. ~/directory/file or ~u/d/f, you
+may want to use the separate form, e.g. <code>git</code> <code>foo</code> <code>--file</code> <code>~/mine</code>,
+not <code>git</code> <code>foo</code> <code>--file=~/mine</code>.  The shell will expand <code>~/</code> in the
+former to your home directory, but most shells keep the tilde in
+the latter.  Some of our commands know how to tilde-expand the
+option value even when given in the stuck form, but not all of
+them do.</p>
+</li>
+<li>
 <p>When you give a revision parameter to a command, make sure the parameter is
 not ambiguous with a name of a file in the work tree.  E.g. do not write
 <code>git</code> <code>log</code> <code>-1</code> <code>HEAD</code> but write <code>git</code> <code>log</code> <code>-1</code> <code>HEAD</code> <code>--</code>; the former will not work
@@ -760,7 +770,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-03-11 15:39:49 -0700
+Last updated 2024-12-10 21:07:44 +0900
 </div>
 </div>
 </body>

gitcli.txt

@@ -90,6 +90,15 @@ scripting Git:
    for long options.  An option that takes optional option-argument must be
    written in the 'stuck' form.
 
+ * Despite the above suggestion, when Arg is a path relative to the
+   home directory of a user, e.g. ~/directory/file or ~u/d/f, you
+   may want to use the separate form, e.g. `git foo --file ~/mine`,
+   not `git foo --file=~/mine`.  The shell will expand `~/` in the
+   former to your home directory, but most shells keep the tilde in
+   the latter.  Some of our commands know how to tilde-expand the
+   option value even when given in the stuck form, but not all of
+   them do.
+
  * When you give a revision parameter to a command, make sure the parameter is
    not ambiguous with a name of a file in the work tree.  E.g. do not write
    `git log -1 HEAD` but write `git log -1 HEAD --`; the former will not work

gitcredentials.html

@@ -764,6 +764,12 @@ <h2 id="_custom_helpers">CUSTOM HELPERS</h2>
 [credential]
         helper = "foo --bar='whitespace arg'"
 
+# store helper (discouraged) with custom location for the db file;
+# use `--file ~/.git-secret.txt`, rather than `--file=~/.git-secret.txt`,
+# to allow the shell to expand tilde to the home directory.
+[credential]
+        helper = "store --file ~/.git-secret.txt"
+
 # you can also use an absolute path, which will not use the git wrapper
 [credential]
         helper = "/path/to/my/helper --with-arguments"
@@ -858,7 +864,7 @@ <h2 id="_git">GIT</h2>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2023-07-18 08:52:58 -0700
+Last updated 2024-12-10 21:07:44 +0900
 </div>
 </div>
 </body>

gitcredentials.txt

@@ -242,6 +242,12 @@ Here are some example specifications:
 [credential]
 	helper = "foo --bar='whitespace arg'"
 
+# store helper (discouraged) with custom location for the db file;
+# use `--file ~/.git-secret.txt`, rather than `--file=~/.git-secret.txt`,
+# to allow the shell to expand tilde to the home directory.
+[credential]
+	helper = "store --file ~/.git-secret.txt"
+
 # you can also use an absolute path, which will not use the git wrapper
 [credential]
 	helper = "/path/to/my/helper --with-arguments"

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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:11:00 +0900
+Last updated 2024-12-10 21:08:08 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-10</span>
 </div>
 </div>
 <div id="content">
@@ -1326,7 +1326,7 @@ <h3 id="_preparing_a_merge_fix">Preparing a "merge-fix"</h3>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2024-12-06 15:11:00 +0900
+Last updated 2024-12-10 21:08:09 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:10:59 +0900
+Last updated 2024-12-10 21:08:07 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:11:00 +0900
+Last updated 2024-12-10 21:08:08 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:11:00 +0900
+Last updated 2024-12-10 21:08:08 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:11:00 +0900
+Last updated 2024-12-10 21:08:08 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:11:00 +0900
+Last updated 2024-12-10 21:08:08 +0900
 </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-12-06</span>
+<span id="revdate">2024-12-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-12-06 15:10:59 +0900
+Last updated 2024-12-10 21:08:08 +0900
 </div>
 </div>
 </body>