commit 07f74738a18008a5dc7571048fef967a248670eb
from: Stefan Sperling <stsp@stsp.name>
via: Thomas Adam <thomas@xteddy.org>
date: Sun Mar 13 21:25:37 2022 UTC

some man page tweaks for 'got patch'

ok op@

commit - 7dd42450fb28f64d7fab8fb244760da303664e7e
commit + 07f74738a18008a5dc7571048fef967a248670eb
blob - 191ae2e5a9cee80ff3902ee897f67501ec3aad5e
blob + f0d5878b2556cfd6f8d306281a46eae5ada09f16
--- got/got.1
+++ got/got.1
@@ -1289,31 +1289,38 @@ option)
 .Dl Pq alias: Cm pa
 Apply changes from
 .Ar patchfile
-.Pq or standard input
-that must be a unified diff.
-If
+to files in a work tree.
+.Pp
+The patch must be in the unified diff format as produced by
+.Cm got diff ,
+or
+.Xr diff 1
+when invoked with the
+.Fl u
+option.
+.Pp
+If no
 .Ar patchfile
-contains more than one patch,
-.Nm
-.Cm patch
-will try to apply each of them in sequence.
-Files added or removed by the patch scheduled for addition or removal in
+argument is provided, read unified diff data from standard input instead.
+.Pp
+If the
+.Ar patchfile
+contains multiple patches then attempt to apply each of them in sequence.
+Files added or removed by a patch will be scheduled for addition or removal in
 the work tree.
 .Pp
 While applying the
 .Ar patchfile ,
 show the status of each affected file, using the following status codes:
 .Bl -column XYZ description
-.It M Ta modified file
-.It D Ta deleted file
-.It A Ta added file
+.It M Ta file was modified
+.It D Ta file was deleted
+.It A Ta file was added
 .El
 .Pp
-If a change does not match at its exact line number,
-.Nm
-.Cm patch
-applies it somewhere else in the file if it can find a good spot before
-giving up.
+If a change does not match at its exact line number, attempt to
+apply it somewhere else in the file if a good spot can be found,
+before giving up.
 .Pp
 .Nm
 .Cm patch
@@ -1321,14 +1328,14 @@ will refuse to apply a patch if certain preconditions 
 Files to be deleted must be present in the work tree and not have been
 scheduled for deletion already.
 Files to be added must be unknown and not present in the work tree.
-Files to be modified must be already present in the the work tree and
-not have conflicts or being obstructed.
+Files to be modified must be already be present in the work tree and
+not contain conflicts or be obstructed.
 .Pp
 If an error occurs, the
 .Cm patch
 operation will be aborted.
 Any changes made to the work tree up to this point will be left behind.
-Such cahnges can be viewed with
+Such changes can be viewed with
 .Cm got diff
 and can be reverted with
 .Cm got revert