doc: add doc for git-push --recurse-submodules=only
Add documentation for the `--recurse-submodules=only` option of git-push. The feature was added in commit 225e8bf (add option to push only submodules). Signed-off-by: Cornelius Weig <cornelius.weig@tngtech.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Cornelius Weig committed
Feb 2, 2017 at 00:07 UTC
9c24c8741e275e2fa30aa7e800c1d4610a6fe2fd
1 file changed
+7
-6
Documentation/git-push.txt
+7
-6
@@ -272,7 +272,7 @@ origin +master` to force a push to the `master` branch). See the
272
standard error stream is not directed to a terminal.
273
274
--no-recurse-submodules::
275
---recurse-submodules=check|on-demand|no::
275
+--recurse-submodules=check|on-demand|only|no::
276
May be used to make sure all submodule commits used by the
277
revisions to be pushed are available on a remote-tracking branch.
278
If 'check' is used Git will verify that all submodule commits that
@@ -280,11 +280,12 @@ origin +master` to force a push to the `master` branch). See the
280
remote of the submodule. If any commits are missing the push will
281
be aborted and exit with non-zero status. If 'on-demand' is used
282
all submodules that changed in the revisions to be pushed will be
283
- pushed. If on-demand was not able to push all necessary revisions
284
- it will also be aborted and exit with non-zero status. A value of
285
- 'no' or using `--no-recurse-submodules` can be used to override the
286
- push.recurseSubmodules configuration variable when no submodule
287
- recursion is required.
283
+ pushed. If on-demand was not able to push all necessary revisions it will
284
+ also be aborted and exit with non-zero status. If 'only' is used all
285
+ submodules will be recursively pushed while the superproject is left
286
+ unpushed. A value of 'no' or using `--no-recurse-submodules` can be used
287
+ to override the push.recurseSubmodules configuration variable when no
288
+ submodule recursion is required.
289
290
--[no-]verify::
291
Toggle the pre-push hook (see linkgit:githooks[5]). The