with lots of help from stsp for the manpage bits!

ok op@

Simplify some phrasing, explain what preconditions `got patch' has and what happens to the work tree when an error occurs.

ok millert@

Replace hand-rolled parentheses with the proper mdoc(7) macro, otherwise the closing ")" ends up inside the command description. Reported by Josh Rickmar, thanks!

Need for filtering by path sugggested by kn@ ok naddy@

positive feedback from Omar and kn ok kn

This has the advantage of tags being located right by the full command; combined with tags ":tco" to search for the `co` alias will jump right to the `checkout` line, neatly showing everything without needing further navigation. tmux hint from Thomas Adam, thanks. OK stsp

ok jrick

Specifically, obstructed files are versioned files which should be on disk but have been replaced on disk by a non-regular file (e.g. by a directory). The man page used the phrase "deletion was obstructed" which is unrelated to the above concept and can be expressed as "deletion was prevented" instead.