[PATCH] Add an option to specify a file to config builtin

DORMANTno replies

5 messages, 2 authors, 2016-06-15 · open the first message on its own page

[PATCH] Add an option to specify a file to config builtin

From: Alex Riesen <hidden>
Date: 2016-06-15 22:43:25

There are (really!) systems where using environment variables is very
cumbersome (yes, Windows, it has problems unsetting them). Besides this
form is shorter.

Signed-off-by: Alex Riesen <redacted>
---
 Documentation/git-config.txt |   29 ++++++++++++++++-------------
 builtin-config.c             |    9 ++++++++-
 2 files changed, 24 insertions(+), 14 deletions(-)

Re: [PATCH] Add an option to specify a file to config builtin

From: Johannes Schindelin <hidden>
Date: 2016-06-15 22:43:25

Hi,

On Tue, 31 Jul 2007, Alex Riesen wrote:
There are (really!) systems where using environment variables is very
cumbersome (yes, Windows, it has problems unsetting them). Besides this
form is shorter.
You could use this chance to make the verse nicer, i.e. split it into a 
[<file-option>] and an [<action>] part.

Ciao,
Dscho

Re: [PATCH] Add an option to specify a file to config builtin

From: Alex Riesen <hidden>
Date: 2016-06-15 22:43:25

On 7/31/07, Johannes Schindelin [off-list ref] wrote:
quoted
There are (really!) systems where using environment variables is very
cumbersome (yes, Windows, it has problems unsetting them). Besides this
form is shorter.
You could use this chance to make the verse nicer, i.e. split it into a
[<file-option>] and an [<action>] part.
Missed that opportunity for today, I'm afraid. Will try to get to it
the next evening

[PATCH] Make verse of git-config manpage more readable

From: Alex Riesen <hidden>
Date: 2016-06-15 22:43:25

Also mention '--file' in FILES.

Signed-off-by: Alex Riesen <redacted>
---

Alex Riesen, Tue, Jul 31, 2007 14:02:13 +0200:
On 7/31/07, Johannes Schindelin [off-list ref] wrote:
quoted
You could use this chance to make the verse nicer, i.e. split it into a
[<file-option>] and an [<action>] part.
Did only the long one, file-option. I don't think the [<action>] part
is essential, though. It is quite understandable...

 Documentation/git-config.txt |   32 +++++++++++++++++++-------------
 1 files changed, 19 insertions(+), 13 deletions(-)
diff --git a/Documentation/git-config.txt b/Documentation/git-config.txt
index 88acf6c..8451ccc 100644
--- a/Documentation/git-config.txt
+++ b/Documentation/git-config.txt
@@ -9,17 +9,17 @@ git-config - Get and set repository or global options
 SYNOPSIS
 --------
 [verse]
-'git-config' [--system | --global | [-f|--file] config-file] [type] [-z|--null] name [value [value_regex]]
-'git-config' [--system | --global | [-f|--file] config-file] [type] --add name value
-'git-config' [--system | --global | [-f|--file] config-file] [type] --replace-all name [value [value_regex]]
-'git-config' [--system | --global | [-f|--file] config-file] [type] [-z|--null] --get name [value_regex]
-'git-config' [--system | --global | [-f|--file] config-file] [type] [-z|--null] --get-all name [value_regex]
-'git-config' [--system | --global | [-f|--file] config-file] [type] [-z|--null] --get-regexp name_regex [value_regex]
-'git-config' [--system | --global | [-f|--file] config-file] --unset name [value_regex]
-'git-config' [--system | --global | [-f|--file] config-file] --unset-all name [value_regex]
-'git-config' [--system | --global | [-f|--file] config-file] --rename-section old_name new_name
-'git-config' [--system | --global | [-f|--file] config-file] --remove-section name
-'git-config' [--system | --global | [-f|--file] config-file] [-z|--null] -l | --list
+'git-config' [<file-option>] [type] [-z|--null] name [value [value_regex]]
+'git-config' [<file-option>] [type] --add name value
+'git-config' [<file-option>] [type] --replace-all name [value [value_regex]]
+'git-config' [<file-option>] [type] [-z|--null] --get name [value_regex]
+'git-config' [<file-option>] [type] [-z|--null] --get-all name [value_regex]
+'git-config' [<file-option>] [type] [-z|--null] --get-regexp name_regex [value_regex]
+'git-config' [<file-option>] --unset name [value_regex]
+'git-config' [<file-option>] --unset-all name [value_regex]
+'git-config' [<file-option>] --rename-section old_name new_name
+'git-config' [<file-option>] --remove-section name
+'git-config' [<file-option>] [-z|--null] -l | --list
 
 DESCRIPTION
 -----------
@@ -40,6 +40,12 @@ convert the value to the canonical form (simple decimal number for int,
 a "true" or "false" string for bool).  If no type specifier is passed,
 no checks or transformations are performed on the value.
 
+The file-option can be one of '--system', '--global' or '--file'
+which specify where the values will be read from or written to.
+The default is to assume the config file of the current repository,
+.git/config unless defined otherwise with GIT_DIR and GIT_CONFIG
+(see <<FILES>>).
+
 This command will fail if:
 
 . The config file is invalid,
@@ -133,8 +139,8 @@ See also <<FILES>>.
 FILES
 -----
 
-There are three files where git-config will search for configuration
-options:
+If not set explicitely with '--file', there are three files where
+git-config will search for configuration options:
 
 .git/config::
 	Repository specific configuration file. (The filename is
-- 
1.5.3.rc3.116.g94fd8

Re: [PATCH] Make verse of git-config manpage more readable

From: Johannes Schindelin <hidden>
Date: 2016-06-15 22:43:25

Hi,

On Wed, 1 Aug 2007, Alex Riesen wrote:
Also mention '--file' in FILES.

Signed-off-by: Alex Riesen <redacted>
---

Alex Riesen, Tue, Jul 31, 2007 14:02:13 +0200:
quoted
On 7/31/07, Johannes Schindelin [off-list ref] wrote:
quoted
You could use this chance to make the verse nicer, i.e. split it into a
[<file-option>] and an [<action>] part.
Did only the long one, file-option. I don't think the [<action>] part
is essential, though. It is quite understandable...
It is too long.  That's my gripe with it.  But then, I do not really care; 
I know pretty well what "git config" can do...

Ciao,
Dscho
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help