commit f2cf8fbb2f991890d446eb5f7b566b2c8312333c
from: Stefan Sperling <stsp@stsp.name>
date: Thu Apr 04 09:12:02 2019 UTC

improve partial update documentation

commit - c4cdcb68ce13515b0852719b9690a470731c3d5d
commit + f2cf8fbb2f991890d446eb5f7b566b2c8312333c
blob - 83aee6576831b519a3f1d35c2beb93c6197794c5
blob + 5d3d48a6f0063cfe7d991fdb98df27be37e2e210
--- got/got.1
+++ got/got.1
@@ -103,11 +103,15 @@ Show the status of each affected file, using the follo
 If a
 .Ar path
 is specified, restrict the update operation to files at or within this path.
-Files outside this path will remain at their currently recorded base commit.
-Some operations may refuse to run while the work tree contains files from
+The path is required to exist in the update operation's target commit.
+Files in the work tree outside this path will remain unchanged and will
+retain their previously recorded base commit.
+Some
+.Nm
+commands may refuse to run while the work tree contains files from
 multiple base commits.
-Inconsistent base commits in a work tree can be repaired by running another
-update operation across the entire work tree.
+The base commit of such a work tree can be made consistent by running
+another update operation across the entire work tree.
 .Pp
 The options for
 .Cm got update