File: //usr/share/doc/tig/tig.1.html
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 10.2.0" />
<title>tig(1)</title>
<style type="text/css">
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
/* Default font. */
body {
font-family: Georgia,serif;
}
/* Title font. */
h1, h2, h3, h4, h5, h6,
div.title, caption.title,
thead, p.table.header,
#toctitle,
#author, #revnumber, #revdate, #revremark,
#footer {
font-family: Arial,Helvetica,sans-serif;
}
body {
margin: 1em 5% 1em 5%;
}
a {
color: blue;
text-decoration: underline;
}
a:visited {
color: fuchsia;
}
em {
font-style: italic;
color: navy;
}
strong {
font-weight: bold;
color: #083194;
}
h1, h2, h3, h4, h5, h6 {
color: #527bbd;
margin-top: 1.2em;
margin-bottom: 0.5em;
line-height: 1.3;
}
h1, h2, h3 {
border-bottom: 2px solid silver;
}
h2 {
padding-top: 0.5em;
}
h3 {
float: left;
}
h3 + * {
clear: left;
}
h5 {
font-size: 1.0em;
}
div.sectionbody {
margin-left: 0;
}
hr {
border: 1px solid silver;
}
p {
margin-top: 0.5em;
margin-bottom: 0.5em;
}
ul, ol, li > p {
margin-top: 0;
}
ul > li { color: #aaa; }
ul > li > * { color: black; }
.monospaced, code, pre {
font-family: "Courier New", Courier, monospace;
font-size: inherit;
color: navy;
padding: 0;
margin: 0;
}
pre {
white-space: pre-wrap;
}
#author {
color: #527bbd;
font-weight: bold;
font-size: 1.1em;
}
#email {
}
#revnumber, #revdate, #revremark {
}
#footer {
font-size: small;
border-top: 2px solid silver;
padding-top: 0.5em;
margin-top: 4.0em;
}
#footer-text {
float: left;
padding-bottom: 0.5em;
}
#footer-badges {
float: right;
padding-bottom: 0.5em;
}
#preamble {
margin-top: 1.5em;
margin-bottom: 1.5em;
}
div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
margin-top: 1.0em;
margin-bottom: 1.5em;
}
div.admonitionblock {
margin-top: 2.0em;
margin-bottom: 2.0em;
margin-right: 10%;
color: #606060;
}
div.content { /* Block element content. */
padding: 0;
}
/* Block element titles. */
div.title, caption.title {
color: #527bbd;
font-weight: bold;
text-align: left;
margin-top: 1.0em;
margin-bottom: 0.5em;
}
div.title + * {
margin-top: 0;
}
td div.title:first-child {
margin-top: 0.0em;
}
div.content div.title:first-child {
margin-top: 0.0em;
}
div.content + div.title {
margin-top: 0.0em;
}
div.sidebarblock > div.content {
background: #ffffee;
border: 1px solid #dddddd;
border-left: 4px solid #f0f0f0;
padding: 0.5em;
}
div.listingblock > div.content {
border: 1px solid #dddddd;
border-left: 5px solid #f0f0f0;
background: #f8f8f8;
padding: 0.5em;
}
div.quoteblock, div.verseblock {
padding-left: 1.0em;
margin-left: 1.0em;
margin-right: 10%;
border-left: 5px solid #f0f0f0;
color: #888;
}
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
div.verseblock > pre.content {
font-family: inherit;
font-size: inherit;
}
div.verseblock > div.attribution {
padding-top: 0.75em;
text-align: left;
}
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
div.verseblock + div.attribution {
text-align: left;
}
div.admonitionblock .icon {
vertical-align: top;
font-size: 1.1em;
font-weight: bold;
text-decoration: underline;
color: #527bbd;
padding-right: 0.5em;
}
div.admonitionblock td.content {
padding-left: 0.5em;
border-left: 3px solid #dddddd;
}
div.exampleblock > div.content {
border-left: 3px solid #dddddd;
padding-left: 0.5em;
}
div.imageblock div.content { padding-left: 0; }
span.image img { border-style: none; vertical-align: text-bottom; }
a.image:visited { color: white; }
dl {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
dt {
margin-top: 0.5em;
margin-bottom: 0;
font-style: normal;
color: navy;
}
dd > *:first-child {
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
ol.upperalpha {
list-style-type: upper-alpha;
}
ol.lowerroman {
list-style-type: lower-roman;
}
ol.upperroman {
list-style-type: upper-roman;
}
div.compact ul, div.compact ol,
div.compact p, div.compact p,
div.compact div, div.compact div {
margin-top: 0.1em;
margin-bottom: 0.1em;
}
tfoot {
font-weight: bold;
}
td > div.verse {
white-space: pre;
}
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
div.hdlist tr {
padding-bottom: 15px;
}
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
font-style: normal;
padding-right: 0.8em;
color: navy;
}
td.hdlist2 {
vertical-align: top;
}
div.hdlist.compact tr {
margin: 0;
padding-bottom: 0;
}
.comment {
background: yellow;
}
.footnote, .footnoteref {
font-size: 0.8em;
}
span.footnote, span.footnoteref {
vertical-align: super;
}
#footnotes {
margin: 20px 0 20px 0;
padding: 7px 0 0 0;
}
#footnotes div.footnote {
margin: 0 0 5px 0;
}
#footnotes hr {
border: none;
border-top: 1px solid silver;
height: 1px;
text-align: left;
margin-left: 0;
width: 20%;
min-width: 100px;
}
div.colist td {
padding-right: 0.5em;
padding-bottom: 0.3em;
vertical-align: top;
}
div.colist td img {
margin-top: 0.3em;
}
@media print {
#footer-badges { display: none; }
}
#toc {
margin-bottom: 2.5em;
}
#toctitle {
color: #527bbd;
font-size: 1.1em;
font-weight: bold;
margin-top: 1.0em;
margin-bottom: 0.1em;
}
div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
margin-top: 0;
margin-bottom: 0;
}
div.toclevel2 {
margin-left: 2em;
font-size: 0.9em;
}
div.toclevel3 {
margin-left: 4em;
font-size: 0.9em;
}
div.toclevel4 {
margin-left: 6em;
font-size: 0.9em;
}
span.aqua { color: aqua; }
span.black { color: black; }
span.blue { color: blue; }
span.fuchsia { color: fuchsia; }
span.gray { color: gray; }
span.green { color: green; }
span.lime { color: lime; }
span.maroon { color: maroon; }
span.navy { color: navy; }
span.olive { color: olive; }
span.purple { color: purple; }
span.red { color: red; }
span.silver { color: silver; }
span.teal { color: teal; }
span.white { color: white; }
span.yellow { color: yellow; }
span.aqua-background { background: aqua; }
span.black-background { background: black; }
span.blue-background { background: blue; }
span.fuchsia-background { background: fuchsia; }
span.gray-background { background: gray; }
span.green-background { background: green; }
span.lime-background { background: lime; }
span.maroon-background { background: maroon; }
span.navy-background { background: navy; }
span.olive-background { background: olive; }
span.purple-background { background: purple; }
span.red-background { background: red; }
span.silver-background { background: silver; }
span.teal-background { background: teal; }
span.white-background { background: white; }
span.yellow-background { background: yellow; }
span.big { font-size: 2em; }
span.small { font-size: 0.6em; }
span.underline { text-decoration: underline; }
span.overline { text-decoration: overline; }
span.line-through { text-decoration: line-through; }
div.unbreakable { page-break-inside: avoid; }
/*
* xhtml11 specific
*
* */
div.tableblock {
margin-top: 1.0em;
margin-bottom: 1.5em;
}
div.tableblock > table {
border: 3px solid #527bbd;
}
thead, p.table.header {
font-weight: bold;
color: #527bbd;
}
p.table {
margin-top: 0;
}
/* Because the table frame attribute is overridden by CSS in most browsers. */
div.tableblock > table[frame="void"] {
border-style: none;
}
div.tableblock > table[frame="hsides"] {
border-left-style: none;
border-right-style: none;
}
div.tableblock > table[frame="vsides"] {
border-top-style: none;
border-bottom-style: none;
}
/*
* html5 specific
*
* */
table.tableblock {
margin-top: 1.0em;
margin-bottom: 1.5em;
}
thead, p.tableblock.header {
font-weight: bold;
color: #527bbd;
}
p.tableblock {
margin-top: 0;
}
table.tableblock {
border-width: 3px;
border-spacing: 0px;
border-style: solid;
border-color: #527bbd;
border-collapse: collapse;
}
th.tableblock, td.tableblock {
border-width: 1px;
padding: 4px;
border-style: solid;
border-color: #527bbd;
}
table.tableblock.frame-topbot {
border-left-style: hidden;
border-right-style: hidden;
}
table.tableblock.frame-sides {
border-top-style: hidden;
border-bottom-style: hidden;
}
table.tableblock.frame-none {
border-style: hidden;
}
th.tableblock.halign-left, td.tableblock.halign-left {
text-align: left;
}
th.tableblock.halign-center, td.tableblock.halign-center {
text-align: center;
}
th.tableblock.halign-right, td.tableblock.halign-right {
text-align: right;
}
th.tableblock.valign-top, td.tableblock.valign-top {
vertical-align: top;
}
th.tableblock.valign-middle, td.tableblock.valign-middle {
vertical-align: middle;
}
th.tableblock.valign-bottom, td.tableblock.valign-bottom {
vertical-align: bottom;
}
/*
* manpage specific
*
* */
body.manpage h1 {
padding-top: 0.5em;
padding-bottom: 0.5em;
border-top: 2px solid silver;
border-bottom: 2px solid silver;
}
body.manpage h2 {
border-style: none;
}
body.manpage div.sectionbody {
margin-left: 3em;
}
@media print {
body.manpage div#toc { display: none; }
}
</style>
<script type="text/javascript">
/*<+'])');
// Function that scans the DOM tree for header elements (the DOM2
// nodeIterator API would be a better technique but not supported by all
// browsers).
var iterate = function (el) {
for (var i = el.firstChild; i != null; i = i.nextSibling) {
if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
var mo = re.exec(i.tagName);
if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
}
iterate(i);
}
}
}
iterate(el);
return result;
}
var toc = document.getElementById("toc");
if (!toc) {
return;
}
// Delete existing TOC entries in case we're reloading the TOC.
var tocEntriesToRemove = [];
var i;
for (i = 0; i < toc.childNodes.length; i++) {
var entry = toc.childNodes[i];
if (entry.nodeName.toLowerCase() == 'div'
&& entry.getAttribute("class")
&& entry.getAttribute("class").match(/^toclevel/))
tocEntriesToRemove.push(entry);
}
for (i = 0; i < tocEntriesToRemove.length; i++) {
toc.removeChild(tocEntriesToRemove[i]);
}
// Rebuild TOC entries.
var entries = tocEntries(document.getElementById("content"), toclevels);
for (var i = 0; i < entries.length; ++i) {
var entry = entries[i];
if (entry.element.id == "")
entry.element.id = "_toc_" + i;
var a = document.createElement("a");
a.href = "#" + entry.element.id;
a.appendChild(document.createTextNode(entry.text));
var div = document.createElement("div");
div.appendChild(a);
div.className = "toclevel" + entry.toclevel;
toc.appendChild(div);
}
if (entries.length == 0)
toc.parentNode.removeChild(toc);
},
/////////////////////////////////////////////////////////////////////
// Footnotes generator
/////////////////////////////////////////////////////////////////////
/* Based on footnote generation code from:
* http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
*/
footnotes: function () {
// Delete existing footnote entries in case we're reloading the footnodes.
var i;
var noteholder = document.getElementById("footnotes");
if (!noteholder) {
return;
}
var entriesToRemove = [];
for (i = 0; i < noteholder.childNodes.length; i++) {
var entry = noteholder.childNodes[i];
if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
entriesToRemove.push(entry);
}
for (i = 0; i < entriesToRemove.length; i++) {
noteholder.removeChild(entriesToRemove[i]);
}
// Rebuild footnote entries.
var cont = document.getElementById("content");
var spans = cont.getElementsByTagName("span");
var refs = {};
var n = 0;
for (i=0; i<spans.length; i++) {
if (spans[i].className == "footnote") {
n++;
var note = spans[i].getAttribute("data-note");
if (!note) {
// Use [\s\S] in place of . so multi-line matches work.
// Because JavaScript has no s (dotall) regex flag.
note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
spans[i].innerHTML =
"[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
"' title='View footnote' class='footnote'>" + n + "</a>]";
spans[i].setAttribute("data-note", note);
}
noteholder.innerHTML +=
"<div class='footnote' id='_footnote_" + n + "'>" +
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +
n + "</a>. " + note + "</div>";
var id =spans[i].getAttribute("id");
if (id != null) refs["#"+id] = n;
}
}
if (n == 0)
noteholder.parentNode.removeChild(noteholder);
else {
// Process footnoterefs.
for (i=0; i<spans.length; i++) {
if (spans[i].className == "footnoteref") {
var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
href = href.match(/#.*/)[0]; // Because IE return full URL.
n = refs[href];
spans[i].innerHTML =
"[<a href='#_footnote_" + n +
"' title='View footnote' class='footnote'>" + n + "</a>]";
}
}
}
},
install: function(toclevels) {
var timerId;
function reinstall() {
asciidoc.footnotes();
if (toclevels) {
asciidoc.toc(toclevels);
}
}
function reinstallAndRemoveTimer() {
clearInterval(timerId);
reinstall();
}
timerId = setInterval(reinstall, 500);
if (document.addEventListener)
document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
else
window.onload = reinstallAndRemoveTimer;
}
}
asciidoc.install();
/*]]>*/
</script>
</head>
<body class="manpage">
<div id="header">
<h1>
tig(1) Manual Page
</h1>
<h2>NAME</h2>
<div class="sectionbody">
<p>tig -
text-mode interface for Git
</p>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="_synopsis">SYNOPSIS</h2>
<div class="sectionbody">
<div class="verseblock">
<pre class="content">tig [options] [revisions] [--] [paths]
tig log [options] [revisions] [--] [paths]
tig show [options] [revisions] [--] [paths]
tig reflog [options] [revisions]
tig blame [options] [rev] [--] path
tig grep [options] [pattern]
tig refs [options]
tig stash [options]
tig status
tig < [Git command output]</pre>
<div class="attribution">
</div></div>
</div>
</div>
<div class="sect1">
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
<div class="paragraph"><p>Tig is an ncurses-based text-mode interface for git(1). It functions
mainly as a Git repository browser, but can also assist in staging
changes for commit at chunk level and act as a pager for output from
various Git commands.</p></div>
</div>
</div>
<div class="sect1">
<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
<div class="paragraph"><p>Command line options recognized by Tig include all valid git-log(1) and
git-diff(1) options, as well as the following subcommands and Tig-specific
options. The first command line parameter not starting with "-" is interpreted
as being either a revision specification or a path and will end the option
parsing. All additional options will be passed to the underlying Git command.</p></div>
<div class="paragraph"><p>Note that this means that any arguments to options should be specified
together. For example, run tig -Sfoo instead of tig -S foo, and tig --grep=foo
instead of tig --grep foo, otherwise foo will be interpreted as a revision
rather than an argument.</p></div>
<div class="dlist"><dl>
<dt class="hdlist1">
show
</dt>
<dd>
<p>
Open diff view using the given git-show(1) options.
</p>
</dd>
<dt class="hdlist1">
blame
</dt>
<dd>
<p>
Show given file annotated by commits.
Takes zero or more git-blame(1) options.
Optionally limited from given revision.
</p>
</dd>
<dt class="hdlist1">
status
</dt>
<dd>
<p>
Start up in status view.
</p>
</dd>
<dt class="hdlist1">
log
</dt>
<dd>
<p>
Start up in log view, displaying git-log(1) output.
</p>
</dd>
<dt class="hdlist1">
reflog
</dt>
<dd>
<p>
Start up in reflog view.
</p>
</dd>
<dt class="hdlist1">
refs
</dt>
<dd>
<p>
Start up in refs view. All refs are displayed unless limited by using
one of the <em>--branches</em>, <em>--remotes</em>, or <em>--tags</em> parameters.
</p>
</dd>
<dt class="hdlist1">
stash
</dt>
<dd>
<p>
Start up in stash view.
</p>
</dd>
<dt class="hdlist1">
grep
</dt>
<dd>
<p>
Open the grep view. Supports the same options as git-grep(1).
</p>
</dd>
<dt class="hdlist1">
+<number>
</dt>
<dd>
<p>
Show the first view with line <number> visible and selected.
</p>
</dd>
<dt class="hdlist1">
-v, --version
</dt>
<dd>
<p>
Show version and exit.
</p>
</dd>
<dt class="hdlist1">
-h, --help
</dt>
<dd>
<p>
Show help message and exit.
</p>
</dd>
<dt class="hdlist1">
-C <path>
</dt>
<dd>
<p>
Run as if Tig was started in <path> instead of the current working directory.
</p>
</dd>
</dl></div>
</div>
</div>
<div class="sect1">
<h2 id="_pager_mode">PAGER MODE</h2>
<div class="sectionbody">
<div class="paragraph"><p>Tig enters pager mode when input is provided via stdin and supports the
following subcommands and options:</p></div>
<div class="openblock">
<div class="content">
<div class="ulist"><ul>
<li>
<p>
When the <em>show</em> subcommand is specified and the <em>--stdin</em> option is given,
stdin is assumed to be a list of commit IDs and will be forwarded to the diff
view’s underlying git-show(1) command. For example:
</p>
</li>
</ul></div>
<div class="listingblock">
<div class="content">
<pre><code>$ git rev-list --author=vivien HEAD | tig show --stdin</code></pre>
</div></div>
<div class="ulist"><ul>
<li>
<p>
When <em>--stdin</em> is given, stdin is assumed to be a list of commit IDs
and will be forwarded to the main view’s underlying git-log(1)
command. For example:
</p>
</li>
</ul></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig --no-walk --stdin < cherry-picks.txt</code></pre>
</div></div>
<div class="ulist"><ul>
<li>
<p>
When <em>--pretty=raw</em> is given, stdin is assumed to be a "pretty=raw"
formatted output similar to that of git-log(1). For example:
</p>
</li>
</ul></div>
<div class="listingblock">
<div class="content">
<pre><code>$ git reflog --pretty=raw | tig --pretty=raw</code></pre>
</div></div>
</div></div>
<div class="paragraph"><p>When no subcommands nor options are given, the pager view will be used for
displaying the Git command input given on stdin. The pager view assumes the
input is either from git-log(1) or git-diff(1) and will highlight it similar to
the log and diff views. For example:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ git log -Schange -p --raw | tig</code></pre>
</div></div>
</div>
</div>
<div class="sect1">
<h2 id="_examples">EXAMPLES</h2>
<div class="sectionbody">
<div class="paragraph"><p>Display the list of commits for the current branch:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig</code></pre>
</div></div>
<div class="paragraph"><p>Display commits from one or more branches:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig test master</code></pre>
</div></div>
<div class="paragraph"><p>Pretend as if all the refs in <code>refs/</code> are listed on the command line:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig --all</code></pre>
</div></div>
<div class="paragraph"><p>Display differences between two branches:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig test..master</code></pre>
</div></div>
<div class="paragraph"><p>Display changes for sub-module versions:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig --submodule</code></pre>
</div></div>
<div class="paragraph"><p>Display changes for a single file:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig -- README</code></pre>
</div></div>
<div class="paragraph"><p>Display contents of the README file in a specific revision:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig show tig-0.8:README</code></pre>
</div></div>
<div class="paragraph"><p>Display revisions between two dates for a specific file:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig --after="2004-01-01" --before="2006-05-16" -- README</code></pre>
</div></div>
<div class="paragraph"><p>Blame file with copy detection enabled:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig blame -C README</code></pre>
</div></div>
<div class="paragraph"><p>Display the list of stashes:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig stash</code></pre>
</div></div>
<div class="paragraph"><p>Grep all files for lines containing <code>DEFINE_ENUM</code>:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig grep -p DEFINE_ENUM</code></pre>
</div></div>
<div class="paragraph"><p>Show references (branches, remotes and tags):</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig refs</code></pre>
</div></div>
<div class="paragraph"><p>Use word diff in the diff view:</p></div>
<div class="listingblock">
<div class="content">
<pre><code>$ tig --word-diff=plain</code></pre>
</div></div>
</div>
</div>
<div class="sect1">
<h2 id="_environment_variables">ENVIRONMENT VARIABLES</h2>
<div class="sectionbody">
<div class="paragraph"><p>In addition to environment variables used by Git (e.g. GIT_DIR), Tig defines
the ones below. The command related environment variables have access to the
internal state of Tig via replacement variables, such as <code>%(commit)</code> and
<code>%(blob)</code>.
See <a href="tigrc.5.html">tigrc(5)</a> for a full list.</p></div>
<div class="dlist"><dl>
<dt class="hdlist1">
TIGRC_USER
</dt>
<dd>
<p>
Path of the user configuration file (defaults to <code>~/.tigrc</code> or
<code>$XDG_CONFIG_HOME/tig/config</code>).
</p>
</dd>
<dt class="hdlist1">
TIGRC_SYSTEM
</dt>
<dd>
<p>
Path of the system wide configuration file (defaults to
<code>{sysconfdir}/tigrc</code>). Define to empty string to use built-in
configuration.
</p>
</dd>
<dt class="hdlist1">
TIG_LS_REMOTE
</dt>
<dd>
<p>
Command for retrieving all repository references. The command
should output data in the same format as git-ls-remote(1).
</p>
</dd>
<dt class="hdlist1">
TIG_DIFF_OPTS
</dt>
<dd>
<p>
The diff options to use in the diff view. The diff view uses
git-show(1) for formatting and always passes --patch-with-stat. You
may also set the <code>diff-options</code> setting in the configuration file.
</p>
</dd>
<dt class="hdlist1">
TIG_TRACE
</dt>
<dd>
<p>
Path for trace file where information about Git commands are logged.
</p>
</dd>
<dt class="hdlist1">
TIG_SCRIPT
</dt>
<dd>
<p>
Path to script that should be executed automatically on startup. If this
environment variable is defined to the empty string, the script is read
from stdin. The script is interpreted line-by-line and can contain
prompt commands and key mappings.
</p>
<div class="literalblock">
<div class="content">
<pre><code>E.g. TIG_SCRIPT=<(echo :set main-view-commit-title-graph = no) tig</code></pre>
</div></div>
</dd>
<dt class="hdlist1">
TIG_NO_DISPLAY
</dt>
<dd>
<p>
Open Tig without rendering anything to the terminal. This force Ncurses
to write to /dev/null. The main use is for automated testing of Tig.
</p>
</dd>
<dt class="hdlist1">
TIG_EDITOR
</dt>
<dd>
<p>
The editor command to use when visiting files. This environment
variable overrides $GIT_EDITOR, $EDITOR and $VISUAL, so it allows
to use a different editor from the one Git uses.
</p>
</dd>
</dl></div>
</div>
</div>
<div class="sect1">
<h2 id="_files">FILES</h2>
<div class="sectionbody">
<div class="dlist"><dl>
<dt class="hdlist1">
<em>$XDG_CONFIG_HOME/tig/config</em>
</dt>
<dt class="hdlist1">
<em>~/.config/tig/config</em>
</dt>
<dt class="hdlist1">
<em>~/.tigrc</em>
</dt>
<dd>
<p>
The Tig user configuration file is loaded in the following way. If
<code>$XDG_CONFIG_HOME</code> is set, read user configuration from
<code>$XDG_CONFIG_HOME/tig/config</code>. If <code>$XDG_CONFIG_HOME</code> is empty or
undefined, read user configuration from <code>~/.config/tig/config</code> if it
exists and fall back to <code>~/.tigrc</code> if it does not exist. See
<a href="tigrc.5.html">tigrc(5)</a> for examples.
</p>
</dd>
<dt class="hdlist1">
<em>/etc/tigrc</em>
</dt>
<dd>
<p>
System wide configuration file.
</p>
</dd>
<dt class="hdlist1">
<em>$GIT_DIR/config</em>
</dt>
<dt class="hdlist1">
<em>~/.gitconfig</em>
</dt>
<dt class="hdlist1">
<em>/etc/gitconfig</em>
</dt>
<dd>
<p>
Git configuration files. Read on start-up with the help of
git-config(1).
</p>
</dd>
<dt class="hdlist1">
<em>$XDG_DATA_HOME/tig/history</em>
</dt>
<dt class="hdlist1">
<em>~/.local/share/tig/history</em>
</dt>
<dt class="hdlist1">
<em>~/.tig_history</em>
</dt>
<dd>
<p>
When compiled with readline support, Tig writes a persistent command and
search history. The location of the history file is determined in the
following way. If <code>$XDG_DATA_HOME</code> is set and <code>$XDG_DATA_HOME/</code> exists,
create <code>$XDG_DATA_HOME/tig/</code> if needed and store history to
<code>$XDG_DATA_HOME/tig/history</code>. If <code>$XDG_DATA_HOME</code> is empty or undefined,
store history to <code>~/.local/share/tig/history</code> if the directory
<code>~/.local/share/tig/</code> exists, and fall back to <code>~/.tig_history</code> if it
does not exist.
</p>
</dd>
</dl></div>
</div>
</div>
<div class="sect1">
<h2 id="_bugs">BUGS</h2>
<div class="sectionbody">
<div class="paragraph"><p>Please visit Tig’s <a href="https://jonas.github.io/tig">home page</a> or
<a href="https://github.com/jonas/tig">main Git repository</a> for information about
new releases and how to report bugs or feature request.</p></div>
</div>
</div>
<div class="sect1">
<h2 id="_copyright">COPYRIGHT</h2>
<div class="sectionbody">
<div class="paragraph"><p>Copyright (c) 2006-2022 Jonas Fonseca <<a href="mailto:jonas.fonseca@gmail.com">jonas.fonseca@gmail.com</a>></p></div>
<div class="paragraph"><p>This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.</p></div>
</div>
</div>
<div class="sect1">
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
<div class="paragraph"><p><a href="tigrc.5.html">tigrc(5)</a>,
<a href="manual.html">the Tig manual</a>,
git(7)</p></div>
</div>
</div>
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Last updated
2023-02-04 12:30:14 UTC
</div>
</div>
</body>
</html>