commit cc63216e4c9ca57c8711120fc6028ed5d5e2dde9
from: Stefan Sperling <stsp@stsp.name>
date: Sat Dec 26 12:23:23 2020 UTC

update got.1 CAVEATS section; prompted by feedback from otto@

commit - d2075bf3e6019b7903ce19414f09348839e36fbc
commit + cc63216e4c9ca57c8711120fc6028ed5d5e2dde9
blob - 51b79323bbf09e0af51f6906923168ce9a121113
blob + 0d05ef480cf0480004133b98b02d8a976c0dfbfb
--- got/got.1
+++ got/got.1
@@ -2321,8 +2321,43 @@ repository with
 .An Ori Bernstein Aq Mt ori@openbsd.org
 .Sh CAVEATS
 .Nm
-is a work-in-progress and many commands remain to be implemented.
+is a work-in-progress and some features remain to be implemented.
+
 At present, the user has to fall back on
 .Xr git 1
-to perform many tasks, in particular tasks related to repository
-administration and tasks which require a network connection.
+to perform some tasks.
+In particular:
+.Bl -bullet
+.It
+Reading from remote repositories over HTTP or HTTPS protocols requires
+.Xr git-clone 1
+and
+.Xr git-fetch 1 .
+.It
+Writing to remote repositories, over any protocol, requires
+.Xr git-push 1 .
+.It
+Packing repositories, which reduces disk space consumption and improves
+read-access performance, requires
+.Xr git-repack 1 .
+.It
+Exporting data from repositories requires
+.Xr git-fast-export 1 .
+.It
+Importing data into repositories requires
+.Xr git-fast-import 1 .
+.It
+Reducing the size of repositories by removing redundant or unreferenced
+data requires
+.Xr git-gc 1 .
+.It
+The creation of merge commits, i.e. commits with two or more parent commits,
+requires
+.Xr git-merge 1 .
+.It
+In situations where files or directories were moved around
+.Cm got
+will not automatically merge changes to new locations and
+.Xr git 1
+will usually produce better results.
+.El