commit 89c3c67b24da7bf5364338accaaea129b49097eb
from: Stefan Sperling <stsp@stsp.name>
date: Fri Mar 20 16:40:24 2020 UTC

document what got-index-pack does

commit - fed0b873e568aa771d704ea245efd739a07b41f4
commit + 89c3c67b24da7bf5364338accaaea129b49097eb
blob - 2b7971b0b0d9defaddcc26bc2ff5f92b69db18f7
blob + 56213702158e8ae63a83507c7153e0135d56eb9c
--- got/got.1
+++ got/got.1
@@ -176,6 +176,14 @@ to use:
 .It ssh
 Short alias for git+ssh.
 .El
+.Pp
+Objects in the cloned repository are stored in a pack file which is downloaded
+from the server.
+This pack file will then be indexed to facilitate access to the objects stored
+within.
+If any objects in the pack file are stored in deltified form, all deltas will
+be fully resolved in order to compute the ID of such objects.
+This can take some time.
 .Pp
 .Cm got clone
 creates a remote repository entry in the
@@ -252,6 +260,10 @@ The remote repository's URL is obtained from the corre
 file of the repository, as created by
 .Cm got clone .
 .Pp
+New changes will be stored in a separate pack file downloaded from the server.
+Optionally, separate pack files stored in the repository can be combined with
+.Xr git-repack 1 .
+.Pp
 Branch references in the
 .Dq refs/remotes/
 reference namespace will be updated to point at the newly fetched commits,