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