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">If invoked in a work tree, the log entry of the work tree's
153 base commit will be prefixed with one of the following annotations:</p>
154 <table class="Bl-column">
155 <tr>
156 <td>*</td>
157 <td>work tree's base commit and the base commit of all tracked files
158 matches the branch tip</td>
159 </tr>
160 <tr>
161 <td>~</td>
162 <td>work tree comprises mixed commits or its base commit is
163 out-of-date</td>
164 </tr>
165 </table>
166 <p class="Pp">This command is also executed if no explicit command is
167 specified.</p>
168 <p class="Pp">The key bindings for <code class="Cm">tog log</code> are as
169 follows (N denotes optional prefixed count modifier):</p>
170 <dl class="Bl-tag">
171 <dt id="Down-arrow,"><a class="permalink" href="#Down-arrow,"><code class="Cm">Down-arrow,
172 j, &gt;, Full stop, Ctrl-n</code></a></dt>
173 <dd>Move the selection cursor down N lines (default: 1).</dd>
174 <dt id="Up-arrow,"><a class="permalink" href="#Up-arrow,"><code class="Cm">Up-arrow,
175 k, &lt;, Comma, Ctrl-p</code></a></dt>
176 <dd>Move the selection cursor up N lines (default: 1).</dd>
177 <dt id="Page-down,"><a class="permalink" href="#Page-down,"><code class="Cm">Page-down,
178 Space, Ctrl+f, f</code></a></dt>
179 <dd>Move the selection cursor down N pages (default: 1).</dd>
180 <dt id="Page-up,"><a class="permalink" href="#Page-up,"><code class="Cm">Page-up,
181 Ctrl+b, b</code></a></dt>
182 <dd>Move the selection cursor up N pages (default: 1).</dd>
183 <dt id="Ctrl+d,"><a class="permalink" href="#Ctrl+d,"><code class="Cm">Ctrl+d,
184 d</code></a></dt>
185 <dd>Move the selection cursor down N half pages (default: 1).</dd>
186 <dt id="Ctrl+u,"><a class="permalink" href="#Ctrl+u,"><code class="Cm">Ctrl+u,
187 u</code></a></dt>
188 <dd>Move the selection cursor up N half pages (default: 1).</dd>
189 <dt id="Home,"><a class="permalink" href="#Home,"><code class="Cm">Home,
190 =</code></a></dt>
191 <dd>Move the cursor to the newest commit.</dd>
192 <dt id="End,"><a class="permalink" href="#End,"><code class="Cm">End,
193 *</code></a></dt>
194 <dd>Move the cursor to the oldest commit. This will traverse all commits
195 on the current branch which may take a long time depending on the
196 number of commits in branch history. If needed, this operation can be
197 cancelled with <code class="Cm">C-g</code> or
198 <code class="Cm">Backspace</code>.</dd>
199 <dt id="g~2"><a class="permalink" href="#g~2"><code class="Cm">g</code></a></dt>
200 <dd>Move the cursor to commit N (default: 1).</dd>
201 <dt id="G~2"><a class="permalink" href="#G~2"><code class="Cm">G</code></a></dt>
202 <dd>Like <code class="Cm">g</code> but defaults to the oldest commit.</dd>
203 <dt id="Enter"><a class="permalink" href="#Enter"><code class="Cm">Enter</code></a></dt>
204 <dd>Open a <code class="Cm">diff</code> view showing file changes made in
205 the currently selected commit.</dd>
206 <dt id="T"><a class="permalink" href="#T"><code class="Cm">T</code></a></dt>
207 <dd>Open a <code class="Cm">tree</code> view showing the tree for the
208 currently selected commit.</dd>
209 <dt id="Backspace"><a class="permalink" href="#Backspace"><code class="Cm">Backspace</code></a></dt>
210 <dd>Show log entries for the parent directory of the currently selected
211 path. However when an active search is in progress or when additional
212 commits are loaded, <code class="Cm">Backspace</code> aborts the
213 running operation.</dd>
214 <dt id="/"><a class="permalink" href="#/"><code class="Cm">/</code></a></dt>
215 <dd>Prompt for a search pattern and start searching for matching commits.
216 The search pattern is an extended regular expression which is matched
217 against a commit's author name, committer name, log message, and
218 commit ID SHA1 hash. Regular expression syntax is documented in
219 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
220 <dt id="&amp;"><a class="permalink" href="#&amp;"><code class="Cm">&amp;</code></a></dt>
221 <dd>Prompt for a pattern and limit the log view's list of commits to those
222 which match the pattern. If no pattern is specified, i.e. the
223 <code class="Cm">&amp;</code> prompt is immediately closed with the
224 Enter key, then the pattern is cleared. Until the pattern is cleared,
225 the limited list of commits replaces the full list of commits for all
226 operations supported by the log view. For example, a search started
227 with <code class="Cm">/</code> will search the limited list of
228 commits, rather than searching all commits. The pattern is an extended
229 regular expression which is matched against a commit's author name,
230 committer name, log message, and commit ID SHA1 hash. Regular
231 expression syntax is documented in
232 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
233 <dt id="n"><a class="permalink" href="#n"><code class="Cm">n</code></a></dt>
234 <dd>Find the Nth next commit which matches the current search pattern
235 (default: 1).
236 <br/>
237 Searching continues until either a match is found or
238 <code class="Cm">C-g</code> or the <code class="Cm">Backspace</code>
239 key is pressed.</dd>
240 <dt id="N"><a class="permalink" href="#N"><code class="Cm">N</code></a></dt>
241 <dd>Find the Nth previous commit which matches the current search pattern
242 (default: 1).
243 <br/>
244 Searching continues until either a match is found or
245 <code class="Cm">C-g</code> or the <code class="Cm">Backspace</code>
246 key is pressed.</dd>
247 <dt id="Ctrl+l"><a class="permalink" href="#Ctrl+l"><code class="Cm">Ctrl+l</code></a></dt>
248 <dd>Reload the <code class="Cm">log</code> view with new commits found in
249 the repository.</dd>
250 <dt id="B"><a class="permalink" href="#B"><code class="Cm">B</code></a></dt>
251 <dd>Reload the <code class="Cm">log</code> view and toggle display of
252 merged commits. The <code class="Fl">-b</code> option determines
253 whether merged commits are displayed initially.</dd>
254 <dt id="R"><a class="permalink" href="#R"><code class="Cm">R</code></a></dt>
255 <dd>Open a <code class="Cm">ref</code> view listing all references in the
256 repository. This can then be used to open a new
257 <code class="Cm">log</code> view for arbitrary branches and tags.</dd>
258 <dt id="@"><a class="permalink" href="#@"><code class="Cm">@</code></a></dt>
259 <dd>Toggle between showing the committer name and the author name.</dd>
260 </dl>
261 <p class="Pp">The options for <code class="Cm">tog log</code> are as
262 follows:</p>
263 <dl class="Bl-tag">
264 <dt id="b"><a class="permalink" href="#b"><code class="Fl">-b</code></a></dt>
265 <dd>Display individual commits which were merged into the current branch
266 from other branches. By default, <code class="Cm">tog log</code> shows
267 the linear history of the current branch only. The
268 <code class="Cm">B</code> key binding can be used to toggle display of
269 merged commits at run-time.</dd>
270 <dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
271 <var class="Ar">commit</var></dt>
272 <dd>Start traversing history at the specified
273 <var class="Ar">commit</var>. The expected argument is a commit ID
274 SHA1 hash, or a reference name or keyword which will be resolved to a
275 commit ID. An abbreviated hash argument will be expanded to a full
276 SHA1 hash automatically, provided the abbreviation is unique. The
277 keywords &quot;:base&quot; and &quot;:head&quot; resolve to the work
278 tree's base commit and branch head, respectively. The former is only
279 valid if invoked in a work tree, while the latter will resolve to the
280 tip of the work tree's current branch if invoked in a work tree,
281 otherwise it will resolve to the repository's HEAD reference. Keywords
282 and references may be appended with &quot;:+&quot; or &quot;:-&quot;
283 modifiers and an optional integer N to denote the Nth descendant or
284 antecedent by first parent traversal, respectively; for example,
285 <b class="Sy">:head:-2</b> denotes the work tree branch head's 2nd
286 generation ancestor, and <b class="Sy">:base:+4</b> denotes the 4th
287 generation descendant of the work tree's base commit. Similarly,
288 <b class="Sy">foobar:+3</b> will denote the 3rd generation descendant
289 of the commit resolved by the &quot;foobar&quot; reference. A
290 &quot;:+&quot; or &quot;:-&quot; modifier without a trailing integer
291 has an implicit &quot;1&quot; appended (e.g.,
292 <b class="Sy">:base:+</b> is equivalent to
293 <b class="Sy">:base:+1</b>).</dd>
294 <dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a>
295 <var class="Ar">repository-path</var></dt>
296 <dd>Use the repository at the specified path. If not specified, assume the
297 repository is located at or above the current working directory. If
298 this directory is a <a class="Xr" aria-label="got, section
299 1">got(1)</a> work tree, use the repository path associated with this
300 work tree.</dd>
301 </dl>
302 </dd>
303 <dt id="diff"><a class="permalink" href="#diff"><code class="Cm">diff</code></a>
304 [<code class="Fl">-aw</code>] [<code class="Fl">-C</code>
305 <var class="Ar">number</var>] [<code class="Fl">-r</code>
306 <var class="Ar">repository-path</var>] <var class="Ar">object1</var>
307 <var class="Ar">object2</var></dt>
308 <dd>Display the differences between two objects in the repository. Treat each
309 of the two arguments as a reference, a tag name, an object ID SHA1 hash,
310 or a keyword and display differences between the corresponding objects.
311 Both objects must be of the same type (blobs, trees, or commits). An
312 abbreviated hash argument will be expanded to a full SHA1 hash
313 automatically, provided the abbreviation is unique. The keywords
314 &quot;:base&quot; and &quot;:head&quot; resolve to the work tree's base
315 commit and branch head, respectively. The former is only valid if invoked
316 in a work tree, while the latter will resolve to the tip of the work
317 tree's current branch if invoked in a work tree, otherwise it will resolve
318 to the repository's HEAD reference. Keywords and references may be
319 appended with &quot;:+&quot; or &quot;:-&quot; modifiers and an optional
320 integer N to denote the Nth descendant or antecedent by first parent
321 traversal, respectively; for example, <b class="Sy">:head:-2</b> denotes
322 the work tree branch head's 2nd generation ancestor, and
323 <b class="Sy">:base:+4</b> denotes the 4th generation descendant of the
324 work tree's base commit. Similarly, <b class="Sy">foobar:+3</b> will
325 denote the 3rd generation descendant of the commit resolved by the
326 &quot;foobar&quot; reference. A &quot;:+&quot; or &quot;:-&quot; modifier
327 without a trailing integer has an implicit &quot;1&quot; appended (e.g.,
328 <b class="Sy">:base:+</b> is equivalent to <b class="Sy">:base:+1</b>).
329 <p class="Pp">The key bindings for <code class="Cm">tog diff</code> are as
330 follows (N denotes optional prefixed count modifier):</p>
331 <dl class="Bl-tag">
332 <dt id="a"><a class="permalink" href="#a"><code class="Cm">a</code></a></dt>
333 <dd>Toggle treatment of file contents as ASCII text even if binary data
334 was detected.</dd>
335 <dt id="Down-arrow,~2"><a class="permalink" href="#Down-arrow,~2"><code class="Cm">Down-arrow,
336 j, Ctrl-n</code></a></dt>
337 <dd>Scroll down N lines (default: 1).</dd>
338 <dt id="Up-arrow,~2"><a class="permalink" href="#Up-arrow,~2"><code class="Cm">Up-arrow,
339 k, Ctrl-p</code></a></dt>
340 <dd>Scroll up N lines (default: 1).</dd>
341 <dt id="Page-down,~2"><a class="permalink" href="#Page-down,~2"><code class="Cm">Page-down,
342 Space, Ctrl+f, f</code></a></dt>
343 <dd>Scroll down N pages (default: 1).</dd>
344 <dt id="Page-up,~2"><a class="permalink" href="#Page-up,~2"><code class="Cm">Page-up,
345 Ctrl+b, b</code></a></dt>
346 <dd>Scroll up N pages (default: 1).</dd>
347 <dt id="Ctrl+d,~2"><a class="permalink" href="#Ctrl+d,~2"><code class="Cm">Ctrl+d,
348 d</code></a></dt>
349 <dd>Scroll down N half pages (default: 1).</dd>
350 <dt id="Ctrl+u,~2"><a class="permalink" href="#Ctrl+u,~2"><code class="Cm">Ctrl+u,
351 u</code></a></dt>
352 <dd>Scroll up N half pages (default: 1).</dd>
353 <dt id="Home"><a class="permalink" href="#Home"><code class="Cm">Home</code></a></dt>
354 <dd>Scroll to the top of the view.</dd>
355 <dt id="End"><a class="permalink" href="#End"><code class="Cm">End</code></a></dt>
356 <dd>Scroll to the bottom of the view.</dd>
357 <dt id="g~3"><a class="permalink" href="#g~3"><code class="Cm">g</code></a></dt>
358 <dd>Scroll to line N (default: 1).</dd>
359 <dt id="G~3"><a class="permalink" href="#G~3"><code class="Cm">G</code></a></dt>
360 <dd>Like <code class="Cm">g</code> but defaults to the last line in the
361 diff.</dd>
362 <dt id="("><a class="permalink" href="#("><code class="Cm">(</code></a></dt>
363 <dd>Navigate to the Nth previous file in the diff (default: 1).</dd>
364 <dt id=")"><a class="permalink" href="#)"><code class="Cm">)</code></a></dt>
365 <dd>Navigate to the Nth next file in the diff (default: 1).</dd>
366 <dt id="_"><a class="permalink" href="#_"><code class="Cm">{</code></a></dt>
367 <dd>Navigate to the Nth previous hunk in the diff (default: 1).</dd>
368 <dt id="_~2"><a class="permalink" href="#_~2"><code class="Cm">}</code></a></dt>
369 <dd>Navigate to the Nth next hunk in the diff (default: 1).</dd>
370 <dt id="_~3"><a class="permalink" href="#_~3"><code class="Cm">[</code></a></dt>
371 <dd>Reduce diff context by N lines (default: 1).</dd>
372 <dt id="_~4"><a class="permalink" href="#_~4"><code class="Cm">]</code></a></dt>
373 <dd>Increase diff context by N lines (default: 1).</dd>
374 <dt id="_,"><a class="permalink" href="#_,"><code class="Cm">&lt;, Comma,
375 K</code></a></dt>
376 <dd>If the <code class="Cm">diff</code> view was opened via the
377 <code class="Cm">log</code> view, move to the Nth previous (younger)
378 commit. If the diff was opened via the <code class="Cm">blame</code>
379 view, move to the Nth previous line and load the corresponding commit
380 (default: 1).</dd>
381 <dt id="_,~2"><a class="permalink" href="#_,~2"><code class="Cm">&gt;,
382 Full stop, J</code></a></dt>
383 <dd>If the <code class="Cm">diff</code> view was opened via the
384 <code class="Cm">log</code> view, move to the Nth next (older) commit.
385 If the diff was opened via the <code class="Cm">blame</code> view,
386 move to the Nth next line and load the corresponding commit (default:
387 1).</dd>
388 <dt id="/~2"><a class="permalink" href="#/~2"><code class="Cm">/</code></a></dt>
389 <dd>Prompt for a search pattern and start searching for matching lines.
390 The search pattern is an extended regular expression. Regular
391 expression syntax is documented in
392 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
393 <dt id="n~2"><a class="permalink" href="#n~2"><code class="Cm">n</code></a></dt>
394 <dd>Find the Nth next line which matches the current search pattern
395 (default: 1).</dd>
396 <dt id="N~2"><a class="permalink" href="#N~2"><code class="Cm">N</code></a></dt>
397 <dd>Find the Nth previous line which matches the current search pattern
398 (default: 1).</dd>
399 <dt id="w"><a class="permalink" href="#w"><code class="Cm">w</code></a></dt>
400 <dd>Toggle display of whitespace-only changes.</dd>
401 <dt id="A"><a class="permalink" href="#A"><code class="Cm">A</code></a></dt>
402 <dd>Change the diff algorithm. Supported diff algorithms are Myers (quick
403 and dirty) and Patience (slow and tidy). This is a global setting
404 which also affects the <code class="Cm">blame</code> view.</dd>
405 </dl>
406 <p class="Pp">The options for <code class="Cm">tog diff</code> are as
407 follows:</p>
408 <dl class="Bl-tag">
409 <dt id="a~2"><a class="permalink" href="#a~2"><code class="Fl">-a</code></a></dt>
410 <dd>Treat file contents as ASCII text even if binary data is
411 detected.</dd>
412 <dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a>
413 <var class="Ar">number</var></dt>
414 <dd>Set the number of context lines shown in the diff. By default, 3 lines
415 of context are shown.</dd>
416 <dt id="r~2"><a class="permalink" href="#r~2"><code class="Fl">-r</code></a>
417 <var class="Ar">repository-path</var></dt>
418 <dd>Use the repository at the specified path. If not specified, assume the
419 repository is located at or above the current working directory. If
420 this directory is a <a class="Xr" aria-label="got, section
421 1">got(1)</a> work tree, use the repository path associated with this
422 work tree.</dd>
423 <dt id="w~2"><a class="permalink" href="#w~2"><code class="Fl">-w</code></a></dt>
424 <dd>Ignore whitespace-only changes.</dd>
425 </dl>
426 </dd>
427 <dt id="blame"><a class="permalink" href="#blame"><code class="Cm">blame</code></a>
428 [<code class="Fl">-c</code> <var class="Ar">commit</var>]
429 [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
430 <var class="Ar">path</var></dt>
431 <dd>Display line-by-line history of a file at the specified path.
432 <p class="Pp">The key bindings for <code class="Cm">tog blame</code> are as
433 follows (N denotes optional prefixed count modifier):</p>
434 <dl class="Bl-tag">
435 <dt id="Down-arrow,~3"><a class="permalink" href="#Down-arrow,~3"><code class="Cm">Down-arrow,
436 j, Ctrl-n</code></a></dt>
437 <dd>Move the selection cursor down N pages (default: 1).</dd>
438 <dt id="Up-arrow,~3"><a class="permalink" href="#Up-arrow,~3"><code class="Cm">Up-arrow,
439 k, Ctrl-p</code></a></dt>
440 <dd>Move the selection cursor up N pages (default: 1).</dd>
441 <dt id="Page-down,~3"><a class="permalink" href="#Page-down,~3"><code class="Cm">Page-down,
442 Space, Ctrl+f, f</code></a></dt>
443 <dd>Move the selection cursor down N pages (default: 1).</dd>
444 <dt id="Page-up,~3"><a class="permalink" href="#Page-up,~3"><code class="Cm">Page-up,
445 Ctrl+b, b</code></a></dt>
446 <dd>Move the selection cursor up N pages (default: 1).</dd>
447 <dt id="Ctrl+d,~3"><a class="permalink" href="#Ctrl+d,~3"><code class="Cm">Ctrl+d,
448 d</code></a></dt>
449 <dd>Move the selection cursor down N half pages (default: 1).</dd>
450 <dt id="Ctrl+u,~3"><a class="permalink" href="#Ctrl+u,~3"><code class="Cm">Ctrl+u,
451 u</code></a></dt>
452 <dd>Move the selection cursor up N half pages (default: 1).</dd>
453 <dt id="Home~2"><a class="permalink" href="#Home~2"><code class="Cm">Home</code></a></dt>
454 <dd>Move the selection cursor to the first line of the file.</dd>
455 <dt id="End~2"><a class="permalink" href="#End~2"><code class="Cm">End</code></a></dt>
456 <dd>Move the selection cursor to the last line of the file.</dd>
457 <dt id="g~4"><a class="permalink" href="#g~4"><code class="Cm">g</code></a></dt>
458 <dd>Move the selection cursor to line N (default: 1).</dd>
459 <dt id="G~4"><a class="permalink" href="#G~4"><code class="Cm">G</code></a></dt>
460 <dd>Like <code class="Cm">g</code> but defaults to the last line in the
461 file.</dd>
462 <dt id="Enter~2"><a class="permalink" href="#Enter~2"><code class="Cm">Enter</code></a></dt>
463 <dd>Open a <code class="Cm">diff</code> view for the currently selected
464 line's commit.</dd>
465 <dt id="c~2"><a class="permalink" href="#c~2"><code class="Cm">c</code></a></dt>
466 <dd>Reload the <code class="Cm">blame</code> view with the version of the
467 file as found in the currently selected line's commit.</dd>
468 <dt id="p"><a class="permalink" href="#p"><code class="Cm">p</code></a></dt>
469 <dd>Reload the <code class="Cm">blame</code> view with the version of the
470 file as found in the parent commit of the currently selected line's
471 commit.</dd>
472 <dt id="C~2"><a class="permalink" href="#C~2"><code class="Cm">C</code></a></dt>
473 <dd>Reload the <code class="Cm">blame</code> view with the previously
474 blamed commit.</dd>
475 <dt id="L"><a class="permalink" href="#L"><code class="Cm">L</code></a></dt>
476 <dd>Open a <code class="Cm">log</code> view for the currently selected
477 annotated line.</dd>
478 <dt id="/~3"><a class="permalink" href="#/~3"><code class="Cm">/</code></a></dt>
479 <dd>Prompt for a search pattern and start searching for matching lines.
480 The search pattern is an extended regular expression. Regular
481 expression syntax is documented in
482 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a>.</dd>
483 <dt id="n~3"><a class="permalink" href="#n~3"><code class="Cm">n</code></a></dt>
484 <dd>Find the Nth next line which matches the current search pattern
485 (default: 1).</dd>
486 <dt id="N~3"><a class="permalink" href="#N~3"><code class="Cm">N</code></a></dt>
487 <dd>Find the Nth previous line which matches the current search pattern
488 (default: 1).</dd>
489 <dt id="A~2"><a class="permalink" href="#A~2"><code class="Cm">A</code></a></dt>
490 <dd>Change the diff algorithm. Supported diff algorithms are Myers (quick
491 and dirty) and Patience (slow and tidy). This is a global setting
492 which also affects the <code class="Cm">diff</code> view.</dd>
493 </dl>
494 <p class="Pp">The options for <code class="Cm">tog blame</code> are as
495 follows:</p>
496 <dl class="Bl-tag">
497 <dt id="c~3"><a class="permalink" href="#c~3"><code class="Fl">-c</code></a>
498 <var class="Ar">commit</var></dt>
499 <dd>Start traversing history at the specified
500 <var class="Ar">commit</var>. The expected argument is a commit ID
501 SHA1 hash, or a reference name or keyword which will be resolved to a
502 commit ID. An abbreviated hash argument will be expanded to a full
503 SHA1 hash automatically, provided the abbreviation is unique. The
504 keywords &quot;:base&quot; and &quot;:head&quot; resolve to the work
505 tree's base commit and branch head, respectively. The former is only
506 valid if invoked in a work tree, while the latter will resolve to the
507 tip of the work tree's current branch if invoked in a work tree,
508 otherwise it will resolve to the repository's HEAD reference. Keywords
509 and references may be appended with &quot;:+&quot; or &quot;:-&quot;
510 modifiers and an optional integer N to denote the Nth descendant or
511 antecedent by first parent traversal, respectively; for example,
512 <b class="Sy">:head:-2</b> denotes the work tree branch head's 2nd
513 generation ancestor, and <b class="Sy">:base:+4</b> denotes the 4th
514 generation descendant of the work tree's base commit. Similarly,
515 <b class="Sy">foobar:+3</b> will denote the 3rd generation descendant
516 of the commit resolved by the &quot;foobar&quot; reference. A
517 &quot;:+&quot; or &quot;:-&quot; modifier without a trailing integer
518 has an implicit &quot;1&quot; appended (e.g.,
519 <b class="Sy">:base:+</b> is equivalent to
520 <b class="Sy">:base:+1</b>).</dd>
521 <dt id="r~3"><a class="permalink" href="#r~3"><code class="Fl">-r</code></a>
522 <var class="Ar">repository-path</var></dt>
523 <dd>Use the repository at the specified path. If not specified, assume the
524 repository is located at or above the current working directory. If
525 this directory is a <a class="Xr" aria-label="got, section
526 1">got(1)</a> work tree, use the repository path associated with this
527 work tree.</dd>
528 </dl>
529 </dd>
530 <dt id="tree"><a class="permalink" href="#tree"><code class="Cm">tree</code></a>
531 [<code class="Fl">-c</code> <var class="Ar">commit</var>]
532 [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
533 [<var class="Ar">path</var>]</dt>
534 <dd>Display the repository tree. If a <var class="Ar">path</var> is specified,
535 show tree entries at this path.
536 <p class="Pp">Displayed tree entries may carry one of the following trailing
537 annotations:</p>
538 <table class="Bl-column">
539 <tr>
540 <td>@</td>
541 <td>entry is a symbolic link</td>
542 </tr>
543 <tr>
544 <td>/</td>
545 <td>entry is a directory</td>
546 </tr>
547 <tr>
548 <td>*</td>
549 <td>entry is an executable file</td>
550 </tr>
551 <tr>
552 <td>$</td>
553 <td>entry is a Git submodule</td>
554 </tr>
555 </table>
556 <p class="Pp">Symbolic link entries are also annotated with the target path
557 of the link.</p>
558 <p class="Pp">The key bindings for <code class="Cm">tog tree</code> are as
559 follows (N denotes optional prefixed count modifier):</p>
560 <dl class="Bl-tag">
561 <dt id="Down-arrow,~4"><a class="permalink" href="#Down-arrow,~4"><code class="Cm">Down-arrow,
562 j, Ctrl-n</code></a></dt>
563 <dd>Move the selection cursor down N lines (default: 1).</dd>
564 <dt id="Up-arrow,~4"><a class="permalink" href="#Up-arrow,~4"><code class="Cm">Up-arrow,
565 k, Ctrl-p</code></a></dt>
566 <dd>Move the selection cursor up N lines (default: 1).</dd>
567 <dt id="Page-down,~4"><a class="permalink" href="#Page-down,~4"><code class="Cm">Page-down,
568 Space, Ctrl+f, f</code></a></dt>
569 <dd>Move the selection cursor down N pages (default: 1).</dd>
570 <dt id="Page-up,~4"><a class="permalink" href="#Page-up,~4"><code class="Cm">Page-up,
571 Ctrl+b, b</code></a></dt>
572 <dd>Move the selection cursor up N pages (default: 1).</dd>
573 <dt id="Ctrl+d,~4"><a class="permalink" href="#Ctrl+d,~4"><code class="Cm">Ctrl+d,
574 d</code></a></dt>
575 <dd>Move the selection cursor down N half pages (default: 1).</dd>
576 <dt id="Ctrl+u,~4"><a class="permalink" href="#Ctrl+u,~4"><code class="Cm">Ctrl+u,
577 u</code></a></dt>
578 <dd>Move the selection cursor up N half pages (default: 1).</dd>
579 <dt id="Home,~2"><a class="permalink" href="#Home,~2"><code class="Cm">Home,
580 =</code></a></dt>
581 <dd>Move the selection cursor to the first entry.</dd>
582 <dt id="End,~2"><a class="permalink" href="#End,~2"><code class="Cm">End,
583 *</code></a></dt>
584 <dd>Move the selection cursor to the last entry.</dd>
585 <dt id="g~5"><a class="permalink" href="#g~5"><code class="Cm">g</code></a></dt>
586 <dd>Move the selection cursor to entry N (default: 1).</dd>
587 <dt id="G~5"><a class="permalink" href="#G~5"><code class="Cm">G</code></a></dt>
588 <dd>Like <code class="Cm">g</code> but defaults to the last entry.</dd>
589 <dt id="Enter~3"><a class="permalink" href="#Enter~3"><code class="Cm">Enter</code></a></dt>
590 <dd>Enter the currently selected directory, or switch to the
591 <code class="Cm">blame</code> view for the currently selected
592 file.</dd>
593 <dt id="L~2"><a class="permalink" href="#L~2"><code class="Cm">L</code></a></dt>
594 <dd>Open a <code class="Cm">log</code> view for the currently selected
595 tree entry.</dd>
596 <dt id="R~2"><a class="permalink" href="#R~2"><code class="Cm">R</code></a></dt>
597 <dd>Open a <code class="Cm">ref</code> view listing all references in the
598 repository. This can then be used to open a new
599 <code class="Cm">tree</code> view for arbitrary branches and
600 tags.</dd>
601 <dt id="Backspace~2"><a class="permalink" href="#Backspace~2"><code class="Cm">Backspace</code></a></dt>
602 <dd>Move back to the Nth parent directory (default: 1).</dd>
603 <dt id="i"><a class="permalink" href="#i"><code class="Cm">i</code></a></dt>
604 <dd>Show object IDs for all objects displayed in the
605 <code class="Cm">tree</code> view.</dd>
606 <dt id="/~4"><a class="permalink" href="#/~4"><code class="Cm">/</code></a></dt>
607 <dd>Prompt for a search pattern and start searching for matching tree
608 entries. The search pattern is an extended regular expression which is
609 matched against the tree entry's name. Regular expression syntax is
610 documented in <a class="Xr" aria-label="re_format, section
611 7">re_format(7)</a>.</dd>
612 <dt id="n~4"><a class="permalink" href="#n~4"><code class="Cm">n</code></a></dt>
613 <dd>Find the Nth next tree entry which matches the current search pattern
614 (default: 1).</dd>
615 <dt id="N~4"><a class="permalink" href="#N~4"><code class="Cm">N</code></a></dt>
616 <dd>Find the Nth previous tree entry which matches the current search
617 pattern (default: 1).</dd>
618 </dl>
619 <p class="Pp">The options for <code class="Cm">tog tree</code> are as
620 follows:</p>
621 <dl class="Bl-tag">
622 <dt id="c~4"><a class="permalink" href="#c~4"><code class="Fl">-c</code></a>
623 <var class="Ar">commit</var></dt>
624 <dd>Start traversing history at the specified
625 <var class="Ar">commit</var>. The expected argument is a commit ID
626 SHA1 hash, or a reference name or keyword which will be resolved to a
627 commit ID. An abbreviated hash argument will be expanded to a full
628 SHA1 hash automatically, provided the abbreviation is unique. The
629 keywords &quot;:base&quot; and &quot;:head&quot; resolve to the work
630 tree's base commit and branch head, respectively. The former is only
631 valid if invoked in a work tree, while the latter will resolve to the
632 tip of the work tree's current branch if invoked in a work tree,
633 otherwise it will resolve to the repository's HEAD reference. Keywords
634 and references may be appended with &quot;:+&quot; or &quot;:-&quot;
635 modifiers and an optional integer N to denote the Nth descendant or
636 antecedent by first parent traversal, respectively; for example,
637 <b class="Sy">:head:-2</b> denotes the work tree branch head's 2nd
638 generation ancestor, and <b class="Sy">:base:+4</b> denotes the 4th
639 generation descendant of the work tree's base commit. Similarly,
640 <b class="Sy">foobar:+3</b> will denote the 3rd generation descendant
641 of the commit resolved by the &quot;foobar&quot; reference. A
642 &quot;:+&quot; or &quot;:-&quot; modifier without a trailing integer
643 has an implicit &quot;1&quot; appended (e.g.,
644 <b class="Sy">:base:+</b> is equivalent to
645 <b class="Sy">:base:+1</b>).</dd>
646 <dt id="r~4"><a class="permalink" href="#r~4"><code class="Fl">-r</code></a>
647 <var class="Ar">repository-path</var></dt>
648 <dd>Use the repository at the specified path. If not specified, assume the
649 repository is located at or above the current working directory. If
650 this directory is a <a class="Xr" aria-label="got, section
651 1">got(1)</a> work tree, use the repository path associated with this
652 work tree.</dd>
653 </dl>
654 </dd>
655 <dt id="ref"><a class="permalink" href="#ref"><code class="Cm">ref</code></a>
656 [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]</dt>
657 <dd>Display references in the repository.
658 <p class="Pp">The key bindings for <code class="Cm">tog ref</code> are as
659 follows (N denotes optional prefixed count modifier):</p>
660 <dl class="Bl-tag">
661 <dt id="Down-arrow,~5"><a class="permalink" href="#Down-arrow,~5"><code class="Cm">Down-arrow,
662 j, Ctrl-n</code></a></dt>
663 <dd>Move the selection cursor down N lines (default: 1).</dd>
664 <dt id="Up-arrow,~5"><a class="permalink" href="#Up-arrow,~5"><code class="Cm">Up-arrow,
665 k, Ctrl-p</code></a></dt>
666 <dd>Move the selection cursor up N lines (default: 1).</dd>
667 <dt id="Page-down,~5"><a class="permalink" href="#Page-down,~5"><code class="Cm">Page-down,
668 Space, Ctrl+f, f</code></a></dt>
669 <dd>Move the selection cursor down N pages (default: 1).</dd>
670 <dt id="Page-up,~5"><a class="permalink" href="#Page-up,~5"><code class="Cm">Page-up,
671 Ctrl+b, b</code></a></dt>
672 <dd>Move the selection cursor up N pages (default: 1).</dd>
673 <dt id="Ctrl+d,~5"><a class="permalink" href="#Ctrl+d,~5"><code class="Cm">Ctrl+d,
674 d</code></a></dt>
675 <dd>Move the selection cursor down N half pages (default: 1).</dd>
676 <dt id="Ctrl+u,~5"><a class="permalink" href="#Ctrl+u,~5"><code class="Cm">Ctrl+u,
677 u</code></a></dt>
678 <dd>Move the selection cursor up N half pages (default: 1).</dd>
679 <dt id="Home,~3"><a class="permalink" href="#Home,~3"><code class="Cm">Home,
680 =</code></a></dt>
681 <dd>Move the selection cursor to the first reference.</dd>
682 <dt id="End,~3"><a class="permalink" href="#End,~3"><code class="Cm">End,
683 *</code></a></dt>
684 <dd>Move the selection cursor to the last reference.</dd>
685 <dt id="g~6"><a class="permalink" href="#g~6"><code class="Cm">g</code></a></dt>
686 <dd>Move the selection cursor to reference N (default: 1).</dd>
687 <dt id="G~6"><a class="permalink" href="#G~6"><code class="Cm">G</code></a></dt>
688 <dd>Like <code class="Cm">g</code> but defaults to the last
689 reference.</dd>
690 <dt id="Enter~4"><a class="permalink" href="#Enter~4"><code class="Cm">Enter</code></a></dt>
691 <dd>Open a <code class="Cm">log</code> view which begins traversing
692 history at the commit resolved via the currently selected
693 reference.</dd>
694 <dt id="T~2"><a class="permalink" href="#T~2"><code class="Cm">T</code></a></dt>
695 <dd>Open a <code class="Cm">tree</code> view showing the tree resolved via
696 the currently selected reference.</dd>
697 <dt id="i~2"><a class="permalink" href="#i~2"><code class="Cm">i</code></a></dt>
698 <dd>Show object IDs for all non-symbolic references displayed in the
699 <code class="Cm">ref</code> view.</dd>
700 <dt id="m"><a class="permalink" href="#m"><code class="Cm">m</code></a></dt>
701 <dd>Show last modified date of each displayed reference.</dd>
702 <dt id="o"><a class="permalink" href="#o"><code class="Cm">o</code></a></dt>
703 <dd>Toggle display order of references between sort by name and sort by
704 timestamp.</dd>
705 <dt id="/~5"><a class="permalink" href="#/~5"><code class="Cm">/</code></a></dt>
706 <dd>Prompt for a search pattern and start searching for matching
707 references. The search pattern is an extended regular expression which
708 is matched against absolute reference names. Regular expression syntax
709 is documented in <a class="Xr" aria-label="re_format, section
710 7">re_format(7)</a>.</dd>
711 <dt id="n~5"><a class="permalink" href="#n~5"><code class="Cm">n</code></a></dt>
712 <dd>Find the Nth next reference which matches the current search pattern
713 (default: 1).</dd>
714 <dt id="N~5"><a class="permalink" href="#N~5"><code class="Cm">N</code></a></dt>
715 <dd>Find the Nth previous reference which matches the current search
716 pattern (default: 1).</dd>
717 <dt id="Ctrl+l~2"><a class="permalink" href="#Ctrl+l~2"><code class="Cm">Ctrl+l</code></a></dt>
718 <dd>Reload the list of references displayed by the
719 <code class="Cm">ref</code> view.</dd>
720 </dl>
721 <p class="Pp">The options for <code class="Cm">tog ref</code> are as
722 follows:</p>
723 <dl class="Bl-tag">
724 <dt id="r~5"><a class="permalink" href="#r~5"><code class="Fl">-r</code></a>
725 <var class="Ar">repository-path</var></dt>
726 <dd>Use the repository at the specified path. If not specified, assume the
727 repository is located at or above the current working directory. If
728 this directory is a <a class="Xr" aria-label="got, section
729 1">got(1)</a> work tree, use the repository path associated with this
730 work tree.</dd>
731 </dl>
732 </dd>
733 </dl>
734 </section>
735 <section class="Sh">
736 <h2 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h2>
737 <dl class="Bl-tag">
738 <dt id="TOG_COLORS"><a class="permalink" href="#TOG_COLORS"><code class="Ev">TOG_COLORS</code></a></dt>
739 <dd><code class="Nm">tog</code> shows colorized output if this variable is set
740 to a non-empty value. The default color scheme can be modified by setting
741 the environment variables documented below. The colors available in color
742 schemes are &#x201C;black&#x201D;, &#x201C;red&#x201D;,
743 &#x201C;green&#x201D;, &#x201C;yellow&#x201D;, &#x201C;blue&#x201D;,
744 &#x201C;magenta&#x201D;, &#x201C;cyan&#x201D;, and &#x201C;default&#x201D;
745 which maps to the terminal's default foreground color.</dd>
746 <dt id="TOG_COLOR_AUTHOR"><a class="permalink" href="#TOG_COLOR_AUTHOR"><code class="Ev">TOG_COLOR_AUTHOR</code></a></dt>
747 <dd>The color used to mark up author information. If not set, the default
748 value &#x201C;cyan&#x201D; is used.</dd>
749 <dt id="TOG_COLOR_COMMIT"><a class="permalink" href="#TOG_COLOR_COMMIT"><code class="Ev">TOG_COLOR_COMMIT</code></a></dt>
750 <dd>The color used to mark up commit IDs. If not set, the default value
751 &#x201C;green&#x201D; is used.</dd>
752 <dt id="TOG_COLOR_DATE"><a class="permalink" href="#TOG_COLOR_DATE"><code class="Ev">TOG_COLOR_DATE</code></a></dt>
753 <dd>The color used to mark up date information. If not set, the default value
754 &#x201C;yellow&#x201D; is used.</dd>
755 <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>
756 <dd>The color used to mark up chunk header lines in diffs. If not set, the
757 default value &#x201C;yellow&#x201D; is used.</dd>
758 <dt id="TOG_COLOR_DIFF_META"><a class="permalink" href="#TOG_COLOR_DIFF_META"><code class="Ev">TOG_COLOR_DIFF_META</code></a></dt>
759 <dd>The color used to mark up meta data in diffs. If not set, the default
760 value &#x201C;green&#x201D; is used.</dd>
761 <dt id="TOG_COLOR_DIFF_MINUS"><a class="permalink" href="#TOG_COLOR_DIFF_MINUS"><code class="Ev">TOG_COLOR_DIFF_MINUS</code></a></dt>
762 <dd>The color used to mark up removed lines in diffs. If not set, the default
763 value &#x201C;magenta&#x201D; is used.</dd>
764 <dt id="TOG_COLOR_DIFF_PLUS"><a class="permalink" href="#TOG_COLOR_DIFF_PLUS"><code class="Ev">TOG_COLOR_DIFF_PLUS</code></a></dt>
765 <dd>The color used to mark up added lines in diffs. If not set, the default
766 value &#x201C;cyan&#x201D; is used.</dd>
767 <dt id="TOG_COLOR_REFS_BACKUP"><a class="permalink" href="#TOG_COLOR_REFS_BACKUP"><code class="Ev">TOG_COLOR_REFS_BACKUP</code></a></dt>
768 <dd>The color used to mark up references in the
769 &#x201C;refs/got/backup/&#x201D; namespace. If not set, the default value
770 &#x201C;cyan&#x201D; is used.</dd>
771 <dt id="TOG_COLOR_REFS_HEADS"><a class="permalink" href="#TOG_COLOR_REFS_HEADS"><code class="Ev">TOG_COLOR_REFS_HEADS</code></a></dt>
772 <dd>The color used to mark up references in the &#x201C;refs/heads/&#x201D;
773 namespace. If not set, the default value &#x201C;green&#x201D; is
774 used.</dd>
775 <dt id="TOG_COLOR_REFS_REMOTES"><a class="permalink" href="#TOG_COLOR_REFS_REMOTES"><code class="Ev">TOG_COLOR_REFS_REMOTES</code></a></dt>
776 <dd>The color used to mark up references in the &#x201C;refs/remotes/&#x201D;
777 namespace. If not set, the default value &#x201C;yellow&#x201D; is
778 used.</dd>
779 <dt id="TOG_COLOR_REFS_TAGS"><a class="permalink" href="#TOG_COLOR_REFS_TAGS"><code class="Ev">TOG_COLOR_REFS_TAGS</code></a></dt>
780 <dd>The color used to mark up references in the &#x201C;refs/tags/&#x201D;
781 namespace. If not set, the default value &#x201C;magenta&#x201D; is
782 used.</dd>
783 <dt id="TOG_COLOR_TREE_DIRECTORY"><a class="permalink" href="#TOG_COLOR_TREE_DIRECTORY"><code class="Ev">TOG_COLOR_TREE_DIRECTORY</code></a></dt>
784 <dd>The color used to mark up directory tree entries. If not set, the default
785 value &#x201C;cyan&#x201D; is used.</dd>
786 <dt id="TOG_COLOR_TREE_EXECUTABLE"><a class="permalink" href="#TOG_COLOR_TREE_EXECUTABLE"><code class="Ev">TOG_COLOR_TREE_EXECUTABLE</code></a></dt>
787 <dd>The color used to mark up executable file tree entries. If not set, the
788 default value &#x201C;green&#x201D; is used.</dd>
789 <dt id="TOG_COLOR_TREE_SUBMODULE"><a class="permalink" href="#TOG_COLOR_TREE_SUBMODULE"><code class="Ev">TOG_COLOR_TREE_SUBMODULE</code></a></dt>
790 <dd>The color used to mark up submodule tree entries. If not set, the default
791 value &#x201C;magenta&#x201D; is used.</dd>
792 <dt id="TOG_COLOR_TREE_SYMLINK"><a class="permalink" href="#TOG_COLOR_TREE_SYMLINK"><code class="Ev">TOG_COLOR_TREE_SYMLINK</code></a></dt>
793 <dd>The color used to mark up symbolic link tree entries. If not set, the
794 default value &#x201C;magenta&#x201D; is used.</dd>
795 <dt id="TOG_DIFF_ALGORITHM"><a class="permalink" href="#TOG_DIFF_ALGORITHM"><code class="Ev">TOG_DIFF_ALGORITHM</code></a></dt>
796 <dd>Determines the default diff algorithm used by <code class="Nm">tog</code>.
797 Supported diff algorithms are Myers (quick and dirty) and Patience (slow
798 and tidy). Valid values for <code class="Ev">TOG_DIFF_ALGORITHM</code> are
799 &#x201C;patience&#x201D; and &#x201C;myers&#x201D;. If unset, the Patience
800 diff algorithm will be used by default.</dd>
801 <dt id="TOG_VIEW_SPLIT_MODE"><a class="permalink" href="#TOG_VIEW_SPLIT_MODE"><code class="Ev">TOG_VIEW_SPLIT_MODE</code></a></dt>
802 <dd>Determines the default layout of split-screen views. If set to
803 &#x201C;h&#x201D; or &#x201C;H&#x201D;, <code class="Nm">tog</code> will
804 use horizontal split by default. Otherwise, vertical split will be used.
805 The <code class="Cm">S</code> key can be used to switch between vertical
806 and horizontal split layout at run-time.</dd>
807 </dl>
808 </section>
809 <section class="Sh">
810 <h2 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
811 STATUS</a></h2>
812 <p class="Pp">The <code class="Nm">tog</code> utility exits&#x00A0;0 on success,
813 and&#x00A0;&gt;0 if an error occurs.</p>
814 </section>
815 <section class="Sh">
816 <h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
817 ALSO</a></h2>
818 <p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
819 <a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
820 <a class="Xr" aria-label="re_format, section 7">re_format(7)</a></p>
821 </section>
822 <section class="Sh">
823 <h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
824 <p class="Pp"><span class="An">Christian Weisgerber</span>
825 &lt;<a class="Mt" href="mailto:naddy@openbsd.org">naddy@openbsd.org</a>&gt;
826 <br/>
827 <span class="An">Josh Rickmar</span>
828 &lt;<a class="Mt" href="mailto:jrick@zettaport.com">jrick@zettaport.com</a>&gt;
829 <br/>
830 <span class="An">Joshua Stein</span>
831 &lt;<a class="Mt" href="mailto:jcs@openbsd.org">jcs@openbsd.org</a>&gt;
832 <br/>
833 <span class="An">Mark Jamsek</span>
834 &lt;<a class="Mt" href="mailto:mark@jamsek.dev">mark@jamsek.dev</a>&gt;
835 <br/>
836 <span class="An">Martin Pieuchot</span>
837 &lt;<a class="Mt" href="mailto:mpi@openbsd.org">mpi@openbsd.org</a>&gt;
838 <br/>
839 <span class="An">Omar Polo</span>
840 &lt;<a class="Mt" href="mailto:op@openbsd.org">op@openbsd.org</a>&gt;
841 <br/>
842 <span class="An">Stefan Sperling</span>
843 &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;
844 <br/>
845 <span class="An">Klemens Nanni</span>
846 &lt;<a class="Mt" href="mailto:kn@openbsd.org">kn@openbsd.org</a>&gt;</p>
847 </section>
848 </main>
849 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
850 line"><span class="foot-left"></span><span class="foot-date">March 11,
851 2024</span> <span class="foot-os">OpenBSD 7.5</span></div>
852 </body>
853 </html>