Re: [PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-13 Thread Junio C Hamano
Yaroslav Halchenko writes: > It always read it for non--global > ... > and it doesn't read it for --global > ... > unless ~/.gitconfig is missing Yes, this dates back to 21cf3227 ("config: read (but not write) from $XDG_CONFIG_HOME/git/config file", 2012-06-22), around the time back when we adde

Re: [PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-13 Thread Yaroslav Halchenko
On Tue, 12 Dec 2017, Jacob Keller wrote: > > And then "and the other files will not be read" can be dropped from > > the first sentence of this paragraph? > > Yaroslav on the original thread mentioned that reading codepath > > without --file or --global does not limit to one of the three, and >

Re: [PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-12 Thread Jacob Keller
On Tue, Dec 12, 2017 at 11:47 AM, Junio C Hamano wrote: > Jacob Keller writes: > >> --global:: >> + For writing options: write to global user configuration file >> + rather than the repository `.git/config`. >> + >> +For reading options: read only from global user configuration file >>

Re: [PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-12 Thread Jacob Keller
On Tue, Dec 12, 2017 at 7:20 AM, Todd Zullinger wrote: > Hi Jacob, > > Jacob Keller wrote: >> The documentation for git config and how it reads the user specific >> configuration file is misleading. In some places it implies that >> $XDG_CONFIG_HOME/git/config will always be read. In others, it im

Re: [PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-12 Thread Junio C Hamano
Jacob Keller writes: > --global:: > + For writing options: write to global user configuration file > + rather than the repository `.git/config`. > + > +For reading options: read only from global user configuration file > +rather than from all available files. > + > See also <>. OK.

Re: [PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-12 Thread Todd Zullinger
Hi Jacob, Jacob Keller wrote: > The documentation for git config and how it reads the user specific > configuration file is misleading. In some places it implies that > $XDG_CONFIG_HOME/git/config will always be read. In others, it implies > that only one of ~/.gitconfig and $XDG_CONFIG_HOME/git/c

[PATCH] doc: clarify usage of XDG_CONFIG_HOME config file

2017-12-12 Thread Jacob Keller
The documentation for git config and how it reads the user specific configuration file is misleading. In some places it implies that $XDG_CONFIG_HOME/git/config will always be read. In others, it implies that only one of ~/.gitconfig and $XDG_CONFIG_HOME/git/config will be read. Improve the docume