Differences

This shows you the differences between two versions of the page.

--- git_config [2019/02/18 09:27] – [SYNOPSIS] rpjday
+++ git_config [2019/02/18 09:57] (current) – [Configuration sections and keys] rpjday
@@ Line 37: / Line 37: @@
 ===== Basic configuration examples =====
+Configuration settings of the form ''<section>''.''<key>'':
 <code>
@@ Line 56: / Line 58: @@
 </code>
-===== Configuration sections and keys =====
+All of the above (based on specifying ''%%--%%global'') end up in your (INI-style) personal ''~/.gitconfig'' file with the form:
-Format of ''<section>.<key>'':
+<code>
+[user]
+	email = rpjday@crashcourse.ca
+	name = Robert P. J. Day
+[color]
+	ui = false
+</code>
-  * ''user.name''
+and so on.
-  * ''user.email''
-  * ''core.editor''
-  * ''color.ui''
-  * ''format.pretty''
-Format of ''<section>.<subsection>.<key>'':
+To delete a configuration setting, add ''%%--%%unset'':
-  * ''remote.origin.url''
+<code>
-  * ''branch.master.merge''
+$ git config --global --unset alias.br
+</code>
-Sections and keys are //not// case-sensitive, while (weirdly) those middle subsections //are//:
+===== Three levels of configuration =====
-  * ''user.name''
+In order of processing (later settings override earlier ones):
-  * ''UsEr.nAmE''
-  * ''REMOTE.origin.URL''
-  * ''BrAnCh.master.meRGE''
-===== Three levels of configuration =====
+  * system (''/etc/gitconfig'')
+  * global (''~/.gitconfig'')
+  * local (''.git/config'') [associated with the repo itself]
 ==== /etc/gitconfig (--system) ====
@@ Line 92: / Line 96: @@
 ==== ~/.gitconfig (--global) ====
-Per-user (it would have killed them to call it ''%%--%%user''?):
+Per-user:
 <code>
@@ Line 132: / Line 136: @@
 </code>
-===== Setting your configuration =====
+NOTE: If you don't specify which of the three levels you want, the operation defaults to ''%%--%%local'', which will fail if you are not inside a working tree, and is probably not what you want, anyway.
-==== Global configuration ====
-Setting globally (in personal ''~/.gitconfig''):
-<code>
-$ git config --global user.name "Robert P. J. Day"
-$ git config --global user.email "rpjday@crashcourse.ca"
-$ git config --global color.ui false
-</code>
-==== Local configuration ====
-Setting locally (in repo's ''.git/config''):
-<code>
-$ git config [--local] gui.wmstate normal   (the default mode)
-</code>
 ===== Listing config settings =====
@@ Line 201: / Line 187: @@
 ===== Overriding configuration settings =====
-==== One-time config override with -c ====
-<code>
-$ git -c user.name="Keyser Soze" <command>...
-</code>
 ==== Environment variables ====
-As an example, ''git commit'' searches for the editor to use when entering the commit message:
+Most Git commands support environment variables for overriding configuration settings. As an example, ''git commit'' searches for the editor to use when entering the commit message:
   * ''GIT_EDITOR'' environment variable
@@ Line 227: / Line 209: @@
 $ man git
 </code>
+==== One-time config override with -c ====
+If you need a one-time-only override of some config setting, most Git commands support the "-c" option:
+<code>
+$ git -c user.name="Keyser Soze" <some command>...
+</code>
+===== Sections and subsections =====
+Format of ''<section>.<key>'':
+  * ''user.name''
+  * ''user.email''
+  * ''core.editor''
+  * ''color.ui''
+  * ''format.pretty''
+Format of ''<section>.<subsection>.<key>'':
+  * ''remote.origin.url''
+  * ''branch.master.merge''
+Sections and keys are //not// case-sensitive, while (weirdly) those middle subsections //are//:
+  * ''user.name''
+  * ''UsEr.nAmE''
+  * ''REMOTE.origin.URL''
+  * ''BrAnCh.master.meRGE''