commit 285dc8a4ab48574b35edaca5be7e3032020ccfa7
from: Stefan Sperling <stsp@stsp.name>
date: Tue Mar 13 02:11:35 2018 UTC

add more information to got(1) man page

commit - 48a3b9344c854dcde131b93b3a09fd7d9dea146d
commit + 285dc8a4ab48574b35edaca5be7e3032020ccfa7
blob - c281528136eb3890d4b7799d3a247a888bc36a31
blob + 22c9a0e284497d8f76f166830a10122a05758fb5
--- got/got.1
+++ got/got.1
@@ -18,21 +18,39 @@
 .Os
 .Sh NAME
 .Nm got
-.Nd simple version control system
+.Nd distributed version control system
 .Sh SYNOPSIS
 .Nm
 .Ar command
 .Op Fl h
 .Op Ar arg ...
 .Sh DESCRIPTION
-The
 .Nm
-utility is used to manage
-.Xr git 5
-repositories.
-It prioritizes ease of use and simplicity over flexibility.
+is a distributed version control system which prioritizes ease of use
+and simplicity over flexibility.
 .Pp
-The options are as follows:
+.Nm
+stores the history of files tracked in version control in a repository
+which happens to use the same on-disk format as the so-called
+.Dq bare
+repositories created by the popular Git version control system.
+This repository format is described in
+.Xr got-repository 5 .
+.Pp
+Files managed by
+.Nm
+can be checked out from the repository for modification.
+Checked out files are stored in a
+.Em work tree
+which is placed at an arbitrary directory in the filesystem hierarchy.
+The format of a
+.Nm
+work tree is described in
+.Xr got-worktree 5 .
+.Pp
+.Nm
+provides global and command-specific options.
+Global options must preceed the command name, and are as follows:
 .Bl -tag -width tenletters
 .It Fl h
 Display usage information.
@@ -50,4 +68,5 @@ Display history of the repository.
 .Sh EXIT STATUS
 .Ex -std got
 .Sh SEE ALSO
-.Xr git 5
+.Xr got-repository 5
+.Xr got-worktree 5