commit - 4c169ba3efc94f3f88c70b9f81c4c9daf93c0842
commit + 97e00196faca624305726d6e8b70d166dcf429fc
blob - 63aa9a23e4909d3ef2b5fa381ecde329b82273d9
blob + a70717773a243d58cc554a6e1638e0d6f466a34d
--- got.1.html
+++ got.1.html
<var class="Ar">commit</var></dt>
<dd>Check out files from the specified <var class="Ar">commit</var> on the
selected branch. The expected argument is a commit ID SHA1 hash or an
- existing reference which will be resolved to a commit ID. An
- abbreviated hash argument will be expanded to a full SHA1 hash
+ existing reference or tag name 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. If this option is
not specified, the most recent commit on the selected branch will be
used.</dd>
<var class="Ar">commit</var></dt>
<dd>Update the work tree to the specified <var class="Ar">commit</var>.
The expected argument is a commit ID SHA1 hash or an existing
- reference 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. If this option is not specified, the most
- recent commit on the work tree's branch will be used.</dd>
+ reference or tag name 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. If this option is
+ not specified, the most recent commit on the work tree's branch will
+ be used.</dd>
</dl>
</dd>
<dt><a class="permalink" href="#up"><code class="Cm" id="up">up</code></a></dt>
<var class="Ar">commit</var></dt>
<dd>Start traversing history at the specified
<var class="Ar">commit</var>. The expected argument is a commit ID
- SHA1 hash or an existing reference 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. If this option is
- not specified, default to the work tree's current branch if invoked in
- a work tree, or to the repository's HEAD reference.</dd>
+ SHA1 hash or an existing reference or tag name 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. If
+ this option is not specified, default to the work tree's current
+ branch if invoked in a work tree, or to the repository's HEAD
+ reference.</dd>
<dt><a class="permalink" href="#C"><code class="Fl" id="C">-C</code></a>
<var class="Ar">number</var></dt>
<dd>Set the number of context lines shown in diffs with
<var class="Ar">commit</var></dt>
<dd>Start traversing history at the specified
<var class="Ar">commit</var>. The expected argument is a commit ID
- SHA1 hash or an existing reference 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.</dd>
+ SHA1 hash or an existing reference or tag name 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.</dd>
<dt><a class="permalink" href="#r_4"><code class="Fl" id="r_4">-r</code></a>
<var class="Ar">repository-path</var></dt>
<dd>Use the repository at the specified path. If not specified, assume the
<var class="Ar">commit</var></dt>
<dd>List files and directories as they appear in the specified
<var class="Ar">commit</var>. The expected argument is a commit ID
- SHA1 hash or an existing reference 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.</dd>
+ SHA1 hash or an existing reference or tag name 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.</dd>
<dt><a class="permalink" href="#r_5"><code class="Fl" id="r_5">-r</code></a>
<var class="Ar">repository-path</var></dt>
<dd>Use the repository at the specified path. If not specified, assume the
and <code class="Cm">got import</code>, for example: <span class="An">Flan
Hacker</span>
<<a class="Mt" href="mailto:flan_hacker@openbsd.org">flan_hacker@openbsd.org</a>>.
- <a class="Xr">git(1)</a> may fail to parse commits created with
- <code class="Nm">got</code> if the <code class="Ev">GOT_AUTHOR</code>
- environment variable does not contain an email address.</dd>
+ Because <a class="Xr">git(1)</a> may fail to parse commits without an
+ email address in author data, <code class="Nm">got</code> attempts to
+ reject <code class="Ev">GOT_AUTHOR</code> environment variables with a
+ missing email address.</dd>
<dt><a class="permalink" href="#VISUAL,"><code class="Ev" id="VISUAL,">VISUAL,</code></a>
<code class="Ev">EDITOR</code></dt>
<dd>The editor spawned by <code class="Cm">got commit</code>.</dd>