Merge branch 'maint'
authorJunio C Hamano <gitster@pobox.com>
Thu, 1 Mar 2012 22:45:14 +0000 (14:45 -0800)
committerJunio C Hamano <gitster@pobox.com>
Thu, 1 Mar 2012 22:45:14 +0000 (14:45 -0800)
* maint:
Documentation fixes in git-config

1  2 
Documentation/config.txt
Documentation/git-config.txt
diff --combined Documentation/config.txt
index e55dae1806a8889d8179c94139bb60a2c5f7a9a6,a7a6dc071d4c5d3d6ce89b043f4cecc36fbe37dc..5367ba9cae84c54b1c1b5b26fd7b4bd69383f832
@@@ -12,8 -12,9 +12,9 @@@ The configuration variables are used b
  and the porcelains. The variables are divided into sections, wherein
  the fully qualified variable name of the variable itself is the last
  dot-separated segment and the section name is everything before the last
- dot. The variable names are case-insensitive and only alphanumeric
- characters are allowed. Some variables may appear multiple times.
+ dot. The variable names are case-insensitive, allow only alphanumeric
+ characters and `-`, and must start with an alphabetic character.  Some
+ variables may appear multiple times.
  
  Syntax
  ~~~~~~
@@@ -54,9 -55,10 +55,10 @@@ All the other lines (and the remainder 
  header) are recognized as setting variables, in the form
  'name = value'.  If there is no equal sign on the line, the entire line
  is taken as 'name' and the variable is recognized as boolean "true".
- The variable names are case-insensitive and only alphanumeric
- characters and `-` are allowed.  There can be more than one value
- for a given variable; we say then that variable is multivalued.
+ The variable names are case-insensitive, allow only alphanumeric characters
+ and `-`, and must start with an alphabetic character.  There can be more
+ than one value for a given variable; we say then that the variable is
+ multivalued.
  
  Leading and trailing whitespace in a variable value is discarded.
  Internal whitespace within a variable value is retained verbatim.
@@@ -84,17 -86,6 +86,17 @@@ customary UNIX fashion
  
  Some variables may require a special value format.
  
 +Includes
 +~~~~~~~~
 +
 +You can include one config file from another by setting the special
 +`include.path` variable to the name of the file to be included. The
 +included file is expanded immediately, as if its contents had been
 +found at the location of the include directive. If the value of the
 +`include.path` variable is a relative path, the path is considered to be
 +relative to the configuration file in which the include directive was
 +found. See below for examples.
 +
  Example
  ~~~~~~~
  
                gitProxy="ssh" for "kernel.org"
                gitProxy=default-proxy ; for the rest
  
 +      [include]
 +              path = /path/to/foo.inc ; include by absolute path
 +              path = foo ; expand "foo" relative to the current file
 +
  Variables
  ~~~~~~~~~
  
index aa8303b1adb1ac6efba6a5919a6a59495e89c6fb,7617d9eb2431a1dd52516b22b5e2ac4be2962f97..81b03982e372c98afaf944398e9a168554871447
@@@ -85,8 -85,11 +85,11 @@@ OPTION
        is not exactly one.
  
  --get-regexp::
-       Like --get-all, but interprets the name as a regular expression.
-       Also outputs the key names.
+       Like --get-all, but interprets the name as a regular expression and
+       writes out the key names.  Regular expression matching is currently
+       case-sensitive and done against a canonicalized version of the key
+       in which section and variable names are lowercased, but subsection
+       names are not.
  
  --global::
        For writing options: write to global ~/.gitconfig file rather than
@@@ -178,11 -181,6 +181,11 @@@ See also <<FILES>>
        Opens an editor to modify the specified config file; either
        '--system', '--global', or repository (default).
  
 +--includes::
 +--no-includes::
 +      Respect `include.*` directives in config files when looking up
 +      values. Defaults to on.
 +
  [[FILES]]
  FILES
  -----