kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

docs/api-config: minor clarifications 

The first change simply drops some parentheses to make a
statement more clear. The seconds clarifies that almost
nobody wants to call git_config_early.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Jeff King 2012-02-17 03:18:38 -05:00 committed by Junio C Hamano
parent 9c3c22e2bf
commit d7be1f142f
1 changed files with 8 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Documentation/technical/api-config.txt
View File

@ -11,9 +11,9 @@ General Usage
Config files are parsed linearly, and each variable found is passed to a Config files are parsed linearly, and each variable found is passed to a
caller-provided callback function. The callback function is responsible caller-provided callback function. The callback function is responsible
for any actions to be taken on the config option, and is free to ignore for any actions to be taken on the config option, and is free to ignore
some options (it is not uncommon for the configuration to be parsed some options. It is not uncommon for the configuration to be parsed
several times during the run of a git program, with different callbacks several times during the run of a git program, with different callbacks
picking out different variables useful to themselves). picking out different variables useful to themselves.


A config callback function takes three parameters: A config callback function takes three parameters:


@ -47,11 +47,12 @@ will first feed the user-wide one to the callback, and then the
repo-specific one; by overwriting, the higher-priority repo-specific repo-specific one; by overwriting, the higher-priority repo-specific
value is left at the end). value is left at the end).


There is a special version of `git_config` called `git_config_early` There is a special version of `git_config` called `git_config_early`.
that takes an additional parameter to specify the repository config. This version takes an additional parameter to specify the repository
This should be used early in a git program when the repository location config, instead of having it looked up via `git_path`. This is useful
has not yet been determined (and calling the usual lazy-evaluation early in a git program before the repository has been found. Unless
lookup rules would yield an incorrect location). you're working with early setup code, you probably don't want to use
this.


Reading Specific Files Reading Specific Files
---------------------- ----------------------