man page tweaks
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84
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