| color.advice:: |
| A boolean to enable/disable color in hints (e.g. when a push |
| failed, see `advice.*` for a list). May be set to `always`, |
| `false` (or `never`) or `auto` (or `true`), in which case colors |
| are used only when the error output goes to a terminal. If |
| unset, then the value of `color.ui` is used (`auto` by default). |
| |
| color.advice.hint:: |
| Use customized color for hints. |
| |
| color.blame.highlightRecent:: |
| Specify the line annotation color for `git blame --color-by-age` |
| depending upon the age of the line. |
| + |
| This setting should be set to a comma-separated list of color and |
| date settings, starting and ending with a color, the dates should be |
| set from oldest to newest. The metadata will be colored with the |
| specified colors if the line was introduced before the given |
| timestamp, overwriting older timestamped colors. |
| + |
| Instead of an absolute timestamp relative timestamps work as well, |
| e.g. `2.weeks.ago` is valid to address anything older than 2 weeks. |
| + |
| It defaults to `blue,12 month ago,white,1 month ago,red`, which |
| colors everything older than one year blue, recent changes between |
| one month and one year old are kept white, and lines introduced |
| within the last month are colored red. |
| |
| color.blame.repeatedLines:: |
| Use the specified color to colorize line annotations for |
| `git blame --color-lines`, if they come from the same commit as the |
| preceding line. Defaults to cyan. |
| |
| color.branch:: |
| A boolean to enable/disable color in the output of |
| linkgit:git-branch[1]. May be set to `always`, |
| `false` (or `never`) or `auto` (or `true`), in which case colors are used |
| only when the output is to a terminal. If unset, then the |
| value of `color.ui` is used (`auto` by default). |
| |
| color.branch.<slot>:: |
| Use customized color for branch coloration. `<slot>` is one of |
| `current` (the current branch), `local` (a local branch), |
| `remote` (a remote-tracking branch in refs/remotes/), |
| `upstream` (upstream tracking branch), `plain` (other |
| refs). |
| |
| color.diff:: |
| Whether to use ANSI escape sequences to add color to patches. |
| If this is set to `always`, linkgit:git-diff[1], |
| linkgit:git-log[1], and linkgit:git-show[1] will use color |
| for all patches. If it is set to `true` or `auto`, those |
| commands will only use color when output is to the terminal. |
| If unset, then the value of `color.ui` is used (`auto` by |
| default). |
| + |
| This does not affect linkgit:git-format-patch[1] or the |
| 'git-diff-{asterisk}' plumbing commands. Can be overridden on the |
| command line with the `--color[=<when>]` option. |
| |
| color.diff.<slot>:: |
| Use customized color for diff colorization. `<slot>` specifies |
| which part of the patch to use the specified color, and is one |
| of `context` (context text - `plain` is a historical synonym), |
| `meta` (metainformation), `frag` |
| (hunk header), 'func' (function in hunk header), `old` (removed lines), |
| `new` (added lines), `commit` (commit headers), `whitespace` |
| (highlighting whitespace errors), `oldMoved` (deleted lines), |
| `newMoved` (added lines), `oldMovedDimmed`, `oldMovedAlternative`, |
| `oldMovedAlternativeDimmed`, `newMovedDimmed`, `newMovedAlternative` |
| `newMovedAlternativeDimmed` (See the '<mode>' |
| setting of '--color-moved' in linkgit:git-diff[1] for details), |
| `contextDimmed`, `oldDimmed`, `newDimmed`, `contextBold`, |
| `oldBold`, and `newBold` (see linkgit:git-range-diff[1] for details). |
| |
| color.decorate.<slot>:: |
| Use customized color for 'git log --decorate' output. `<slot>` is one |
| of `branch`, `remoteBranch`, `tag`, `stash` or `HEAD` for local |
| branches, remote-tracking branches, tags, stash and HEAD, respectively |
| and `grafted` for grafted commits. |
| |
| color.grep:: |
| When set to `always`, always highlight matches. When `false` (or |
| `never`), never. When set to `true` or `auto`, use color only |
| when the output is written to the terminal. If unset, then the |
| value of `color.ui` is used (`auto` by default). |
| |
| color.grep.<slot>:: |
| Use customized color for grep colorization. `<slot>` specifies which |
| part of the line to use the specified color, and is one of |
| + |
| -- |
| `context`;; |
| non-matching text in context lines (when using `-A`, `-B`, or `-C`) |
| `filename`;; |
| filename prefix (when not using `-h`) |
| `function`;; |
| function name lines (when using `-p`) |
| `lineNumber`;; |
| line number prefix (when using `-n`) |
| `column`;; |
| column number prefix (when using `--column`) |
| `match`;; |
| matching text (same as setting `matchContext` and `matchSelected`) |
| `matchContext`;; |
| matching text in context lines |
| `matchSelected`;; |
| matching text in selected lines. Also, used to customize the following |
| linkgit:git-log[1] subcommands: `--grep`, `--author`, and `--committer`. |
| `selected`;; |
| non-matching text in selected lines. Also, used to customize the |
| following linkgit:git-log[1] subcommands: `--grep`, `--author` and |
| `--committer`. |
| `separator`;; |
| separators between fields on a line (`:`, `-`, and `=`) |
| and between hunks (`--`) |
| -- |
| |
| color.interactive:: |
| When set to `always`, always use colors for interactive prompts |
| and displays (such as those used by "git-add --interactive" and |
| "git-clean --interactive"). When false (or `never`), never. |
| When set to `true` or `auto`, use colors only when the output is |
| to the terminal. If unset, then the value of `color.ui` is |
| used (`auto` by default). |
| |
| color.interactive.<slot>:: |
| Use customized color for 'git add --interactive' and 'git clean |
| --interactive' output. `<slot>` may be `prompt`, `header`, `help` |
| or `error`, for four distinct types of normal output from |
| interactive commands. |
| |
| color.pager:: |
| A boolean to specify whether `auto` color modes should colorize |
| output going to the pager. Defaults to true; set this to false |
| if your pager does not understand ANSI color codes. |
| |
| color.push:: |
| A boolean to enable/disable color in push errors. May be set to |
| `always`, `false` (or `never`) or `auto` (or `true`), in which |
| case colors are used only when the error output goes to a terminal. |
| If unset, then the value of `color.ui` is used (`auto` by default). |
| |
| color.push.error:: |
| Use customized color for push errors. |
| |
| color.remote:: |
| If set, keywords at the start of the line are highlighted. The |
| keywords are "error", "warning", "hint" and "success", and are |
| matched case-insensitively. May be set to `always`, `false` (or |
| `never`) or `auto` (or `true`). If unset, then the value of |
| `color.ui` is used (`auto` by default). |
| |
| color.remote.<slot>:: |
| Use customized color for each remote keyword. `<slot>` may be |
| `hint`, `warning`, `success` or `error` which match the |
| corresponding keyword. |
| |
| color.showBranch:: |
| A boolean to enable/disable color in the output of |
| linkgit:git-show-branch[1]. May be set to `always`, |
| `false` (or `never`) or `auto` (or `true`), in which case colors are used |
| only when the output is to a terminal. If unset, then the |
| value of `color.ui` is used (`auto` by default). |
| |
| color.status:: |
| A boolean to enable/disable color in the output of |
| linkgit:git-status[1]. May be set to `always`, |
| `false` (or `never`) or `auto` (or `true`), in which case colors are used |
| only when the output is to a terminal. If unset, then the |
| value of `color.ui` is used (`auto` by default). |
| |
| color.status.<slot>:: |
| Use customized color for status colorization. `<slot>` is |
| one of `header` (the header text of the status message), |
| `added` or `updated` (files which are added but not committed), |
| `changed` (files which are changed but not added in the index), |
| `untracked` (files which are not tracked by Git), |
| `branch` (the current branch), |
| `nobranch` (the color the 'no branch' warning is shown in, defaulting |
| to red), |
| `localBranch` or `remoteBranch` (the local and remote branch names, |
| respectively, when branch and tracking information is displayed in the |
| status short-format), or |
| `unmerged` (files which have unmerged changes). |
| |
| color.transport:: |
| A boolean to enable/disable color when pushes are rejected. May be |
| set to `always`, `false` (or `never`) or `auto` (or `true`), in which |
| case colors are used only when the error output goes to a terminal. |
| If unset, then the value of `color.ui` is used (`auto` by default). |
| |
| color.transport.rejected:: |
| Use customized color when a push was rejected. |
| |
| color.ui:: |
| This variable determines the default value for variables such |
| as `color.diff` and `color.grep` that control the use of color |
| per command family. Its scope will expand as more commands learn |
| configuration to set a default for the `--color` option. Set it |
| to `false` or `never` if you prefer Git commands not to use |
| color unless enabled explicitly with some other configuration |
| or the `--color` option. Set it to `always` if you want all |
| output not intended for machine consumption to use color, to |
| `true` or `auto` (this is the default since Git 1.8.4) if you |
| want such output to use color when written to the terminal. |