undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge branch 'sb/clone-recursive-submodule-doc'

Browse Source 
Doc update.

* sb/clone-recursive-submodule-doc:
  Documentation/git-clone: improve description for submodule recursing
This commit is contained in:
Junio C Hamano 2017-12-19 11:33:56 -08:00
commit a328b2cb63
1 changed files with 11 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
Documentation/git-clone.txt
View File

@ -14,7 +14,7 @@ SYNOPSIS
[-o <name>] [-b <name>] [-u <upload-pack>] [--reference <repository>] [-o <name>] [-b <name>] [-u <upload-pack>] [--reference <repository>]
[--dissociate] [--separate-git-dir <git dir>] [--dissociate] [--separate-git-dir <git dir>]
[--depth <depth>] [--[no-]single-branch] [--no-tags] [--depth <depth>] [--[no-]single-branch] [--no-tags]
[--recurse-submodules] [--[no-]shallow-submodules] [--recurse-submodules[=<pathspec>]] [--[no-]shallow-submodules]
[--jobs <n>] [--] <repository> [<directory>] [--jobs <n>] [--] <repository> [<directory>]
DESCRIPTION DESCRIPTION
@ -231,14 +231,17 @@ branch of some repository for search indexing.
After the clone is created, initialize and clone submodules After the clone is created, initialize and clone submodules
within based on the provided pathspec. If no pathspec is within based on the provided pathspec. If no pathspec is
provided, all submodules are initialized and cloned. provided, all submodules are initialized and cloned.
Submodules are initialized and cloned using their default This option can be given multiple times for pathspecs consisting
settings. The resulting clone has `submodule.active` set to of multiple entries. The resulting clone has `submodule.active` set to
the provided pathspec, or "." (meaning all submodules) if no the provided pathspec, or "." (meaning all submodules) if no
pathspec is provided. This is equivalent to running pathspec is provided.
`git submodule update --init --recursive` immediately after +
the clone is finished. This option is ignored if the cloned Submodules are initialized and cloned using their default settings. This is
repository does not have a worktree/checkout (i.e. if any of equivalent to running
`--no-checkout`/`-n`, `--bare`, or `--mirror` is given) `git submodule update --init --recursive <pathspec>` immediately after
the clone is finished. This option is ignored if the cloned repository does
not have a worktree/checkout (i.e. if any of `--no-checkout`/`-n`, `--bare`,
or `--mirror` is given)
--[no-]shallow-submodules:: --[no-]shallow-submodules::
All submodules which are cloned will be shallow with a depth of 1. All submodules which are cloned will be shallow with a depth of 1.