[PATCH] doc git: multivar configuration parameters append to existing values
- From
Philip Oakley <philipoakley@iee.org>
- Date
- Jun 16, 2014, 12:49 UTC
- Message-ID
- <1402922952-172-1-git-send-email-philipoakley@iee.org>
When the '-c' option is used to pass alternate URLs or similar multivar parameters to git commands the effect is not what the user expected [1,2].
Clarify that multivar configuration parameters do not supercede previous values. Suggest an alternative style parameter.
[1] http://article.gmane.org/gmane.comp.version-control.git/250427 [2] http://article.gmane.org/gmane.comp.version-control.git/251529
Signed-off-by: Philip Oakley <philipoakley@iee.org> --- Documentation/git.txt | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/Documentation/git.txt b/Documentation/git.txt index 3bd68b0..bedbd76 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -440,7 +440,10 @@ example the following invocations are equivalent: -c <name>=<value>:: Pass a configuration parameter to the command. The value - given will override values from configuration files. + given will override single valued variables from configuration + files, and append to multivar variables. Previous multivar values + remain in effect. Use "insteadOf" style config variables when an + over-ride is needed. The <name> is expected in the same format as listed by 'git config' (subkeys separated by dots).
-- 1.9.4.msysgit.0