commit - 91b3da3f7b9f268cef0228f185c163f0d7490b70
commit + f447d26b4a79b05fb05ab16410e8acce870f192d
blob - 0e8394b9eed3ab2bfbcb700ffadd52ab470b7858
blob + 384a5c187c0056e9bf21c3eb9e7a9ab948a62519
--- git-repository.5.html
+++ git-repository.5.html
other commit's <i class="Em">parent commit</i>. A commit with multiple
parents unites disparate lines of history and is known as a
<i class="Em">merge commit</i>.</dd>
+ <dt>Tags</dt>
+ <dd>A <i class="Em">tag</i> object associates an user-defined label with
+ another object, which is typically a commit object. Tag objects also
+ contains a tag message, as well as author and timestamp information.</dd>
</dl>
<p class="Pp">Each object is identified by a SHA1 hash calculated over both the
object's header and the data stored in the object.</p>
</div>
<table class="foot">
<tr>
- <td class="foot-date">August 18, 2019</td>
+ <td class="foot-date">August 23, 2019</td>
<td class="foot-os">OpenBSD 6.5</td>
</tr>
</table>
blob - 0d40608b27035511e57f1d0217b6d0dbd248360e
blob + 8060f9dcb94dab5cbf3d37b435b1395d18ec9304
--- got-worktree.5.html
+++ got-worktree.5.html
</div>
<table class="foot">
<tr>
- <td class="foot-date">August 18, 2019</td>
+ <td class="foot-date">August 23, 2019</td>
<td class="foot-os">OpenBSD 6.5</td>
</tr>
</table>
blob - 565e5a1f6c1ad67800debb217f77b536e5447971
blob + ece46d6f825c02b54fc5b035551436de48af8587
--- got.1.html
+++ got.1.html
</dd>
<dt><a class="permalink" href="#br"><code class="Cm" id="br">br</code></a></dt>
<dd>Short alias for <code class="Cm">branch</code>.</dd>
+ <dt><a class="permalink" href="#tag"><code class="Cm" id="tag">tag</code></a>
+ [<code class="Fl">-m</code> <var class="Ar">message</var>]
+ [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
+ [<code class="Fl">-l</code>] <var class="Ar">name</var>
+ [<var class="Ar">commit</var>]</dt>
+ <dd>Manage tags in a repository.
+ <p class="Pp">Tags are managed via references which live in the
+ “refs/tags/” reference namespace. The <code class="Cm">got
+ tag</code> command operates on references in this namespace only.
+ References in this namespace point at tag objects which contain a
+ pointer to another object, a tag message, as well as author and
+ timestamp information.</p>
+ <p class="Pp">Expect one or two arguments and attempt to create a tag with
+ the given <var class="Ar">name</var>, and make this tag point at the
+ given <var class="Ar">commit</var>. If no commit is specified, default
+ to the latest commit on the work tree's current branch if invoked in a
+ work tree, and to a commit resolved via the repository's HEAD reference
+ otherwise. Otherwise, the expected argument is a commit ID 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.</p>
+ <p class="Pp">The options for <code class="Cm">got tag</code> are as
+ follows:</p>
+ <dl class="Bl-tag">
+ <dt><a class="permalink" href="#m_2"><code class="Fl" id="m_2">-m</code></a>
+ <var class="Ar">message</var></dt>
+ <dd>Use the specified tag message when creating the new tag Without the
+ <code class="Fl">-m</code> option, <code class="Cm">got import</code>
+ opens a temporary file in an editor where a tag message can be
+ written.</dd>
+ <dt><a class="permalink" href="#r_8"><code class="Fl" id="r_8">-r</code></a>
+ <var class="Ar">repository-path</var></dt>
+ <dd>Use the repository at the specified path. If not specified, assume the
+ repository is located at or above the current working directory. If
+ this directory is a <code class="Nm">got</code> work tree, use the
+ repository path associated with this work tree.</dd>
+ <dt><a class="permalink" href="#l_4"><code class="Fl" id="l_4">-l</code></a></dt>
+ <dd>List all existing tags in the repository instead of creating a new
+ tag. If this option is used, no other command-line arguments are
+ allowed.</dd>
+ </dl>
+ <p class="Pp">By design, the <code class="Cm">got tag</code> command will
+ not delete tags or change existing tags. If a tag must be deleted, the
+ <code class="Cm">got ref</code> command may be used to delete a tag's
+ reference. This should only be done if the tag has not already been
+ copied to another repository.</p>
+ </dd>
<dt><a class="permalink" href="#add"><code class="Cm" id="add">add</code></a>
<var class="Ar">file-path ...</var></dt>
<dd>Schedule unversioned files in a work tree for addition to the repository
<p class="Pp">The options for <code class="Cm">got commit</code> are as
follows:</p>
<dl class="Bl-tag">
- <dt><a class="permalink" href="#m_2"><code class="Fl" id="m_2">-m</code></a>
+ <dt><a class="permalink" href="#m_3"><code class="Fl" id="m_3">-m</code></a>
<var class="Ar">message</var></dt>
<dd>Use the specified log message when creating the new commit. Without
the <code class="Fl">-m</code> option, <code class="Cm">got
<p class="Pp">The options for <code class="Cm">got stage</code> are as
follows:</p>
<dl class="Bl-tag">
- <dt><a class="permalink" href="#l_4"><code class="Fl" id="l_4">-l</code></a></dt>
+ <dt><a class="permalink" href="#l_5"><code class="Fl" id="l_5">-l</code></a></dt>
<dd>Instead of staging new changes, list paths which are already staged,
along with the IDs of staged blob objects and stage status codes. If
paths were provided in the command line show the staged paths among
</dd>
<dt><a class="permalink" href="#ug"><code class="Cm" id="ug">ug</code></a></dt>
<dd>Short alias for <code class="Cm">unstage</code>.</dd>
+ <dt><a class="permalink" href="#cat"><code class="Cm" id="cat">cat</code></a>
+ [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
+ <var class="Ar">object ...</var></dt>
+ <dd>Parse and print contents of specified objects to standard output in a
+ line-based text format. Treat each argument as a reference, a tag name, or
+ an object ID SHA1 hash. References will be resolved to an object ID. Tag
+ names will resolved to a tag object. An abbreviated hash argument will be
+ expanded to a full SHA1 hash automatically, provided the abbreviation is
+ unique.
+ <p class="Pp">The options for <code class="Cm">got cat</code> are as
+ follows:</p>
+ <dl class="Bl-tag">
+ <dt><a class="permalink" href="#r_9"><code class="Fl" id="r_9">-r</code></a>
+ <var class="Ar">repository-path</var></dt>
+ <dd>Use the repository at the specified path. If not specified, assume the
+ repository is located at or above the current working directory. If
+ this directory is a <code class="Nm">got</code> work tree, use the
+ repository path associated with this work tree.</dd>
+ </dl>
+ </dd>
</dl>
</section>
<section class="Sh">
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>
+ <dd>The editor spawned by <code class="Cm">got commit</code>,
+ <code class="Cm">got import</code>, or <code class="Cm">got
+ tag</code>.</dd>
<dt><a class="permalink" href="#GOT_LOG_DEFAULT_LIMIT"><code class="Ev" id="GOT_LOG_DEFAULT_LIMIT">GOT_LOG_DEFAULT_LIMIT</code></a></dt>
<dd>The default limit on the number of commits traversed by
<code class="Cm">got log</code>. If set to zero, the limit is unbounded.
</div>
<table class="foot">
<tr>
- <td class="foot-date">August 18, 2019</td>
+ <td class="foot-date">August 23, 2019</td>
<td class="foot-os">OpenBSD 6.5</td>
</tr>
</table>
blob - d1aa49ad661721837c636c500da417eb77ea35c8
blob + 6216afa959214f368c86ab7952aa3737ba1d6250
--- tog.1.html
+++ tog.1.html
</div>
<table class="foot">
<tr>
- <td class="foot-date">August 18, 2019</td>
+ <td class="foot-date">August 23, 2019</td>
<td class="foot-os">OpenBSD 6.5</td>
</tr>
</table>
