1TIGRC(5) Tig Manual TIGRC(5)
2
6 tigrc - tig user configuration file
7
9 set variable = value
10 bind keymap key action
11 color area fgcolor bgcolor [attributes]
12
15 You can permanently set an option by putting it in the ~/.tigrc file.
16 The file consists of a series of commands. Each line of the file may
17 contain only one command.
18 The hash mark (#) is used as a comment character. All text after the
20 comment character to the end of the line is ignored. You can use
21 comments to annotate your initialization file.
22
25 A few selective variables can be configured via the set command. The
26 syntax is:
27 set variables = value
30 Examples:
32 set show-rev-graph = yes # Show revision graph?
35 set line-number-interval = 5 # Interval between line numbers
36 set tab-size = 8 # Number of spaces pr tab
37 set encoding = "UTF-8" # Commit encoding
38 The type of variables are either bool, int, and string.
40 Valid bool values
43 To set a bool variable to true use either "1", "true", or "yes". Any
44 other value will set the variable to false.
45 Valid int values
48 A non-negative integer.
49 Valid string values
52 A string of characters. Optionally, use either ' or " as delimiters.
53 Variables
56 The following variables can be set:
57 show-rev-graph (bool)
60 Show revision graph in the main view on start-up. Can be toggled
61 with g.
62 line-number-interval (int)
65 Interval between line numbers. Note, you have to toggle on line
66 numbering with n or the -n command line option. The default is to
67 number every line.
68 tab-size (int)
71 Number of spaces per tab. The default is 8 spaces.
72 commit-encoding (string)
75 The encoding used for commits. The default is UTF-8. Not this option
76 is shadowed by the "i18n.commitencoding" option in .git/config.
77
80 Using bind commands keys can be mapped to an action when pressed in a
81 given key map. The syntax is:
82 bind keymap key action
85 Examples:
87 # A few keybindings
90 bind main w scroll-line-up
91 bind main s scroll-line-down
92 bind main space enter
93 bind diff a previous
94 bind diff d next
95 bind diff b move-first-line
96 # 'unbind' the default quit key binding
97 bind main Q none
98 Keys are mapped by first searching the keybindings for the current
100 view, then the keybindings for the generic keymap, and last the default
101 keybindings. Thus, the view keybindings shadow the generic keybindings
102 which Shadow the built-in keybindings.
103 Keymaps
106 Valid keymaps are: main, diff, log, help, pager, status, and
107 generic. Use generic to set key mapping in all keymaps.
108 Key values
111 Key values should never be quoted. Use either the ASCII value or one
112 of the following symbolic key names. Symbolic key names are case
113 insensitive, Use Hash to bind to the # key, since the hash mark is
114 used as a comment character.
115 Enter, Space, Backspace, Tab, Escape, Left, Right, Up, Down, Insert,
117 Delete, Hash, Home, End, PageUp, PageDown, F1, F2, F3, F4, F5, F6,
118 F7, F8, F9, F10, F11, F12.
119 Action names
122 Valid action names are described below. Note, all names are
123 case-insensitive, and you may use -, _, and . interchangeably, e.g.
124 "view-main", "View.Main", and "VIEW_MAIN" are the same.
125 Actions
128 View switching:
129 view-main Show main view
132 view-diff Show diff view
133 view-log Show log view
134 view-tree Show tree view
135 view-blob Show blob view
136 view-status Show status view
137 view-pager Show pager view
138 view-help Show help page
139 View manipulation:
141 enter Enter current line and scroll
144 next Move to next
145 previous Move to previous
146 view-next Move focus to next view
147 view-close Close the current view
148 quit Close all views and quit
149 Cursor navigation:
151 move-up Move cursor one line up
154 move-down Move cursor one line down
155 move-page-down Move cursor one page down
156 move-page-up Move cursor one page up
157 move-first-line Move cursor to first line
158 move-last-line Move cursor to last line
159 Scrolling:
161 scroll-line-up Scroll one line up
164 scroll-line-down Scroll one line down
165 scroll-page-eup Scroll one page up
166 scroll-page-down Scroll one page down
167 Misc:
169 none Do nothing
172 prompt Bring up the prompt
173 screen-redraw Redraw the screen
174 screen-resize Resize the screen
175 show-version Show version information
176 stop-loading Stop all loading views
177 toggle-lineno Toggle line numbers
178 toggle-rev-graph Toggle revision graph visualization
179
182 Color commands control highlighting and the user interface styles. If
183 your terminal supports color, these commands can be used to assign
184 foreground and background combinations to certain areas. Optionally, an
185 attribute can be given as the last parameter. The syntax is:
186 color area fgcolor bgcolor [attributes]
189 Examples:
191 # Diff colors
194 color diff-header yellow default
195 color diff-index blue default
196 color diff-chunk magenta default
197 # A strange looking cursor line
198 color cursor red default underline
199 # UI colors
200 color title-blur white blue
201 color title-focus white blue bold
202 Area names
205 Valid area names are described below. Note, all names are
206 case-insensitive, and you may use -, _, and . interchangeably, e.g.
207 "Diff-Header", "DIFF_HEADER", and "diff.header" are the same.
208 Color names
211 Valid colors include: white, black, green, magenta, blue, cyan,
212 yellow, red, default. Use default to refer to the default terminal
213 colors.
214 Attribute names
217 Valid attributes include: normal, blink, bold, dim, reverse,
218 standout, and underline. Note, not all attributes may be supported
219 by the terminal.
220 UI colors
223 Status window colors
224 Appearance of the bottom window showing info messages.
225 status
227 Title window colors
230 Appearance of the title windows when they are attached to any
231 backgrounded windows and the current window.
232 title-blur, title-focus
234 Cursor line colors
237 cursor
238 Main view specific
241 Appearance of the various columns in the main view, including the ~
242 used for delimiting long author names and labels for tag and branch
243 references.
244 main-date, main-author, main-commit, main-delim, main-tag, main-ref,
246 main-remote
247 Highlighting
250 The colors and attributes for text that is not highlighted can be
251 controlled by changing the default color option.
252 Diff markup
255 Options concerning diff start, chunks and lines added and deleted.
256 diff-header, diff-chunk, diff-add, diff-del
258 Enhanced git diff markup
261 Extra diff information emitted by the git diff machinery, such as
262 mode changes, rename detection, and similarity.
263 diff-oldmode, diff-newmode, diff-copy-from, diff-copy-to,
265 diff-rename-from, diff-rename-to, diff-similarity diff-dissimilarity
266 diff-tree, diff-index
267 Pretty print commit headers
270 Commit diffs and the revision logs are usually formatted using
271 pretty printed headers , unless --pretty=raw was given. This
272 includes lines, such as merge info, commit ID, and author and
273 committer date.
274 pp-author, pp-commit, pp-merge, pp-date, pp-adate, pp-cdate
276 Raw commit header
279 Usually shown when --pretty=raw is given, however commit is pretty
280 much omnipresent.
281 commit, parent, tree, author, committer
283 Commit message
286 For now only Signed-off-by and Acked-by lines are colorized.
287 signoff, acked
289
292 Copyright (c) 2006 Jonas Fonseca <fonseca@diku.dk>
293 Licensed under the terms of the GNU General Public License.
295
298 tig(1) and the [1]tig manual.
299
302 1. tig manual
303 http://jonas.nitro.dk/tig/manual.html
304Tig 0.7 05/31/2007 TIGRC(5)