From be52a41c4ea02fe7fabfef4ea9af821cdfd69a15 Mon Sep 17 00:00:00 2001 From: Alex Riesen Date: Wed, 1 Aug 2007 00:01:17 +0200 Subject: [PATCH] Make verse of git-config manpage more readable Also mention '--file' in FILES. Signed-off-by: Alex Riesen Signed-off-by: Junio C Hamano --- Documentation/git-config.txt | 32 +++++++++++++++++++------------- 1 file changed, 19 insertions(+), 13 deletions(-) diff --git a/Documentation/git-config.txt b/Documentation/git-config.txt index 88acf6ce98..8451cccf8a 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' [] [type] [-z|--null] name [value [value_regex]] +'git-config' [] [type] --add name value +'git-config' [] [type] --replace-all name [value [value_regex]] +'git-config' [] [type] [-z|--null] --get name [value_regex] +'git-config' [] [type] [-z|--null] --get-all name [value_regex] +'git-config' [] [type] [-z|--null] --get-regexp name_regex [value_regex] +'git-config' [] --unset name [value_regex] +'git-config' [] --unset-all name [value_regex] +'git-config' [] --rename-section old_name new_name +'git-config' [] --remove-section name +'git-config' [] [-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 <>). + This command will fail if: . The config file is invalid, @@ -133,8 +139,8 @@ See also <>. 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