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