Documentation/git-config: describe and clarify "--local <file>" option
Describe config file selection in git-config. While the usage message of git-config shows --local, the documentation page did not contain anything about that. Signed-off-by: Florian Achleitner <florian.achleitner.2.6.31@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Florian Achleitner committed
May 5, 2012 at 12:03 UTC
c598c5aa01c9a6a877986ac4a99074fc65445141
1 file changed
+9
-5
Documentation/git-config.txt
+9
-5
@@ -44,11 +44,15 @@ a "true" or "false" string for bool), or '--path', which does some
44
path expansion (see '--path' below). If no type specifier is passed, no
45
checks or transformations are performed on the value.
46
47
-The file-option can be one of '--system', '--global' or '--file'
48
-which specify where the values will be read from or written to.
49
-The default is to assume the config file of the current repository,
50
-.git/config unless defined otherwise with GIT_DIR and GIT_CONFIG
51
-(see <<FILES>>).
47
+When reading, the values are read from the system, global and
48
+repository local configuration files by default, and options
49
+'--system', '--global', '--local' and '--file <filename>' can be
50
+used to tell the command to read from only that location (see <<FILES>>).
51
+
52
+When writing, the new value is written to the repository local
53
+configuration file by default, and options '--system', '--global',
54
+'--file <filename>' can be used to tell the command to write to
55
+that location (you can say '--local' but that is the default).
56
57
This command will fail (with exit code ret) if:
58