]>
Commit | Line | Data |
---|---|---|
6014363f NTND |
1 | submodule.<name>.url:: |
2 | The URL for a submodule. This variable is copied from the .gitmodules | |
3 | file to the git config via 'git submodule init'. The user can change | |
4 | the configured URL before obtaining the submodule via 'git submodule | |
5 | update'. If neither submodule.<name>.active or submodule.active are | |
6 | set, the presence of this variable is used as a fallback to indicate | |
7 | whether the submodule is of interest to git commands. | |
8 | See linkgit:git-submodule[1] and linkgit:gitmodules[5] for details. | |
9 | ||
10 | submodule.<name>.update:: | |
11 | The method by which a submodule is updated by 'git submodule update', | |
12 | which is the only affected command, others such as | |
13 | 'git checkout --recurse-submodules' are unaffected. It exists for | |
14 | historical reasons, when 'git submodule' was the only command to | |
15 | interact with submodules; settings like `submodule.active` | |
16 | and `pull.rebase` are more specific. It is populated by | |
17 | `git submodule init` from the linkgit:gitmodules[5] file. | |
18 | See description of 'update' command in linkgit:git-submodule[1]. | |
19 | ||
20 | submodule.<name>.branch:: | |
21 | The remote branch name for a submodule, used by `git submodule | |
22 | update --remote`. Set this option to override the value found in | |
23 | the `.gitmodules` file. See linkgit:git-submodule[1] and | |
24 | linkgit:gitmodules[5] for details. | |
25 | ||
26 | submodule.<name>.fetchRecurseSubmodules:: | |
27 | This option can be used to control recursive fetching of this | |
28 | submodule. It can be overridden by using the --[no-]recurse-submodules | |
29 | command-line option to "git fetch" and "git pull". | |
30 | This setting will override that from in the linkgit:gitmodules[5] | |
31 | file. | |
32 | ||
33 | submodule.<name>.ignore:: | |
34 | Defines under what circumstances "git status" and the diff family show | |
35 | a submodule as modified. When set to "all", it will never be considered | |
36 | modified (but it will nonetheless show up in the output of status and | |
37 | commit when it has been staged), "dirty" will ignore all changes | |
38 | to the submodules work tree and | |
39 | takes only differences between the HEAD of the submodule and the commit | |
40 | recorded in the superproject into account. "untracked" will additionally | |
41 | let submodules with modified tracked files in their work tree show up. | |
42 | Using "none" (the default when this option is not set) also shows | |
43 | submodules that have untracked files in their work tree as changed. | |
44 | This setting overrides any setting made in .gitmodules for this submodule, | |
45 | both settings can be overridden on the command line by using the | |
46 | "--ignore-submodules" option. The 'git submodule' commands are not | |
47 | affected by this setting. | |
48 | ||
49 | submodule.<name>.active:: | |
50 | Boolean value indicating if the submodule is of interest to git | |
51 | commands. This config option takes precedence over the | |
52 | submodule.active config option. See linkgit:gitsubmodules[7] for | |
53 | details. | |
54 | ||
55 | submodule.active:: | |
56 | A repeated field which contains a pathspec used to match against a | |
57 | submodule's path to determine if the submodule is of interest to git | |
58 | commands. See linkgit:gitsubmodules[7] for details. | |
59 | ||
60 | submodule.recurse:: | |
61 | Specifies if commands recurse into submodules by default. This | |
62 | applies to all commands that have a `--recurse-submodules` option, | |
63 | except `clone`. | |
64 | Defaults to false. | |
65 | ||
66 | submodule.fetchJobs:: | |
67 | Specifies how many submodules are fetched/cloned at the same time. | |
68 | A positive integer allows up to that number of submodules fetched | |
69 | in parallel. A value of 0 will give some reasonable default. | |
70 | If unset, it defaults to 1. | |
71 | ||
72 | submodule.alternateLocation:: | |
73 | Specifies how the submodules obtain alternates when submodules are | |
74 | cloned. Possible values are `no`, `superproject`. | |
75 | By default `no` is assumed, which doesn't add references. When the | |
76 | value is set to `superproject` the submodule to be cloned computes | |
77 | its alternates location relative to the superprojects alternate. | |
78 | ||
79 | submodule.alternateErrorStrategy:: | |
80 | Specifies how to treat errors with the alternates for a submodule | |
81 | as computed via `submodule.alternateLocation`. Possible values are | |
82 | `ignore`, `info`, `die`. Default is `die`. |