Imported Upstream version 2.27.0
[platform/upstream/git.git] / Documentation / config / push.txt
index dffd4d5..f5e5b38 100644 (file)
@@ -1,6 +1,7 @@
 push.default::
        Defines the action `git push` should take if no refspec is
-       explicitly given.  Different values are well-suited for
+       given (whether from the command-line, config, or elsewhere).
+       Different values are well-suited for
        specific workflows; for instance, in a purely central workflow
        (i.e. the fetch source is equal to the push destination),
        `upstream` is probably what you want.  Possible values are:
@@ -8,7 +9,7 @@ push.default::
 --
 
 * `nothing` - do not push anything (error out) unless a refspec is
-  explicitly given. This is primarily meant for people who want to
+  given. This is primarily meant for people who want to
   avoid mistakes by always being explicit.
 
 * `current` - push the current branch to update a branch with the same
@@ -111,3 +112,5 @@ push.recurseSubmodules::
        is 'no' then default behavior of ignoring submodules when pushing
        is retained. You may override this configuration at time of push by
        specifying '--recurse-submodules=check|on-demand|no'.
+       If not set, 'no' is used by default, unless 'submodule.recurse' is
+       set (in which case a 'true' value means 'on-demand').