Autogenerated HTML docs for v2.44.0-84-gb3876

git · Mar 2, 2024 · ff92186 · ff92186
1 parent cd35a3e
commit ff92186
Show file tree

Hide file tree

Showing 63 changed files with 175 additions and 161 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-02-27</span>
+<span id="revdate">2024-03-01</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-02-27</span>
+<span id="revdate">2024-03-01</span>
 </div>
 <div id="content">
 <div class="sect1">

diff --git a/RelNotes/2.45.0.txt b/RelNotes/2.45.0.txt
@@ -15,6 +15,8 @@ UI, Workflows & Features
  * Variants of vimdiff learned to honor mergetool.<variant>.layout
    settings.
 
+ * "git reflog" learned a "list" subcommand that enumerates known reflogs.
+
 
 Performance, Internal Implementation, Development Support etc.
 
@@ -27,6 +29,10 @@ Performance, Internal Implementation, Development Support etc.
  * Some parts of command line completion script (in contrib/) have
    been micro-optimized.
 
+ * The way placeholders are to be marked-up in documentation have been
+   specified; use "_<placeholder>_" to typeset the word inside a pair
+   of <angle-brakets> emphasized.
+
 
 Fixes since v2.44
 -----------------
@@ -55,7 +61,16 @@ Fixes since v2.44
    to handle an empty password correctly.
    (merge 8f1f2023b7 mh/libsecret-empty-password-fix later to maint).
 
+ * "git difftool --dir-diff" learned to honor the "--trust-exit-code"
+   option; it used to always exit with 0 and signalled success.
+   (merge eb84c8b6ce ps/difftool-dir-diff-exit-code later to maint).
+
  * Other code cleanup, docfix, build fix, etc.
    (merge f0e578c69c rs/use-xstrncmpz later to maint).
    (merge 83e6eb7d7a ba/credential-test-clean-fix later to maint).
    (merge 64562d784d jb/doc-interactive-singlekey-do-not-need-perl later to maint).
+   (merge c431a235e2 cp/t9146-use-test-path-helpers later to maint).
+   (merge 82d75402d5 ds/doc-send-email-capitalization later to maint).
+   (merge 41bff66e35 jc/doc-add-placeholder-fix later to maint).
+   (merge 6835f0efe9 jw/remote-doc-typofix later to maint).
+   (merge 244001aa20 hs/rebase-not-in-progress later to maint).
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-02-27</span>
+<span id="revdate">2024-03-01</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-02-27</span>
+<span id="revdate">2024-03-01</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-02-27</span>
+<span id="revdate">2024-03-01</span>
 </div>
 <div id="content">
 <div class="sect1">

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-02-27</span>
+<span id="revdate">2024-03-01</span>
 </div>
 <div id="content">
 <div id="preamble">

diff --git a/git-add.html b/git-add.html
@@ -809,7 +809,7 @@ <h2 id="_options">OPTIONS</h2>
         to ignore removed files; use <code>--no-all</code> option if you want
         to add modified or new files but ignore removed ones.
 </p>
-<div class="paragraph"><p>For more details about the &lt;pathspec&gt; syntax, see the <em>pathspec</em> entry
+<div class="paragraph"><p>For more details about the <em>&lt;pathspec&gt;</em> syntax, see the <em>pathspec</em> entry
 in <a href="gitglossary.html">gitglossary(7)</a>.</p></div>
 </dd>
 <dt class="hdlist1">
@@ -916,10 +916,10 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Update the index just where it already has an entry matching
-        &lt;pathspec&gt;.  This removes as well as modifies index entries to
+        <em>&lt;pathspec&gt;</em>.  This removes as well as modifies index entries to
         match the working tree, but adds no new files.
 </p>
-<div class="paragraph"><p>If no &lt;pathspec&gt; is given when <code>-u</code> option is used, all
+<div class="paragraph"><p>If no <em>&lt;pathspec&gt;</em> is given when <code>-u</code> option is used, all
 tracked files in the entire working tree are updated (old versions
 of Git used to limit the update to the current directory and its
 subdirectories).</p></div>
@@ -936,11 +936,11 @@ <h2 id="_options">OPTIONS</h2>
 <dd>
 <p>
         Update the index not only where the working tree has a file
-        matching &lt;pathspec&gt; but also where the index already has an
+        matching <em>&lt;pathspec&gt;</em> but also where the index already has an
         entry. This adds, modifies, and removes index entries to
         match the working tree.
 </p>
-<div class="paragraph"><p>If no &lt;pathspec&gt; is given when <code>-A</code> option is used, all
+<div class="paragraph"><p>If no <em>&lt;pathspec&gt;</em> is given when <code>-A</code> option is used, all
 files in the entire working tree are updated (old versions
 of Git used to limit the update to the current directory and its
 subdirectories).</p></div>
@@ -956,11 +956,11 @@ <h2 id="_options">OPTIONS</h2>
         Update the index by adding new files that are unknown to the
         index and files modified in the working tree, but ignore
         files that have been removed from the working tree.  This
-        option is a no-op when no &lt;pathspec&gt; is used.
+        option is a no-op when no <em>&lt;pathspec&gt;</em> is used.
 </p>
 <div class="paragraph"><p>This option is primarily to help users who are used to older
-versions of Git, whose "git add &lt;pathspec&gt;&#8230;" was a synonym
-for "git add --no-all &lt;pathspec&gt;&#8230;", i.e. ignored removed files.</p></div>
+versions of Git, whose "git add <em>&lt;pathspec&gt;</em>&#8230;" was a synonym
+for "git add --no-all <em>&lt;pathspec&gt;</em>&#8230;", i.e. ignored removed files.</p></div>
 </dd>
 <dt class="hdlist1">
 -N
@@ -1050,8 +1050,8 @@ <h2 id="_options">OPTIONS</h2>
 </dt>
 <dd>
 <p>
-        Pathspec is passed in <code>&lt;file&gt;</code> instead of commandline args. If
-        <code>&lt;file&gt;</code> is exactly <code>-</code> then standard input is used. Pathspec
+        Pathspec is passed in <em>&lt;file&gt;</em> instead of commandline args. If
+        <em>&lt;file&gt;</em> is exactly <code>-</code> then standard input is used. Pathspec
         elements are separated by LF or CR/LF. Pathspec elements can be
         quoted as explained for the configuration variable <code>core.quotePath</code>
         (see <a href="git-config.html">git-config(1)</a>). See also <code>--pathspec-file-nul</code> and
@@ -1425,7 +1425,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2023-12-27 15:50:18 PST
+ 2024-03-01 17:30:58 PST
 </div>
 </div>
 </body>

diff --git a/git-add.txt b/git-add.txt
@@ -63,7 +63,7 @@ OPTIONS
 	to ignore removed files; use `--no-all` option if you want
 	to add modified or new files but ignore removed ones.
 +
-For more details about the <pathspec> syntax, see the 'pathspec' entry
+For more details about the _<pathspec>_ syntax, see the 'pathspec' entry
 in linkgit:gitglossary[7].
 
 -n::
@@ -119,10 +119,10 @@ apply to the index. See EDITING PATCHES below.
 -u::
 --update::
 	Update the index just where it already has an entry matching
-	<pathspec>.  This removes as well as modifies index entries to
+	_<pathspec>_.  This removes as well as modifies index entries to
 	match the working tree, but adds no new files.
 +
-If no <pathspec> is given when `-u` option is used, all
+If no _<pathspec>_ is given when `-u` option is used, all
 tracked files in the entire working tree are updated (old versions
 of Git used to limit the update to the current directory and its
 subdirectories).
@@ -131,11 +131,11 @@ subdirectories).
 --all::
 --no-ignore-removal::
 	Update the index not only where the working tree has a file
-	matching <pathspec> but also where the index already has an
+	matching _<pathspec>_ but also where the index already has an
 	entry. This adds, modifies, and removes index entries to
 	match the working tree.
 +
-If no <pathspec> is given when `-A` option is used, all
+If no _<pathspec>_ is given when `-A` option is used, all
 files in the entire working tree are updated (old versions
 of Git used to limit the update to the current directory and its
 subdirectories).
@@ -145,11 +145,11 @@ subdirectories).
 	Update the index by adding new files that are unknown to the
 	index and files modified in the working tree, but ignore
 	files that have been removed from the working tree.  This
-	option is a no-op when no <pathspec> is used.
+	option is a no-op when no _<pathspec>_ is used.
 +
 This option is primarily to help users who are used to older
-versions of Git, whose "git add <pathspec>..." was a synonym
-for "git add --no-all <pathspec>...", i.e. ignored removed files.
+versions of Git, whose "git add _<pathspec>_..." was a synonym
+for "git add --no-all _<pathspec>_...", i.e. ignored removed files.
 
 -N::
 --intent-to-add::
@@ -198,8 +198,8 @@ for "git add --no-all <pathspec>...", i.e. ignored removed files.
 	unchanged.
 
 --pathspec-from-file=<file>::
-	Pathspec is passed in `<file>` instead of commandline args. If
-	`<file>` is exactly `-` then standard input is used. Pathspec
+	Pathspec is passed in _<file>_ instead of commandline args. If
+	_<file>_ is exactly `-` then standard input is used. Pathspec
 	elements are separated by LF or CR/LF. Pathspec elements can be
 	quoted as explained for the configuration variable `core.quotePath`
 	(see linkgit:git-config[1]). See also `--pathspec-file-nul` and

diff --git a/git-clone.html b/git-clone.html
@@ -1213,7 +1213,7 @@ <h2 id="_options">OPTIONS</h2>
 </p>
 </dd>
 <dt class="hdlist1">
---ref-format=&lt;ref-format
+--ref-format=&lt;ref-format&gt;
 </dt>
 <dd>
 <p>
@@ -1534,7 +1534,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2024-01-16 12:41:37 PST
+ 2024-03-01 17:30:58 PST
 </div>
 </div>
 </body>

diff --git a/git-clone.txt b/git-clone.txt
@@ -311,7 +311,7 @@ or `--mirror` is given)
 	The result is Git repository can be separated from working
 	tree.
 
---ref-format=<ref-format::
+--ref-format=<ref-format>::
 
 Specify the given ref storage format for the repository. The valid values are:
 +

diff --git a/git-config.html b/git-config.html
@@ -5309,8 +5309,8 @@ <h3 id="_variables">Variables</h3>
 <dd>
 <p>
         When moved lines are colored using e.g. the <code>diff.colorMoved</code> setting,
-        this option controls the <code>&lt;mode&gt;</code> how spaces are treated
-        for details of valid modes see <em>--color-moved-ws</em> in <a href="git-diff.html">git-diff(1)</a>.
+        this option controls the <code>&lt;mode&gt;</code> how spaces are treated.
+        For details of valid modes see <em>--color-moved-ws</em> in <a href="git-diff.html">git-diff(1)</a>.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -9058,14 +9058,10 @@ <h3 id="_variables">Variables</h3>
         reachability bitmap is available, pack-objects will try to send
         parts of all packs in the MIDX.
 </p>
-<div class="literalblock">
-<div class="content">
-<pre><code>If only a single pack bitmap is available, and
-`pack.allowPackReuse` is set to "multi", reuse parts of just the
-bitmapped packfile. This can reduce memory and CPU usage to
-serve fetches, but might result in sending a slightly larger
-pack. Defaults to true.</code></pre>
-</div></div>
+<div class="paragraph"><p>If only a single pack bitmap is available, and <code>pack.allowPackReuse</code>
+is set to "multi", reuse parts of just the bitmapped packfile. This
+can reduce memory and CPU usage to serve fetches, but might result in
+sending a slightly larger pack. Defaults to true.</p></div>
 </dd>
 <dt class="hdlist1">
 pack.island
@@ -10470,7 +10466,7 @@ <h3 id="_variables">Variables</h3>
 </p>
 </dd>
 <dt class="hdlist1">
-sendemail.smtpsslcertpath
+sendemail.smtpSSLCertPath
 </dt>
 <dd>
 <p>
@@ -10594,13 +10590,13 @@ <h3 id="_variables">Variables</h3>
 sendemail.headerCmd
 </dt>
 <dt class="hdlist1">
-sendemail.signedoffbycc
+sendemail.signedOffByCc
 </dt>
 <dt class="hdlist1">
 sendemail.smtpPass
 </dt>
 <dt class="hdlist1">
-sendemail.suppresscc
+sendemail.suppressCc
 </dt>
 <dt class="hdlist1">
 sendemail.suppressFrom
@@ -10609,7 +10605,7 @@ <h3 id="_variables">Variables</h3>
 sendemail.to
 </dt>
 <dt class="hdlist1">
-sendemail.tocmd
+sendemail.toCmd
 </dt>
 <dt class="hdlist1">
 sendemail.smtpDomain
@@ -10646,11 +10642,11 @@ <h3 id="_variables">Variables</h3>
 </p>
 </dd>
 <dt class="hdlist1">
-sendemail.signedoffcc (deprecated)
+sendemail.signedOffCc (deprecated)
 </dt>
 <dd>
 <p>
-        Deprecated alias for <code>sendemail.signedoffbycc</code>.
+        Deprecated alias for <code>sendemail.signedOffByCc</code>.
 </p>
 </dd>
 <dt class="hdlist1">

diff --git a/git-diff.html b/git-diff.html
@@ -3649,8 +3649,8 @@ <h2 id="_configuration">CONFIGURATION</h2>
 <dd>
 <p>
         When moved lines are colored using e.g. the <code>diff.colorMoved</code> setting,
-        this option controls the <code>&lt;mode&gt;</code> how spaces are treated
-        for details of valid modes see <em>--color-moved-ws</em> in <a href="git-diff.html">git-diff(1)</a>.
+        this option controls the <code>&lt;mode&gt;</code> how spaces are treated.
+        For details of valid modes see <em>--color-moved-ws</em> in <a href="git-diff.html">git-diff(1)</a>.
 </p>
 </dd>
 </dl></div>

diff --git a/git-difftool.html b/git-difftool.html
@@ -912,7 +912,6 @@ <h2 id="_options">OPTIONS</h2>
 </dt>
 <dd>
 <p>
-        <em>git-difftool</em> invokes a diff tool individually on each file.
         Errors reported by the diff tool are ignored by default.
         Use <code>--trust-exit-code</code> to make <em>git-difftool</em> exit when an
         invoked diff tool returns a non-zero exit code.
@@ -1055,7 +1054,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2024-02-08 15:45:59 PST
+ 2024-03-01 17:30:58 PST
 </div>
 </div>
 </body>

diff --git a/git-difftool.txt b/git-difftool.txt
@@ -105,7 +105,6 @@ instead.  `--no-symlinks` is the default on Windows.
 	`merge.tool` until a tool is found.
 
 --[no-]trust-exit-code::
-	'git-difftool' invokes a diff tool individually on each file.
 	Errors reported by the diff tool are ignored by default.
 	Use `--trust-exit-code` to make 'git-difftool' exit when an
 	invoked diff tool returns a non-zero exit code.

diff --git a/git-fast-export.html b/git-fast-export.html
@@ -807,7 +807,7 @@ <h2 id="_options">OPTIONS</h2>
 when encountering such a tag.  With <em>drop</em> it will omit such tags from
 the output.  With <em>rewrite</em>, if the tagged object is a commit, it will
 rewrite the tag to tag an ancestor commit (via parent rewriting; see
-<a href="git-rev-list.html">git-rev-list(1)</a>)</p></div>
+<a href="git-rev-list.html">git-rev-list(1)</a>).</p></div>
 </dd>
 <dt class="hdlist1">
 -M
@@ -1120,7 +1120,7 @@ <h2 id="_git">GIT</h2>
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2022-10-28 11:53:56 PDT
+ 2024-03-01 17:30:58 PST
 </div>
 </div>
 </body>

diff --git a/git-fast-export.txt b/git-fast-export.txt
@@ -48,7 +48,7 @@ When asking to 'abort' (which is the default), this program will die
 when encountering such a tag.  With 'drop' it will omit such tags from
 the output.  With 'rewrite', if the tagged object is a commit, it will
 rewrite the tag to tag an ancestor commit (via parent rewriting; see
-linkgit:git-rev-list[1])
+linkgit:git-rev-list[1]).
 
 -M::
 -C::