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 start-up. 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\r
 388         # 'unbind' the default quit key binding\r
 389         bind main Q none</tt></pre>\r
 390 </div></div>\r
 391 <p>Keys are mapped by first searching the keybindings for the current view, then\r
 392 the keybindings for the <strong>generic</strong> keymap, and last the default keybindings.\r
 393 Thus, the view keybindings shadow the generic keybindings which Shadow the\r
 394 built-in keybindings.</p>\r
 395 <dl>\r
 396 <dt>\r
 397 Keymaps\r
 398 </dt>\r
 399 <dd>\r
 400 <p>\r
 401 Valid 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
 406 Key values\r
 407 </dt>\r
 408 <dd>\r
 409 <p>\r
 410 Key values should never be quoted. Use either the ASCII value or one of the\r
 411 following 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
 413 character.\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
 420 Action names\r
 421 </dt>\r
 422 <dd>\r
 423 <p>\r
 424 Valid action names are described below. Note, all names are\r
 425 case-insensitive, and you may use <em>-</em>, <em>_</em>, and <em>.</em> interchangeably,\r
 426 e.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
 433 frame="void"\r
 434 cellspacing="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
 440     View switching:\r
 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
 474     view-tree\r
 475     </td>\r
 476     <td align="left">\r
 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
 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
 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
 504 </tbody>\r
 505 </table>\r
 506 </div>\r
 507 <div class="tableblock">\r
 508 <table rules="none"\r
 509 frame="void"\r
 510 cellspacing="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
 516     View manipulation:\r
 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
 577 frame="void"\r
 578 cellspacing="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
 584     Cursor navigation:\r
 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
 610     move-page-down\r
 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
 618     move-page-up\r
 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
 626     move-first-line\r
 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
 634     move-last-line\r
 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
 645 frame="void"\r
 646 cellspacing="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
 652     Scrolling:\r
 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
 662     scroll-line-up\r
 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
 670     scroll-line-down\r
 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
 678     scroll-page-eup\r
 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
 686     scroll-page-down\r
 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
 697 frame="void"\r
 698 cellspacing="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
 704     Misc:\r
 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
 714     none\r
 715     </td>\r
 716     <td align="left">\r
 717     Do nothing\r
 718     </td>\r
 719   </tr>\r
 720   <tr>\r
 721     <td align="left">\r
 722     prompt\r
 723     </td>\r
 724     <td align="left">\r
 725     Bring up the prompt\r
 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
 770     toggle-rev-graph\r
 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
 783 terminal supports color, these commands can be used to assign foreground and\r
 784 background combinations to certain areas. Optionally, an attribute can be given\r
 785 as the last parameter. The syntax is:</p>\r
 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
 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
 803 Area 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
 813 Color 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
 823 Attribute 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
 836 Status window colors\r
 837 </dt>\r
 838 <dd>\r
 839 <p>\r
 840 Appearance of the bottom window showing info messages.\r
 841 </p>\r
 842 <p><strong>status</strong></p>\r
 843 </dd>\r
 844 <dt>\r
 845 Title window colors\r
 846 </dt>\r
 847 <dd>\r
 848 <p>\r
 849 Appearance of the title windows when they are attached\r
 850 to 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
 855 Cursor 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
 863 Main view specific\r
 864 </dt>\r
 865 <dd>\r
 866 <p>\r
 867 Appearance of the various columns in the main view, including the <em>~</em> used for\r
 868 delimiting 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
 876 by changing the <strong>default</strong> color option.</p>\r
 877 <dl>\r
 878 <dt>\r
 879 Diff markup\r
 880 </dt>\r
 881 <dd>\r
 882 <p>\r
 883 Options concerning diff start, chunks and lines added and deleted.\r
 884 </p>\r
 885 <p><strong>diff-header</strong>, <strong>diff-chunk</strong>, <strong>diff-add</strong>, <strong>diff-del</strong></p>\r
 886 </dd>\r
 887 <dt>\r
 888 Enhanced git diff markup\r
 889 </dt>\r
 890 <dd>\r
 891 <p>\r
 892 Extra diff information emitted by the git diff machinery, such as mode\r
 893 changes, rename detection, and similarity.\r
 894 </p>\r
 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
 898 </dd>\r
 899 <dt>\r
 900 Pretty print commit headers\r
 901 </dt>\r
 902 <dd>\r
 903 <p>\r
 904 Commit diffs and the revision logs are usually formatted using pretty printed\r
 905 headers , unless <tt>--pretty=raw</tt> was given. This includes lines, such as merge\r
 906 info, commit ID, and author and committer date.\r
 907 </p>\r
 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
 909 </dd>\r
 910 <dt>\r
 911 Raw commit header\r
 912 </dt>\r
 913 <dd>\r
 914 <p>\r
 915 Usually shown when <tt>--pretty=raw</tt> is given, however <em>commit</em> is pretty much\r
 916 omnipresent.\r
 917 </p>\r
 918 <p><strong>commit</strong>, <strong>parent</strong>, <strong>tree</strong>, <strong>author</strong>, <strong>committer</strong></p>\r
 919 </dd>\r
 920 <dt>\r
 921 Commit message\r
 922 </dt>\r
 923 <dd>\r
 924 <p>\r
 925 For now only <tt>Signed-off-by</tt> and <tt>Acked-by</tt> lines are colorized.\r
 926 </p>\r
 927 <p><strong>signoff</strong>, <strong>acked</strong></p>\r
 928 </dd>\r
 929 </dl>\r
 930 </div>\r
 931 <h2>COPYRIGHT</h2>\r
 932 <div class="sectionbody">\r
 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
 935 </div>\r
 936 <h2>SEE ALSO</h2>\r
 937 <div class="sectionbody">\r
 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
 939 </div>\r
 940 <div id="footer">\r
 941 <div id="footer-text">\r
 942 Last updated 18-Sep-2006 18:23:53 CEST\r
 943 </div>\r
 944 </div>\r
 945 </body>\r
 946 </html>\r