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) |