threads / patch / 25325

patchDocumentation: mention environment variables GIT_CONFIG_NO(GLOBAL|SYSTEM)

Subject: [PATCH] Documentation: mention environment variables GIT_CONFIG_NO(GLOBAL|SYSTEM)

## tl;dr

4 messages between Oct 3, 2010 and Oct 4, 2010. Diffs are folded; open one to read it.

replies: 3people: 3as markdown or json

Jan Krüger· Oct 3, 2010, 21:53 UTC · lore

The environment variables GIT_CONFIG_NOGLOBAL and GIT_CONFIG_NOSYSTEM which have the opposite effect of the --global and --system switches to git-config are completely undocumented. This mentions them in the 'files' and 'environment' sections of the manpage for git-config where GIT_CONFIG is already mentioned.

Signed-off-by: Jan Krüger <jk@jk.gs>
---
 Documentation/git-config.txt |   10 ++++++++++
 1 files changed, 10 insertions(+), 0 deletions(-)
Show changes to Documentation/git-config.txt +11 −0
diff --git a/Documentation/git-config.txt b/Documentation/git-config.txt
index 543dd64..c3ea29c 100644
--- a/Documentation/git-config.txt
+++ b/Documentation/git-config.txt
@@ -210,6 +210,9 @@ variables. The '--global' and the '--system' options will limit the file used
 to the global or system-wide file respectively. The GIT_CONFIG environment
 variable has a similar effect, but you can specify any filename you want.
 
+You can also set the environment GIT_CONFIG_NOGLOBAL and GIT_CONFIG_NOSYSTEM
+to explicitly prevent git from falling back to global/system settings.
+
 
 ENVIRONMENT
 -----------
@@ -219,6 +222,14 @@ GIT_CONFIG::
 	Using the "--global" option forces this to ~/.gitconfig. Using the
 	"--system" option forces this to $(prefix)/etc/gitconfig.
 
+GIT_CONFIG_NOGLOBAL::
+	If set to true, do not use the global configuration file
+	in ~/.gitconfig.
+
+GIT_CONFIG_NOSYSTEM::
+	If set to true, do not use the system-wide configuration file in
+	/etc/gitconfig.
+
 See also <<FILES>>.
 
 

-- 
1.7.2.3.392.g02377.dirty
Sverre Rabbelier· Oct 3, 2010, 23:10 UTC · re: Jan Krüger · lore

Re: [PATCH] Documentation: mention environment variables GIT_CONFIG_NO(GLOBAL|SYSTEM)

Heya,
On Sun, Oct 3, 2010 at 23:53, Jan Krüger <jk@jk.gs> wrote:
Show 5 quoted lines
> The environment variables GIT_CONFIG_NOGLOBAL and GIT_CONFIG_NOSYSTEM
> which have the opposite effect of the --global and --system switches to
> git-config are completely undocumented. This mentions them in the
> 'files' and 'environment' sections of the manpage for git-config where
> GIT_CONFIG is already mentioned.
Nice.
Show 8 quoted lines
> +GIT_CONFIG_NOGLOBAL::
> +       If set to true, do not use the global configuration file
> +       in ~/.gitconfig.
> +
> +GIT_CONFIG_NOSYSTEM::
> +       If set to true, do not use the system-wide configuration file in
> +       /etc/gitconfig.
> +

If there are a '--no-global' and '--no-system', would it good to mention those too? Something like: "If set to true, do not use the system-wide configuration file in /etc/gitconfig, equivalent to --no-global."?

-- 
Cheers,

Sverre Rabbelier
Junio C Hamano· Oct 3, 2010, 23:27 UTC · re: Jan Krüger · lore

Re: [PATCH] Documentation: mention environment variables GIT_CONFIG_NO(GLOBAL|SYSTEM)

Jan Krüger <jk@jk.gs> writes:
Show 7 quoted lines
> The environment variables GIT_CONFIG_NOGLOBAL and GIT_CONFIG_NOSYSTEM
> which have the opposite effect of the --global and --system switches to
> git-config are completely undocumented. This mentions them in the
> 'files' and 'environment' sections of the manpage for git-config where
> GIT_CONFIG is already mentioned.
>
> Signed-off-by: Jan Krüger <jk@jk.gs>

Aren't they undocumented because the use case for them is pretty much limited to the test scripts and nowhere else? I am not absolutely sure about GIT_CONFIG_NOGLOBAL, but NOSYSTEM surely was started that way.

Jan Krüger· Oct 4, 2010, 06:31 UTC · re: Junio C Hamano · lore

Re: [PATCH] Documentation: mention environment variables GIT_CONFIG_NO(GLOBAL|SYSTEM)

--- Junio C Hamano <gitster@pobox.com> wrote:
> Aren't they undocumented because the use case for them is pretty much
> limited to the test scripts and nowhere else?  I am not absolutely
> sure about GIT_CONFIG_NOGLOBAL, but NOSYSTEM surely was started that
> way.

I don't know. I found them when someone on IRC was looking for a way to bypass an insteadOf setting in his ~/.gitconfig file, so I guess that there is an actual use case for some.

-Jan

← back to recent threads