Autogenerated HTML docs for v2.44.0-413-gd6fd0

git · Mar 28, 2024 · c416a71 · c416a71
1 parent 8842ccc
commit c416a71
Show file tree

Hide file tree

Showing 60 changed files with 200 additions and 82 deletions.
diff --git a/MyFirstContribution.html b/MyFirstContribution.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>My First Contribution to the Git Project</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div class="sect1">

diff --git a/MyFirstObjectWalk.html b/MyFirstObjectWalk.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>My First Object Walk</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div class="sect1">

diff --git a/RelNotes/2.45.0.txt b/RelNotes/2.45.0.txt
@@ -45,6 +45,18 @@ UI, Workflows & Features
  * The output format for dates "iso-strict" has been tweaked to show
    a time in the Zulu timezone with "Z" suffix, instead of "+00:00".
 
+ * "git diff" and friends learned two extra configuration variables,
+   diff.srcPrefix and diff.dstPrefix.
+
+ * The status.showUntrackedFiles configuration variable had a name
+   that tempts users to set a Boolean value expressed in our usual
+   "false", "off", and "0", but it only took "no".  This has been
+   corrected so "true" and its synonyms are taken as "normal", while
+   "false" and its synonyms are taken as "no".
+
+ * Remove an ancient and not well maintained Hg-to-git migration
+   script from contrib/.
+
 
 Performance, Internal Implementation, Development Support etc.
 
@@ -93,6 +105,12 @@ Performance, Internal Implementation, Development Support etc.
  * The code to iterate over reflogs in the reftable has been optimized
    to reduce memory allocation and deallocation.
 
+ * Work to support a repository that work with both SHA-1 and SHA-256
+   hash algorithms has started.
+
+ * A new fuzz target that exercises config parsing code has been
+   added.
+
 
 Fixes since v2.44
 -----------------

diff --git a/ReviewingGuidelines.html b/ReviewingGuidelines.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>Reviewing Patches in the Git Project</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div class="sect1">

diff --git a/SubmittingPatches.html b/SubmittingPatches.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>Submitting Patches</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div class="sect1">

diff --git a/ToolsForGit.html b/ToolsForGit.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>Tools for developing Git</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div class="sect1">

diff --git a/diff-options.txt b/diff-options.txt
@@ -865,8 +865,9 @@ endif::git-format-patch[]
 
 --default-prefix::
 	Use the default source and destination prefixes ("a/" and "b/").
-	This is usually the default already, but may be used to override
-	config such as `diff.noprefix`.
+	This overrides configuration variables such as `diff.noprefix`,
+	`diff.srcPrefix`, `diff.dstPrefix`, and `diff.mnemonicPrefix`
+	(see `git-config`(1)).
 
 --line-prefix=<prefix>::
 	Prepend an additional prefix to every line of output.

diff --git a/everyday.html b/everyday.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>Everyday Git With 20 Commands Or So</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div id="preamble">

diff --git a/git-commit.html b/git-commit.html
@@ -1348,7 +1348,9 @@ <h2 id="_options">OPTIONS</h2>
 </p>
 </li>
 </ul></div>
-<div class="paragraph"><p>The default can be changed using the status.showUntrackedFiles
+<div class="paragraph"><p>All usual spellings for Boolean value <code>true</code> are taken as <code>normal</code>
+and <code>false</code> as <code>no</code>.
+The default can be changed using the status.showUntrackedFiles
 configuration variable documented in <a href="git-config.html">git-config(1)</a>.</p></div>
 </div></div>
 </dd>
@@ -1840,7 +1842,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2023-10-04 15:43:56 PDT
+ 2024-03-28 14:36:08 PDT
 </div>
 </div>
 </body>

diff --git a/git-commit.txt b/git-commit.txt
@@ -347,6 +347,8 @@ The possible options are:
 	- 'normal' - Shows untracked files and directories
 	- 'all'    - Also shows individual files in untracked directories.
 
+All usual spellings for Boolean value `true` are taken as `normal`
+and `false` as `no`.
 The default can be changed using the status.showUntrackedFiles
 configuration variable documented in linkgit:git-config[1].
 --

diff --git a/git-config.html b/git-config.html
@@ -4903,14 +4903,30 @@ <h3 id="_variables">Variables</h3>
 </dl></div>
 </dd>
 <dt class="hdlist1">
-diff.noprefix
+diff.noPrefix
 </dt>
 <dd>
 <p>
         If set, <em>git diff</em> does not show any source or destination prefix.
 </p>
 </dd>
 <dt class="hdlist1">
+diff.srcPrefix
+</dt>
+<dd>
+<p>
+        If set, <em>git diff</em> uses this source prefix. Defaults to "a/".
+</p>
+</dd>
+<dt class="hdlist1">
+diff.dstPrefix
+</dt>
+<dd>
+<p>
+        If set, <em>git diff</em> uses this destination prefix. Defaults to "b/".
+</p>
+</dd>
+<dt class="hdlist1">
 diff.relative
 </dt>
 <dd>
@@ -5423,6 +5439,22 @@ <h3 id="_variables">Variables</h3>
 work and will produce hard-to-diagnose issues.</p></div>
 </dd>
 <dt class="hdlist1">
+extensions.compatObjectFormat
+</dt>
+<dd>
+<p>
+        Specify a compatitbility hash algorithm to use.  The acceptable values
+        are <code>sha1</code> and <code>sha256</code>.  The value specified must be different from the
+        value of extensions.objectFormat.  This allows client level
+        interoperability between git repositories whose objectFormat matches
+        this compatObjectFormat.  In particular when fully implemented the
+        pushes and pulls from a repository in whose objectFormat matches
+        compatObjectFormat.  As well as being able to use oids encoded in
+        compatObjectFormat in addition to oids encoded with objectFormat to
+        locally specify objects.
+</p>
+</dd>
+<dt class="hdlist1">
 extensions.refStorage
 </dt>
 <dd>
@@ -10982,6 +11014,8 @@ <h3 id="_variables">Variables</h3>
 </ul></div>
 </div></div>
 <div class="paragraph"><p>If this variable is not specified, it defaults to <em>normal</em>.
+All usual spellings for Boolean value <code>true</code> are taken as <code>normal</code>
+and <code>false</code> as <code>no</code>.
 This variable can be overridden with the -u|--untracked-files option
 of <a href="git-status.html">git-status(1)</a> and <a href="git-commit.html">git-commit(1)</a>.</p></div>
 </dd>

diff --git a/git-diff-files.html b/git-diff-files.html
@@ -2024,8 +2024,9 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-diff-index.html b/git-diff-index.html
@@ -2025,8 +2025,9 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-diff-tree.html b/git-diff-tree.html
@@ -2026,8 +2026,9 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-diff.html b/git-diff.html
@@ -2166,8 +2166,9 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">
@@ -3224,14 +3225,30 @@ <h2 id="_configuration">CONFIGURATION</h2>
 </dl></div>
 </dd>
 <dt class="hdlist1">
-diff.noprefix
+diff.noPrefix
 </dt>
 <dd>
 <p>
         If set, <em>git diff</em> does not show any source or destination prefix.
 </p>
 </dd>
 <dt class="hdlist1">
+diff.srcPrefix
+</dt>
+<dd>
+<p>
+        If set, <em>git diff</em> uses this source prefix. Defaults to "a/".
+</p>
+</dd>
+<dt class="hdlist1">
+diff.dstPrefix
+</dt>
+<dd>
+<p>
+        If set, <em>git diff</em> uses this destination prefix. Defaults to "b/".
+</p>
+</dd>
+<dt class="hdlist1">
 diff.relative
 </dt>
 <dd>

diff --git a/git-format-patch.html b/git-format-patch.html
@@ -1606,8 +1606,9 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-log.html b/git-log.html
@@ -4954,8 +4954,9 @@ <h2 id="_diff_formatting">DIFF FORMATTING</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-remote-helpers.html b/git-remote-helpers.html
@@ -735,7 +735,7 @@
 <body class="article">
 <div id="header">
 <h1>git-remote-helpers</h1>
-<span id="revdate">2024-03-25</span>
+<span id="revdate">2024-03-28</span>
 </div>
 <div id="content">
 <div id="preamble">

diff --git a/git-rev-parse.html b/git-rev-parse.html
@@ -1001,6 +1001,28 @@ <h3 id="_options_for_output">Options for Output</h3>
         refnames (e.g. "refs/heads/master").
 </p>
 </dd>
+<dt class="hdlist1">
+--output-object-format=(sha1|sha256|storage)
+</dt>
+<dd>
+<p>
+        Allow oids to be input from any object format that the current
+        repository supports.
+</p>
+<div class="literalblock">
+<div class="content">
+<pre><code>Specifying "sha1" translates if necessary and returns a sha1 oid.</code></pre>
+</div></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>Specifying "sha256" translates if necessary and returns a sha256 oid.</code></pre>
+</div></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>Specifying "storage" translates if necessary and returns an oid in
+encoded in the storage hash algorithm.</code></pre>
+</div></div>
+</dd>
 </dl></div>
 </div>
 <div class="sect2">
@@ -2159,7 +2181,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2024-03-01 17:30:58 PST
+ 2024-03-28 14:36:08 PDT
 </div>
 </div>
 </body>

diff --git a/git-rev-parse.txt b/git-rev-parse.txt
@@ -159,6 +159,18 @@ for another option.
 	unfortunately named tag "master"), and shows them as full
 	refnames (e.g. "refs/heads/master").
 
+--output-object-format=(sha1|sha256|storage)::
+
+	Allow oids to be input from any object format that the current
+	repository supports.
+
+	Specifying "sha1" translates if necessary and returns a sha1 oid.
+
+	Specifying "sha256" translates if necessary and returns a sha256 oid.
+
+	Specifying "storage" translates if necessary and returns an oid in
+	encoded in the storage hash algorithm.
+
 Options for Objects
 ~~~~~~~~~~~~~~~~~~~
 

diff --git a/git-show.html b/git-show.html
@@ -3406,8 +3406,9 @@ <h2 id="_diff_formatting">DIFF FORMATTING</h2>
 <dd>
 <p>
         Use the default source and destination prefixes ("a/" and "b/").
-        This is usually the default already, but may be used to override
-        config such as <code>diff.noprefix</code>.
+        This overrides configuration variables such as <code>diff.noprefix</code>,
+        <code>diff.srcPrefix</code>, <code>diff.dstPrefix</code>, and <code>diff.mnemonicPrefix</code>
+        (see <code>git-config</code>(1)).
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-status.html b/git-status.html
@@ -877,7 +877,9 @@ <h2 id="_options">OPTIONS</h2>
 Consider enabling untracked cache and split index if supported (see
 <code>git update-index --untracked-cache</code> and <code>git update-index
 --split-index</code>), Otherwise you can use <code>no</code> to have <code>git status</code>
-return more quickly without showing untracked files.</p></div>
+return more quickly without showing untracked files.
+All usual spellings for Boolean value <code>true</code> are taken as <code>normal</code>
+and <code>false</code> as <code>no</code>.</p></div>
 <div class="paragraph"><p>The default can be changed using the status.showUntrackedFiles
 configuration variable documented in <a href="git-config.html">git-config(1)</a>.</p></div>
 </div></div>
@@ -1464,7 +1466,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2024-03-21 16:28:38 PDT
+ 2024-03-28 14:36:08 PDT
 </div>
 </div>
 </body>