~mdw / tig / blame
| Commit | Line | Data |
|---|---|---|
| cb7f42cd JF |
1 | tigrc(5) |
| 2 | ======== | |
| 3 | ||
| 4 | NAME | |
| 5 | ---- | |
| 6 | tigrc - tig user configuration file | |
| 7 | ||
| 8 | SYNOPSIS | |
| 9 | -------- | |
| 10 | [verse] | |
| 11 | ............................................................................. | |
| 12 | *color* 'fgcolor' 'bgcolor' '[attributes]' | |
| 13 | ............................................................................. | |
| 14 | ||
| 15 | DESCRIPTION | |
| 16 | ----------- | |
| 17 | You can permanently set an option by putting it in the `~/.tigrc` file. | |
| 18 | The file consists of a series of 'commands'. Each | |
| 19 | line of the file may contain only one command. | |
| 20 | ||
| 21 | The hash mark ('#'), or semi-colon (';') is used as a 'comment' character. | |
| 22 | All text after the comment character to the end of the line is ignored. | |
| 23 | You can use comments to annotate your initialization file. | |
| 24 | ||
| 25 | Color options | |
| 26 | ------------- | |
| 27 | ||
| 28 | Color options control highlighting and the user interface styles. | |
| 29 | If your terminal supports color, these commands can be used to assign | |
| 30 | foreground/backgound combinations to certain areas. Optionally, an | |
| 31 | attribute can be given as the last parameter. The syntax is: | |
| 32 | ||
| 33 | [verse] | |
| 34 | .......................................................................... | |
| 35 | *color* 'area' 'fgcolor' 'bgcolor' '[attributes]' | |
| 36 | .......................................................................... | |
| 37 | ||
| 38 | Valid colors include: *white*, *black*, *green*, *magenta*, *blue*, *cyan*, | |
| 39 | *yellow*, *red*, *default*. Use *default* to refer to the default terminal | |
| 40 | colors. | |
| 41 | ||
| 42 | Valid attributes include: *normal*, *blink*, *bold*, *dim*, *reverse*, *standout*, | |
| 43 | and *underline*. Note, not all attributes may be supported by the terminal. | |
| 44 | ||
| 45 | Valid area names are described below. Note, all names are case-insensitive, | |
| 46 | and you may use '-', '_', and '.' interchangeably. So "Diff-Header", | |
| 47 | "DIFF_HEADER", and "diff.header" are the same. | |
| 48 | ||
| 49 | Diff markup | |
| 50 | ~~~~~~~~~~~ | |
| 51 | ||
| 52 | Options concerning diff start, chunks and lines added and deleted. | |
| 53 | ||
| 54 | *diff-header*, *diff-chunk*, *diff-add*, *diff-del* | |
| 55 | ||
| 56 | Enhanced git diff markup | |
| 57 | ~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 58 | ||
| 59 | Extra diff information emitted by the git diff machinery, such as mode | |
| 60 | changes, rename detection, and similarity. | |
| 61 | ||
| 62 | *diff-oldmode*, *diff-newmode*, *diff-copy-from*, *diff-copy-to*, | |
| 63 | *diff-rename-from*, *diff-rename-to*, *diff-similarity* *diff-dissimilarity* | |
| 64 | *diff-tree*, *diff-index* | |
| 65 | ||
| 66 | Pretty print commit headers | |
| 67 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 68 | ||
| 69 | Commit diffs and the revision logs are usually formatted using pretty | |
| 70 | printed headers , unless `--pretty=raw` was given. This includes lines, | |
| 71 | such as merge info, commit ID, and author and comitter date. | |
| 72 | ||
| 73 | *pp-author*, *pp-commit*, *pp-merge*, *pp-date*, *pp-adate*, *pp-cdate* | |
| 74 | ||
| 75 | Raw commit header | |
| 76 | ~~~~~~~~~~~~~~~~~ | |
| 77 | ||
| 78 | Usually shown when `--pretty=raw` is given, however 'commit' is pretty | |
| 79 | much omnipresent. | |
| 80 | ||
| 81 | *commit*, *parent*, *tree*, *author*, *committer* | |
| 82 | ||
| 83 | Commit message | |
| 84 | ~~~~~~~~~~~~~~ | |
| 85 | ||
| 86 | For now only `Signed-off-by lines` are colorized. | |
| 87 | ||
| 88 | *signoff* | |
| 89 | ||
| 90 | UI colors | |
| 91 | ~~~~~~~~~ | |
| 92 | ||
| 93 | Colors for text not matching any of the above: *default* | |
| 94 | ||
| 95 | Status window colors: *status* | |
| 96 | ||
| 97 | Title window colors: *title-blur*, *title-focus* | |
| 98 | ||
| 99 | Cursor line colors: *cursor* | |
| 100 | ||
| 101 | Main view specific: *main-date*, *main-author*, *main-commit*, *main-delim*, | |
| 102 | *main-tag*, *main-ref* | |
| 103 | ||
| 104 | ||
| 105 | EXAMPLES | |
| 106 | -------- | |
| 107 | ||
| 108 | Some sample options: | |
| 109 | ||
| 110 | ========================================================================== | |
| 111 | # Diff colors | |
| 112 | color diff-header yellow default | |
| 113 | color diff-index blue default | |
| 114 | color diff-chunk magenta default | |
| 115 | # UI colors | |
| 116 | color title-blur white blue | |
| 117 | color title-focus white blue bold | |
| 118 | ========================================================================== | |
| 119 | ||
| 120 | SEE ALSO | |
| 121 | -------- | |
| 122 | tig(1) |