Blob


1 <!DOCTYPE html>
2 <html>
3 <head>
4 <meta charset="utf-8"/>
5 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
6 <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
7 <title>TOG(1)</title>
8 </head>
9 <!-- This is an automatically generated file. Do not edit.
10 Copyright (c) 2018 Stefan Sperling
12 Permission to use, copy, modify, and distribute this software for any
13 purpose with or without fee is hereby granted, provided that the above
14 copyright notice and this permission notice appear in all copies.
16 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
17 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
18 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
19 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
20 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
21 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
22 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 -->
24 <body>
25 <div class="head" role="doc-pageheader" aria-label="Manual header
26 line"><span class="head-ltitle">TOG(1)</span> <span class="head-vol">General
27 Commands Manual</span> <span class="head-rtitle">TOG(1)</span></div>
28 <main class="manual-text">
29 <section class="Sh">
30 <h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
31 <p class="Pp"><code class="Nm">tog</code> &#x2014;
32 <span class="Nd" role="doc-subtitle">Git repository browser</span></p>
33 </section>
34 <section class="Sh">
35 <h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h2>
36 <table class="Nm">
37 <tr>
38 <td><code class="Nm">tog</code></td>
39 <td>[<code class="Fl">-hV</code>] <var class="Ar">command</var>
40 [<var class="Ar">arg ...</var>]</td>
41 </tr>
42 </table>
43 <p class="Pp"></p>
44 <br/>
45 <table class="Nm">
46 <tr>
47 <td><code class="Nm">tog</code></td>
48 <td><var class="Ar">path</var></td>
49 </tr>
50 </table>
51 </section>
52 <section class="Sh">
53 <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
54 <p class="Pp"><code class="Nm">tog</code> is an interactive read-only browser
55 for Git repositories. This repository format is described in
56 <a class="Xr" aria-label="git-repository, section
57 5">git-repository(5)</a>.</p>
58 <p class="Pp"><code class="Nm">tog</code> supports several types of views which
59 display repository data:</p>
60 <dl class="Bl-tag">
61 <dt>Log view</dt>
62 <dd>Displays commits in the repository's history. This view is displayed
63 initially if no <var class="Ar">command</var> is specified, or if just a
64 <var class="Ar">path</var> is specified.</dd>
65 <dt>Diff view</dt>
66 <dd>Displays changes made in a particular commit.</dd>
67 <dt>Blame view</dt>
68 <dd>Displays the line-by-line history of a file.</dd>
69 <dt>Tree view</dt>
70 <dd>Displays the tree corresponding to a particular commit.</dd>
71 <dt>Ref view</dt>
72 <dd>Displays references in the repository.</dd>
73 </dl>
74 <p class="Pp"><code class="Nm">tog</code> provides global and command-specific
75 key bindings and options. Some command-specific key bindings may be prefixed
76 with an integer, which is denoted by N in the descriptions below, and is
77 used as a modifier to the operation as indicated.
78 <code class="Nm">tog</code> will echo digits to the screen when count
79 modifiers are entered, and complete the sequence upon input of the first
80 non-numeric character. Count modifiers can be aborted by entering an
81 unmapped key. Once a compound command is executed, the operation can be
82 cancelled with <code class="Cm">C-g</code> or
83 <code class="Cm">Backspace</code>.</p>
84 <p class="Pp">Global options must precede the command name, and are as
85 follows:</p>
86 <dl class="Bl-tag">
87 <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a></dt>
88 <dd>Display usage information.</dd>
89 <dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
90 <code class="Fl">--version</code></dt>
91 <dd>Display program version and exit immediately.</dd>
92 </dl>
93 <p class="Pp">The global key bindings are:</p>
94 <dl class="Bl-tag">
95 <dt id="H,"><a class="permalink" href="#H,"><code class="Cm">H,
96 F1</code></a></dt>
97 <dd>Display run-time help. Key bindings for the focussed view will be
98 displayed. Pressing this again inside the help view will toggle the
99 display of key bindings for all <code class="Nm">tog</code> views.</dd>
100 <dt id="Q"><a class="permalink" href="#Q"><code class="Cm">Q</code></a></dt>
101 <dd>Quit <code class="Nm">tog</code>.</dd>
102 <dt id="q"><a class="permalink" href="#q"><code class="Cm">q</code></a></dt>
103 <dd>Quit the view which is in focus.</dd>
104 <dt id="Tab"><a class="permalink" href="#Tab"><code class="Cm">Tab</code></a></dt>
105 <dd>Switch focus between views.</dd>
106 <dt id="F"><a class="permalink" href="#F"><code class="Cm">F</code></a></dt>
107 <dd>Toggle fullscreen mode for a split-screen view.
108 <code class="Nm">tog</code> will automatically use vertical split-screen
109 views if the size of the terminal window is sufficiently large.</dd>
110 <dt id="S"><a class="permalink" href="#S"><code class="Cm">S</code></a></dt>
111 <dd>Switch the current split-screen layout, and render all active views in
112 this new layout. The split-screen layout can be either vertical or
113 horizontal. If the terminal is not wide enough when switching to a
114 vertical split, views will render in fullscreen.</dd>
115 <dt><code class="Cm">-</code></dt>
116 <dd>When in a split-screen view, decrease the size of the focussed split N
117 increments (default: 1).</dd>
118 <dt id="+"><a class="permalink" href="#+"><code class="Cm">+</code></a></dt>
119 <dd>When in a split-screen view, increase the size of the focussed split N
120 increments (default: 1).</dd>
121 <dt id="G"><a class="permalink" href="#G"><code class="Cm">G</code></a></dt>
122 <dd>Go to line N in the view (default: last line).</dd>
123 <dt id="g"><a class="permalink" href="#g"><code class="Cm">g</code></a></dt>
124 <dd>Go to line N in the view (default: first line).</dd>
125 <dt id="Right-arrow,"><a class="permalink" href="#Right-arrow,"><code class="Cm">Right-arrow,
126 l</code></a></dt>
127 <dd>Scroll view to the right N increments (default: 1).
128 <br/>
129 Output moves left on the screen.</dd>
130 <dt id="Left-arrow,"><a class="permalink" href="#Left-arrow,"><code class="Cm">Left-arrow,
131 h</code></a></dt>
132 <dd>Scroll view to the left N increments (default: 1).
133 <br/>
134 Output moves right on the screen.</dd>
135 <dt id="$"><a class="permalink" href="#$"><code class="Cm">$</code></a></dt>
136 <dd>Scroll view to the rightmost position.</dd>
137 <dt id="0"><a class="permalink" href="#0"><code class="Cm">0</code></a></dt>
138 <dd>Scroll view left to the start of the line.</dd>
139 </dl>
140 <p class="Pp">The commands for <code class="Nm">tog</code> are as follows:</p>
141 <dl class="Bl-tag">
142 <dt id="log"><a class="permalink" href="#log"><code class="Cm">log</code></a>
143 [<code class="Fl">-b</code>] [<code class="Fl">-c</code>
144 <var class="Ar">commit</var>] [<code class="Fl">-r</code>
145 <var class="Ar">repository-path</var>] [<var class="Ar">path</var>]</dt>
146 <dd>Display history of a repository. If a <var class="Ar">path</var> is
147 specified, show only commits which modified this path. If invoked in a
148 work tree, the <var class="Ar">path</var> is interpreted relative to the
149 current working directory, and the work tree's path prefix is implicitly
150 prepended. Otherwise, the path is interpreted relative to the repository
151 root.
152 <p class="Pp">This command is also executed if no explicit command is
153 specified.</p>
154 <p class="Pp">The key bindings for <code class="Cm">tog log</code> are as
155 follows (N denotes optional prefixed count modifier):</p>
156 <dl class="Bl-tag">
157 <dt id="Down-arrow,"><a class="permalink" href="#Down-arrow,"><code class="Cm">Down-arrow,
158 j, &gt;, Full stop, Ctrl-n</code></a></dt>
159 <dd>Move the selection cursor down N lines (default: 1).</dd>
160 <dt id="Up-arrow,"><a class="permalink" href="#Up-arrow,"><code class="Cm">Up-arrow,
161 k, &lt;, Comma, Ctrl-p</code></a></dt>
162 <dd>Move the selection cursor up N lines (default: 1).</dd>
163 <dt id="Page-down,"><a class="permalink" href="#Page-down,"><code class="Cm">Page-down,
164 Space, Ctrl+f, f</code></a></dt>
165 <dd>Move the selection cursor down N pages (default: 1).</dd>
166 <dt id="Page-up,"><a class="permalink" href="#Page-up,"><code class="Cm">Page-up,
167 Ctrl+b, b</code></a></dt>
168 <dd>Move the selection cursor up N pages (default: 1).</dd>
169 <dt id="Ctrl+d,"><a class="permalink" href="#Ctrl+d,"><code class="Cm">Ctrl+d,
170 d</code></a></dt>
171 <dd>Move the selection cursor down N half pages (default: 1).</dd>
172 <dt id="Ctrl+u,"><a class="permalink" href="#Ctrl+u,"><code class="Cm">Ctrl+u,
173 u</code></a></dt>
174 <dd>Move the selection cursor up N half pages (default: 1).</dd>
175 <dt id="Home,"><a class="permalink" href="#Home,"><code class="Cm">Home,
176 =</code></a></dt>
177 <dd>Move the cursor to the newest commit.</dd>
178 <dt id="End,"><a class="permalink" href="#End,"><code class="Cm">End,
179 *</code></a></dt>
180 <dd>Move the cursor to the oldest commit. This will traverse all commits
181 on the current branch which may take a long time depending on the
182 number of commits in branch history. If needed, this operation can be
183 cancelled with <code class="Cm">C-g</code> or
184 <code class="Cm">Backspace</code>.</dd>
185 <dt id="g~2"><a class="permalink" href="#g~2"><code class="Cm">g</code></a></dt>
186 <dd>Move the cursor to commit N (default: 1).</dd>
187 <dt id="G~2"><a class="permalink" href="#G~2"><code class="Cm">G</code></a></dt>
188 <dd>Like <code class="Cm">g</code> but defaults to the oldest commit.</dd>
189 <dt id="Enter"><a class="permalink" href="#Enter"><code class="Cm">Enter</code></a></dt>
190 <dd>Open a <code class="Cm">diff</code> view showing file changes made in
191 the currently selected commit.</dd>
192 <dt id="T"><a class="permalink" href="#T"><code class="Cm">T</code></a></dt>
193 <dd>Open a <code class="Cm">tree</code> view showing the tree for the
194 currently selected commit.</dd>
195 <dt id="Backspace"><a class="permalink" href="#Backspace"><code class="Cm">Backspace</code></a></dt>
196 <dd>Show log entries for the parent directory of the currently selected
197 path. However when an active search is in progress or when additional
198 commits are loaded, <code class="Cm">Backspace</code> aborts the
199 running operation.</dd>
200 <dt id="/"><a class="permalink" href="#/"><code class="Cm">/</code></a></dt>
201 <dd>Prompt for a search pattern and start searching for matching commits.
202 The search pattern is an extended regular expression which is matched
203 against a commit's author name, committer name, log message, and
204 commit ID SHA1 hash. Regular expression syntax is documented in
205 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
206 <dt id="&amp;"><a class="permalink" href="#&amp;"><code class="Cm">&amp;</code></a></dt>
207 <dd>Prompt for a pattern and limit the log view's list of commits to those
208 which match the pattern. If no pattern is specified, i.e. the
209 <code class="Cm">&amp;</code> prompt is immediately closed with the
210 Enter key, then the pattern is cleared. Until the pattern is cleared,
211 the limited list of commits replaces the full list of commits for all
212 operations supported by the log view. For example, a search started
213 with <code class="Cm">/</code> will search the limited list of
214 commits, rather than searching all commits. The pattern is an extended
215 regular expression which is matched against a commit's author name,
216 committer name, log message, and commit ID SHA1 hash. Regular
217 expression syntax is documented in
218 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
219 <dt id="n"><a class="permalink" href="#n"><code class="Cm">n</code></a></dt>
220 <dd>Find the Nth next commit which matches the current search pattern
221 (default: 1).
222 <br/>
223 Searching continues until either a match is found or
224 <code class="Cm">C-g</code> or the <code class="Cm">Backspace</code>
225 key is pressed.</dd>
226 <dt id="N"><a class="permalink" href="#N"><code class="Cm">N</code></a></dt>
227 <dd>Find the Nth previous commit which matches the current search pattern
228 (default: 1).
229 <br/>
230 Searching continues until either a match is found or
231 <code class="Cm">C-g</code> or the <code class="Cm">Backspace</code>
232 key is pressed.</dd>
233 <dt id="Ctrl+l"><a class="permalink" href="#Ctrl+l"><code class="Cm">Ctrl+l</code></a></dt>
234 <dd>Reload the <code class="Cm">log</code> view with new commits found in
235 the repository.</dd>
236 <dt id="B"><a class="permalink" href="#B"><code class="Cm">B</code></a></dt>
237 <dd>Reload the <code class="Cm">log</code> view and toggle display of
238 merged commits. The <code class="Fl">-b</code> option determines
239 whether merged commits are displayed initially.</dd>
240 <dt id="R"><a class="permalink" href="#R"><code class="Cm">R</code></a></dt>
241 <dd>Open a <code class="Cm">ref</code> view listing all references in the
242 repository. This can then be used to open a new
243 <code class="Cm">log</code> view for arbitrary branches and tags.</dd>
244 <dt id="@"><a class="permalink" href="#@"><code class="Cm">@</code></a></dt>
245 <dd>Toggle between showing the committer name and the author name.</dd>
246 </dl>
247 <p class="Pp">The options for <code class="Cm">tog log</code> are as
248 follows:</p>
249 <dl class="Bl-tag">
250 <dt id="b"><a class="permalink" href="#b"><code class="Fl">-b</code></a></dt>
251 <dd>Display individual commits which were merged into the current branch
252 from other branches. By default, <code class="Cm">tog log</code> shows
253 the linear history of the current branch only. The
254 <code class="Cm">B</code> key binding can be used to toggle display of
255 merged commits at run-time.</dd>
256 <dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
257 <var class="Ar">commit</var></dt>
258 <dd>Start traversing history at the specified
259 <var class="Ar">commit</var>. The expected argument is a commit ID
260 SHA1 hash, or a reference name or keyword which will be resolved to a
261 commit ID. An abbreviated hash argument will be expanded to a full
262 SHA1 hash automatically, provided the abbreviation is unique. The
263 keywords &quot;:base&quot; and &quot;:head&quot; resolve to the work
264 tree's base commit and branch head, respectively. The former is only
265 valid if invoked in a work tree, while the latter will resolve to the
266 tip of the work tree's current branch if invoked in a work tree,
267 otherwise it will resolve to the repository's HEAD reference. Keywords
268 and references may be appended with &quot;:+&quot; or &quot;:-&quot;
269 modifiers and an optional integer N to denote the Nth descendant or
270 antecedent by first parent traversal, respectively; for example,
271 <b class="Sy">:head:-2</b> denotes the work tree branch head's 2nd
272 generation ancestor, and <b class="Sy">:base:+4</b> denotes the 4th
273 generation descendant of the work tree's base commit. Similarly,
274 <b class="Sy">foobar:+3</b> will denote the 3rd generation descendant
275 of the commit resolved by the &quot;foobar&quot; reference. A
276 &quot;:+&quot; or &quot;:-&quot; modifier without a trailing integer
277 has an implicit &quot;1&quot; appended (e.g.,
278 <b class="Sy">:base:+</b> is equivalent to
279 <b class="Sy">:base:+1</b>).</dd>
280 <dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a>
281 <var class="Ar">repository-path</var></dt>
282 <dd>Use the repository at the specified path. If not specified, assume the
283 repository is located at or above the current working directory. If
284 this directory is a <a class="Xr" aria-label="got, section
285 1">got(1)</a> work tree, use the repository path associated with this
286 work tree.</dd>
287 </dl>
288 </dd>
289 <dt id="diff"><a class="permalink" href="#diff"><code class="Cm">diff</code></a>
290 [<code class="Fl">-aw</code>] [<code class="Fl">-C</code>
291 <var class="Ar">number</var>] [<code class="Fl">-r</code>
292 <var class="Ar">repository-path</var>] <var class="Ar">object1</var>
293 <var class="Ar">object2</var></dt>
294 <dd>Display the differences between two objects in the repository. Treat each
295 of the two arguments as a reference, a tag name, an object ID SHA1 hash,
296 or a keyword and display differences between the corresponding objects.
297 Both objects must be of the same type (blobs, trees, or commits). An
298 abbreviated hash argument will be expanded to a full SHA1 hash
299 automatically, provided the abbreviation is unique. The keywords
300 &quot;:base&quot; and &quot;:head&quot; resolve to the work tree's base
301 commit and branch head, respectively. The former is only valid if invoked
302 in a work tree, while the latter will resolve to the tip of the work
303 tree's current branch if invoked in a work tree, otherwise it will resolve
304 to the repository's HEAD reference. Keywords and references may be
305 appended with &quot;:+&quot; or &quot;:-&quot; modifiers and an optional
306 integer N to denote the Nth descendant or antecedent by first parent
307 traversal, respectively; for example, <b class="Sy">:head:-2</b> denotes
308 the work tree branch head's 2nd generation ancestor, and
309 <b class="Sy">:base:+4</b> denotes the 4th generation descendant of the
310 work tree's base commit. Similarly, <b class="Sy">foobar:+3</b> will
311 denote the 3rd generation descendant of the commit resolved by the
312 &quot;foobar&quot; reference. A &quot;:+&quot; or &quot;:-&quot; modifier
313 without a trailing integer has an implicit &quot;1&quot; appended (e.g.,
314 <b class="Sy">:base:+</b> is equivalent to <b class="Sy">:base:+1</b>).
315 <p class="Pp">The key bindings for <code class="Cm">tog diff</code> are as
316 follows (N denotes optional prefixed count modifier):</p>
317 <dl class="Bl-tag">
318 <dt id="a"><a class="permalink" href="#a"><code class="Cm">a</code></a></dt>
319 <dd>Toggle treatment of file contents as ASCII text even if binary data
320 was detected.</dd>
321 <dt id="Down-arrow,~2"><a class="permalink" href="#Down-arrow,~2"><code class="Cm">Down-arrow,
322 j, Ctrl-n</code></a></dt>
323 <dd>Scroll down N lines (default: 1).</dd>
324 <dt id="Up-arrow,~2"><a class="permalink" href="#Up-arrow,~2"><code class="Cm">Up-arrow,
325 k, Ctrl-p</code></a></dt>
326 <dd>Scroll up N lines (default: 1).</dd>
327 <dt id="Page-down,~2"><a class="permalink" href="#Page-down,~2"><code class="Cm">Page-down,
328 Space, Ctrl+f, f</code></a></dt>
329 <dd>Scroll down N pages (default: 1).</dd>
330 <dt id="Page-up,~2"><a class="permalink" href="#Page-up,~2"><code class="Cm">Page-up,
331 Ctrl+b, b</code></a></dt>
332 <dd>Scroll up N pages (default: 1).</dd>
333 <dt id="Ctrl+d,~2"><a class="permalink" href="#Ctrl+d,~2"><code class="Cm">Ctrl+d,
334 d</code></a></dt>
335 <dd>Scroll down N half pages (default: 1).</dd>
336 <dt id="Ctrl+u,~2"><a class="permalink" href="#Ctrl+u,~2"><code class="Cm">Ctrl+u,
337 u</code></a></dt>
338 <dd>Scroll up N half pages (default: 1).</dd>
339 <dt id="Home"><a class="permalink" href="#Home"><code class="Cm">Home</code></a></dt>
340 <dd>Scroll to the top of the view.</dd>
341 <dt id="End"><a class="permalink" href="#End"><code class="Cm">End</code></a></dt>
342 <dd>Scroll to the bottom of the view.</dd>
343 <dt id="g~3"><a class="permalink" href="#g~3"><code class="Cm">g</code></a></dt>
344 <dd>Scroll to line N (default: 1).</dd>
345 <dt id="G~3"><a class="permalink" href="#G~3"><code class="Cm">G</code></a></dt>
346 <dd>Like <code class="Cm">g</code> but defaults to the last line in the
347 diff.</dd>
348 <dt id="("><a class="permalink" href="#("><code class="Cm">(</code></a></dt>
349 <dd>Navigate to the Nth previous file in the diff (default: 1).</dd>
350 <dt id=")"><a class="permalink" href="#)"><code class="Cm">)</code></a></dt>
351 <dd>Navigate to the Nth next file in the diff (default: 1).</dd>
352 <dt id="_"><a class="permalink" href="#_"><code class="Cm">{</code></a></dt>
353 <dd>Navigate to the Nth previous hunk in the diff (default: 1).</dd>
354 <dt id="_~2"><a class="permalink" href="#_~2"><code class="Cm">}</code></a></dt>
355 <dd>Navigate to the Nth next hunk in the diff (default: 1).</dd>
356 <dt id="_~3"><a class="permalink" href="#_~3"><code class="Cm">[</code></a></dt>
357 <dd>Reduce diff context by N lines (default: 1).</dd>
358 <dt id="_~4"><a class="permalink" href="#_~4"><code class="Cm">]</code></a></dt>
359 <dd>Increase diff context by N lines (default: 1).</dd>
360 <dt id="_,"><a class="permalink" href="#_,"><code class="Cm">&lt;, Comma,
361 K</code></a></dt>
362 <dd>If the <code class="Cm">diff</code> view was opened via the
363 <code class="Cm">log</code> view, move to the Nth previous (younger)
364 commit. If the diff was opened via the <code class="Cm">blame</code>
365 view, move to the Nth previous line and load the corresponding commit
366 (default: 1).</dd>
367 <dt id="_,~2"><a class="permalink" href="#_,~2"><code class="Cm">&gt;,
368 Full stop, J</code></a></dt>
369 <dd>If the <code class="Cm">diff</code> view was opened via the
370 <code class="Cm">log</code> view, move to the Nth next (older) commit.
371 If the diff was opened via the <code class="Cm">blame</code> view,
372 move to the Nth next line and load the corresponding commit (default:
373 1).</dd>
374 <dt id="/~2"><a class="permalink" href="#/~2"><code class="Cm">/</code></a></dt>
375 <dd>Prompt for a search pattern and start searching for matching lines.
376 The search pattern is an extended regular expression. Regular
377 expression syntax is documented in
378 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
379 <dt id="n~2"><a class="permalink" href="#n~2"><code class="Cm">n</code></a></dt>
380 <dd>Find the Nth next line which matches the current search pattern
381 (default: 1).</dd>
382 <dt id="N~2"><a class="permalink" href="#N~2"><code class="Cm">N</code></a></dt>
383 <dd>Find the Nth previous line which matches the current search pattern
384 (default: 1).</dd>
385 <dt id="w"><a class="permalink" href="#w"><code class="Cm">w</code></a></dt>
386 <dd>Toggle display of whitespace-only changes.</dd>
387 <dt id="A"><a class="permalink" href="#A"><code class="Cm">A</code></a></dt>
388 <dd>Change the diff algorithm. Supported diff algorithms are Myers (quick
389 and dirty) and Patience (slow and tidy). This is a global setting
390 which also affects the <code class="Cm">blame</code> view.</dd>
391 </dl>
392 <p class="Pp">The options for <code class="Cm">tog diff</code> are as
393 follows:</p>
394 <dl class="Bl-tag">
395 <dt id="a~2"><a class="permalink" href="#a~2"><code class="Fl">-a</code></a></dt>
396 <dd>Treat file contents as ASCII text even if binary data is
397 detected.</dd>
398 <dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a>
399 <var class="Ar">number</var></dt>
400 <dd>Set the number of context lines shown in the diff. By default, 3 lines
401 of context are shown.</dd>
402 <dt id="r~2"><a class="permalink" href="#r~2"><code class="Fl">-r</code></a>
403 <var class="Ar">repository-path</var></dt>
404 <dd>Use the repository at the specified path. If not specified, assume the
405 repository is located at or above the current working directory. If
406 this directory is a <a class="Xr" aria-label="got, section
407 1">got(1)</a> work tree, use the repository path associated with this
408 work tree.</dd>
409 <dt id="w~2"><a class="permalink" href="#w~2"><code class="Fl">-w</code></a></dt>
410 <dd>Ignore whitespace-only changes.</dd>
411 </dl>
412 </dd>
413 <dt id="blame"><a class="permalink" href="#blame"><code class="Cm">blame</code></a>
414 [<code class="Fl">-c</code> <var class="Ar">commit</var>]
415 [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
416 <var class="Ar">path</var></dt>
417 <dd>Display line-by-line history of a file at the specified path.
418 <p class="Pp">The key bindings for <code class="Cm">tog blame</code> are as
419 follows (N denotes optional prefixed count modifier):</p>
420 <dl class="Bl-tag">
421 <dt id="Down-arrow,~3"><a class="permalink" href="#Down-arrow,~3"><code class="Cm">Down-arrow,
422 j, Ctrl-n</code></a></dt>
423 <dd>Move the selection cursor down N pages (default: 1).</dd>
424 <dt id="Up-arrow,~3"><a class="permalink" href="#Up-arrow,~3"><code class="Cm">Up-arrow,
425 k, Ctrl-p</code></a></dt>
426 <dd>Move the selection cursor up N pages (default: 1).</dd>
427 <dt id="Page-down,~3"><a class="permalink" href="#Page-down,~3"><code class="Cm">Page-down,
428 Space, Ctrl+f, f</code></a></dt>
429 <dd>Move the selection cursor down N pages (default: 1).</dd>
430 <dt id="Page-up,~3"><a class="permalink" href="#Page-up,~3"><code class="Cm">Page-up,
431 Ctrl+b, b</code></a></dt>
432 <dd>Move the selection cursor up N pages (default: 1).</dd>
433 <dt id="Ctrl+d,~3"><a class="permalink" href="#Ctrl+d,~3"><code class="Cm">Ctrl+d,
434 d</code></a></dt>
435 <dd>Move the selection cursor down N half pages (default: 1).</dd>
436 <dt id="Ctrl+u,~3"><a class="permalink" href="#Ctrl+u,~3"><code class="Cm">Ctrl+u,
437 u</code></a></dt>
438 <dd>Move the selection cursor up N half pages (default: 1).</dd>
439 <dt id="Home~2"><a class="permalink" href="#Home~2"><code class="Cm">Home</code></a></dt>
440 <dd>Move the selection cursor to the first line of the file.</dd>
441 <dt id="End~2"><a class="permalink" href="#End~2"><code class="Cm">End</code></a></dt>
442 <dd>Move the selection cursor to the last line of the file.</dd>
443 <dt id="g~4"><a class="permalink" href="#g~4"><code class="Cm">g</code></a></dt>
444 <dd>Move the selection cursor to line N (default: 1).</dd>
445 <dt id="G~4"><a class="permalink" href="#G~4"><code class="Cm">G</code></a></dt>
446 <dd>Like <code class="Cm">g</code> but defaults to the last line in the
447 file.</dd>
448 <dt id="Enter~2"><a class="permalink" href="#Enter~2"><code class="Cm">Enter</code></a></dt>
449 <dd>Open a <code class="Cm">diff</code> view for the currently selected
450 line's commit.</dd>
451 <dt id="c~2"><a class="permalink" href="#c~2"><code class="Cm">c</code></a></dt>
452 <dd>Reload the <code class="Cm">blame</code> view with the version of the
453 file as found in the currently selected line's commit.</dd>
454 <dt id="p"><a class="permalink" href="#p"><code class="Cm">p</code></a></dt>
455 <dd>Reload the <code class="Cm">blame</code> view with the version of the
456 file as found in the parent commit of the currently selected line's
457 commit.</dd>
458 <dt id="C~2"><a class="permalink" href="#C~2"><code class="Cm">C</code></a></dt>
459 <dd>Reload the <code class="Cm">blame</code> view with the previously
460 blamed commit.</dd>
461 <dt id="L"><a class="permalink" href="#L"><code class="Cm">L</code></a></dt>
462 <dd>Open a <code class="Cm">log</code> view for the currently selected
463 annotated line.</dd>
464 <dt id="/~3"><a class="permalink" href="#/~3"><code class="Cm">/</code></a></dt>
465 <dd>Prompt for a search pattern and start searching for matching lines.
466 The search pattern is an extended regular expression. Regular
467 expression syntax is documented in
468 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
469 <dt id="n~3"><a class="permalink" href="#n~3"><code class="Cm">n</code></a></dt>
470 <dd>Find the Nth next line which matches the current search pattern
471 (default: 1).</dd>
472 <dt id="N~3"><a class="permalink" href="#N~3"><code class="Cm">N</code></a></dt>
473 <dd>Find the Nth previous line which matches the current search pattern
474 (default: 1).</dd>
475 <dt id="A~2"><a class="permalink" href="#A~2"><code class="Cm">A</code></a></dt>
476 <dd>Change the diff algorithm. Supported diff algorithms are Myers (quick
477 and dirty) and Patience (slow and tidy). This is a global setting
478 which also affects the <code class="Cm">diff</code> view.</dd>
479 </dl>
480 <p class="Pp">The options for <code class="Cm">tog blame</code> are as
481 follows:</p>
482 <dl class="Bl-tag">
483 <dt id="c~3"><a class="permalink" href="#c~3"><code class="Fl">-c</code></a>
484 <var class="Ar">commit</var></dt>
485 <dd>Start traversing history at the specified
486 <var class="Ar">commit</var>. The expected argument is a commit ID
487 SHA1 hash, or a reference name or keyword which will be resolved to a
488 commit ID. An abbreviated hash argument will be expanded to a full
489 SHA1 hash automatically, provided the abbreviation is unique. The
490 keywords &quot;:base&quot; and &quot;:head&quot; resolve to the work
491 tree's base commit and branch head, respectively. The former is only
492 valid if invoked in a work tree, while the latter will resolve to the
493 tip of the work tree's current branch if invoked in a work tree,
494 otherwise it will resolve to the repository's HEAD reference. Keywords
495 and references may be appended with &quot;:+&quot; or &quot;:-&quot;
496 modifiers and an optional integer N to denote the Nth descendant or
497 antecedent by first parent traversal, respectively; for example,
498 <b class="Sy">:head:-2</b> denotes the work tree branch head's 2nd
499 generation ancestor, and <b class="Sy">:base:+4</b> denotes the 4th
500 generation descendant of the work tree's base commit. Similarly,
501 <b class="Sy">foobar:+3</b> will denote the 3rd generation descendant
502 of the commit resolved by the &quot;foobar&quot; reference. A
503 &quot;:+&quot; or &quot;:-&quot; modifier without a trailing integer
504 has an implicit &quot;1&quot; appended (e.g.,
505 <b class="Sy">:base:+</b> is equivalent to
506 <b class="Sy">:base:+1</b>).</dd>
507 <dt id="r~3"><a class="permalink" href="#r~3"><code class="Fl">-r</code></a>
508 <var class="Ar">repository-path</var></dt>
509 <dd>Use the repository at the specified path. If not specified, assume the
510 repository is located at or above the current working directory. If
511 this directory is a <a class="Xr" aria-label="got, section
512 1">got(1)</a> work tree, use the repository path associated with this
513 work tree.</dd>
514 </dl>
515 </dd>
516 <dt id="tree"><a class="permalink" href="#tree"><code class="Cm">tree</code></a>
517 [<code class="Fl">-c</code> <var class="Ar">commit</var>]
518 [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
519 [<var class="Ar">path</var>]</dt>
520 <dd>Display the repository tree. If a <var class="Ar">path</var> is specified,
521 show tree entries at this path.
522 <p class="Pp">Displayed tree entries may carry one of the following trailing
523 annotations:</p>
524 <table class="Bl-column">
525 <tr>
526 <td>@</td>
527 <td>entry is a symbolic link</td>
528 </tr>
529 <tr>
530 <td>/</td>
531 <td>entry is a directory</td>
532 </tr>
533 <tr>
534 <td>*</td>
535 <td>entry is an executable file</td>
536 </tr>
537 <tr>
538 <td>$</td>
539 <td>entry is a Git submodule</td>
540 </tr>
541 </table>
542 <p class="Pp">Symbolic link entries are also annotated with the target path
543 of the link.</p>
544 <p class="Pp">The key bindings for <code class="Cm">tog tree</code> are as
545 follows (N denotes optional prefixed count modifier):</p>
546 <dl class="Bl-tag">
547 <dt id="Down-arrow,~4"><a class="permalink" href="#Down-arrow,~4"><code class="Cm">Down-arrow,
548 j, Ctrl-n</code></a></dt>
549 <dd>Move the selection cursor down N lines (default: 1).</dd>
550 <dt id="Up-arrow,~4"><a class="permalink" href="#Up-arrow,~4"><code class="Cm">Up-arrow,
551 k, Ctrl-p</code></a></dt>
552 <dd>Move the selection cursor up N lines (default: 1).</dd>
553 <dt id="Page-down,~4"><a class="permalink" href="#Page-down,~4"><code class="Cm">Page-down,
554 Space, Ctrl+f, f</code></a></dt>
555 <dd>Move the selection cursor down N pages (default: 1).</dd>
556 <dt id="Page-up,~4"><a class="permalink" href="#Page-up,~4"><code class="Cm">Page-up,
557 Ctrl+b, b</code></a></dt>
558 <dd>Move the selection cursor up N pages (default: 1).</dd>
559 <dt id="Ctrl+d,~4"><a class="permalink" href="#Ctrl+d,~4"><code class="Cm">Ctrl+d,
560 d</code></a></dt>
561 <dd>Move the selection cursor down N half pages (default: 1).</dd>
562 <dt id="Ctrl+u,~4"><a class="permalink" href="#Ctrl+u,~4"><code class="Cm">Ctrl+u,
563 u</code></a></dt>
564 <dd>Move the selection cursor up N half pages (default: 1).</dd>
565 <dt id="Home,~2"><a class="permalink" href="#Home,~2"><code class="Cm">Home,
566 =</code></a></dt>
567 <dd>Move the selection cursor to the first entry.</dd>
568 <dt id="End,~2"><a class="permalink" href="#End,~2"><code class="Cm">End,
569 *</code></a></dt>
570 <dd>Move the selection cursor to the last entry.</dd>
571 <dt id="g~5"><a class="permalink" href="#g~5"><code class="Cm">g</code></a></dt>
572 <dd>Move the selection cursor to entry N (default: 1).</dd>
573 <dt id="G~5"><a class="permalink" href="#G~5"><code class="Cm">G</code></a></dt>
574 <dd>Like <code class="Cm">g</code> but defaults to the last entry.</dd>
575 <dt id="Enter~3"><a class="permalink" href="#Enter~3"><code class="Cm">Enter</code></a></dt>
576 <dd>Enter the currently selected directory, or switch to the
577 <code class="Cm">blame</code> view for the currently selected
578 file.</dd>
579 <dt id="L~2"><a class="permalink" href="#L~2"><code class="Cm">L</code></a></dt>
580 <dd>Open a <code class="Cm">log</code> view for the currently selected
581 tree entry.</dd>
582 <dt id="R~2"><a class="permalink" href="#R~2"><code class="Cm">R</code></a></dt>
583 <dd>Open a <code class="Cm">ref</code> view listing all references in the
584 repository. This can then be used to open a new
585 <code class="Cm">tree</code> view for arbitrary branches and
586 tags.</dd>
587 <dt id="Backspace~2"><a class="permalink" href="#Backspace~2"><code class="Cm">Backspace</code></a></dt>
588 <dd>Move back to the Nth parent directory (default: 1).</dd>
589 <dt id="i"><a class="permalink" href="#i"><code class="Cm">i</code></a></dt>
590 <dd>Show object IDs for all objects displayed in the
591 <code class="Cm">tree</code> view.</dd>
592 <dt id="/~4"><a class="permalink" href="#/~4"><code class="Cm">/</code></a></dt>
593 <dd>Prompt for a search pattern and start searching for matching tree
594 entries. The search pattern is an extended regular expression which is
595 matched against the tree entry's name. Regular expression syntax is
596 documented in <a class="Xr" aria-label="re_format, section
597 7">re_format(7)</a>.</dd>
598 <dt id="n~4"><a class="permalink" href="#n~4"><code class="Cm">n</code></a></dt>
599 <dd>Find the Nth next tree entry which matches the current search pattern
600 (default: 1).</dd>
601 <dt id="N~4"><a class="permalink" href="#N~4"><code class="Cm">N</code></a></dt>
602 <dd>Find the Nth previous tree entry which matches the current search
603 pattern (default: 1).</dd>
604 </dl>
605 <p class="Pp">The options for <code class="Cm">tog tree</code> are as
606 follows:</p>
607 <dl class="Bl-tag">
608 <dt id="c~4"><a class="permalink" href="#c~4"><code class="Fl">-c</code></a>
609 <var class="Ar">commit</var></dt>
610 <dd>Start traversing history at the specified
611 <var class="Ar">commit</var>. The expected argument is a commit ID
612 SHA1 hash, or a reference name or keyword which will be resolved to a
613 commit ID. An abbreviated hash argument will be expanded to a full
614 SHA1 hash automatically, provided the abbreviation is unique. The
615 keywords &quot;:base&quot; and &quot;:head&quot; resolve to the work
616 tree's base commit and branch head, respectively. The former is only
617 valid if invoked in a work tree, while the latter will resolve to the
618 tip of the work tree's current branch if invoked in a work tree,
619 otherwise it will resolve to the repository's HEAD reference. Keywords
620 and references may be appended with &quot;:+&quot; or &quot;:-&quot;
621 modifiers and an optional integer N to denote the Nth descendant or
622 antecedent by first parent traversal, respectively; for example,
623 <b class="Sy">:head:-2</b> denotes the work tree branch head's 2nd
624 generation ancestor, and <b class="Sy">:base:+4</b> denotes the 4th
625 generation descendant of the work tree's base commit. Similarly,
626 <b class="Sy">foobar:+3</b> will denote the 3rd generation descendant
627 of the commit resolved by the &quot;foobar&quot; reference. A
628 &quot;:+&quot; or &quot;:-&quot; modifier without a trailing integer
629 has an implicit &quot;1&quot; appended (e.g.,
630 <b class="Sy">:base:+</b> is equivalent to
631 <b class="Sy">:base:+1</b>).</dd>
632 <dt id="r~4"><a class="permalink" href="#r~4"><code class="Fl">-r</code></a>
633 <var class="Ar">repository-path</var></dt>
634 <dd>Use the repository at the specified path. If not specified, assume the
635 repository is located at or above the current working directory. If
636 this directory is a <a class="Xr" aria-label="got, section
637 1">got(1)</a> work tree, use the repository path associated with this
638 work tree.</dd>
639 </dl>
640 </dd>
641 <dt id="ref"><a class="permalink" href="#ref"><code class="Cm">ref</code></a>
642 [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]</dt>
643 <dd>Display references in the repository.
644 <p class="Pp">The key bindings for <code class="Cm">tog ref</code> are as
645 follows (N denotes optional prefixed count modifier):</p>
646 <dl class="Bl-tag">
647 <dt id="Down-arrow,~5"><a class="permalink" href="#Down-arrow,~5"><code class="Cm">Down-arrow,
648 j, Ctrl-n</code></a></dt>
649 <dd>Move the selection cursor down N lines (default: 1).</dd>
650 <dt id="Up-arrow,~5"><a class="permalink" href="#Up-arrow,~5"><code class="Cm">Up-arrow,
651 k, Ctrl-p</code></a></dt>
652 <dd>Move the selection cursor up N lines (default: 1).</dd>
653 <dt id="Page-down,~5"><a class="permalink" href="#Page-down,~5"><code class="Cm">Page-down,
654 Space, Ctrl+f, f</code></a></dt>
655 <dd>Move the selection cursor down N pages (default: 1).</dd>
656 <dt id="Page-up,~5"><a class="permalink" href="#Page-up,~5"><code class="Cm">Page-up,
657 Ctrl+b, b</code></a></dt>
658 <dd>Move the selection cursor up N pages (default: 1).</dd>
659 <dt id="Ctrl+d,~5"><a class="permalink" href="#Ctrl+d,~5"><code class="Cm">Ctrl+d,
660 d</code></a></dt>
661 <dd>Move the selection cursor down N half pages (default: 1).</dd>
662 <dt id="Ctrl+u,~5"><a class="permalink" href="#Ctrl+u,~5"><code class="Cm">Ctrl+u,
663 u</code></a></dt>
664 <dd>Move the selection cursor up N half pages (default: 1).</dd>
665 <dt id="Home,~3"><a class="permalink" href="#Home,~3"><code class="Cm">Home,
666 =</code></a></dt>
667 <dd>Move the selection cursor to the first reference.</dd>
668 <dt id="End,~3"><a class="permalink" href="#End,~3"><code class="Cm">End,
669 *</code></a></dt>
670 <dd>Move the selection cursor to the last reference.</dd>
671 <dt id="g~6"><a class="permalink" href="#g~6"><code class="Cm">g</code></a></dt>
672 <dd>Move the selection cursor to reference N (default: 1).</dd>
673 <dt id="G~6"><a class="permalink" href="#G~6"><code class="Cm">G</code></a></dt>
674 <dd>Like <code class="Cm">g</code> but defaults to the last
675 reference.</dd>
676 <dt id="Enter~4"><a class="permalink" href="#Enter~4"><code class="Cm">Enter</code></a></dt>
677 <dd>Open a <code class="Cm">log</code> view which begins traversing
678 history at the commit resolved via the currently selected
679 reference.</dd>
680 <dt id="T~2"><a class="permalink" href="#T~2"><code class="Cm">T</code></a></dt>
681 <dd>Open a <code class="Cm">tree</code> view showing the tree resolved via
682 the currently selected reference.</dd>
683 <dt id="i~2"><a class="permalink" href="#i~2"><code class="Cm">i</code></a></dt>
684 <dd>Show object IDs for all non-symbolic references displayed in the
685 <code class="Cm">ref</code> view.</dd>
686 <dt id="m"><a class="permalink" href="#m"><code class="Cm">m</code></a></dt>
687 <dd>Show last modified date of each displayed reference.</dd>
688 <dt id="o"><a class="permalink" href="#o"><code class="Cm">o</code></a></dt>
689 <dd>Toggle display order of references between sort by name and sort by
690 timestamp.</dd>
691 <dt id="/~5"><a class="permalink" href="#/~5"><code class="Cm">/</code></a></dt>
692 <dd>Prompt for a search pattern and start searching for matching
693 references. The search pattern is an extended regular expression which
694 is matched against absolute reference names. Regular expression syntax
695 is documented in <a class="Xr" aria-label="re_format, section
696 7">re_format(7)</a>.</dd>
697 <dt id="n~5"><a class="permalink" href="#n~5"><code class="Cm">n</code></a></dt>
698 <dd>Find the Nth next reference which matches the current search pattern
699 (default: 1).</dd>
700 <dt id="N~5"><a class="permalink" href="#N~5"><code class="Cm">N</code></a></dt>
701 <dd>Find the Nth previous reference which matches the current search
702 pattern (default: 1).</dd>
703 <dt id="Ctrl+l~2"><a class="permalink" href="#Ctrl+l~2"><code class="Cm">Ctrl+l</code></a></dt>
704 <dd>Reload the list of references displayed by the
705 <code class="Cm">ref</code> view.</dd>
706 </dl>
707 <p class="Pp">The options for <code class="Cm">tog ref</code> are as
708 follows:</p>
709 <dl class="Bl-tag">
710 <dt id="r~5"><a class="permalink" href="#r~5"><code class="Fl">-r</code></a>
711 <var class="Ar">repository-path</var></dt>
712 <dd>Use the repository at the specified path. If not specified, assume the
713 repository is located at or above the current working directory. If
714 this directory is a <a class="Xr" aria-label="got, section
715 1">got(1)</a> work tree, use the repository path associated with this
716 work tree.</dd>
717 </dl>
718 </dd>
719 </dl>
720 </section>
721 <section class="Sh">
722 <h2 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h2>
723 <dl class="Bl-tag">
724 <dt id="TOG_COLORS"><a class="permalink" href="#TOG_COLORS"><code class="Ev">TOG_COLORS</code></a></dt>
725 <dd><code class="Nm">tog</code> shows colorized output if this variable is set
726 to a non-empty value. The default color scheme can be modified by setting
727 the environment variables documented below. The colors available in color
728 schemes are &#x201C;black&#x201D;, &#x201C;red&#x201D;,
729 &#x201C;green&#x201D;, &#x201C;yellow&#x201D;, &#x201C;blue&#x201D;,
730 &#x201C;magenta&#x201D;, &#x201C;cyan&#x201D;, and &#x201C;default&#x201D;
731 which maps to the terminal's default foreground color.</dd>
732 <dt id="TOG_COLOR_AUTHOR"><a class="permalink" href="#TOG_COLOR_AUTHOR"><code class="Ev">TOG_COLOR_AUTHOR</code></a></dt>
733 <dd>The color used to mark up author information. If not set, the default
734 value &#x201C;cyan&#x201D; is used.</dd>
735 <dt id="TOG_COLOR_COMMIT"><a class="permalink" href="#TOG_COLOR_COMMIT"><code class="Ev">TOG_COLOR_COMMIT</code></a></dt>
736 <dd>The color used to mark up commit IDs. If not set, the default value
737 &#x201C;green&#x201D; is used.</dd>
738 <dt id="TOG_COLOR_DATE"><a class="permalink" href="#TOG_COLOR_DATE"><code class="Ev">TOG_COLOR_DATE</code></a></dt>
739 <dd>The color used to mark up date information. If not set, the default value
740 &#x201C;yellow&#x201D; is used.</dd>
741 <dt id="TOG_COLOR_DIFF_CHUNK_HEADER"><a class="permalink" href="#TOG_COLOR_DIFF_CHUNK_HEADER"><code class="Ev">TOG_COLOR_DIFF_CHUNK_HEADER</code></a></dt>
742 <dd>The color used to mark up chunk header lines in diffs. If not set, the
743 default value &#x201C;yellow&#x201D; is used.</dd>
744 <dt id="TOG_COLOR_DIFF_META"><a class="permalink" href="#TOG_COLOR_DIFF_META"><code class="Ev">TOG_COLOR_DIFF_META</code></a></dt>
745 <dd>The color used to mark up meta data in diffs. If not set, the default
746 value &#x201C;green&#x201D; is used.</dd>
747 <dt id="TOG_COLOR_DIFF_MINUS"><a class="permalink" href="#TOG_COLOR_DIFF_MINUS"><code class="Ev">TOG_COLOR_DIFF_MINUS</code></a></dt>
748 <dd>The color used to mark up removed lines in diffs. If not set, the default
749 value &#x201C;magenta&#x201D; is used.</dd>
750 <dt id="TOG_COLOR_DIFF_PLUS"><a class="permalink" href="#TOG_COLOR_DIFF_PLUS"><code class="Ev">TOG_COLOR_DIFF_PLUS</code></a></dt>
751 <dd>The color used to mark up added lines in diffs. If not set, the default
752 value &#x201C;cyan&#x201D; is used.</dd>
753 <dt id="TOG_COLOR_REFS_BACKUP"><a class="permalink" href="#TOG_COLOR_REFS_BACKUP"><code class="Ev">TOG_COLOR_REFS_BACKUP</code></a></dt>
754 <dd>The color used to mark up references in the
755 &#x201C;refs/got/backup/&#x201D; namespace. If not set, the default value
756 &#x201C;cyan&#x201D; is used.</dd>
757 <dt id="TOG_COLOR_REFS_HEADS"><a class="permalink" href="#TOG_COLOR_REFS_HEADS"><code class="Ev">TOG_COLOR_REFS_HEADS</code></a></dt>
758 <dd>The color used to mark up references in the &#x201C;refs/heads/&#x201D;
759 namespace. If not set, the default value &#x201C;green&#x201D; is
760 used.</dd>
761 <dt id="TOG_COLOR_REFS_REMOTES"><a class="permalink" href="#TOG_COLOR_REFS_REMOTES"><code class="Ev">TOG_COLOR_REFS_REMOTES</code></a></dt>
762 <dd>The color used to mark up references in the &#x201C;refs/remotes/&#x201D;
763 namespace. If not set, the default value &#x201C;yellow&#x201D; is
764 used.</dd>
765 <dt id="TOG_COLOR_REFS_TAGS"><a class="permalink" href="#TOG_COLOR_REFS_TAGS"><code class="Ev">TOG_COLOR_REFS_TAGS</code></a></dt>
766 <dd>The color used to mark up references in the &#x201C;refs/tags/&#x201D;
767 namespace. If not set, the default value &#x201C;magenta&#x201D; is
768 used.</dd>
769 <dt id="TOG_COLOR_TREE_DIRECTORY"><a class="permalink" href="#TOG_COLOR_TREE_DIRECTORY"><code class="Ev">TOG_COLOR_TREE_DIRECTORY</code></a></dt>
770 <dd>The color used to mark up directory tree entries. If not set, the default
771 value &#x201C;cyan&#x201D; is used.</dd>
772 <dt id="TOG_COLOR_TREE_EXECUTABLE"><a class="permalink" href="#TOG_COLOR_TREE_EXECUTABLE"><code class="Ev">TOG_COLOR_TREE_EXECUTABLE</code></a></dt>
773 <dd>The color used to mark up executable file tree entries. If not set, the
774 default value &#x201C;green&#x201D; is used.</dd>
775 <dt id="TOG_COLOR_TREE_SUBMODULE"><a class="permalink" href="#TOG_COLOR_TREE_SUBMODULE"><code class="Ev">TOG_COLOR_TREE_SUBMODULE</code></a></dt>
776 <dd>The color used to mark up submodule tree entries. If not set, the default
777 value &#x201C;magenta&#x201D; is used.</dd>
778 <dt id="TOG_COLOR_TREE_SYMLINK"><a class="permalink" href="#TOG_COLOR_TREE_SYMLINK"><code class="Ev">TOG_COLOR_TREE_SYMLINK</code></a></dt>
779 <dd>The color used to mark up symbolic link tree entries. If not set, the
780 default value &#x201C;magenta&#x201D; is used.</dd>
781 <dt id="TOG_DIFF_ALGORITHM"><a class="permalink" href="#TOG_DIFF_ALGORITHM"><code class="Ev">TOG_DIFF_ALGORITHM</code></a></dt>
782 <dd>Determines the default diff algorithm used by <code class="Nm">tog</code>.
783 Supported diff algorithms are Myers (quick and dirty) and Patience (slow
784 and tidy). Valid values for <code class="Ev">TOG_DIFF_ALGORITHM</code> are
785 &#x201C;patience&#x201D; and &#x201C;myers&#x201D;. If unset, the Myers
786 diff algorithm will be used by default.</dd>
787 <dt id="TOG_VIEW_SPLIT_MODE"><a class="permalink" href="#TOG_VIEW_SPLIT_MODE"><code class="Ev">TOG_VIEW_SPLIT_MODE</code></a></dt>
788 <dd>Determines the default layout of split-screen views. If set to
789 &#x201C;h&#x201D; or &#x201C;H&#x201D;, <code class="Nm">tog</code> will
790 use horizontal split by default. Otherwise, vertical split will be used.
791 The <code class="Cm">S</code> key can be used to switch between vertical
792 and horizontal split layout at run-time.</dd>
793 </dl>
794 </section>
795 <section class="Sh">
796 <h2 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
797 STATUS</a></h2>
798 <p class="Pp">The <code class="Nm">tog</code> utility exits&#x00A0;0 on success,
799 and&#x00A0;&gt;0 if an error occurs.</p>
800 </section>
801 <section class="Sh">
802 <h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
803 ALSO</a></h2>
804 <p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
805 <a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
806 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a></p>
807 </section>
808 <section class="Sh">
809 <h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
810 <p class="Pp"><span class="An">Christian Weisgerber</span>
811 &lt;<a class="Mt" href="mailto:naddy@openbsd.org">naddy@openbsd.org</a>&gt;
812 <br/>
813 <span class="An">Josh Rickmar</span>
814 &lt;<a class="Mt" href="mailto:jrick@zettaport.com">jrick@zettaport.com</a>&gt;
815 <br/>
816 <span class="An">Joshua Stein</span>
817 &lt;<a class="Mt" href="mailto:jcs@openbsd.org">jcs@openbsd.org</a>&gt;
818 <br/>
819 <span class="An">Mark Jamsek</span>
820 &lt;<a class="Mt" href="mailto:mark@jamsek.dev">mark@jamsek.dev</a>&gt;
821 <br/>
822 <span class="An">Martin Pieuchot</span>
823 &lt;<a class="Mt" href="mailto:mpi@openbsd.org">mpi@openbsd.org</a>&gt;
824 <br/>
825 <span class="An">Omar Polo</span>
826 &lt;<a class="Mt" href="mailto:op@openbsd.org">op@openbsd.org</a>&gt;
827 <br/>
828 <span class="An">Stefan Sperling</span>
829 &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;
830 <br/>
831 <span class="An">Klemens Nanni</span>
832 &lt;<a class="Mt" href="mailto:kn@openbsd.org">kn@openbsd.org</a>&gt;</p>
833 </section>
834 </main>
835 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
836 line"><span class="foot-left"></span><span class="foot-date">July 19,
837 2023</span> <span class="foot-os">OpenBSD 7.3</span></div>
838 </body>
839 </html>