@@ -749,24 +749,24 @@ <h2>NAME</h2>
749
749
< h2 id ="_synopsis "> SYNOPSIS</ h2 >
750
750
< div class ="sectionbody ">
751
751
< div class ="verseblock ">
752
- < pre class ="content "> < em > git update-ref</ em > [-m <reason>] [--no-deref] (-d <ref> [<oldvalue >] | [--create-reflog] <ref> <newvalue > [<oldvalue >] | --stdin [-z])</ pre >
752
+ < pre class ="content "> < em > git update-ref</ em > [-m <reason>] [--no-deref] (-d <ref> [<old-oid >] | [--create-reflog] <ref> <new-oid > [<old-oid >] | --stdin [-z])</ pre >
753
753
< div class ="attribution ">
754
754
</ div > </ div >
755
755
</ div >
756
756
</ div >
757
757
< div class ="sect1 ">
758
758
< h2 id ="_description "> DESCRIPTION</ h2 >
759
759
< div class ="sectionbody ">
760
- < div class ="paragraph "> < p > Given two arguments, stores the <newvalue > in the <ref>, possibly
760
+ < div class ="paragraph "> < p > Given two arguments, stores the <new-oid > in the <ref>, possibly
761
761
dereferencing the symbolic refs. E.g. < code > git update-ref HEAD
762
- <newvalue ></ code > updates the current branch head to the new object.</ p > </ div >
763
- < div class ="paragraph "> < p > Given three arguments, stores the <newvalue > in the <ref>,
762
+ <new-oid ></ code > updates the current branch head to the new object.</ p > </ div >
763
+ < div class ="paragraph "> < p > Given three arguments, stores the <new-oid > in the <ref>,
764
764
possibly dereferencing the symbolic refs, after verifying that
765
- the current value of the <ref> matches <oldvalue >.
766
- E.g. < code > git update-ref refs/heads/master <newvalue > <oldvalue ></ code >
767
- updates the master branch head to <newvalue > only if its current
768
- value is <oldvalue >. You can specify 40 "0" or an empty string
769
- as <oldvalue > to make sure that the ref you are creating does
765
+ the current value of the <ref> matches <old-oid >.
766
+ E.g. < code > git update-ref refs/heads/master <new-oid > <old-oid ></ code >
767
+ updates the master branch head to <new-oid > only if its current
768
+ value is <old-oid >. You can specify 40 "0" or an empty string
769
+ as <old-oid > to make sure that the ref you are creating does
770
770
not exist.</ p > </ div >
771
771
< div class ="paragraph "> < p > It also allows a "ref" file to be a symbolic pointer to another
772
772
ref file by starting with the four-byte header sequence of
@@ -797,15 +797,15 @@ <h2 id="_description">DESCRIPTION</h2>
797
797
ref symlink to some other tree, if you have copied a whole
798
798
archive by creating a symlink tree).</ p > </ div >
799
799
< div class ="paragraph "> < p > With < code > -d</ code > flag, it deletes the named <ref> after verifying it
800
- still contains <oldvalue >.</ p > </ div >
800
+ still contains <old-oid >.</ p > </ div >
801
801
< div class ="paragraph "> < p > With < code > --stdin</ code > , update-ref reads instructions from standard input and
802
802
performs all modifications together. Specify commands of the form:</ p > </ div >
803
803
< div class ="literalblock ">
804
804
< div class ="content ">
805
- < pre > < code > update SP <ref> SP <newvalue > [SP <oldvalue >] LF
806
- create SP <ref> SP <newvalue > LF
807
- delete SP <ref> [SP <oldvalue >] LF
808
- verify SP <ref> [SP <oldvalue >] LF
805
+ < pre > < code > update SP <ref> SP <new-oid > [SP <old-oid >] LF
806
+ create SP <ref> SP <new-oid > LF
807
+ delete SP <ref> [SP <old-oid >] LF
808
+ verify SP <ref> [SP <old-oid >] LF
809
809
option SP <opt> LF
810
810
start LF
811
811
prepare LF
@@ -822,10 +822,10 @@ <h2 id="_description">DESCRIPTION</h2>
822
822
quoting:</ p > </ div >
823
823
< div class ="literalblock ">
824
824
< div class ="content ">
825
- < pre > < code > update SP <ref> NUL <newvalue > NUL [<oldvalue >] NUL
826
- create SP <ref> NUL <newvalue > NUL
827
- delete SP <ref> NUL [<oldvalue >] NUL
828
- verify SP <ref> NUL [<oldvalue >] NUL
825
+ < pre > < code > update SP <ref> NUL <new-oid > NUL [<old-oid >] NUL
826
+ create SP <ref> NUL <new-oid > NUL
827
+ delete SP <ref> NUL [<old-oid >] NUL
828
+ verify SP <ref> NUL [<old-oid >] NUL
829
829
option SP <opt> NUL
830
830
start NUL
831
831
prepare NUL
@@ -843,9 +843,9 @@ <h2 id="_description">DESCRIPTION</h2>
843
843
</ dt >
844
844
< dd >
845
845
< p >
846
- Set <ref> to <newvalue > after verifying <oldvalue >, if given.
847
- Specify a zero <newvalue > to ensure the ref does not exist
848
- after the update and/or a zero <oldvalue > to make sure the
846
+ Set <ref> to <new-oid > after verifying <old-oid >, if given.
847
+ Specify a zero <new-oid > to ensure the ref does not exist
848
+ after the update and/or a zero <old-oid > to make sure the
849
849
ref does not exist before the update.
850
850
</ p >
851
851
</ dd >
@@ -854,26 +854,26 @@ <h2 id="_description">DESCRIPTION</h2>
854
854
</ dt >
855
855
< dd >
856
856
< p >
857
- Create <ref> with <newvalue > after verifying it does not
858
- exist. The given <newvalue > may not be zero.
857
+ Create <ref> with <new-oid > after verifying it does not
858
+ exist. The given <new-oid > may not be zero.
859
859
</ p >
860
860
</ dd >
861
861
< dt class ="hdlist1 ">
862
862
delete
863
863
</ dt >
864
864
< dd >
865
865
< p >
866
- Delete <ref> after verifying it exists with <oldvalue >, if
867
- given. If given, <oldvalue > may not be zero.
866
+ Delete <ref> after verifying it exists with <old-oid >, if
867
+ given. If given, <old-oid > may not be zero.
868
868
</ p >
869
869
</ dd >
870
870
< dt class ="hdlist1 ">
871
871
verify
872
872
</ dt >
873
873
< dd >
874
874
< p >
875
- Verify <ref> against <oldvalue > but do not change it. If
876
- <oldvalue > is zero or missing, the ref must not exist.
875
+ Verify <ref> against <old-oid > but do not change it. If
876
+ <old-oid > is zero or missing, the ref must not exist.
877
877
</ p >
878
878
</ dd >
879
879
< dt class ="hdlist1 ">
@@ -926,7 +926,7 @@ <h2 id="_description">DESCRIPTION</h2>
926
926
</ p >
927
927
</ dd >
928
928
</ dl > </ div >
929
- < div class ="paragraph "> < p > If all <ref>s can be locked with matching <oldvalue >s
929
+ < div class ="paragraph "> < p > If all <ref>s can be locked with matching <old-oid >s
930
930
simultaneously, all modifications are performed. Otherwise, no
931
931
modifications are performed. Note that while each individual
932
932
<ref> is updated or deleted atomically, a concurrent reader may
@@ -949,7 +949,7 @@ <h2 id="_logging_updates">LOGGING UPDATES</h2>
949
949
</ div > </ div >
950
950
< div class ="paragraph "> < p > Where "oldsha1" is the 40 character hexadecimal value previously
951
951
stored in <ref>, "newsha1" is the 40 character hexadecimal value of
952
- <newvalue > and "committer" is the committer’s name, email address
952
+ <new-oid > and "committer" is the committer’s name, email address
953
953
and date in the standard Git committer ident format.</ p > </ div >
954
954
< div class ="paragraph "> < p > Optionally with -m:</ p > </ div >
955
955
< div class ="literalblock ">
@@ -974,7 +974,7 @@ <h2 id="_git">GIT</h2>
974
974
< div id ="footer ">
975
975
< div id ="footer-text ">
976
976
Last updated
977
- 2023-10-23 14:43:46 PDT
977
+ 2024-04-10 12:46:30 PDT
978
978
</ div >
979
979
</ div >
980
980
</ body >
0 commit comments