commit b3cd068e5e43ee5e281716ea420c953fad4fac57
from: Stefan Sperling <stsp@stsp.name>
date: Thu Aug 22 20:39:18 2019 UTC

document tag objects

commit - c904c63e1cecd38d94c5ba386b2600f5cb2e53ca
commit + b3cd068e5e43ee5e281716ea420c953fad4fac57
blob - 677dc0636905770f879f37341a86c7744276da35
blob + c53949e2acfc59b59bb645d889edb1743baa2988
--- got/git-repository.5
+++ got/git-repository.5
@@ -48,6 +48,13 @@ A commit which precedes another commit is referred to 
 A commit with multiple parents unites disparate lines of history and is
 known as a
 .Em merge commit .
+.It Tags
+A
+.Em tag
+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.
 .El
 .Pp
 Each object is identified by a SHA1 hash calculated over both the object's
blob - c570e9380338cb7e97047870f80835c0834d134c
blob + bc24b56fe9ee8b371a400a11357acd2fe46e4a65
--- got/got.1
+++ got/got.1
@@ -529,6 +529,8 @@ reference namespace.
 The
 .Cm got tag
 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.
 .Pp
 Expect one or two arguments and attempt to create a tag with the given
 .Ar name ,