chiark - git - mdw - tig/blob - tigrc.5.html

   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
   9 p, 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
  15 body {\r
  16   margin: 1em 5% 1em 5%;\r
  17 }\r
  18 \r
  19 a { color: blue; }\r
  20 a:visited { color: fuchsia; }\r
  21 \r
  22 em {\r
  23   font-style: italic;\r
  24 }\r
  25 \r
  26 strong {\r
  27   font-weight: bold;\r
  28 }\r
  29 \r
  30 tt {\r
  31   color: navy;\r
  32 }\r
  33 \r
  34 h1, 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
  42 h1 {\r
  43   border-bottom: 2px solid silver;\r
  44 }\r
  45 h2 {\r
  46   border-bottom: 2px solid silver;\r
  47   padding-top: 0.5em;\r
  48 }\r
  49 \r
  50 div.sectionbody {\r
  51   font-family: serif;\r
  52   margin-left: 0;\r
  53 }\r
  54 \r
  55 hr {\r
  56   border: 1px solid silver;\r
  57 }\r
  58 \r
  59 p {\r
  60   margin-top: 0.5em;\r
  61   margin-bottom: 0.5em;\r
  62 }\r
  63 \r
  64 pre {\r
  65   padding: 0;\r
  66   margin: 0;\r
  67 }\r
  68 \r
  69 span#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
  75 span#email {\r
  76 }\r
  77 span#revision {\r
  78   font-family: sans-serif;\r
  79 }\r
  80 \r
  81 div#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
  88 div#footer-text {\r
  89   float: left;\r
  90   padding-bottom: 0.5em;\r
  91 }\r
  92 div#footer-badges {\r
  93   float: right;\r
  94   padding-bottom: 0.5em;\r
  95 }\r
  96 \r
  97 div#preamble,\r
  98 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
  99 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
 100 div.admonitionblock {\r
 101   margin-right: 10%;\r
 102   margin-top: 1.5em;\r
 103   margin-bottom: 1.5em;\r
 104 }\r
 105 div.admonitionblock {\r
 106   margin-top: 2.5em;\r
 107   margin-bottom: 2.5em;\r
 108 }\r
 109 \r
 110 div.content { /* Block element content. */\r
 111   padding: 0;\r
 112 }\r
 113 \r
 114 /* Block element titles. */\r
 115 div.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
 122 div.title + * {\r
 123   margin-top: 0;\r
 124 }\r
 125 \r
 126 td div.title:first-child {\r
 127   margin-top: 0.0em;\r
 128 }\r
 129 div.content div.title:first-child {\r
 130   margin-top: 0.0em;\r
 131 }\r
 132 div.content + div.title {\r
 133   margin-top: 0.0em;\r
 134 }\r
 135 \r
 136 div.sidebarblock > div.content {\r
 137   background: #ffffee;\r
 138   border: 1px solid silver;\r
 139   padding: 0.5em;\r
 140 }\r
 141 \r
 142 div.listingblock > div.content {\r
 143   border: 1px solid silver;\r
 144   background: #f4f4f4;\r
 145   padding: 0.5em;\r
 146 }\r
 147 \r
 148 div.quoteblock > div.content {\r
 149   padding-left: 2.0em;\r
 150 }\r
 151 div.quoteblock .attribution {\r
 152   text-align: right;\r
 153 }\r
 154 \r
 155 div.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
 163 div.admonitionblock td.content {\r
 164   padding-left: 0.5em;\r
 165   border-left: 2px solid silver;\r
 166 }\r
 167 \r
 168 div.exampleblock > div.content {\r
 169   border-left: 2px solid silver;\r
 170   padding: 0.5em;\r
 171 }\r
 172 \r
 173 div.verseblock div.content {\r
 174   white-space: pre;\r
 175 }\r
 176 \r
 177 div.imageblock div.content { padding-left: 0; }\r
 178 div.imageblock img { border: 1px solid silver; }\r
 179 span.image img { border-style: none; }\r
 180 \r
 181 dl {\r
 182   margin-top: 0.8em;\r
 183   margin-bottom: 0.8em;\r
 184 }\r
 185 dt {\r
 186   margin-top: 0.5em;\r
 187   margin-bottom: 0;\r
 188   font-style: italic;\r
 189 }\r
 190 dd > *:first-child {\r
 191   margin-top: 0;\r
 192 }\r
 193 \r
 194 ul, ol {\r
 195     list-style-position: outside;\r
 196 }\r
 197 ol.olist2 {\r
 198   list-style-type: lower-alpha;\r
 199 }\r
 200 \r
 201 div.tableblock > table {\r
 202   border-color: #527bbd;\r
 203   border-width: 3px;\r
 204 }\r
 205 thead {\r
 206   font-family: sans-serif;\r
 207   font-weight: bold;\r
 208 }\r
 209 tfoot {\r
 210   font-weight: bold;\r
 211 }\r
 212 \r
 213 div.hlist {\r
 214   margin-top: 0.8em;\r
 215   margin-bottom: 0.8em;\r
 216 }\r
 217 td.hlist1 {\r
 218   vertical-align: top;\r
 219   font-style: italic;\r
 220   padding-right: 0.8em;\r
 221 }\r
 222 td.hlist2 {\r
 223   vertical-align: top;\r
 224 }\r
 225 \r
 226 @media print {\r
 227   div#footer-badges { display: none; }\r
 228 }\r
 229 include::./stylesheets/xhtml11-manpage.css[]\r
 230 /* Workarounds for IE6's broken and incomplete CSS2. */\r
 231 \r
 232 div.sidebar-content {\r
 233   background: #ffffee;\r
 234   border: 1px solid silver;\r
 235   padding: 0.5em;\r
 236 }\r
 237 div.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
 244 div.listingblock div.content {\r
 245   border: 1px solid silver;\r
 246   background: #f4f4f4;\r
 247   padding: 0.5em;\r
 248 }\r
 249 \r
 250 div.quoteblock-content {\r
 251   padding-left: 2.0em;\r
 252 }\r
 253 \r
 254 div.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
 264 tigrc(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
 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
 279 </div>\r
 280 <h2>DESCRIPTION</h2>\r
 281 <div class="sectionbody">\r
 282 <p>You can permanently set an option by putting it in the <tt>~/.tigrc</tt> file.  The\r
 283 file consists of a series of <em>commands</em>.  Each line of the file may contain\r
 284 only one command.</p>\r
 285 <p>The hash mark (<em>#</em>) is used as a <em>comment</em> character. All text after the\r
 286 comment character to the end of the line is ignored. You can use comments to\r
 287 annotate your initialization file.</p>\r
 288 </div>\r
 289 <h2>Set command</h2>\r
 290 <div class="sectionbody">\r
 291 <p>A few selective variables can be configured via the set command. The syntax\r
 292 is:</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
 306 Valid 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
 315 Valid 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
 323 Valid 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
 339         Show revision graph in the main view on startup. Can be toggled with\r
 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
 375 key 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
 387         bind diff b move-first-line</tt></pre>\r
 388 </div></div>\r
 389 <p>Keys are mapped by first searching the keybindings for the current view, then\r
 390 the keybindings for the <strong>generic</strong> keymap, and last the default keybindings.\r
 391 Thus, the view keybindings shaddow the generic keybindings which shaddow the\r
 392 built-in keybindings.</p>\r
 393 <dl>\r
 394 <dt>\r
 395 Keymaps\r
 396 </dt>\r
 397 <dd>\r
 398 <p>\r
 399 Valid keymaps are: <strong>main</strong>, <strong>diff</strong>, <strong>log</strong>, <strong>help</strong>, <strong>pager</strong>, and <strong>generic</strong>.  Use\r
 400 <strong>generic</strong> to set key mapping in all keymaps.\r
 401 </p>\r
 402 </dd>\r
 403 <dt>\r
 404 Key values\r
 405 </dt>\r
 406 <dd>\r
 407 <p>\r
 408 Key values should never be quoted. Use either the ASCII value or one of the\r
 409 following symbolic key names. Symbolic key names are case insensitive, Use\r
 410 <strong>Hash</strong> to bind to the <tt>#</tt> key, since the hash mark is used as a comment\r
 411 character.\r
 412 </p>\r
 413 <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
 414 <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
 415 <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
 416 </dd>\r
 417 <dt>\r
 418 Action names\r
 419 </dt>\r
 420 <dd>\r
 421 <p>\r
 422 Valid action names are described below. Note, all names are\r
 423 case-insensitive, and you may use <em>-</em>, <em>_</em>, and <em>.</em> interchangeably,\r
 424 e.g. "view-main", "View.Main", and "VIEW_MAIN" are the same.\r
 425 </p>\r
 426 </dd>\r
 427 </dl>\r
 428 <h3>Actions</h3>\r
 429 <div class="tableblock">\r
 430 <table rules="none"\r
 431 frame="void"\r
 432 cellspacing="0" cellpadding="4">\r
 433 <col width="274" />\r
 434 <col width="617" />\r
 435 <thead>\r
 436   <tr>\r
 437     <th align="left">\r
 438     View switching:\r
 439     </th>\r
 440     <th align="left">\r
 441     \r
 442     </th>\r
 443   </tr>\r
 444 </thead>\r
 445 <tbody valign="top">\r
 446   <tr>\r
 447     <td align="left">\r
 448     view-main\r
 449     </td>\r
 450     <td align="left">\r
 451     Show main view\r
 452     </td>\r
 453   </tr>\r
 454   <tr>\r
 455     <td align="left">\r
 456     view-diff\r
 457     </td>\r
 458     <td align="left">\r
 459     Show diff view\r
 460     </td>\r
 461   </tr>\r
 462   <tr>\r
 463     <td align="left">\r
 464     view-log\r
 465     </td>\r
 466     <td align="left">\r
 467     Show log view\r
 468     </td>\r
 469   </tr>\r
 470   <tr>\r
 471     <td align="left">\r
 472     view-help\r
 473     </td>\r
 474     <td align="left">\r
 475     Show help page\r
 476     </td>\r
 477   </tr>\r
 478   <tr>\r
 479     <td align="left">\r
 480     view-pager\r
 481     </td>\r
 482     <td align="left">\r
 483     Show pager view\r
 484     </td>\r
 485   </tr>\r
 486 </tbody>\r
 487 </table>\r
 488 </div>\r
 489 <div class="tableblock">\r
 490 <table rules="none"\r
 491 frame="void"\r
 492 cellspacing="0" cellpadding="4">\r
 493 <col width="274" />\r
 494 <col width="617" />\r
 495 <thead>\r
 496   <tr>\r
 497     <th align="left">\r
 498     View manipulation:\r
 499     </th>\r
 500     <th align="left">\r
 501     \r
 502     </th>\r
 503   </tr>\r
 504 </thead>\r
 505 <tbody valign="top">\r
 506   <tr>\r
 507     <td align="left">\r
 508     enter\r
 509     </td>\r
 510     <td align="left">\r
 511     Enter current line and scroll\r
 512     </td>\r
 513   </tr>\r
 514   <tr>\r
 515     <td align="left">\r
 516     next\r
 517     </td>\r
 518     <td align="left">\r
 519     Move to next\r
 520     </td>\r
 521   </tr>\r
 522   <tr>\r
 523     <td align="left">\r
 524     previous\r
 525     </td>\r
 526     <td align="left">\r
 527     Move to previous\r
 528     </td>\r
 529   </tr>\r
 530   <tr>\r
 531     <td align="left">\r
 532     view-next\r
 533     </td>\r
 534     <td align="left">\r
 535     Move focus to next view\r
 536     </td>\r
 537   </tr>\r
 538   <tr>\r
 539     <td align="left">\r
 540     view-close\r
 541     </td>\r
 542     <td align="left">\r
 543     Close the current view\r
 544     </td>\r
 545   </tr>\r
 546   <tr>\r
 547     <td align="left">\r
 548     quit\r
 549     </td>\r
 550     <td align="left">\r
 551     Close all views and quit\r
 552     </td>\r
 553   </tr>\r
 554 </tbody>\r
 555 </table>\r
 556 </div>\r
 557 <div class="tableblock">\r
 558 <table rules="none"\r
 559 frame="void"\r
 560 cellspacing="0" cellpadding="4">\r
 561 <col width="274" />\r
 562 <col width="617" />\r
 563 <thead>\r
 564   <tr>\r
 565     <th align="left">\r
 566     Cursor navigation:\r
 567     </th>\r
 568     <th align="left">\r
 569     \r
 570     </th>\r
 571   </tr>\r
 572 </thead>\r
 573 <tbody valign="top">\r
 574   <tr>\r
 575     <td align="left">\r
 576     move-up\r
 577     </td>\r
 578     <td align="left">\r
 579     Move cursor one line up\r
 580     </td>\r
 581   </tr>\r
 582   <tr>\r
 583     <td align="left">\r
 584     move-down\r
 585     </td>\r
 586     <td align="left">\r
 587     Move cursor one line down\r
 588     </td>\r
 589   </tr>\r
 590   <tr>\r
 591     <td align="left">\r
 592     move-page_down\r
 593     </td>\r
 594     <td align="left">\r
 595     Move cursor one page down\r
 596     </td>\r
 597   </tr>\r
 598   <tr>\r
 599     <td align="left">\r
 600     move-page_up\r
 601     </td>\r
 602     <td align="left">\r
 603     Move cursor one page up\r
 604     </td>\r
 605   </tr>\r
 606   <tr>\r
 607     <td align="left">\r
 608     move-first_line\r
 609     </td>\r
 610     <td align="left">\r
 611     Move cursor to first line\r
 612     </td>\r
 613   </tr>\r
 614   <tr>\r
 615     <td align="left">\r
 616     move-last_line\r
 617     </td>\r
 618     <td align="left">\r
 619     Move cursor to last line\r
 620     </td>\r
 621   </tr>\r
 622 </tbody>\r
 623 </table>\r
 624 </div>\r
 625 <div class="tableblock">\r
 626 <table rules="none"\r
 627 frame="void"\r
 628 cellspacing="0" cellpadding="4">\r
 629 <col width="274" />\r
 630 <col width="617" />\r
 631 <thead>\r
 632   <tr>\r
 633     <th align="left">\r
 634     Scrolling:\r
 635     </th>\r
 636     <th align="left">\r
 637     \r
 638     </th>\r
 639   </tr>\r
 640 </thead>\r
 641 <tbody valign="top">\r
 642   <tr>\r
 643     <td align="left">\r
 644     scroll-line_up\r
 645     </td>\r
 646     <td align="left">\r
 647     Scroll one line up\r
 648     </td>\r
 649   </tr>\r
 650   <tr>\r
 651     <td align="left">\r
 652     scroll-line_down\r
 653     </td>\r
 654     <td align="left">\r
 655     Scroll one line down\r
 656     </td>\r
 657   </tr>\r
 658   <tr>\r
 659     <td align="left">\r
 660     scroll-page_up\r
 661     </td>\r
 662     <td align="left">\r
 663     Scroll one page up\r
 664     </td>\r
 665   </tr>\r
 666   <tr>\r
 667     <td align="left">\r
 668     scroll-page_down\r
 669     </td>\r
 670     <td align="left">\r
 671     Scroll one page down\r
 672     </td>\r
 673   </tr>\r
 674 </tbody>\r
 675 </table>\r
 676 </div>\r
 677 <div class="tableblock">\r
 678 <table rules="none"\r
 679 frame="void"\r
 680 cellspacing="0" cellpadding="4">\r
 681 <col width="274" />\r
 682 <col width="617" />\r
 683 <thead>\r
 684   <tr>\r
 685     <th align="left">\r
 686     Misc:\r
 687     </th>\r
 688     <th align="left">\r
 689     \r
 690     </th>\r
 691   </tr>\r
 692 </thead>\r
 693 <tbody valign="top">\r
 694   <tr>\r
 695     <td align="left">\r
 696     prompt\r
 697     </td>\r
 698     <td align="left">\r
 699     Bring up the prompt\r
 700     </td>\r
 701   </tr>\r
 702   <tr>\r
 703     <td align="left">\r
 704     screen-update\r
 705     </td>\r
 706     <td align="left">\r
 707     Update the screen\r
 708     </td>\r
 709   </tr>\r
 710   <tr>\r
 711     <td align="left">\r
 712     screen-redraw\r
 713     </td>\r
 714     <td align="left">\r
 715     Redraw the screen\r
 716     </td>\r
 717   </tr>\r
 718   <tr>\r
 719     <td align="left">\r
 720     screen-resize\r
 721     </td>\r
 722     <td align="left">\r
 723     Resize the screen\r
 724     </td>\r
 725   </tr>\r
 726   <tr>\r
 727     <td align="left">\r
 728     show-version\r
 729     </td>\r
 730     <td align="left">\r
 731     Show version information\r
 732     </td>\r
 733   </tr>\r
 734   <tr>\r
 735     <td align="left">\r
 736     stop-loading\r
 737     </td>\r
 738     <td align="left">\r
 739     Stop all loading views\r
 740     </td>\r
 741   </tr>\r
 742   <tr>\r
 743     <td align="left">\r
 744     toggle-lineno\r
 745     </td>\r
 746     <td align="left">\r
 747     Toggle line numbers\r
 748     </td>\r
 749   </tr>\r
 750   <tr>\r
 751     <td align="left">\r
 752     toggle-rev_graph\r
 753     </td>\r
 754     <td align="left">\r
 755     Toggle revision graph visualization\r
 756     </td>\r
 757   </tr>\r
 758 </tbody>\r
 759 </table>\r
 760 </div>\r
 761 </div>\r
 762 <h2>Color command</h2>\r
 763 <div class="sectionbody">\r
 764 <p>Color commands control highlighting and the user interface styles. If your\r
 765 terminal supports color, these commands can be used to assign foreground and\r
 766 backgound combinations to certain areas. Optionally, an attribute can be given\r
 767 as the last parameter. The syntax is:</p>\r
 768 <div class="verseblock">\r
 769 <div class="content">        <strong>color</strong> <em>area</em> <em>fgcolor</em> <em>bgcolor</em> <em>[attributes]</em></div></div>\r
 770 <p>Examples:</p>\r
 771 <div class="listingblock">\r
 772 <div class="content">\r
 773 <pre><tt>        # Diff colors\r
 774         color diff-header       yellow  default\r
 775         color diff-index        blue    default\r
 776         color diff-chunk        magenta default\r
 777         # A strange looking cursor line\r
 778         color cursor            red     default underline\r
 779         # UI colors\r
 780         color title-blur        white   blue\r
 781         color title-focus       white   blue    bold</tt></pre>\r
 782 </div></div>\r
 783 <dl>\r
 784 <dt>\r
 785 Area names\r
 786 </dt>\r
 787 <dd>\r
 788 <p>\r
 789         Valid area names are described below. Note, all names are\r
 790         case-insensitive, and you may use <em>-</em>, <em>_</em>, and <em>.</em> interchangeably,\r
 791         e.g. "Diff-Header", "DIFF_HEADER", and "diff.header" are the same.\r
 792 </p>\r
 793 </dd>\r
 794 <dt>\r
 795 Color names\r
 796 </dt>\r
 797 <dd>\r
 798 <p>\r
 799         Valid colors include: <strong>white</strong>, <strong>black</strong>, <strong>green</strong>, <strong>magenta</strong>, <strong>blue</strong>,\r
 800         <strong>cyan</strong>, <strong>yellow</strong>, <strong>red</strong>, <strong>default</strong>. Use <strong>default</strong> to refer to the\r
 801         default terminal colors.\r
 802 </p>\r
 803 </dd>\r
 804 <dt>\r
 805 Attribute names\r
 806 </dt>\r
 807 <dd>\r
 808 <p>\r
 809         Valid attributes include: <strong>normal</strong>, <strong>blink</strong>, <strong>bold</strong>, <strong>dim</strong>, <strong>reverse</strong>,\r
 810         <strong>standout</strong>, and <strong>underline</strong>. Note, not all attributes may be supported\r
 811         by the terminal.\r
 812 </p>\r
 813 </dd>\r
 814 </dl>\r
 815 <h3>UI colors</h3>\r
 816 <dl>\r
 817 <dt>\r
 818 Status window colors\r
 819 </dt>\r
 820 <dd>\r
 821 <p>\r
 822 Appearance of the bottom window showing info messages.\r
 823 </p>\r
 824 <p><strong>status</strong></p>\r
 825 </dd>\r
 826 <dt>\r
 827 Title window colors\r
 828 </dt>\r
 829 <dd>\r
 830 <p>\r
 831 Appearence of the title windows when they are attached\r
 832 to any backgrounded windows and the current window.\r
 833 </p>\r
 834 <p><strong>title-blur</strong>, <strong>title-focus</strong></p>\r
 835 </dd>\r
 836 <dt>\r
 837 Cursor line colors\r
 838 </dt>\r
 839 <dd>\r
 840 <p>\r
 841 <strong>cursor</strong>\r
 842 </p>\r
 843 </dd>\r
 844 <dt>\r
 845 Main view specific\r
 846 </dt>\r
 847 <dd>\r
 848 <p>\r
 849 Appearance of the various columns in the main view, including the <em>~</em> used for\r
 850 delimiting long author names and labels for tag and branch references.\r
 851 </p>\r
 852 <p><strong>main-date</strong>, <strong>main-author</strong>, <strong>main-commit</strong>, <strong>main-delim</strong>, <strong>main-tag</strong>,\r
 853 <strong>main-ref</strong></p>\r
 854 </dd>\r
 855 </dl>\r
 856 <h3>Highlighting</h3>\r
 857 <p>The colors and attributes for text that is not highlighted can be controlled\r
 858 by changing the <strong>default</strong> color option.</p>\r
 859 <dl>\r
 860 <dt>\r
 861 Diff markup\r
 862 </dt>\r
 863 <dd>\r
 864 <p>\r
 865 Options concerning diff start, chunks and lines added and deleted.\r
 866 </p>\r
 867 <p><strong>diff-header</strong>, <strong>diff-chunk</strong>, <strong>diff-add</strong>, <strong>diff-del</strong></p>\r
 868 </dd>\r
 869 <dt>\r
 870 Enhanced git diff markup\r
 871 </dt>\r
 872 <dd>\r
 873 <p>\r
 874 Extra diff information emitted by the git diff machinery, such as mode\r
 875 changes, rename detection, and similarity.\r
 876 </p>\r
 877 <p><strong>diff-oldmode</strong>, <strong>diff-newmode</strong>, <strong>diff-copy-from</strong>, <strong>diff-copy-to</strong>,\r
 878 <strong>diff-rename-from</strong>, <strong>diff-rename-to</strong>, <strong>diff-similarity</strong> <strong>diff-dissimilarity</strong>\r
 879 <strong>diff-tree</strong>, <strong>diff-index</strong></p>\r
 880 </dd>\r
 881 <dt>\r
 882 Pretty print commit headers\r
 883 </dt>\r
 884 <dd>\r
 885 <p>\r
 886 Commit diffs and the revision logs are usually formatted using pretty printed\r
 887 headers , unless <tt>--pretty=raw</tt> was given. This includes lines, such as merge\r
 888 info, commit ID, and author and comitter date.\r
 889 </p>\r
 890 <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
 891 </dd>\r
 892 <dt>\r
 893 Raw commit header\r
 894 </dt>\r
 895 <dd>\r
 896 <p>\r
 897 Usually shown when <tt>--pretty=raw</tt> is given, however <em>commit</em> is pretty much\r
 898 omnipresent.\r
 899 </p>\r
 900 <p><strong>commit</strong>, <strong>parent</strong>, <strong>tree</strong>, <strong>author</strong>, <strong>committer</strong></p>\r
 901 </dd>\r
 902 <dt>\r
 903 Commit message\r
 904 </dt>\r
 905 <dd>\r
 906 <p>\r
 907 For now only <tt>Signed-off-by</tt> lines are colorized.\r
 908 </p>\r
 909 <p><strong>signoff</strong></p>\r
 910 </dd>\r
 911 </dl>\r
 912 </div>\r
 913 <h2>COPYRIGHT</h2>\r
 914 <div class="sectionbody">\r
 915 <p>Copyright (c) 2006 Jonas Fonseca &lt;fonseca@diku.dk&gt;</p>\r
 916 <p>Licensed under the terms of the GNU General Public License.</p>\r
 917 </div>\r
 918 <h2>SEE ALSO</h2>\r
 919 <div class="sectionbody">\r
 920 <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
 921 </div>\r
 922 <div id="footer">\r
 923 <div id="footer-text">\r
 924 Last updated 03-Sep-2006 22:04:39 CEST\r
 925 </div>\r
 926 </div>\r
 927 </body>\r
 928 </html>\r