Blame


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