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