Skip to content

Commit 7271016

Browse files
stefanbellergitster
authored andcommitted
documentation: improve submodule.<name>.{url, path} description
Unlike the url variable a user cannot override the the path variable, as it is part of the content together with the gitlink at the given path. To avoid confusion do not mention the .path variable in the config section and rely on the documentation provided in gitmodules[5]. Enhance the description of submodule.<name>.url and mention its two use cases separately. Signed-off-by: Stefan Beller <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 0b65a8d commit 7271016

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

Documentation/config.txt

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2706,12 +2706,13 @@ stash.showStat::
27062706
option will show diffstat of the stash. Defaults to true.
27072707
See description of 'show' command in linkgit:git-stash[1].
27082708

2709-
submodule.<name>.path::
27102709
submodule.<name>.url::
2711-
The path within this project and URL for a submodule. These
2712-
variables are initially populated by 'git submodule init'. See
2713-
linkgit:git-submodule[1] and linkgit:gitmodules[5] for
2714-
details.
2710+
The URL for a submodule. This variable is copied from the .gitmodules
2711+
file to the git config via 'git submodule init'. The user can change
2712+
the configured URL before obtaining the submodule via 'git submodule
2713+
update'. After obtaining the submodule, the presence of this variable
2714+
is used as a sign whether the submodule is of interest to git commands.
2715+
See linkgit:git-submodule[1] and linkgit:gitmodules[5] for details.
27152716

27162717
submodule.<name>.update::
27172718
The default update procedure for a submodule. This variable

0 commit comments

Comments
 (0)