Sync docs
[tig] / tigrc.5.html
CommitLineData
3ad8214b
JF
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
4<head>\r
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
6<meta name="generator" content="AsciiDoc 7.0.2" />\r
7<style type="text/css">\r
8/* Debug borders */\r
9p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
10/*\r
11 border: 1px solid red;\r
12*/\r
13}\r
14\r
15body {\r
16 margin: 1em 5% 1em 5%;\r
17}\r
18\r
19a { color: blue; }\r
20a:visited { color: fuchsia; }\r
21\r
22em {\r
23 font-style: italic;\r
24}\r
25\r
26strong {\r
27 font-weight: bold;\r
28}\r
29\r
30tt {\r
31 color: navy;\r
32}\r
33\r
34h1, h2, h3, h4, h5, h6 {\r
35 color: #527bbd;\r
36 font-family: sans-serif;\r
37 margin-top: 1.2em;\r
38 margin-bottom: 0.5em;\r
39 line-height: 1.3;\r
40}\r
41\r
42h1 {\r
43 border-bottom: 2px solid silver;\r
44}\r
45h2 {\r
46 border-bottom: 2px solid silver;\r
47 padding-top: 0.5em;\r
48}\r
49\r
50div.sectionbody {\r
51 font-family: serif;\r
52 margin-left: 0;\r
53}\r
54\r
55hr {\r
56 border: 1px solid silver;\r
57}\r
58\r
59p {\r
60 margin-top: 0.5em;\r
61 margin-bottom: 0.5em;\r
62}\r
63\r
64pre {\r
65 padding: 0;\r
66 margin: 0;\r
67}\r
68\r
69span#author {\r
70 color: #527bbd;\r
71 font-family: sans-serif;\r
72 font-weight: bold;\r
73 font-size: 1.2em;\r
74}\r
75span#email {\r
76}\r
77span#revision {\r
78 font-family: sans-serif;\r
79}\r
80\r
81div#footer {\r
82 font-family: sans-serif;\r
83 font-size: small;\r
84 border-top: 2px solid silver;\r
85 padding-top: 0.5em;\r
86 margin-top: 4.0em;\r
87}\r
88div#footer-text {\r
89 float: left;\r
90 padding-bottom: 0.5em;\r
91}\r
92div#footer-badges {\r
93 float: right;\r
94 padding-bottom: 0.5em;\r
95}\r
96\r
97div#preamble,\r
98div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
99div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
100div.admonitionblock {\r
101 margin-right: 10%;\r
102 margin-top: 1.5em;\r
103 margin-bottom: 1.5em;\r
104}\r
105div.admonitionblock {\r
106 margin-top: 2.5em;\r
107 margin-bottom: 2.5em;\r
108}\r
109\r
110div.content { /* Block element content. */\r
111 padding: 0;\r
112}\r
113\r
114/* Block element titles. */\r
115div.title, caption.title {\r
116 font-family: sans-serif;\r
117 font-weight: bold;\r
118 text-align: left;\r
119 margin-top: 1.0em;\r
120 margin-bottom: 0.5em;\r
121}\r
122div.title + * {\r
123 margin-top: 0;\r
124}\r
125\r
126td div.title:first-child {\r
127 margin-top: 0.0em;\r
128}\r
129div.content div.title:first-child {\r
130 margin-top: 0.0em;\r
131}\r
132div.content + div.title {\r
133 margin-top: 0.0em;\r
134}\r
135\r
136div.sidebarblock > div.content {\r
137 background: #ffffee;\r
138 border: 1px solid silver;\r
139 padding: 0.5em;\r
140}\r
141\r
142div.listingblock > div.content {\r
143 border: 1px solid silver;\r
144 background: #f4f4f4;\r
145 padding: 0.5em;\r
146}\r
147\r
148div.quoteblock > div.content {\r
149 padding-left: 2.0em;\r
150}\r
151div.quoteblock .attribution {\r
152 text-align: right;\r
153}\r
154\r
155div.admonitionblock .icon {\r
156 vertical-align: top;\r
157 font-size: 1.1em;\r
158 font-weight: bold;\r
159 text-decoration: underline;\r
160 color: #527bbd;\r
161 padding-right: 0.5em;\r
162}\r
163div.admonitionblock td.content {\r
164 padding-left: 0.5em;\r
165 border-left: 2px solid silver;\r
166}\r
167\r
168div.exampleblock > div.content {\r
169 border-left: 2px solid silver;\r
170 padding: 0.5em;\r
171}\r
172\r
173div.verseblock div.content {\r
174 white-space: pre;\r
175}\r
176\r
177div.imageblock div.content { padding-left: 0; }\r
178div.imageblock img { border: 1px solid silver; }\r
179span.image img { border-style: none; }\r
180\r
181dl {\r
182 margin-top: 0.8em;\r
183 margin-bottom: 0.8em;\r
184}\r
185dt {\r
186 margin-top: 0.5em;\r
187 margin-bottom: 0;\r
188 font-style: italic;\r
189}\r
190dd > *:first-child {\r
191 margin-top: 0;\r
192}\r
193\r
194ul, ol {\r
195 list-style-position: outside;\r
196}\r
197ol.olist2 {\r
198 list-style-type: lower-alpha;\r
199}\r
200\r
201div.tableblock > table {\r
202 border-color: #527bbd;\r
203 border-width: 3px;\r
204}\r
205thead {\r
206 font-family: sans-serif;\r
207 font-weight: bold;\r
208}\r
209tfoot {\r
210 font-weight: bold;\r
211}\r
212\r
213div.hlist {\r
214 margin-top: 0.8em;\r
215 margin-bottom: 0.8em;\r
216}\r
217td.hlist1 {\r
218 vertical-align: top;\r
219 font-style: italic;\r
220 padding-right: 0.8em;\r
221}\r
222td.hlist2 {\r
223 vertical-align: top;\r
224}\r
225\r
226@media print {\r
227 div#footer-badges { display: none; }\r
228}\r
229include::./stylesheets/xhtml11-manpage.css[]\r
230/* Workarounds for IE6's broken and incomplete CSS2. */\r
231\r
232div.sidebar-content {\r
233 background: #ffffee;\r
234 border: 1px solid silver;\r
235 padding: 0.5em;\r
236}\r
237div.sidebar-title, div.image-title {\r
238 font-family: sans-serif;\r
239 font-weight: bold;\r
240 margin-top: 0.0em;\r
241 margin-bottom: 0.5em;\r
242}\r
243\r
244div.listingblock div.content {\r
245 border: 1px solid silver;\r
246 background: #f4f4f4;\r
247 padding: 0.5em;\r
248}\r
249\r
250div.quoteblock-content {\r
251 padding-left: 2.0em;\r
252}\r
253\r
254div.exampleblock-content {\r
255 border-left: 2px solid silver;\r
256 padding-left: 0.5em;\r
257}\r
258</style>\r
259<title>tigrc(5)</title>\r
260</head>\r
261<body>\r
262<div id="header">\r
263<h1>\r
264tigrc(5) Manual Page\r
265</h1>\r
266<h2>NAME</h2>\r
267<div class="sectionbody">\r
268<p>tigrc -\r
269 tig user configuration file\r
270</p>\r
271</div>\r
272</div>\r
273<h2>SYNOPSIS</h2>\r
274<div class="sectionbody">\r
275<div class="verseblock">\r
b484cbc8
JF
276<div class="content"><strong>set</strong> variable <strong>=</strong> value\r
277<strong>bind</strong> keymap key action\r
278<strong>color</strong> area fgcolor bgcolor [attributes]</div></div>\r
3ad8214b
JF
279</div>\r
280<h2>DESCRIPTION</h2>\r
281<div class="sectionbody">\r
b484cbc8
JF
282<p>You can permanently set an option by putting it in the <tt>~/.tigrc</tt> file. The\r
283file consists of a series of <em>commands</em>. Each line of the file may contain\r
284only one command.</p>\r
285<p>The hash mark (<em>#</em>) is used as a <em>comment</em> character. All text after the\r
286comment character to the end of the line is ignored. You can use comments to\r
287annotate your initialization file.</p>\r
3ad8214b 288</div>\r
b484cbc8 289<h2>Set command</h2>\r
3ad8214b 290<div class="sectionbody">\r
b484cbc8
JF
291<p>A few selective variables can be configured via the set command. The syntax\r
292is:</p>\r
293<div class="verseblock">\r
294<div class="content"> <strong>set</strong> variables <strong>=</strong> value</div></div>\r
295<p>Examples:</p>\r
296<div class="listingblock">\r
297<div class="content">\r
298<pre><tt> set show-rev-graph = yes # Show revision graph?\r
299 set line-number-interval = 5 # Interval between line numbers\r
300 set tab-size = 8 # Number of spaces pr tab\r
301 set encoding = "UTF-8" # Commit encoding</tt></pre>\r
302</div></div>\r
303<p>The type of variables are either bool, int, and string.</p>\r
304<dl>\r
305<dt>\r
306Valid bool values\r
307</dt>\r
308<dd>\r
309<p>\r
310 To set a bool variable to true use either "1", "true", or "yes".\r
311 Any other value will set the variable to false.\r
312</p>\r
313</dd>\r
314<dt>\r
315Valid int values\r
316</dt>\r
317<dd>\r
318<p>\r
319 A non-negative integer.\r
320</p>\r
321</dd>\r
322<dt>\r
323Valid string values\r
324</dt>\r
325<dd>\r
326<p>\r
327 A string of characters. Optionally, use either ' or " as delimiters.\r
328</p>\r
329</dd>\r
330</dl>\r
331<h3>Variables</h3>\r
332<p>The following variables can be set:</p>\r
333<dl>\r
334<dt>\r
335<em>show-rev-graph</em> (bool)\r
336</dt>\r
337<dd>\r
338<p>\r
af4c75a2 339 Show revision graph in the main view on start-up. Can be toggled with\r
b484cbc8
JF
340 <em>g</em>.\r
341</p>\r
342</dd>\r
343<dt>\r
344<em>line-number-interval</em> (int)\r
345</dt>\r
346<dd>\r
347<p>\r
348 Interval between line numbers. Note, you have to toggle on line\r
349 numbering with <em>n</em> or the <tt>-n</tt> command line option. The default is to\r
350 number every line.\r
351</p>\r
352</dd>\r
353<dt>\r
354<em>tab-size</em> (int)\r
355</dt>\r
356<dd>\r
357<p>\r
358 Number of spaces per tab. The default is 8 spaces.\r
359</p>\r
360</dd>\r
361<dt>\r
362<em>commit-encoding</em> (string)\r
363</dt>\r
364<dd>\r
365<p>\r
366 The encoding used for commits. The default is UTF-8. Not this option\r
367 is shadowed by the "i18n.commitencoding" option in <tt>.git/config</tt>.\r
368</p>\r
369</dd>\r
370</dl>\r
371</div>\r
372<h2>Bind command</h2>\r
373<div class="sectionbody">\r
374<p>Using bind commands keys can be mapped to an action when pressed in a given\r
375key map. The syntax is:</p>\r
376<div class="verseblock">\r
377<div class="content"> <strong>bind</strong> <em>keymap</em> <em>key</em> <em>action</em></div></div>\r
378<p>Examples:</p>\r
379<div class="listingblock">\r
380<div class="content">\r
381<pre><tt> # A few keybindings\r
382 bind main w scroll-line-up\r
383 bind main s scroll-line-down\r
384 bind main space enter\r
385 bind diff a previous\r
386 bind diff d next\r
af4c75a2
JF
387 bind diff b move-first-line\r
388 # 'unbind' the default quit key binding\r
389 bind main Q none</tt></pre>\r
b484cbc8
JF
390</div></div>\r
391<p>Keys are mapped by first searching the keybindings for the current view, then\r
392the keybindings for the <strong>generic</strong> keymap, and last the default keybindings.\r
af4c75a2 393Thus, the view keybindings shadow the generic keybindings which Shadow the\r
b484cbc8
JF
394built-in keybindings.</p>\r
395<dl>\r
396<dt>\r
397Keymaps\r
398</dt>\r
399<dd>\r
400<p>\r
401Valid keymaps are: <strong>main</strong>, <strong>diff</strong>, <strong>log</strong>, <strong>help</strong>, <strong>pager</strong>, and <strong>generic</strong>. Use\r
402<strong>generic</strong> to set key mapping in all keymaps.\r
403</p>\r
404</dd>\r
405<dt>\r
406Key values\r
407</dt>\r
408<dd>\r
409<p>\r
410Key values should never be quoted. Use either the ASCII value or one of the\r
411following symbolic key names. Symbolic key names are case insensitive, Use\r
412<strong>Hash</strong> to bind to the <tt>#</tt> key, since the hash mark is used as a comment\r
413character.\r
414</p>\r
415<p><strong>Enter</strong>, <strong>Space</strong>, <strong>Backspace</strong>, <strong>Tab</strong>, <strong>Escape</strong>, <strong>Left</strong>, <strong>Right</strong>, <strong>Up</strong>, <strong>Down</strong>,\r
416<strong>Insert</strong>, <strong>Delete</strong>, <strong>Hash</strong>, <strong>Home</strong>, <strong>End</strong>, <strong>PageUp</strong>, <strong>PageDown</strong>, <strong>F1</strong>, <strong>F2</strong>, <strong>F3</strong>,\r
417<strong>F4</strong>, <strong>F5</strong>, <strong>F6</strong>, <strong>F7</strong>, <strong>F8</strong>, <strong>F9</strong>, <strong>F10</strong>, <strong>F11</strong>, <strong>F12</strong>.</p>\r
418</dd>\r
419<dt>\r
420Action names\r
421</dt>\r
422<dd>\r
423<p>\r
424Valid action names are described below. Note, all names are\r
425case-insensitive, and you may use <em>-</em>, <em>_</em>, and <em>.</em> interchangeably,\r
426e.g. "view-main", "View.Main", and "VIEW_MAIN" are the same.\r
427</p>\r
428</dd>\r
429</dl>\r
430<h3>Actions</h3>\r
431<div class="tableblock">\r
432<table rules="none"\r
433frame="void"\r
434cellspacing="0" cellpadding="4">\r
435<col width="274" />\r
436<col width="617" />\r
437<thead>\r
438 <tr>\r
439 <th align="left">\r
2c14847e 440 View switching:\r
b484cbc8
JF
441 </th>\r
442 <th align="left">\r
443 \r
444 </th>\r
445 </tr>\r
446</thead>\r
447<tbody valign="top">\r
448 <tr>\r
449 <td align="left">\r
450 view-main\r
451 </td>\r
452 <td align="left">\r
453 Show main view\r
454 </td>\r
455 </tr>\r
456 <tr>\r
457 <td align="left">\r
458 view-diff\r
459 </td>\r
460 <td align="left">\r
461 Show diff view\r
462 </td>\r
463 </tr>\r
464 <tr>\r
465 <td align="left">\r
466 view-log\r
467 </td>\r
468 <td align="left">\r
469 Show log view\r
470 </td>\r
471 </tr>\r
472 <tr>\r
473 <td align="left">\r
af4c75a2 474 view-tree\r
b484cbc8
JF
475 </td>\r
476 <td align="left">\r
af4c75a2
JF
477 Show tree view\r
478 </td>\r
479 </tr>\r
480 <tr>\r
481 <td align="left">\r
482 view-blob\r
483 </td>\r
484 <td align="left">\r
485 Show blob view\r
b484cbc8
JF
486 </td>\r
487 </tr>\r
488 <tr>\r
489 <td align="left">\r
490 view-pager\r
491 </td>\r
492 <td align="left">\r
493 Show pager view\r
494 </td>\r
495 </tr>\r
af4c75a2
JF
496 <tr>\r
497 <td align="left">\r
498 view-help\r
499 </td>\r
500 <td align="left">\r
501 Show help page\r
502 </td>\r
503 </tr>\r
b484cbc8
JF
504</tbody>\r
505</table>\r
506</div>\r
507<div class="tableblock">\r
508<table rules="none"\r
509frame="void"\r
510cellspacing="0" cellpadding="4">\r
511<col width="274" />\r
512<col width="617" />\r
513<thead>\r
514 <tr>\r
515 <th align="left">\r
2c14847e 516 View manipulation:\r
b484cbc8
JF
517 </th>\r
518 <th align="left">\r
519 \r
520 </th>\r
521 </tr>\r
522</thead>\r
523<tbody valign="top">\r
524 <tr>\r
525 <td align="left">\r
526 enter\r
527 </td>\r
528 <td align="left">\r
529 Enter current line and scroll\r
530 </td>\r
531 </tr>\r
532 <tr>\r
533 <td align="left">\r
534 next\r
535 </td>\r
536 <td align="left">\r
537 Move to next\r
538 </td>\r
539 </tr>\r
540 <tr>\r
541 <td align="left">\r
542 previous\r
543 </td>\r
544 <td align="left">\r
545 Move to previous\r
546 </td>\r
547 </tr>\r
548 <tr>\r
549 <td align="left">\r
550 view-next\r
551 </td>\r
552 <td align="left">\r
553 Move focus to next view\r
554 </td>\r
555 </tr>\r
556 <tr>\r
557 <td align="left">\r
558 view-close\r
559 </td>\r
560 <td align="left">\r
561 Close the current view\r
562 </td>\r
563 </tr>\r
564 <tr>\r
565 <td align="left">\r
566 quit\r
567 </td>\r
568 <td align="left">\r
569 Close all views and quit\r
570 </td>\r
571 </tr>\r
572</tbody>\r
573</table>\r
574</div>\r
575<div class="tableblock">\r
576<table rules="none"\r
577frame="void"\r
578cellspacing="0" cellpadding="4">\r
579<col width="274" />\r
580<col width="617" />\r
581<thead>\r
582 <tr>\r
583 <th align="left">\r
2c14847e 584 Cursor navigation:\r
b484cbc8
JF
585 </th>\r
586 <th align="left">\r
587 \r
588 </th>\r
589 </tr>\r
590</thead>\r
591<tbody valign="top">\r
592 <tr>\r
593 <td align="left">\r
594 move-up\r
595 </td>\r
596 <td align="left">\r
597 Move cursor one line up\r
598 </td>\r
599 </tr>\r
600 <tr>\r
601 <td align="left">\r
602 move-down\r
603 </td>\r
604 <td align="left">\r
605 Move cursor one line down\r
606 </td>\r
607 </tr>\r
608 <tr>\r
609 <td align="left">\r
af4c75a2 610 move-page-down\r
b484cbc8
JF
611 </td>\r
612 <td align="left">\r
613 Move cursor one page down\r
614 </td>\r
615 </tr>\r
616 <tr>\r
617 <td align="left">\r
af4c75a2 618 move-page-up\r
b484cbc8
JF
619 </td>\r
620 <td align="left">\r
621 Move cursor one page up\r
622 </td>\r
623 </tr>\r
624 <tr>\r
625 <td align="left">\r
af4c75a2 626 move-first-line\r
b484cbc8
JF
627 </td>\r
628 <td align="left">\r
629 Move cursor to first line\r
630 </td>\r
631 </tr>\r
632 <tr>\r
633 <td align="left">\r
af4c75a2 634 move-last-line\r
b484cbc8
JF
635 </td>\r
636 <td align="left">\r
637 Move cursor to last line\r
638 </td>\r
639 </tr>\r
640</tbody>\r
641</table>\r
642</div>\r
643<div class="tableblock">\r
644<table rules="none"\r
645frame="void"\r
646cellspacing="0" cellpadding="4">\r
647<col width="274" />\r
648<col width="617" />\r
649<thead>\r
650 <tr>\r
651 <th align="left">\r
2c14847e 652 Scrolling:\r
b484cbc8
JF
653 </th>\r
654 <th align="left">\r
655 \r
656 </th>\r
657 </tr>\r
658</thead>\r
659<tbody valign="top">\r
660 <tr>\r
661 <td align="left">\r
af4c75a2 662 scroll-line-up\r
b484cbc8
JF
663 </td>\r
664 <td align="left">\r
665 Scroll one line up\r
666 </td>\r
667 </tr>\r
668 <tr>\r
669 <td align="left">\r
af4c75a2 670 scroll-line-down\r
b484cbc8
JF
671 </td>\r
672 <td align="left">\r
673 Scroll one line down\r
674 </td>\r
675 </tr>\r
676 <tr>\r
677 <td align="left">\r
af4c75a2 678 scroll-page-eup\r
b484cbc8
JF
679 </td>\r
680 <td align="left">\r
681 Scroll one page up\r
682 </td>\r
683 </tr>\r
684 <tr>\r
685 <td align="left">\r
af4c75a2 686 scroll-page-down\r
b484cbc8
JF
687 </td>\r
688 <td align="left">\r
689 Scroll one page down\r
690 </td>\r
691 </tr>\r
692</tbody>\r
693</table>\r
694</div>\r
695<div class="tableblock">\r
696<table rules="none"\r
697frame="void"\r
698cellspacing="0" cellpadding="4">\r
699<col width="274" />\r
700<col width="617" />\r
701<thead>\r
702 <tr>\r
703 <th align="left">\r
2c14847e 704 Misc:\r
b484cbc8
JF
705 </th>\r
706 <th align="left">\r
707 \r
708 </th>\r
709 </tr>\r
710</thead>\r
711<tbody valign="top">\r
712 <tr>\r
713 <td align="left">\r
af4c75a2 714 none\r
b484cbc8
JF
715 </td>\r
716 <td align="left">\r
af4c75a2 717 Do nothing\r
b484cbc8
JF
718 </td>\r
719 </tr>\r
720 <tr>\r
721 <td align="left">\r
af4c75a2 722 prompt\r
b484cbc8
JF
723 </td>\r
724 <td align="left">\r
af4c75a2 725 Bring up the prompt\r
b484cbc8
JF
726 </td>\r
727 </tr>\r
728 <tr>\r
729 <td align="left">\r
730 screen-redraw\r
731 </td>\r
732 <td align="left">\r
733 Redraw the screen\r
734 </td>\r
735 </tr>\r
736 <tr>\r
737 <td align="left">\r
738 screen-resize\r
739 </td>\r
740 <td align="left">\r
741 Resize the screen\r
742 </td>\r
743 </tr>\r
744 <tr>\r
745 <td align="left">\r
746 show-version\r
747 </td>\r
748 <td align="left">\r
749 Show version information\r
750 </td>\r
751 </tr>\r
752 <tr>\r
753 <td align="left">\r
754 stop-loading\r
755 </td>\r
756 <td align="left">\r
757 Stop all loading views\r
758 </td>\r
759 </tr>\r
760 <tr>\r
761 <td align="left">\r
762 toggle-lineno\r
763 </td>\r
764 <td align="left">\r
765 Toggle line numbers\r
766 </td>\r
767 </tr>\r
768 <tr>\r
769 <td align="left">\r
af4c75a2 770 toggle-rev-graph\r
b484cbc8
JF
771 </td>\r
772 <td align="left">\r
773 Toggle revision graph visualization\r
774 </td>\r
775 </tr>\r
776</tbody>\r
777</table>\r
778</div>\r
779</div>\r
780<h2>Color command</h2>\r
781<div class="sectionbody">\r
782<p>Color commands control highlighting and the user interface styles. If your\r
783terminal supports color, these commands can be used to assign foreground and\r
af4c75a2 784background combinations to certain areas. Optionally, an attribute can be given\r
b484cbc8 785as the last parameter. The syntax is:</p>\r
3ad8214b
JF
786<div class="verseblock">\r
787<div class="content"> <strong>color</strong> <em>area</em> <em>fgcolor</em> <em>bgcolor</em> <em>[attributes]</em></div></div>\r
b484cbc8
JF
788<p>Examples:</p>\r
789<div class="listingblock">\r
790<div class="content">\r
791<pre><tt> # Diff colors\r
792 color diff-header yellow default\r
793 color diff-index blue default\r
794 color diff-chunk magenta default\r
795 # A strange looking cursor line\r
796 color cursor red default underline\r
797 # UI colors\r
798 color title-blur white blue\r
799 color title-focus white blue bold</tt></pre>\r
800</div></div>\r
801<dl>\r
802<dt>\r
803Area names\r
804</dt>\r
805<dd>\r
806<p>\r
807 Valid area names are described below. Note, all names are\r
808 case-insensitive, and you may use <em>-</em>, <em>_</em>, and <em>.</em> interchangeably,\r
809 e.g. "Diff-Header", "DIFF_HEADER", and "diff.header" are the same.\r
810</p>\r
811</dd>\r
812<dt>\r
813Color names\r
814</dt>\r
815<dd>\r
816<p>\r
817 Valid colors include: <strong>white</strong>, <strong>black</strong>, <strong>green</strong>, <strong>magenta</strong>, <strong>blue</strong>,\r
818 <strong>cyan</strong>, <strong>yellow</strong>, <strong>red</strong>, <strong>default</strong>. Use <strong>default</strong> to refer to the\r
819 default terminal colors.\r
820</p>\r
821</dd>\r
822<dt>\r
823Attribute names\r
824</dt>\r
825<dd>\r
826<p>\r
827 Valid attributes include: <strong>normal</strong>, <strong>blink</strong>, <strong>bold</strong>, <strong>dim</strong>, <strong>reverse</strong>,\r
828 <strong>standout</strong>, and <strong>underline</strong>. Note, not all attributes may be supported\r
829 by the terminal.\r
830</p>\r
831</dd>\r
832</dl>\r
833<h3>UI colors</h3>\r
834<dl>\r
835<dt>\r
836Status window colors\r
837</dt>\r
838<dd>\r
839<p>\r
840Appearance of the bottom window showing info messages.\r
841</p>\r
842<p><strong>status</strong></p>\r
843</dd>\r
844<dt>\r
845Title window colors\r
846</dt>\r
847<dd>\r
848<p>\r
af4c75a2 849Appearance of the title windows when they are attached\r
b484cbc8
JF
850to any backgrounded windows and the current window.\r
851</p>\r
852<p><strong>title-blur</strong>, <strong>title-focus</strong></p>\r
853</dd>\r
854<dt>\r
855Cursor line colors\r
856</dt>\r
857<dd>\r
858<p>\r
859<strong>cursor</strong>\r
860</p>\r
861</dd>\r
862<dt>\r
863Main view specific\r
864</dt>\r
865<dd>\r
866<p>\r
867Appearance of the various columns in the main view, including the <em>~</em> used for\r
868delimiting long author names and labels for tag and branch references.\r
869</p>\r
870<p><strong>main-date</strong>, <strong>main-author</strong>, <strong>main-commit</strong>, <strong>main-delim</strong>, <strong>main-tag</strong>,\r
871<strong>main-ref</strong></p>\r
872</dd>\r
873</dl>\r
874<h3>Highlighting</h3>\r
875<p>The colors and attributes for text that is not highlighted can be controlled\r
876by changing the <strong>default</strong> color option.</p>\r
877<dl>\r
878<dt>\r
879Diff markup\r
880</dt>\r
881<dd>\r
882<p>\r
883Options concerning diff start, chunks and lines added and deleted.\r
884</p>\r
3ad8214b 885<p><strong>diff-header</strong>, <strong>diff-chunk</strong>, <strong>diff-add</strong>, <strong>diff-del</strong></p>\r
b484cbc8
JF
886</dd>\r
887<dt>\r
888Enhanced git diff markup\r
889</dt>\r
890<dd>\r
891<p>\r
892Extra diff information emitted by the git diff machinery, such as mode\r
893changes, rename detection, and similarity.\r
894</p>\r
3ad8214b
JF
895<p><strong>diff-oldmode</strong>, <strong>diff-newmode</strong>, <strong>diff-copy-from</strong>, <strong>diff-copy-to</strong>,\r
896<strong>diff-rename-from</strong>, <strong>diff-rename-to</strong>, <strong>diff-similarity</strong> <strong>diff-dissimilarity</strong>\r
897<strong>diff-tree</strong>, <strong>diff-index</strong></p>\r
b484cbc8
JF
898</dd>\r
899<dt>\r
900Pretty print commit headers\r
901</dt>\r
902<dd>\r
903<p>\r
904Commit diffs and the revision logs are usually formatted using pretty printed\r
905headers , unless <tt>--pretty=raw</tt> was given. This includes lines, such as merge\r
af4c75a2 906info, commit ID, and author and committer date.\r
b484cbc8 907</p>\r
3ad8214b 908<p><strong>pp-author</strong>, <strong>pp-commit</strong>, <strong>pp-merge</strong>, <strong>pp-date</strong>, <strong>pp-adate</strong>, <strong>pp-cdate</strong></p>\r
b484cbc8
JF
909</dd>\r
910<dt>\r
911Raw commit header\r
912</dt>\r
913<dd>\r
914<p>\r
915Usually shown when <tt>--pretty=raw</tt> is given, however <em>commit</em> is pretty much\r
916omnipresent.\r
917</p>\r
3ad8214b 918<p><strong>commit</strong>, <strong>parent</strong>, <strong>tree</strong>, <strong>author</strong>, <strong>committer</strong></p>\r
b484cbc8
JF
919</dd>\r
920<dt>\r
921Commit message\r
922</dt>\r
923<dd>\r
924<p>\r
af4c75a2 925For now only <tt>Signed-off-by</tt> and <tt>Acked-by</tt> lines are colorized.\r
b484cbc8 926</p>\r
af4c75a2 927<p><strong>signoff</strong>, <strong>acked</strong></p>\r
b484cbc8
JF
928</dd>\r
929</dl>\r
3ad8214b 930</div>\r
b484cbc8 931<h2>COPYRIGHT</h2>\r
3ad8214b 932<div class="sectionbody">\r
b484cbc8
JF
933<p>Copyright (c) 2006 Jonas Fonseca &lt;fonseca@diku.dk&gt;</p>\r
934<p>Licensed under the terms of the GNU General Public License.</p>\r
3ad8214b
JF
935</div>\r
936<h2>SEE ALSO</h2>\r
937<div class="sectionbody">\r
5c09dc14 938<p><a href="tig.1.html">tig(1)</a> and the <a href="http://jonas.nitro.dk/tig/manual.html">tig manual</a>.</p>\r
3ad8214b
JF
939</div>\r
940<div id="footer">\r
941<div id="footer-text">\r
af4c75a2 942Last updated 18-Sep-2006 18:23:53 CEST\r
3ad8214b
JF
943</div>\r
944</div>\r
945</body>\r
946</html>\r