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