mention bare repos in git-repository(5), not got(1)
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
diff --git a/got/git-repository.5 b/got/git-repository.5
index 768ec30..907a0c2 100644
--- a/got/git-repository.5
+++ b/got/git-repository.5
@@ -135,6 +135,18 @@ Corresponding on-disk references take precedence over those stored here.
.It Pa refs/
The default directory to store references in.
.El
+.Pp
+A typical Git repository exposes a work tree which allows the user to make
+changes to versioned files and create new commits.
+When a Git work tree is present, the actual repository data is stored in a
+.Pa .git
+subfolder of the repository's root directory.
+A Git repository without a work tree is known as a
+.Dq bare
+repository.
+.Xr got 1
+does not make use of Git's work tree and treats every repository as if it
+was bare.
.Sh SEE ALSO
.Xr got 1 ,
.Xr deflate 3 ,
diff --git a/got/got.1 b/got/got.1
index 11e87be..9538b04 100644
--- a/got/got.1
+++ b/got/got.1
@@ -27,9 +27,8 @@
.Op Ar arg ...
.Sh DESCRIPTION
.Nm
-is a version control system which stores the history of tracked files in a
-.Dq bare
-Git repository, as used by the Git version control system.
+is a version control system which stores the history of tracked files
+in a Git repository, as used by the Git version control system.
This repository format is described in
.Xr git-repository 5 .
.Pp