Skip to content

Commit 15cf967

Browse files
committed
Autogenerated HTML docs for v2.44.0-568-g436d4
1 parent eabec52 commit 15cf967

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+140
-136
lines changed

MyFirstContribution.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>My First Contribution to the Git Project</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div class="sect1">

MyFirstObjectWalk.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>My First Object Walk</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div class="sect1">

RelNotes/2.45.0.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -335,6 +335,9 @@ Fixes since v2.44
335335
call advise() after checking advice_enabled().
336336
(merge 6412d01527 rj/use-adv-if-enabled later to maint).
337337

338+
* Another "set -u" fix for the bash prompt (in contrib/) script.
339+
(merge d7805bc743 vs/complete-with-set-u-fix later to maint).
340+
338341
* Other code cleanup, docfix, build fix, etc.
339342
(merge f0e578c69c rs/use-xstrncmpz later to maint).
340343
(merge 83e6eb7d7a ba/credential-test-clean-fix later to maint).
@@ -359,3 +362,4 @@ Fixes since v2.44
359362
(merge 86f9ce7dd6 bl/doc-config-fixes later to maint).
360363
(merge 0d527842b7 az/grep-group-error-message-update later to maint).
361364
(merge 7c43bdf07b rs/strbuf-expand-bad-format later to maint).
365+
(merge 8b68b48d5c ds/typofix-core-config-doc later to maint).

ReviewingGuidelines.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>Reviewing Patches in the Git Project</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div class="sect1">

SubmittingPatches.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>Submitting Patches</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div class="sect1">

ToolsForGit.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>Tools for developing Git</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div class="sect1">

everyday.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>Everyday Git With 20 Commands Or So</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div id="preamble">

git-config.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4573,7 +4573,7 @@ <h3 id="_variables">Variables</h3>
45734573
will not overwrite existing objects.
45744574
</p>
45754575
<div class="paragraph"><p>On some file system/operating system combinations, this is unreliable.
4576-
Set this config setting to <em>rename</em> there; However, This will remove the
4576+
Set this config setting to <em>rename</em> there; however, this will remove the
45774577
check that makes sure that existing object files will not get overwritten.</p></div>
45784578
</dd>
45794579
<dt class="hdlist1">

git-remote-helpers.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>git-remote-helpers</h1>
738-
<span id="revdate">2024-04-09</span>
738+
<span id="revdate">2024-04-10</span>
739739
</div>
740740
<div id="content">
741741
<div id="preamble">

git-update-ref.html

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -749,24 +749,24 @@ <h2>NAME</h2>
749749
<h2 id="_synopsis">SYNOPSIS</h2>
750750
<div class="sectionbody">
751751
<div class="verseblock">
752-
<pre class="content"><em>git update-ref</em> [-m &lt;reason&gt;] [--no-deref] (-d &lt;ref&gt; [&lt;oldvalue&gt;] | [--create-reflog] &lt;ref&gt; &lt;newvalue&gt; [&lt;oldvalue&gt;] | --stdin [-z])</pre>
752+
<pre class="content"><em>git update-ref</em> [-m &lt;reason&gt;] [--no-deref] (-d &lt;ref&gt; [&lt;old-oid&gt;] | [--create-reflog] &lt;ref&gt; &lt;new-oid&gt; [&lt;old-oid&gt;] | --stdin [-z])</pre>
753753
<div class="attribution">
754754
</div></div>
755755
</div>
756756
</div>
757757
<div class="sect1">
758758
<h2 id="_description">DESCRIPTION</h2>
759759
<div class="sectionbody">
760-
<div class="paragraph"><p>Given two arguments, stores the &lt;newvalue&gt; in the &lt;ref&gt;, possibly
760+
<div class="paragraph"><p>Given two arguments, stores the &lt;new-oid&gt; in the &lt;ref&gt;, possibly
761761
dereferencing the symbolic refs. E.g. <code>git update-ref HEAD
762-
&lt;newvalue&gt;</code> updates the current branch head to the new object.</p></div>
763-
<div class="paragraph"><p>Given three arguments, stores the &lt;newvalue&gt; in the &lt;ref&gt;,
762+
&lt;new-oid&gt;</code> updates the current branch head to the new object.</p></div>
763+
<div class="paragraph"><p>Given three arguments, stores the &lt;new-oid&gt; in the &lt;ref&gt;,
764764
possibly dereferencing the symbolic refs, after verifying that
765-
the current value of the &lt;ref&gt; matches &lt;oldvalue&gt;.
766-
E.g. <code>git update-ref refs/heads/master &lt;newvalue&gt; &lt;oldvalue&gt;</code>
767-
updates the master branch head to &lt;newvalue&gt; only if its current
768-
value is &lt;oldvalue&gt;. You can specify 40 "0" or an empty string
769-
as &lt;oldvalue&gt; to make sure that the ref you are creating does
765+
the current value of the &lt;ref&gt; matches &lt;old-oid&gt;.
766+
E.g. <code>git update-ref refs/heads/master &lt;new-oid&gt; &lt;old-oid&gt;</code>
767+
updates the master branch head to &lt;new-oid&gt; only if its current
768+
value is &lt;old-oid&gt;. You can specify 40 "0" or an empty string
769+
as &lt;old-oid&gt; to make sure that the ref you are creating does
770770
not exist.</p></div>
771771
<div class="paragraph"><p>It also allows a "ref" file to be a symbolic pointer to another
772772
ref file by starting with the four-byte header sequence of
@@ -797,15 +797,15 @@ <h2 id="_description">DESCRIPTION</h2>
797797
ref symlink to some other tree, if you have copied a whole
798798
archive by creating a symlink tree).</p></div>
799799
<div class="paragraph"><p>With <code>-d</code> flag, it deletes the named &lt;ref&gt; after verifying it
800-
still contains &lt;oldvalue&gt;.</p></div>
800+
still contains &lt;old-oid&gt;.</p></div>
801801
<div class="paragraph"><p>With <code>--stdin</code>, update-ref reads instructions from standard input and
802802
performs all modifications together. Specify commands of the form:</p></div>
803803
<div class="literalblock">
804804
<div class="content">
805-
<pre><code>update SP &lt;ref&gt; SP &lt;newvalue&gt; [SP &lt;oldvalue&gt;] LF
806-
create SP &lt;ref&gt; SP &lt;newvalue&gt; LF
807-
delete SP &lt;ref&gt; [SP &lt;oldvalue&gt;] LF
808-
verify SP &lt;ref&gt; [SP &lt;oldvalue&gt;] LF
805+
<pre><code>update SP &lt;ref&gt; SP &lt;new-oid&gt; [SP &lt;old-oid&gt;] LF
806+
create SP &lt;ref&gt; SP &lt;new-oid&gt; LF
807+
delete SP &lt;ref&gt; [SP &lt;old-oid&gt;] LF
808+
verify SP &lt;ref&gt; [SP &lt;old-oid&gt;] LF
809809
option SP &lt;opt&gt; LF
810810
start LF
811811
prepare LF
@@ -822,10 +822,10 @@ <h2 id="_description">DESCRIPTION</h2>
822822
quoting:</p></div>
823823
<div class="literalblock">
824824
<div class="content">
825-
<pre><code>update SP &lt;ref&gt; NUL &lt;newvalue&gt; NUL [&lt;oldvalue&gt;] NUL
826-
create SP &lt;ref&gt; NUL &lt;newvalue&gt; NUL
827-
delete SP &lt;ref&gt; NUL [&lt;oldvalue&gt;] NUL
828-
verify SP &lt;ref&gt; NUL [&lt;oldvalue&gt;] NUL
825+
<pre><code>update SP &lt;ref&gt; NUL &lt;new-oid&gt; NUL [&lt;old-oid&gt;] NUL
826+
create SP &lt;ref&gt; NUL &lt;new-oid&gt; NUL
827+
delete SP &lt;ref&gt; NUL [&lt;old-oid&gt;] NUL
828+
verify SP &lt;ref&gt; NUL [&lt;old-oid&gt;] NUL
829829
option SP &lt;opt&gt; NUL
830830
start NUL
831831
prepare NUL
@@ -843,9 +843,9 @@ <h2 id="_description">DESCRIPTION</h2>
843843
</dt>
844844
<dd>
845845
<p>
846-
Set &lt;ref&gt; to &lt;newvalue&gt; after verifying &lt;oldvalue&gt;, if given.
847-
Specify a zero &lt;newvalue&gt; to ensure the ref does not exist
848-
after the update and/or a zero &lt;oldvalue&gt; to make sure the
846+
Set &lt;ref&gt; to &lt;new-oid&gt; after verifying &lt;old-oid&gt;, if given.
847+
Specify a zero &lt;new-oid&gt; to ensure the ref does not exist
848+
after the update and/or a zero &lt;old-oid&gt; to make sure the
849849
ref does not exist before the update.
850850
</p>
851851
</dd>
@@ -854,26 +854,26 @@ <h2 id="_description">DESCRIPTION</h2>
854854
</dt>
855855
<dd>
856856
<p>
857-
Create &lt;ref&gt; with &lt;newvalue&gt; after verifying it does not
858-
exist. The given &lt;newvalue&gt; may not be zero.
857+
Create &lt;ref&gt; with &lt;new-oid&gt; after verifying it does not
858+
exist. The given &lt;new-oid&gt; may not be zero.
859859
</p>
860860
</dd>
861861
<dt class="hdlist1">
862862
delete
863863
</dt>
864864
<dd>
865865
<p>
866-
Delete &lt;ref&gt; after verifying it exists with &lt;oldvalue&gt;, if
867-
given. If given, &lt;oldvalue&gt; may not be zero.
866+
Delete &lt;ref&gt; after verifying it exists with &lt;old-oid&gt;, if
867+
given. If given, &lt;old-oid&gt; may not be zero.
868868
</p>
869869
</dd>
870870
<dt class="hdlist1">
871871
verify
872872
</dt>
873873
<dd>
874874
<p>
875-
Verify &lt;ref&gt; against &lt;oldvalue&gt; but do not change it. If
876-
&lt;oldvalue&gt; is zero or missing, the ref must not exist.
875+
Verify &lt;ref&gt; against &lt;old-oid&gt; but do not change it. If
876+
&lt;old-oid&gt; is zero or missing, the ref must not exist.
877877
</p>
878878
</dd>
879879
<dt class="hdlist1">
@@ -926,7 +926,7 @@ <h2 id="_description">DESCRIPTION</h2>
926926
</p>
927927
</dd>
928928
</dl></div>
929-
<div class="paragraph"><p>If all &lt;ref&gt;s can be locked with matching &lt;oldvalue&gt;s
929+
<div class="paragraph"><p>If all &lt;ref&gt;s can be locked with matching &lt;old-oid&gt;s
930930
simultaneously, all modifications are performed. Otherwise, no
931931
modifications are performed. Note that while each individual
932932
&lt;ref&gt; is updated or deleted atomically, a concurrent reader may
@@ -949,7 +949,7 @@ <h2 id="_logging_updates">LOGGING UPDATES</h2>
949949
</div></div>
950950
<div class="paragraph"><p>Where "oldsha1" is the 40 character hexadecimal value previously
951951
stored in &lt;ref&gt;, "newsha1" is the 40 character hexadecimal value of
952-
&lt;newvalue&gt; and "committer" is the committer&#8217;s name, email address
952+
&lt;new-oid&gt; and "committer" is the committer&#8217;s name, email address
953953
and date in the standard Git committer ident format.</p></div>
954954
<div class="paragraph"><p>Optionally with -m:</p></div>
955955
<div class="literalblock">
@@ -974,7 +974,7 @@ <h2 id="_git">GIT</h2>
974974
<div id="footer">
975975
<div id="footer-text">
976976
Last updated
977-
2023-10-23 14:43:46 PDT
977+
2024-04-10 12:46:30 PDT
978978
</div>
979979
</div>
980980
</body>

git-update-ref.txt

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -8,21 +8,21 @@ git-update-ref - Update the object name stored in a ref safely
88
SYNOPSIS
99
--------
1010
[verse]
11-
'git update-ref' [-m <reason>] [--no-deref] (-d <ref> [<oldvalue>] | [--create-reflog] <ref> <newvalue> [<oldvalue>] | --stdin [-z])
11+
'git update-ref' [-m <reason>] [--no-deref] (-d <ref> [<old-oid>] | [--create-reflog] <ref> <new-oid> [<old-oid>] | --stdin [-z])
1212

1313
DESCRIPTION
1414
-----------
15-
Given two arguments, stores the <newvalue> in the <ref>, possibly
15+
Given two arguments, stores the <new-oid> in the <ref>, possibly
1616
dereferencing the symbolic refs. E.g. `git update-ref HEAD
17-
<newvalue>` updates the current branch head to the new object.
17+
<new-oid>` updates the current branch head to the new object.
1818

19-
Given three arguments, stores the <newvalue> in the <ref>,
19+
Given three arguments, stores the <new-oid> in the <ref>,
2020
possibly dereferencing the symbolic refs, after verifying that
21-
the current value of the <ref> matches <oldvalue>.
22-
E.g. `git update-ref refs/heads/master <newvalue> <oldvalue>`
23-
updates the master branch head to <newvalue> only if its current
24-
value is <oldvalue>. You can specify 40 "0" or an empty string
25-
as <oldvalue> to make sure that the ref you are creating does
21+
the current value of the <ref> matches <old-oid>.
22+
E.g. `git update-ref refs/heads/master <new-oid> <old-oid>`
23+
updates the master branch head to <new-oid> only if its current
24+
value is <old-oid>. You can specify 40 "0" or an empty string
25+
as <old-oid> to make sure that the ref you are creating does
2626
not exist.
2727

2828
It also allows a "ref" file to be a symbolic pointer to another
@@ -56,15 +56,15 @@ ref symlink to some other tree, if you have copied a whole
5656
archive by creating a symlink tree).
5757

5858
With `-d` flag, it deletes the named <ref> after verifying it
59-
still contains <oldvalue>.
59+
still contains <old-oid>.
6060

6161
With `--stdin`, update-ref reads instructions from standard input and
6262
performs all modifications together. Specify commands of the form:
6363

64-
update SP <ref> SP <newvalue> [SP <oldvalue>] LF
65-
create SP <ref> SP <newvalue> LF
66-
delete SP <ref> [SP <oldvalue>] LF
67-
verify SP <ref> [SP <oldvalue>] LF
64+
update SP <ref> SP <new-oid> [SP <old-oid>] LF
65+
create SP <ref> SP <new-oid> LF
66+
delete SP <ref> [SP <old-oid>] LF
67+
verify SP <ref> [SP <old-oid>] LF
6868
option SP <opt> LF
6969
start LF
7070
prepare LF
@@ -82,10 +82,10 @@ specify a missing value, omit the value and its preceding SP entirely.
8282
Alternatively, use `-z` to specify in NUL-terminated format, without
8383
quoting:
8484

85-
update SP <ref> NUL <newvalue> NUL [<oldvalue>] NUL
86-
create SP <ref> NUL <newvalue> NUL
87-
delete SP <ref> NUL [<oldvalue>] NUL
88-
verify SP <ref> NUL [<oldvalue>] NUL
85+
update SP <ref> NUL <new-oid> NUL [<old-oid>] NUL
86+
create SP <ref> NUL <new-oid> NUL
87+
delete SP <ref> NUL [<old-oid>] NUL
88+
verify SP <ref> NUL [<old-oid>] NUL
8989
option SP <opt> NUL
9090
start NUL
9191
prepare NUL
@@ -100,22 +100,22 @@ recognizes as an object name. Commands in any other format or a
100100
repeated <ref> produce an error. Command meanings are:
101101

102102
update::
103-
Set <ref> to <newvalue> after verifying <oldvalue>, if given.
104-
Specify a zero <newvalue> to ensure the ref does not exist
105-
after the update and/or a zero <oldvalue> to make sure the
103+
Set <ref> to <new-oid> after verifying <old-oid>, if given.
104+
Specify a zero <new-oid> to ensure the ref does not exist
105+
after the update and/or a zero <old-oid> to make sure the
106106
ref does not exist before the update.
107107

108108
create::
109-
Create <ref> with <newvalue> after verifying it does not
110-
exist. The given <newvalue> may not be zero.
109+
Create <ref> with <new-oid> after verifying it does not
110+
exist. The given <new-oid> may not be zero.
111111

112112
delete::
113-
Delete <ref> after verifying it exists with <oldvalue>, if
114-
given. If given, <oldvalue> may not be zero.
113+
Delete <ref> after verifying it exists with <old-oid>, if
114+
given. If given, <old-oid> may not be zero.
115115

116116
verify::
117-
Verify <ref> against <oldvalue> but do not change it. If
118-
<oldvalue> is zero or missing, the ref must not exist.
117+
Verify <ref> against <old-oid> but do not change it. If
118+
<old-oid> is zero or missing, the ref must not exist.
119119

120120
option::
121121
Modify the behavior of the next command naming a <ref>.
@@ -141,7 +141,7 @@ abort::
141141
Abort the transaction, releasing all locks if the transaction is in
142142
prepared state.
143143

144-
If all <ref>s can be locked with matching <oldvalue>s
144+
If all <ref>s can be locked with matching <old-oid>s
145145
simultaneously, all modifications are performed. Otherwise, no
146146
modifications are performed. Note that while each individual
147147
<ref> is updated or deleted atomically, a concurrent reader may
@@ -161,7 +161,7 @@ formatted as:
161161

162162
Where "oldsha1" is the 40 character hexadecimal value previously
163163
stored in <ref>, "newsha1" is the 40 character hexadecimal value of
164-
<newvalue> and "committer" is the committer's name, email address
164+
<new-oid> and "committer" is the committer's name, email address
165165
and date in the standard Git committer ident format.
166166

167167
Optionally with -m:

githooks.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -975,12 +975,12 @@ <h3 id="pre-receive">pre-receive</h3>
975975
input a line of the format:</p></div>
976976
<div class="literalblock">
977977
<div class="content">
978-
<pre><code>&lt;old-value&gt; SP &lt;new-value&gt; SP &lt;ref-name&gt; LF</code></pre>
978+
<pre><code>&lt;old-oid&gt; SP &lt;new-oid&gt; SP &lt;ref-name&gt; LF</code></pre>
979979
</div></div>
980-
<div class="paragraph"><p>where <code>&lt;old-value&gt;</code> is the old object name stored in the ref,
981-
<code>&lt;new-value&gt;</code> is the new object name to be stored in the ref and
980+
<div class="paragraph"><p>where <code>&lt;old-oid&gt;</code> is the old object name stored in the ref,
981+
<code>&lt;new-oid&gt;</code> is the new object name to be stored in the ref and
982982
<code>&lt;ref-name&gt;</code> is the full name of the ref.
983-
When creating a new ref, <code>&lt;old-value&gt;</code> is the all-zeroes object name.</p></div>
983+
When creating a new ref, <code>&lt;old-oid&gt;</code> is the all-zeroes object name.</p></div>
984984
<div class="paragraph"><p>If the hook exits with non-zero status, none of the refs will be
985985
updated. If the hook exits with zero, updating of individual refs can
986986
still be prevented by the <a href="#update"><em>update</em></a> hook.</p></div>
@@ -1198,13 +1198,13 @@ <h3 id="_reference_transaction">reference-transaction</h3>
11981198
receives on standard input a line of the format:</p></div>
11991199
<div class="literalblock">
12001200
<div class="content">
1201-
<pre><code>&lt;old-value&gt; SP &lt;new-value&gt; SP &lt;ref-name&gt; LF</code></pre>
1201+
<pre><code>&lt;old-oid&gt; SP &lt;new-oid&gt; SP &lt;ref-name&gt; LF</code></pre>
12021202
</div></div>
1203-
<div class="paragraph"><p>where <code>&lt;old-value&gt;</code> is the old object name passed into the reference
1204-
transaction, <code>&lt;new-value&gt;</code> is the new object name to be stored in the
1203+
<div class="paragraph"><p>where <code>&lt;old-oid&gt;</code> is the old object name passed into the reference
1204+
transaction, <code>&lt;new-oid&gt;</code> is the new object name to be stored in the
12051205
ref and <code>&lt;ref-name&gt;</code> is the full name of the ref. When force updating
12061206
the reference regardless of its current value or when the reference is
1207-
to be created anew, <code>&lt;old-value&gt;</code> is the all-zeroes object name. To
1207+
to be created anew, <code>&lt;old-oid&gt;</code> is the all-zeroes object name. To
12081208
distinguish these cases, you can inspect the current value of
12091209
<code>&lt;ref-name&gt;</code> via <code>git rev-parse</code>.</p></div>
12101210
<div class="paragraph"><p>The exit status of the hook is ignored for any state except for the
@@ -1442,7 +1442,7 @@ <h2 id="_git">GIT</h2>
14421442
<div id="footer">
14431443
<div id="footer-text">
14441444
Last updated
1445-
2024-02-08 15:45:59 PST
1445+
2024-04-10 12:46:30 PDT
14461446
</div>
14471447
</div>
14481448
</body>

0 commit comments

Comments
 (0)