document tag objects
diff --git a/got/git-repository.5 b/got/git-repository.5
index 677dc06..c53949e 100644
--- a/got/git-repository.5
+++ b/got/git-repository.5
@@ -48,6 +48,13 @@ A commit which precedes another commit is referred to as that other commit's
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
diff --git a/got/got.1 b/got/got.1
index c570e93..bc24b56 100644
--- a/got/got.1
+++ b/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 ,