Commit 97925469082de2c7fecf720557c9fbc78b2eaf89

Stefan Sperling 2018-03-17T18:33:26

man page tweaks

diff --git a/got/got-repository.5 b/got/got-repository.5
index af90eff..22f46d7 100644
--- a/got/got-repository.5
+++ b/got/got-repository.5
@@ -23,10 +23,10 @@
 repositories
 .Sh DESCRIPTION
 .Xr got 1
-stores the history of files tracked in version control in a repository
-which happens to use the same on-disk format as so-called
+stores the history of tracked files in a repository which happens to use
+the same on-disk format as
 .Dq bare
-repositories created by the popular Git version control system.
+repositories used by the popular Git version control system.
 .Pp
 The repository's core data model is a directed acyclic graph which
 contains three types of objects as nodes.
diff --git a/got/got.1 b/got/got.1
index a41a7e1..a6835cf 100644
--- a/got/got.1
+++ b/got/got.1
@@ -18,7 +18,7 @@
 .Os
 .Sh NAME
 .Nm got
-.Nd distributed version control system
+.Nd version control system
 .Sh SYNOPSIS
 .Nm
 .Ar command
@@ -26,23 +26,23 @@
 .Op Ar arg ...
 .Sh DESCRIPTION
 .Nm
-is a distributed version control system which prioritizes ease of use
-and simplicity over flexibility.
+is a version control system which prioritizes ease of use and simplicity
+over flexibility.
 .Pp
 .Nm
-stores the history of files tracked in version control in a repository
-which happens to use the same on-disk format as so-called
+stores the history of tracked files in a repository which happens to use
+the same on-disk format as
 .Dq bare
-repositories created by the popular Git version control system.
+repositories used by the popular Git version control system.
 This repository format is described in
 .Xr got-repository 5 .
 .Pp
 .Nm
 is a
-.Dq distributed
+.Em distributed
 version control system because every copy of a repository is writeable.
 Modifications made to files can be synchronized between repositories
-automatically at any time.
+at any time.
 .Pp
 Files managed by
 .Nm
@@ -50,7 +50,7 @@ must be checked out from the repository for modification.
 Checked out files are stored in a
 .Em work tree
 which can be placed at an arbitrary directory in the filesystem hierarchy.
-The format of a
+The on-disk format of a
 .Nm
 work tree is described in
 .Xr got-worktree 5 .
@@ -80,6 +80,12 @@ Display history of the repository.
 .El
 .Sh EXIT STATUS
 .Ex -std got
+.Sh EXAMPLES
+Check out a work tree of
+.Ox
+kernel sources from a Git repository at /var/repo/openbsd-src to ~/sys:
+.Pp
+.Dl $ got checkout -p sys /var/repo/openbsd-src ~/sys
 .Sh SEE ALSO
 .Xr got-repository 5
 .Xr got-worktree 5