Clone and fetch git repositories

1 files changed, 34 insertions, 7 deletions

diff --git a/bpkg/common.cli b/bpkg/common.cli
index 45d2c55..5c3de83 100644
--- a/bpkg/common.cli
+++ b/bpkg/common.cli
@@ -122,13 +122,20 @@ namespace bpkg
     size_t --fetch-timeout
     {
       "<sec>",
-      "The fetch program timeout. While the exact semantics of the value
-       depends on the fetch program used, at a minimum it specifies in
-       seconds the maximum time that can be spent without any network
-       activity. Specifically, it is translated to the \cb{--max-time}
-       option for \cb{curl} and to the \cb{--timeout} option for \cb{wget}
-       and \cb{fetch}. See \cb{--fetch} for more information on the fetch
-       program."
+      "The fetch and fetch-like (for example, \cb{git}) program timeout.
+       While the exact semantics of the value depends on the program used,
+       at a minimum it specifies in seconds the maximum time that can be
+       spent without any network activity.
+
+       Specifically, it is translated to the \cb{--max-time} option for
+       \cb{curl} and to the \cb{--timeout} option for \cb{wget} and
+       \cb{fetch}. For \cb{git} over HTTP/HTTPS this semantics is achieved
+       using the \cb{http.lowSpeedLimit}=\i{1} \cb{http.lowSpeedTime}=\i{sec}
+       configuration values (the \cb{git://} protocol currently does not
+       support timeouts).
+
+       See \cb{--fetch} and \cb{--git} for more information on the fetch
+       programs."
     }
 
     strings --fetch-option
@@ -139,6 +146,26 @@ namespace bpkg
        specify multiple fetch options."
     }
 
+    path --git = "git"
+    {
+      "<path>",
+      "The git program to be used to fetch git repositories. You can also
+       specify additional options that should be passed to the git program with
+       \cb{--git-option}.
+
+       If the git program is not explicitly specified, then \cb{bpkg} will use
+       \cb{git} by default."
+    }
+
+    strings --git-option
+    {
+      "<opt>",
+      "Additional common option to be passed to the git program. Note that
+       the common options are the ones that precede the \cb{git} command.
+       See \cb{--git} for more information on the git program. Repeat this
+       option to specify multiple git options."
+    }
+
     path --sha256
     {
       "<path>",