commit - 482b0b83833675d8c750a996c3a9db1fb99e1e8d
commit + a290e4b40845ee5d251cdf5e4d9b31693f37ea49
blob - d52a563d452f3ee2fe440e9ab63d1a2b3ddb551f
blob + 086e9968300ec8161ed6529d40471881657f0b98
--- got/got.1
+++ got/got.1
.Pp
The expected
.Ar commit
-argument is a commit ID SHA1 hash or an existing reference
-or tag name which will be resolved to a commit ID.
+argument is a commit ID SHA1 hash, or a reference name or a keyword
+which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used, with both resolving to the
-repository's HEAD reference, or, if the
+resolve to the repository's HEAD reference, or, if the
.Fl b
option is used, the head of the checked-out
.Ar branch .
.Pp
The expected
.Ar commit
-argument is a commit ID SHA1 hash or an existing reference
-or tag name which will be resolved to a commit ID.
+argument is a commit ID SHA1 hash, or a reference name or a keyword
+which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
Keywords and reference names may be appended with
.Qq :+
or
.Pp
The expected
.Ar commit
-argument is a commit ID SHA1 hash or an existing reference
-or tag name which will be resolved to a commit ID.
+argument is a commit ID SHA1 hash, or a reference name or a keyword
+which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
The former is only valid if invoked in a work tree, while the latter will
resolve to the tip of the work tree's current branch if invoked in a
work tree, otherwise it will resolve to the repository's HEAD reference.
.Pp
The expected
.Ar commit
-argument is a commit ID SHA1 hash or an existing reference
-or tag name which will be resolved to a commit ID.
+argument is a commit ID SHA1 hash, or a reference name or a keyword
+which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
The former is only valid if invoked in a work tree, while the latter will
resolve to the tip of the work tree's current branch if invoked in a
work tree, otherwise it will resolve to the repository's HEAD reference.
.It Fl c Ar commit
Make a newly created branch reference point at the specified
.Ar commit .
-The expected argument is a commit ID SHA1 hash or an existing reference
-or tag name which will be resolved to a commit ID.
-.Pp
-The special
-.Ar commit
-keywords
+The expected argument is a commit ID SHA1 hash, or a reference name or keyword
+which will be resolved to a commit ID.
+An abbreviated hash argument will be expanded to a full SHA1 hash
+automatically, provided the abbreviation is unique.
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
The former is only valid if invoked in a work tree, while the latter will
resolve to the tip of the work tree's current branch if invoked in a
work tree, otherwise it will resolve to the repository's HEAD reference.
.Pp
The expected
.Ar commit
-argument is a commit ID SHA1 hash or an existing reference
-or tag name which will be resolved to a commit ID.
+argument is a commit ID SHA1 hash, or a reference name or a keyword
+which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
Keywords and references may be appended with
.Qq :+
or
The specified
.Ar commit
should be on a different branch than the work tree's base commit.
-The expected argument is a reference or a commit ID SHA1 hash.
+.Pp
+The expected argument is a commit ID SHA1 hash, or a reference name or
+keyword which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
Keywords and references may be appended with
.Qq :+
or
The specified
.Ar commit
should be on the same branch as the work tree's base commit.
-The expected argument is a reference or a commit ID SHA1 hash.
+.Pp
+The expected argument is a commit ID SHA1 hash, or a reference name
+or keyword which will be resolved to a commit ID.
An abbreviated hash argument will be expanded to a full SHA1 hash
automatically, provided the abbreviation is unique.
-.Pp
-The special
-.Ar commit
-keywords
+The keywords
.Qq :base
and
.Qq :head
-can also be used to represent the work tree's base commit
-and branch head, respectively.
+resolve to the work tree's base commit and branch head, respectively.
Keywords and references may be appended with
.Qq :+
or