1 030916b5 2018-07-12 stsp .\"
  2 030916b5 2018-07-12 stsp .\" Copyright (c) 2018 Stefan Sperling
  3 030916b5 2018-07-12 stsp .\"
  4 030916b5 2018-07-12 stsp .\" Permission to use, copy, modify, and distribute this software for any
  5 030916b5 2018-07-12 stsp .\" purpose with or without fee is hereby granted, provided that the above
  6 030916b5 2018-07-12 stsp .\" copyright notice and this permission notice appear in all copies.
  7 030916b5 2018-07-12 stsp .\"
  8 030916b5 2018-07-12 stsp .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  9 030916b5 2018-07-12 stsp .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 10 030916b5 2018-07-12 stsp .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 11 030916b5 2018-07-12 stsp .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 12 030916b5 2018-07-12 stsp .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 13 030916b5 2018-07-12 stsp .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 14 030916b5 2018-07-12 stsp .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 15 030916b5 2018-07-12 stsp .\"
 16 030916b5 2018-07-12 stsp .Dd $Mdocdate$
 17 030916b5 2018-07-12 stsp .Dt TOG 1
 18 030916b5 2018-07-12 stsp .Os
 19 030916b5 2018-07-12 stsp .Sh NAME
 20 030916b5 2018-07-12 stsp .Nm tog
 21 aee2a8bd 2019-08-05 stsp .Nd Git repository browser
 22 030916b5 2018-07-12 stsp .Sh SYNOPSIS
 23 030916b5 2018-07-12 stsp .Nm
 24 ee85c5e8 2020-02-29 stsp .Op Ar command
 25 030916b5 2018-07-12 stsp .Op Fl h
 26 030916b5 2018-07-12 stsp .Op Ar arg ...
 27 ee85c5e8 2020-02-29 stsp .Pp
 28 ee85c5e8 2020-02-29 stsp .Nm
 29 ee85c5e8 2020-02-29 stsp .Ar path
 30 030916b5 2018-07-12 stsp .Sh DESCRIPTION
 31 030916b5 2018-07-12 stsp .Nm
 32 aee2a8bd 2019-08-05 stsp is an interactive read-only browser for Git repositories.
 33 030916b5 2018-07-12 stsp This repository format is described in
 34 5e5560e1 2018-08-01 stsp .Xr git-repository 5 .
 35 030916b5 2018-07-12 stsp .Pp
 36 030916b5 2018-07-12 stsp .Nm
 37 0cf4efb1 2018-09-29 stsp supports several types of views which display repository data:
 38 87aa0e98 2018-08-18 stsp .Bl -tag -width Ds
 39 9419758a 2019-03-27 stsp .It Log view
 40 87aa0e98 2018-08-18 stsp Displays commits in the repository's history.
 41 87aa0e98 2018-08-18 stsp This view is displayed initially if no
 42 87aa0e98 2018-08-18 stsp .Ar command
 43 ee85c5e8 2020-02-29 stsp is specified, or if just a
 44 ee85c5e8 2020-02-29 stsp .Ar path
 45 87aa0e98 2018-08-18 stsp is specified.
 46 9419758a 2019-03-27 stsp .It Diff view
 47 87aa0e98 2018-08-18 stsp Displays changes made in a particular commit.
 48 9419758a 2019-03-27 stsp .It Blame view
 49 87aa0e98 2018-08-18 stsp Displays the line-by-line history of a file.
 50 9419758a 2019-03-27 stsp .It Tree view
 51 87aa0e98 2018-08-18 stsp Displays the tree corresponding to a particular commit.
 52 38cb327b 2020-11-24 stsp .It Ref view
 53 38cb327b 2020-11-24 stsp Displays references in the repository.
 54 87aa0e98 2018-08-18 stsp .El
 55 87aa0e98 2018-08-18 stsp .Pp
 56 87aa0e98 2018-08-18 stsp .Nm
 57 87aa0e98 2018-08-18 stsp provides global and command-specific key bindings and options.
 58 640cd7ff 2022-06-22 mark Some command-specific key bindings may be prefixed with an integer, which is
 59 640cd7ff 2022-06-22 mark denoted by N in the descriptions below, and is used as a modifier to the
 60 640cd7ff 2022-06-22 mark operation as indicated.
 61 640cd7ff 2022-06-22 mark .Nm
 62 f0032ce6 2022-07-02 mark will echo digits to the screen when count modifiers are entered, and complete
 63 f0032ce6 2022-07-02 mark the sequence upon input of the first non-numeric character.
 64 f0032ce6 2022-07-02 mark Count modifiers can be aborted by entering an unmapped key.
 65 a6d37fac 2022-07-03 mark Once a compound command is executed, the operation can be cancelled with
 66 a6d37fac 2022-07-03 mark .Cm C-g
 67 a6d37fac 2022-07-03 mark or
 68 a6d37fac 2022-07-03 mark .Cm Backspace .
 69 c23f7187 2022-07-12 stsp .Pp
 70 87aa0e98 2018-08-18 stsp The global key bindings are:
 71 87aa0e98 2018-08-18 stsp .Bl -tag -width Ds
 72 87aa0e98 2018-08-18 stsp .It Cm Q
 73 87aa0e98 2018-08-18 stsp Quit
 74 87aa0e98 2018-08-18 stsp .Nm .
 75 87aa0e98 2018-08-18 stsp .It Cm q
 76 87aa0e98 2018-08-18 stsp Quit the view which is in focus.
 77 87aa0e98 2018-08-18 stsp .It Cm Tab
 78 c0d30c23 2018-10-07 stsp Switch focus between views.
 79 61417565 2022-06-20 mark .It Cm F
 80 c0d30c23 2018-10-07 stsp Toggle fullscreen mode for a split-screen view.
 81 e9b3576f 2019-03-27 stsp .Nm
 82 67d6e2c2 2022-07-12 stsp will automatically use vertical split-screen views if the size of the
 83 67d6e2c2 2022-07-12 stsp terminal window is sufficiently large.
 84 d2366e29 2022-07-07 mark .It Cm S
 85 2572d286 2022-07-12 stsp Switch the current split-screen layout, and render all active views in
 86 2572d286 2022-07-12 stsp this new layout.
 87 67d6e2c2 2022-07-12 stsp The split-screen layout can be either vertical or horizontal.
 88 2572d286 2022-07-12 stsp If the terminal is not wide enough when switching to a vertical split,
 89 2572d286 2022-07-12 stsp views will render in fullscreen.
 90 3c1dfe12 2022-07-08 mark .It Cm -
 91 3c1dfe12 2022-07-08 mark When in a split-screen view, decrease the size of the focussed split
 92 3c1dfe12 2022-07-08 mark N increments (default: 1).
 93 3c1dfe12 2022-07-08 mark .It Cm +
 94 3c1dfe12 2022-07-08 mark When in a split-screen view, increase the size of the focussed split
 95 3c1dfe12 2022-07-08 mark N increments (default: 1).
 96 94b80cfa 2022-08-01 mark .It Cm G
 97 94b80cfa 2022-08-01 mark Go to line N in the view (default: last line).
 98 94b80cfa 2022-08-01 mark .It Cm g
 99 94b80cfa 2022-08-01 mark Go to line N in the view (default: first line).
100 87aa0e98 2018-08-18 stsp .El
101 87aa0e98 2018-08-18 stsp .Pp
102 87aa0e98 2018-08-18 stsp Global options must precede the command name, and are as follows:
103 030916b5 2018-07-12 stsp .Bl -tag -width tenletters
104 030916b5 2018-07-12 stsp .It Fl h
105 030916b5 2018-07-12 stsp Display usage information.
106 1795b260 2021-04-02 kn .It Fl V , -version
107 53ccebc2 2019-07-30 stsp Display program version and exit immediately.
108 030916b5 2018-07-12 stsp .El
109 030916b5 2018-07-12 stsp .Pp
110 030916b5 2018-07-12 stsp The commands for
111 030916b5 2018-07-12 stsp .Nm
112 030916b5 2018-07-12 stsp are as follows:
113 030916b5 2018-07-12 stsp .Bl -tag -width blame
114 b672a97a 2020-01-27 stsp .It Cm log Oo Fl b Oc Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar path
115 030916b5 2018-07-12 stsp Display history of a repository.
116 ecb28ae0 2018-07-16 stsp If a
117 ecb28ae0 2018-07-16 stsp .Ar path
118 ecb28ae0 2018-07-16 stsp is specified, show only commits which modified this path.
119 dc990cbf 2020-02-22 stsp If invoked in a work tree, the
120 dc990cbf 2020-02-22 stsp .Ar path
121 dc990cbf 2020-02-22 stsp is interpreted relative to the current working directory,
122 dc990cbf 2020-02-22 stsp and the work tree's path prefix is implicitly prepended.
123 dc990cbf 2020-02-22 stsp Otherwise, the path is interpreted relative to the repository root.
124 030916b5 2018-07-12 stsp .Pp
125 030916b5 2018-07-12 stsp This command is also executed if no explicit command is specified.
126 030916b5 2018-07-12 stsp .Pp
127 030916b5 2018-07-12 stsp The key bindings for
128 030916b5 2018-07-12 stsp .Cm tog log
129 640cd7ff 2022-06-22 mark are as follows (N denotes optional prefixed count modifier):
130 030916b5 2018-07-12 stsp .Bl -tag -width Ds
131 02ffd0d5 2021-10-17 stsp .It Cm Down-arrow, j, >, Full stop, Ctrl-n
132 640cd7ff 2022-06-22 mark Move the selection cursor down N lines (default: 1).
133 02ffd0d5 2021-10-17 stsp .It Cm Up-arrow, k, <, Comma, Ctrl-p
134 640cd7ff 2022-06-22 mark Move the selection cursor up N lines (default: 1).
135 145b6838 2022-06-16 stsp .It Cm Right-arrow, l
136 640cd7ff 2022-06-22 mark Scroll log message field to the right N increments (default: 1).
137 640cd7ff 2022-06-22 mark .br
138 f7443f66 2022-06-16 mark Log message moves left on the screen.
139 145b6838 2022-06-16 stsp .It Cm Left-arrow, h
140 640cd7ff 2022-06-22 mark Scroll log message field to the left N increments (default: 1).
141 640cd7ff 2022-06-22 mark .br
142 f7443f66 2022-06-16 mark Log message moves right on the screen.
143 145b6838 2022-06-16 stsp .It Cm $
144 145b6838 2022-06-16 stsp Scroll log message field to the rightmost position.
145 145b6838 2022-06-16 stsp .It Cm 0
146 145b6838 2022-06-16 stsp Scroll log message field to the leftmost position.
147 48bb96f0 2022-06-20 naddy .It Cm Page-down, Space, Ctrl+f, f
148 640cd7ff 2022-06-22 mark Move the selection cursor down N pages (default: 1).
149 61417565 2022-06-20 mark .It Cm Page-up, Ctrl+b, b
150 640cd7ff 2022-06-22 mark Move the selection cursor up N pages (default: 1).
151 33c3719a 2022-06-15 stsp .It Cm Ctrl+d, d
152 640cd7ff 2022-06-22 mark Move the selection cursor down N half pages (default: 1).
153 33c3719a 2022-06-15 stsp .It Cm Ctrl+u, u
154 640cd7ff 2022-06-22 mark Move the selection cursor up N half pages (default: 1).
155 27890b18 2021-08-30 stsp .It Cm Home, g
156 912a3f79 2021-08-30 j Move the cursor to the newest commit.
157 912a3f79 2021-08-30 j .It Cm End, G
158 912a3f79 2021-08-30 j Move the cursor to the oldest commit.
159 1dd93b2a 2021-08-30 stsp This will traverse all commits on the current branch which may take
160 1dd93b2a 2021-08-30 stsp a long time depending on the number of commits in branch history.
161 e38d4cde 2022-03-21 naddy If needed, this operation can be cancelled with
162 a6d37fac 2022-07-03 mark .Cm C-g
163 a6d37fac 2022-07-03 mark or
164 9ebbe6e1 2021-08-30 stsp .Cm Backspace .
165 48bb96f0 2022-06-20 naddy .It Cm Enter
166 c0d30c23 2018-10-07 stsp Open a
167 030916b5 2018-07-12 stsp .Cm diff
168 030916b5 2018-07-12 stsp view showing file changes made in the currently selected commit.
169 5e98fb33 2022-07-22 mark .It Cm T
170 a60a9dc4 2019-05-13 jcs Open a
171 030916b5 2018-07-12 stsp .Cm tree
172 030916b5 2018-07-12 stsp view showing the tree for the currently selected commit.
173 5036bf37 2018-09-24 stsp .It Cm Backspace
174 26f0cb24 2021-08-30 j Show log entries for the parent directory of the currently selected path.
175 26f0cb24 2021-08-30 j However when an active search is in progress or when additional commits
176 26f0cb24 2021-08-30 j are loaded,
177 678cbce5 2019-07-28 stsp .Cm Backspace
178 26f0cb24 2021-08-30 j aborts the running operation.
179 60493ae3 2019-06-20 stsp .It Cm /
180 60493ae3 2019-06-20 stsp Prompt for a search pattern and start searching for matching commits.
181 60493ae3 2019-06-20 stsp The search pattern is an extended regular expression which is matched
182 df0b3d8a 2019-06-28 stsp against a commit's author name, committer name, log message, and
183 df0b3d8a 2019-06-28 stsp commit ID SHA1 hash.
184 e6c76b79 2019-06-21 stsp Regular expression syntax is documented in
185 e6c76b79 2019-06-21 stsp .Xr re_format 7 .
186 60493ae3 2019-06-20 stsp .It Cm n
187 640cd7ff 2022-06-22 mark Find the Nth next commit which matches the current search pattern (default: 1).
188 640cd7ff 2022-06-22 mark .br
189 a6d37fac 2022-07-03 mark Searching continues until either a match is found or
190 a6d37fac 2022-07-03 mark .Cm C-g
191 a6d37fac 2022-07-03 mark or the
192 678cbce5 2019-07-28 stsp .Cm Backspace
193 678cbce5 2019-07-28 stsp key is pressed.
194 b1bf1435 2019-06-21 stsp .It Cm N
195 640cd7ff 2022-06-22 mark Find the Nth previous commit which matches the current search pattern
196 640cd7ff 2022-06-22 mark (default: 1).
197 640cd7ff 2022-06-22 mark .br
198 a6d37fac 2022-07-03 mark Searching continues until either a match is found or
199 a6d37fac 2022-07-03 mark .Cm C-g
200 a6d37fac 2022-07-03 mark or the
201 678cbce5 2019-07-28 stsp .Cm Backspace
202 678cbce5 2019-07-28 stsp key is pressed.
203 bf0668dd 2019-06-26 stsp .It Cm Ctrl+l
204 01ca22b1 2020-12-07 stsp Reload the
205 01ca22b1 2020-12-07 stsp .Cm log
206 01ca22b1 2020-12-07 stsp view with new commits found in the repository.
207 b672a97a 2020-01-27 stsp .It Cm B
208 01ca22b1 2020-12-07 stsp Reload the
209 01ca22b1 2020-12-07 stsp .Cm log
210 01ca22b1 2020-12-07 stsp view and toggle display of merged commits.
211 b672a97a 2020-01-27 stsp The
212 b672a97a 2020-01-27 stsp .Fl b
213 b672a97a 2020-01-27 stsp option determines whether merged commits are displayed initially.
214 5e98fb33 2022-07-22 mark .It Cm R
215 38cb327b 2020-11-24 stsp Open a
216 38cb327b 2020-11-24 stsp .Cm ref
217 38cb327b 2020-11-24 stsp view listing all references in the repository.
218 38cb327b 2020-11-24 stsp This can then be used to open a new
219 38cb327b 2020-11-24 stsp .Cm log
220 38cb327b 2020-11-24 stsp view for arbitrary branches and tags.
221 10aab77f 2022-07-19 op .It Cm @
222 10aab77f 2022-07-19 op Toggle between showing the author and the committer name.
223 030916b5 2018-07-12 stsp .El
224 030916b5 2018-07-12 stsp .Pp
225 030916b5 2018-07-12 stsp The options for
226 030916b5 2018-07-12 stsp .Cm tog log
227 030916b5 2018-07-12 stsp are as follows:
228 030916b5 2018-07-12 stsp .Bl -tag -width Ds
229 b672a97a 2020-01-27 stsp .It Fl b
230 1137e0ae 2020-01-27 stsp Display individual commits which were merged into the current branch
231 1137e0ae 2020-01-27 stsp from other branches.
232 b672a97a 2020-01-27 stsp By default,
233 b672a97a 2020-01-27 stsp .Cm tog log
234 b672a97a 2020-01-27 stsp shows the linear history of the current branch only.
235 b672a97a 2020-01-27 stsp The
236 b672a97a 2020-01-27 stsp .Cm B
237 b672a97a 2020-01-27 stsp key binding can be used to toggle display of merged commits at run-time.
238 030916b5 2018-07-12 stsp .It Fl c Ar commit
239 030916b5 2018-07-12 stsp Start traversing history at the specified
240 030916b5 2018-07-12 stsp .Ar commit .
241 a54b6686 2019-06-28 stsp The expected argument is the name of a branch or a commit ID SHA1 hash.
242 0db75f06 2019-07-07 stsp An abbreviated hash argument will be expanded to a full SHA1 hash
243 0db75f06 2019-07-07 stsp automatically, provided the abbreviation is unique.
244 19e70ad6 2019-05-14 stsp If this option is not specified, default to the work tree's current branch
245 19e70ad6 2019-05-14 stsp if invoked in a work tree, or to the repository's HEAD reference.
246 ecb28ae0 2018-07-16 stsp .It Fl r Ar repository-path
247 ecb28ae0 2018-07-16 stsp Use the repository at the specified path.
248 ecb28ae0 2018-07-16 stsp If not specified, assume the repository is located at or above the current
249 ecb28ae0 2018-07-16 stsp working directory.
250 212b39d1 2020-02-24 naddy If this directory is a
251 212b39d1 2020-02-24 naddy .Xr got 1
252 212b39d1 2020-02-24 naddy work tree, use the repository path associated with this work tree.
253 030916b5 2018-07-12 stsp .El
254 827a167b 2022-08-16 stsp .It Cm diff Oo Fl aw Oc Oo Fl C Ar number Oc Oo Fl r Ar repository-path Oc Ar object1 Ar object2
255 030916b5 2018-07-12 stsp Display the differences between two objects in the repository.
256 3dbaef42 2020-11-24 stsp Treat each of the two arguments as a reference, a tag name, or an object
257 3dbaef42 2020-11-24 stsp ID SHA1 hash, and display differences between the corresponding objects.
258 3dbaef42 2020-11-24 stsp Both objects must be of the same type (blobs, trees, or commits).
259 0db75f06 2019-07-07 stsp An abbreviated hash argument will be expanded to a full SHA1 hash
260 0db75f06 2019-07-07 stsp automatically, provided the abbreviation is unique.
261 030916b5 2018-07-12 stsp .Pp
262 030916b5 2018-07-12 stsp The key bindings for
263 030916b5 2018-07-12 stsp .Cm tog diff
264 640cd7ff 2022-06-22 mark are as follows (N denotes optional prefixed count modifier):
265 030916b5 2018-07-12 stsp .Bl -tag -width Ds
266 64453f7e 2020-11-21 stsp .It Cm a
267 64453f7e 2020-11-21 stsp Toggle treatment of file contents as ASCII text even if binary data was
268 64453f7e 2020-11-21 stsp detected.
269 02ffd0d5 2021-10-17 stsp .It Cm Down-arrow, j, Ctrl-n
270 640cd7ff 2022-06-22 mark Scroll down N lines (default: 1).
271 02ffd0d5 2021-10-17 stsp .It Cm Up-arrow, k, Ctrl-p
272 640cd7ff 2022-06-22 mark Scroll up N lines (default: 1).
273 145b6838 2022-06-16 stsp .It Cm Right-arrow, l
274 640cd7ff 2022-06-22 mark Scroll view to the right N increments (default: 1).
275 640cd7ff 2022-06-22 mark .br
276 f7443f66 2022-06-16 mark Diff output moves left on the screen.
277 145b6838 2022-06-16 stsp .It Cm Left-arrow, h
278 640cd7ff 2022-06-22 mark Scroll view to the left N increments (default: 1).
279 640cd7ff 2022-06-22 mark .br
280 f7443f66 2022-06-16 mark Diff output moves right on the screen.
281 145b6838 2022-06-16 stsp .It Cm $
282 145b6838 2022-06-16 stsp Scroll view to the rightmost position.
283 145b6838 2022-06-16 stsp .It Cm 0
284 145b6838 2022-06-16 stsp Scroll view left to the start of the line.
285 61417565 2022-06-20 mark .It Cm Page-down, Space, Ctrl+f, f
286 640cd7ff 2022-06-22 mark Scroll down N pages (default: 1).
287 61417565 2022-06-20 mark .It Cm Page-up, Ctrl+b, b
288 640cd7ff 2022-06-22 mark Scroll up N pages (default: 1).
289 33c3719a 2022-06-15 stsp .It Cm Ctrl+d, d
290 640cd7ff 2022-06-22 mark Scroll down N half pages (default: 1).
291 33c3719a 2022-06-15 stsp .It Cm Ctrl+u, u
292 640cd7ff 2022-06-22 mark Scroll up N half pages (default: 1).
293 00f6361c 2021-08-30 naddy .It Cm Home, g
294 912a3f79 2021-08-30 j Scroll to the top of the view.
295 912a3f79 2021-08-30 j .It Cm End, G
296 912a3f79 2021-08-30 j Scroll to the bottom of the view.
297 c7d5c43c 2022-08-04 mark .It Cm \&(
298 c7d5c43c 2022-08-04 mark Navigate to the Nth previous file in the diff (default: 1).
299 c7d5c43c 2022-08-04 mark .It Cm \&)
300 c7d5c43c 2022-08-04 mark Navigate to the Nth next file in the diff (default: 1).
301 c7d5c43c 2022-08-04 mark .It Cm \&{
302 c7d5c43c 2022-08-04 mark Navigate to the Nth previous hunk in the diff (default: 1).
303 c7d5c43c 2022-08-04 mark .It Cm \&}
304 c7d5c43c 2022-08-04 mark Navigate to the Nth next hunk in the diff (default: 1).
305 dfc23429 2019-08-11 stsp .It Cm \&[
306 640cd7ff 2022-06-22 mark Reduce diff context by N lines (default: 1).
307 dfc23429 2019-08-11 stsp .It Cm \&]
308 640cd7ff 2022-06-22 mark Increase diff context by N lines (default: 1).
309 2b3e6702 2022-07-20 mark .It Cm <, Comma, K
310 01ca22b1 2020-12-07 stsp If the
311 01ca22b1 2020-12-07 stsp .Cm diff
312 01ca22b1 2020-12-07 stsp view was opened via the
313 01ca22b1 2020-12-07 stsp .Cm log
314 c0f61fa4 2022-07-11 mark view, move to the Nth previous (younger) commit.
315 c0f61fa4 2022-07-11 mark If the diff was opened via the
316 c0f61fa4 2022-07-11 mark .Cm blame
317 c0f61fa4 2022-07-11 mark view, move to the Nth previous line and load the corresponding commit
318 c0f61fa4 2022-07-11 mark (default: 1).
319 2b3e6702 2022-07-20 mark .It Cm >, Full stop, J
320 01ca22b1 2020-12-07 stsp If the
321 01ca22b1 2020-12-07 stsp .Cm diff
322 01ca22b1 2020-12-07 stsp view was opened via the
323 01ca22b1 2020-12-07 stsp .Cm log
324 c0f61fa4 2022-07-11 mark view, move to the Nth next (older) commit.
325 c0f61fa4 2022-07-11 mark If the diff was opened via the
326 c0f61fa4 2022-07-11 mark .Cm blame
327 c0f61fa4 2022-07-11 mark view, move to the Nth next line and load the corresponding commit (default: 1).
328 66dc9065 2020-02-15 stsp .It Cm /
329 0e404f95 2020-11-14 stsp Prompt for a search pattern and start searching for matching lines.
330 66dc9065 2020-02-15 stsp The search pattern is an extended regular expression.
331 66dc9065 2020-02-15 stsp Regular expression syntax is documented in
332 66dc9065 2020-02-15 stsp .Xr re_format 7 .
333 66dc9065 2020-02-15 stsp .It Cm n
334 640cd7ff 2022-06-22 mark Find the Nth next line which matches the current search pattern (default: 1).
335 66dc9065 2020-02-15 stsp .It Cm N
336 640cd7ff 2022-06-22 mark Find the Nth previous line which matches the current search pattern
337 640cd7ff 2022-06-22 mark (default: 1).
338 3dbaef42 2020-11-24 stsp .It Cm w
339 3dbaef42 2020-11-24 stsp Toggle display of whitespace-only changes.
340 917d79a7 2022-07-01 stsp .It Cm A
341 917d79a7 2022-07-01 stsp Change the diff algorithm.
342 41e8d27d 2022-07-03 stsp Supported diff algorithms are Myers (quick and dirty) and
343 41e8d27d 2022-07-03 stsp Patience (slow and tidy).
344 917d79a7 2022-07-01 stsp This is a global setting which also affects the
345 917d79a7 2022-07-01 stsp .Cm blame
346 917d79a7 2022-07-01 stsp view.
347 030916b5 2018-07-12 stsp .El
348 09b5bff8 2020-02-23 naddy .Pp
349 09b5bff8 2020-02-23 naddy The options for
350 09b5bff8 2020-02-23 naddy .Cm tog diff
351 09b5bff8 2020-02-23 naddy are as follows:
352 09b5bff8 2020-02-23 naddy .Bl -tag -width Ds
353 64453f7e 2020-11-21 stsp .It Fl a
354 64453f7e 2020-11-21 stsp Treat file contents as ASCII text even if binary data is detected.
355 3dbaef42 2020-11-24 stsp .It Fl C Ar number
356 3dbaef42 2020-11-24 stsp Set the number of context lines shown in the diff.
357 3dbaef42 2020-11-24 stsp By default, 3 lines of context are shown.
358 09b5bff8 2020-02-23 naddy .It Fl r Ar repository-path
359 09b5bff8 2020-02-23 naddy Use the repository at the specified path.
360 09b5bff8 2020-02-23 naddy If not specified, assume the repository is located at or above the current
361 09b5bff8 2020-02-23 naddy working directory.
362 212b39d1 2020-02-24 naddy If this directory is a
363 212b39d1 2020-02-24 naddy .Xr got 1
364 212b39d1 2020-02-24 naddy work tree, use the repository path associated with this work tree.
365 3dbaef42 2020-11-24 stsp .It Fl w
366 3dbaef42 2020-11-24 stsp Ignore whitespace-only changes.
367 09b5bff8 2020-02-23 naddy .El
368 dfc23429 2019-08-11 stsp .It Cm blame Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Ar path
369 030916b5 2018-07-12 stsp Display line-by-line history of a file at the specified path.
370 030916b5 2018-07-12 stsp .Pp
371 030916b5 2018-07-12 stsp The key bindings for
372 030916b5 2018-07-12 stsp .Cm tog blame
373 640cd7ff 2022-06-22 mark are as follows (N denotes optional prefixed count modifier):
374 030916b5 2018-07-12 stsp .Bl -tag -width Ds
375 02ffd0d5 2021-10-17 stsp .It Cm Down-arrow, j, Ctrl-n
376 640cd7ff 2022-06-22 mark Move the selection cursor down N pages (default: 1).
377 02ffd0d5 2021-10-17 stsp .It Cm Up-arrow, k, Ctrl-p
378 640cd7ff 2022-06-22 mark Move the selection cursor up N pages (default: 1).
379 145b6838 2022-06-16 stsp .It Cm Right-arrow, l
380 640cd7ff 2022-06-22 mark Scroll view to the right N increments (default: 1).
381 640cd7ff 2022-06-22 mark .br
382 f7443f66 2022-06-16 mark File output moves left on the screen.
383 145b6838 2022-06-16 stsp .It Cm Left-arrow, h
384 640cd7ff 2022-06-22 mark Scroll view to the left N increments (default: 1).
385 640cd7ff 2022-06-22 mark .br
386 f7443f66 2022-06-16 mark File output moves right on the screen.
387 145b6838 2022-06-16 stsp .It Cm $
388 145b6838 2022-06-16 stsp Scroll view to the rightmost position.
389 145b6838 2022-06-16 stsp .It Cm 0
390 145b6838 2022-06-16 stsp Scroll view left to the start of the line.
391 61417565 2022-06-20 mark .It Cm Page-down, Space, Ctrl+f, f
392 640cd7ff 2022-06-22 mark Move the selection cursor down N pages (default: 1).
393 61417565 2022-06-20 mark .It Cm Page-up, Ctrl+b, b
394 640cd7ff 2022-06-22 mark Move the selection cursor up N pages (default: 1).
395 33c3719a 2022-06-15 stsp .It Cm Ctrl+d, d
396 640cd7ff 2022-06-22 mark Move the selection cursor down N half pages (default: 1).
397 33c3719a 2022-06-15 stsp .It Cm Ctrl+u, u
398 640cd7ff 2022-06-22 mark Move the selection cursor up N half pages (default: 1).
399 4deef56f 2021-09-02 naddy .It Cm Home, g
400 4deef56f 2021-09-02 naddy Move the selection cursor to the first line of the file.
401 4deef56f 2021-09-02 naddy .It Cm End, G
402 4deef56f 2021-09-02 naddy Move the selection cursor to the last line of the file.
403 030916b5 2018-07-12 stsp .It Cm Enter
404 c0d30c23 2018-10-07 stsp Open a
405 030916b5 2018-07-12 stsp .Cm diff
406 030916b5 2018-07-12 stsp view for the currently selected line's commit.
407 61417565 2022-06-20 mark .It Cm c
408 c0d30c23 2018-10-07 stsp Reload the
409 030916b5 2018-07-12 stsp .Cm blame
410 c0d30c23 2018-10-07 stsp view with the version of the file as found in the currently
411 c0d30c23 2018-10-07 stsp selected line's commit.
412 7a2921f9 2018-07-12 stsp .It Cm p
413 c0d30c23 2018-10-07 stsp Reload the
414 7a2921f9 2018-07-12 stsp .Cm blame
415 c0d30c23 2018-10-07 stsp view with the version of the file as found in the parent commit of the
416 c0d30c23 2018-10-07 stsp currently selected line's commit.
417 61417565 2022-06-20 mark .It Cm C
418 c0d30c23 2018-10-07 stsp Reload the
419 030916b5 2018-07-12 stsp .Cm blame
420 c0d30c23 2018-10-07 stsp view with the previously blamed commit.
421 05f04cdf 2022-07-20 mark .It Cm L
422 05f04cdf 2022-07-20 mark Open a
423 05f04cdf 2022-07-20 mark .Cm log
424 05f04cdf 2022-07-20 mark view for the currently selected annotated line.
425 6c4c42e0 2019-06-24 stsp .It Cm /
426 0e404f95 2020-11-14 stsp Prompt for a search pattern and start searching for matching lines.
427 6c4c42e0 2019-06-24 stsp The search pattern is an extended regular expression.
428 6c4c42e0 2019-06-24 stsp Regular expression syntax is documented in
429 6c4c42e0 2019-06-24 stsp .Xr re_format 7 .
430 6c4c42e0 2019-06-24 stsp .It Cm n
431 640cd7ff 2022-06-22 mark Find the Nth next line which matches the current search pattern (default: 1).
432 6c4c42e0 2019-06-24 stsp .It Cm N
433 640cd7ff 2022-06-22 mark Find the Nth previous line which matches the current search pattern
434 640cd7ff 2022-06-22 mark (default: 1).
435 917d79a7 2022-07-01 stsp .It Cm A
436 917d79a7 2022-07-01 stsp Change the diff algorithm.
437 41e8d27d 2022-07-03 stsp Supported diff algorithms are Myers (quick and dirty) and
438 41e8d27d 2022-07-03 stsp Patience (slow and tidy).
439 917d79a7 2022-07-01 stsp This is a global setting which also affects the
440 917d79a7 2022-07-01 stsp .Cm diff
441 917d79a7 2022-07-01 stsp view.
442 030916b5 2018-07-12 stsp .El
443 030916b5 2018-07-12 stsp .Pp
444 030916b5 2018-07-12 stsp The options for
445 030916b5 2018-07-12 stsp .Cm tog blame
446 030916b5 2018-07-12 stsp are as follows:
447 030916b5 2018-07-12 stsp .Bl -tag -width Ds
448 030916b5 2018-07-12 stsp .It Fl c Ar commit
449 030916b5 2018-07-12 stsp Start traversing history at the specified
450 030916b5 2018-07-12 stsp .Ar commit .
451 a54b6686 2019-06-28 stsp The expected argument is the name of a branch or a commit ID SHA1 hash.
452 0db75f06 2019-07-07 stsp An abbreviated hash argument will be expanded to a full SHA1 hash
453 0db75f06 2019-07-07 stsp automatically, provided the abbreviation is unique.
454 69069811 2018-08-02 stsp .It Fl r Ar repository-path
455 69069811 2018-08-02 stsp Use the repository at the specified path.
456 69069811 2018-08-02 stsp If not specified, assume the repository is located at or above the current
457 69069811 2018-08-02 stsp working directory.
458 212b39d1 2020-02-24 naddy If this directory is a
459 212b39d1 2020-02-24 naddy .Xr got 1
460 212b39d1 2020-02-24 naddy work tree, use the repository path associated with this work tree.
461 030916b5 2018-07-12 stsp .El
462 55cccc34 2020-02-20 stsp .It Cm tree Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar path
463 030916b5 2018-07-12 stsp Display the repository tree.
464 55cccc34 2020-02-20 stsp If a
465 55cccc34 2020-02-20 stsp .Ar path
466 55cccc34 2020-02-20 stsp is specified, show tree entries at this path.
467 030916b5 2018-07-12 stsp .Pp
468 848d6979 2019-08-12 stsp Displayed tree entries may carry one of the following trailing annotations:
469 848d6979 2019-08-12 stsp .Bl -column YXZ description
470 848d6979 2019-08-12 stsp .It @ Ta entry is a symbolic link
471 848d6979 2019-08-12 stsp .It / Ta entry is a directory
472 848d6979 2019-08-12 stsp .It * Ta entry is an executable file
473 63c5ca5d 2019-08-24 stsp .It $ Ta entry is a Git submodule
474 848d6979 2019-08-12 stsp .El
475 0d6c6ee3 2020-05-20 stsp .Pp
476 0d6c6ee3 2020-05-20 stsp Symbolic link entries are also annotated with the target path of the link.
477 848d6979 2019-08-12 stsp .Pp
478 030916b5 2018-07-12 stsp The key bindings for
479 030916b5 2018-07-12 stsp .Cm tog tree
480 640cd7ff 2022-06-22 mark are as follows (N denotes optional prefixed count modifier):
481 030916b5 2018-07-12 stsp .Bl -tag -width Ds
482 02ffd0d5 2021-10-17 stsp .It Cm Down-arrow, j, Ctrl-n
483 640cd7ff 2022-06-22 mark Move the selection cursor down N lines (default: 1).
484 02ffd0d5 2021-10-17 stsp .It Cm Up-arrow, k, Ctrl-p
485 640cd7ff 2022-06-22 mark Move the selection cursor up N lines (default: 1).
486 48bb96f0 2022-06-20 naddy .It Cm Page-down, Space, Ctrl+f, f
487 640cd7ff 2022-06-22 mark Move the selection cursor down N pages (default: 1).
488 61417565 2022-06-20 mark .It Cm Page-up, Ctrl+b, b
489 640cd7ff 2022-06-22 mark Move the selection cursor up N pages (default: 1).
490 33c3719a 2022-06-15 stsp .It Cm Ctrl+d, d
491 640cd7ff 2022-06-22 mark Move the selection cursor down N half pages (default: 1).
492 33c3719a 2022-06-15 stsp .It Cm Ctrl+u, u
493 640cd7ff 2022-06-22 mark Move the selection cursor up N half pages (default: 1).
494 e4526bf5 2021-09-03 naddy .It Cm Home, g
495 e4526bf5 2021-09-03 naddy Move the selection cursor to the first entry.
496 e4526bf5 2021-09-03 naddy .It Cm End, G
497 e4526bf5 2021-09-03 naddy Move the selection cursor to the last entry.
498 030916b5 2018-07-12 stsp .It Cm Enter
499 030916b5 2018-07-12 stsp Enter the currently selected directory, or switch to the
500 030916b5 2018-07-12 stsp .Cm blame
501 030916b5 2018-07-12 stsp view for the currently selected file.
502 5e98fb33 2022-07-22 mark .It Cm L
503 c0d30c23 2018-10-07 stsp Open a
504 69efd4c4 2018-07-18 stsp .Cm log
505 69efd4c4 2018-07-18 stsp view for the currently selected tree entry.
506 5e98fb33 2022-07-22 mark .It Cm R
507 152c1c93 2020-11-29 stsp Open a
508 152c1c93 2020-11-29 stsp .Cm ref
509 152c1c93 2020-11-29 stsp view listing all references in the repository.
510 152c1c93 2020-11-29 stsp This can then be used to open a new
511 152c1c93 2020-11-29 stsp .Cm tree
512 152c1c93 2020-11-29 stsp view for arbitrary branches and tags.
513 7837eeac 2018-09-24 stsp .It Cm Backspace
514 640cd7ff 2022-06-22 mark Move back to the Nth parent directory (default: 1).
515 030916b5 2018-07-12 stsp .It Cm i
516 c0d30c23 2018-10-07 stsp Show object IDs for all objects displayed in the
517 030916b5 2018-07-12 stsp .Cm tree
518 030916b5 2018-07-12 stsp view.
519 4eec20aa 2019-06-22 stsp .It Cm /
520 4eec20aa 2019-06-22 stsp Prompt for a search pattern and start searching for matching tree entries.
521 4eec20aa 2019-06-22 stsp The search pattern is an extended regular expression which is matched
522 4eec20aa 2019-06-22 stsp against the tree entry's name.
523 4eec20aa 2019-06-22 stsp Regular expression syntax is documented in
524 4eec20aa 2019-06-22 stsp .Xr re_format 7 .
525 4eec20aa 2019-06-22 stsp .It Cm n
526 640cd7ff 2022-06-22 mark Find the Nth next tree entry which matches the current search pattern
527 640cd7ff 2022-06-22 mark (default: 1).
528 4eec20aa 2019-06-22 stsp .It Cm N
529 640cd7ff 2022-06-22 mark Find the Nth previous tree entry which matches the current search pattern
530 640cd7ff 2022-06-22 mark (default: 1).
531 030916b5 2018-07-12 stsp .El
532 030916b5 2018-07-12 stsp .Pp
533 030916b5 2018-07-12 stsp The options for
534 030916b5 2018-07-12 stsp .Cm tog tree
535 030916b5 2018-07-12 stsp are as follows:
536 030916b5 2018-07-12 stsp .Bl -tag -width Ds
537 030916b5 2018-07-12 stsp .It Fl c Ar commit
538 030916b5 2018-07-12 stsp Start traversing history at the specified
539 030916b5 2018-07-12 stsp .Ar commit .
540 a54b6686 2019-06-28 stsp The expected argument is the name of a branch or a commit ID SHA1 hash.
541 0db75f06 2019-07-07 stsp An abbreviated hash argument will be expanded to a full SHA1 hash
542 0db75f06 2019-07-07 stsp automatically, provided the abbreviation is unique.
543 38cb327b 2020-11-24 stsp .It Fl r Ar repository-path
544 38cb327b 2020-11-24 stsp Use the repository at the specified path.
545 38cb327b 2020-11-24 stsp If not specified, assume the repository is located at or above the current
546 38cb327b 2020-11-24 stsp working directory.
547 38cb327b 2020-11-24 stsp If this directory is a
548 38cb327b 2020-11-24 stsp .Xr got 1
549 38cb327b 2020-11-24 stsp work tree, use the repository path associated with this work tree.
550 38cb327b 2020-11-24 stsp .El
551 38cb327b 2020-11-24 stsp .It Cm ref Oo Fl r Ar repository-path Oc
552 38cb327b 2020-11-24 stsp Display references in the repository.
553 38cb327b 2020-11-24 stsp .Pp
554 38cb327b 2020-11-24 stsp The key bindings for
555 38cb327b 2020-11-24 stsp .Cm tog ref
556 640cd7ff 2022-06-22 mark are as follows (N denotes optional prefixed count modifier):
557 38cb327b 2020-11-24 stsp .Bl -tag -width Ds
558 02ffd0d5 2021-10-17 stsp .It Cm Down-arrow, j, Ctrl-n
559 640cd7ff 2022-06-22 mark Move the selection cursor down N lines (default: 1).
560 02ffd0d5 2021-10-17 stsp .It Cm Up-arrow, k, Ctrl-p
561 640cd7ff 2022-06-22 mark Move the selection cursor up N lines (default: 1).
562 48bb96f0 2022-06-20 naddy .It Cm Page-down, Space, Ctrl+f, f
563 640cd7ff 2022-06-22 mark Move the selection cursor down N pages (default: 1).
564 61417565 2022-06-20 mark .It Cm Page-up, Ctrl+b, b
565 640cd7ff 2022-06-22 mark Move the selection cursor up N pages (default: 1).
566 33c3719a 2022-06-15 stsp .It Cm Ctrl+d, d
567 640cd7ff 2022-06-22 mark Move the selection cursor down N half pages (default: 1).
568 33c3719a 2022-06-15 stsp .It Cm Ctrl+u, u
569 640cd7ff 2022-06-22 mark Move the selection cursor up N half pages (default: 1).
570 e4526bf5 2021-09-03 naddy .It Cm Home, g
571 e4526bf5 2021-09-03 naddy Move the selection cursor to the first reference.
572 e4526bf5 2021-09-03 naddy .It Cm End, G
573 e4526bf5 2021-09-03 naddy Move the selection cursor to the last reference.
574 38cb327b 2020-11-24 stsp .It Cm Enter
575 01ca22b1 2020-12-07 stsp Open a
576 01ca22b1 2020-12-07 stsp .Cm log
577 01ca22b1 2020-12-07 stsp view which begins traversing history at the commit resolved via the
578 38cb327b 2020-11-24 stsp currently selected reference.
579 5e98fb33 2022-07-22 mark .It Cm T
580 c42c9805 2020-11-24 stsp Open a
581 c42c9805 2020-11-24 stsp .Cm tree
582 c42c9805 2020-11-24 stsp view showing the tree resolved via the currently selected reference.
583 38cb327b 2020-11-24 stsp .It Cm i
584 38cb327b 2020-11-24 stsp Show object IDs for all non-symbolic references displayed in the
585 38cb327b 2020-11-24 stsp .Cm ref
586 38cb327b 2020-11-24 stsp view.
587 b4996bee 2022-06-16 stsp .It Cm m
588 b4996bee 2022-06-16 stsp Show last modified date of each displayed reference.
589 07a065fe 2021-11-20 stsp .It Cm o
590 7f66531d 2021-11-16 stsp Toggle display order of references between sort by name and sort by timestamp.
591 38cb327b 2020-11-24 stsp .It Cm /
592 38cb327b 2020-11-24 stsp Prompt for a search pattern and start searching for matching references.
593 38cb327b 2020-11-24 stsp The search pattern is an extended regular expression which is matched
594 38cb327b 2020-11-24 stsp against absolute reference names.
595 38cb327b 2020-11-24 stsp Regular expression syntax is documented in
596 38cb327b 2020-11-24 stsp .Xr re_format 7 .
597 38cb327b 2020-11-24 stsp .It Cm n
598 640cd7ff 2022-06-22 mark Find the Nth next reference which matches the current search pattern
599 640cd7ff 2022-06-22 mark (default: 1).
600 38cb327b 2020-11-24 stsp .It Cm N
601 640cd7ff 2022-06-22 mark Find the Nth previous reference which matches the current search pattern
602 640cd7ff 2022-06-22 mark (default: 1).
603 38cb327b 2020-11-24 stsp .It Cm Ctrl+l
604 38cb327b 2020-11-24 stsp Reload the list of references displayed by the
605 38cb327b 2020-11-24 stsp .Cm ref
606 38cb327b 2020-11-24 stsp view.
607 38cb327b 2020-11-24 stsp .El
608 38cb327b 2020-11-24 stsp .Pp
609 38cb327b 2020-11-24 stsp The options for
610 38cb327b 2020-11-24 stsp .Cm tog ref
611 38cb327b 2020-11-24 stsp are as follows:
612 38cb327b 2020-11-24 stsp .Bl -tag -width Ds
613 74283ab8 2020-02-07 stsp .It Fl r Ar repository-path
614 74283ab8 2020-02-07 stsp Use the repository at the specified path.
615 74283ab8 2020-02-07 stsp If not specified, assume the repository is located at or above the current
616 74283ab8 2020-02-07 stsp working directory.
617 74283ab8 2020-02-07 stsp If this directory is a
618 74283ab8 2020-02-07 stsp .Xr got 1
619 74283ab8 2020-02-07 stsp work tree, use the repository path associated with this work tree.
620 030916b5 2018-07-12 stsp .El
621 030916b5 2018-07-12 stsp .El
622 6d17833f 2019-11-08 stsp .Sh ENVIRONMENT
623 d2366e29 2022-07-07 mark .Bl -tag -width TOG_VIEW_SPLIT_MODE
624 917d79a7 2022-07-01 stsp .It Ev TOG_DIFF_ALGORITHM
625 917d79a7 2022-07-01 stsp Determines the default diff algorithm used by
626 917d79a7 2022-07-01 stsp .Nm .
627 41e8d27d 2022-07-03 stsp Supported diff algorithms are Myers (quick and dirty) and
628 41e8d27d 2022-07-03 stsp Patience (slow and tidy).
629 41e8d27d 2022-07-03 stsp Valid values for
630 41e8d27d 2022-07-03 stsp .Ev TOG_DIFF_ALGORITHM
631 41e8d27d 2022-07-03 stsp are
632 917d79a7 2022-07-01 stsp .Dq patience
633 917d79a7 2022-07-01 stsp and
634 917d79a7 2022-07-01 stsp .Dq myers .
635 917d79a7 2022-07-01 stsp If unset, the Myers diff algorithm will be used by default.
636 619b3b49 2022-07-04 stsp .It Ev TOG_VIEW_SPLIT_MODE
637 2572d286 2022-07-12 stsp Determines the default layout of split-screen views.
638 619b3b49 2022-07-04 stsp If set to
639 619b3b49 2022-07-04 stsp .Dq h
640 2572d286 2022-07-12 stsp or
641 2572d286 2022-07-12 stsp .Dq H ,
642 2572d286 2022-07-12 stsp .Nm
643 2572d286 2022-07-12 stsp will use horizontal split by default.
644 2572d286 2022-07-12 stsp Otherwise, vertical split will be used.
645 2572d286 2022-07-12 stsp The
646 2572d286 2022-07-12 stsp .Cm S
647 2572d286 2022-07-12 stsp key can be used to switch between vertical and horizontal split layout
648 2572d286 2022-07-12 stsp at run-time.
649 6d17833f 2019-11-08 stsp .It Ev TOG_COLORS
650 6d17833f 2019-11-08 stsp .Nm
651 6d17833f 2019-11-08 stsp shows colorized output if this variable is set to a non-empty value.
652 6d17833f 2019-11-08 stsp The default color scheme can be modified by setting the environment
653 6d17833f 2019-11-08 stsp variables documented below.
654 6d17833f 2019-11-08 stsp The colors available in color schemes are
655 6d17833f 2019-11-08 stsp .Dq black ,
656 6d17833f 2019-11-08 stsp .Dq red ,
657 6d17833f 2019-11-08 stsp .Dq green ,
658 6d17833f 2019-11-08 stsp .Dq yellow ,
659 6d17833f 2019-11-08 stsp .Dq blue ,
660 93a300b2 2021-08-26 stsp .Dq magenta ,
661 1d7fe5cd 2019-11-08 stsp .Dq cyan ,
662 6d17833f 2019-11-08 stsp and
663 1d7fe5cd 2019-11-08 stsp .Dq default
664 1d7fe5cd 2019-11-08 stsp which maps to the terminal's default foreground color.
665 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_MINUS
666 6d17833f 2019-11-08 stsp The color used to mark up removed lines in diffs.
667 6d17833f 2019-11-08 stsp If not set, the default value
668 6d17833f 2019-11-08 stsp .Dq magenta
669 6d17833f 2019-11-08 stsp is used.
670 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_PLUS
671 6d17833f 2019-11-08 stsp The color used to mark up added lines in diffs.
672 6d17833f 2019-11-08 stsp If not set, the default value
673 6d17833f 2019-11-08 stsp .Dq cyan
674 6d17833f 2019-11-08 stsp is used.
675 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_CHUNK_HEADER
676 6d17833f 2019-11-08 stsp The color used to mark up chunk header lines in diffs.
677 6d17833f 2019-11-08 stsp If not set, the default value
678 6d17833f 2019-11-08 stsp .Dq yellow
679 6d17833f 2019-11-08 stsp is used.
680 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_META
681 6d17833f 2019-11-08 stsp The color used to mark up meta data in diffs.
682 c0b01bdb 2019-11-08 stsp If not set, the default value
683 c0b01bdb 2019-11-08 stsp .Dq green
684 c0b01bdb 2019-11-08 stsp is used.
685 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_SUBMODULE
686 93a300b2 2021-08-26 stsp The color used to mark up submodule tree entries.
687 c0b01bdb 2019-11-08 stsp If not set, the default value
688 c0b01bdb 2019-11-08 stsp .Dq magenta
689 c0b01bdb 2019-11-08 stsp is used.
690 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_SYMLINK
691 c0b01bdb 2019-11-08 stsp The color used to mark up symbolic link tree entries.
692 c0b01bdb 2019-11-08 stsp If not set, the default value
693 91b8c405 2020-01-25 stsp .Dq magenta
694 c0b01bdb 2019-11-08 stsp is used.
695 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_DIRECTORY
696 c0b01bdb 2019-11-08 stsp The color used to mark up directory tree entries.
697 6d17833f 2019-11-08 stsp If not set, the default value
698 91b8c405 2020-01-25 stsp .Dq cyan
699 c0b01bdb 2019-11-08 stsp is used.
700 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_EXECUTABLE
701 c0b01bdb 2019-11-08 stsp The color used to mark up executable file tree entries.
702 c0b01bdb 2019-11-08 stsp If not set, the default value
703 6d17833f 2019-11-08 stsp .Dq green
704 6d17833f 2019-11-08 stsp is used.
705 11b20872 2019-11-08 stsp .It Ev TOG_COLOR_COMMIT
706 11b20872 2019-11-08 stsp The color used to mark up commit IDs.
707 11b20872 2019-11-08 stsp If not set, the default value
708 11b20872 2019-11-08 stsp .Dq green
709 11b20872 2019-11-08 stsp is used.
710 11b20872 2019-11-08 stsp .It Ev TOG_COLOR_AUTHOR
711 11b20872 2019-11-08 stsp The color used to mark up author information.
712 11b20872 2019-11-08 stsp If not set, the default value
713 11b20872 2019-11-08 stsp .Dq cyan
714 11b20872 2019-11-08 stsp is used.
715 11b20872 2019-11-08 stsp .It Ev TOG_COLOR_DATE
716 11b20872 2019-11-08 stsp The color used to mark up date information.
717 11b20872 2019-11-08 stsp If not set, the default value
718 11b20872 2019-11-08 stsp .Dq yellow
719 11b20872 2019-11-08 stsp is used.
720 38cb327b 2020-11-24 stsp .It Ev TOG_COLOR_REFS_HEADS
721 38cb327b 2020-11-24 stsp The color used to mark up references in the
722 38cb327b 2020-11-24 stsp .Dq refs/heads/
723 38cb327b 2020-11-24 stsp namespace.
724 38cb327b 2020-11-24 stsp If not set, the default value
725 38cb327b 2020-11-24 stsp .Dq green
726 38cb327b 2020-11-24 stsp is used.
727 38cb327b 2020-11-24 stsp .It Ev TOG_COLOR_REFS_TAGS
728 38cb327b 2020-11-24 stsp The color used to mark up references in the
729 38cb327b 2020-11-24 stsp .Dq refs/tags/
730 38cb327b 2020-11-24 stsp namespace.
731 38cb327b 2020-11-24 stsp If not set, the default value
732 38cb327b 2020-11-24 stsp .Dq magenta
733 38cb327b 2020-11-24 stsp is used.
734 38cb327b 2020-11-24 stsp .It Ev TOG_COLOR_REFS_REMOTES
735 38cb327b 2020-11-24 stsp The color used to mark up references in the
736 38cb327b 2020-11-24 stsp .Dq refs/remotes/
737 38cb327b 2020-11-24 stsp namespace.
738 38cb327b 2020-11-24 stsp If not set, the default value
739 38cb327b 2020-11-24 stsp .Dq yellow
740 38cb327b 2020-11-24 stsp is used.
741 cc488aa7 2022-01-23 stsp .It Ev TOG_COLOR_REFS_BACKUP
742 cc488aa7 2022-01-23 stsp The color used to mark up references in the
743 cc488aa7 2022-01-23 stsp .Dq refs/got/backup/
744 cc488aa7 2022-01-23 stsp namespace.
745 cc488aa7 2022-01-23 stsp If not set, the default value
746 cc488aa7 2022-01-23 stsp .Dq cyan
747 cc488aa7 2022-01-23 stsp is used.
748 6d17833f 2019-11-08 stsp .El
749 030916b5 2018-07-12 stsp .Sh EXIT STATUS
750 030916b5 2018-07-12 stsp .Ex -std tog
751 030916b5 2018-07-12 stsp .Sh SEE ALSO
752 56b9a4ca 2019-06-21 stsp .Xr got 1 ,
753 56b9a4ca 2019-06-21 stsp .Xr git-repository 5 ,
754 56b9a4ca 2019-06-21 stsp .Xr re_format 7
755 030916b5 2018-07-12 stsp .Sh AUTHORS
756 8ca658b9 2022-07-05 stsp .An Christian Weisgerber Aq Mt naddy@openbsd.org
757 8ca658b9 2022-07-05 stsp .An Josh Rickmar Aq Mt jrick@zettaport.com
758 bc3056e3 2019-08-18 stsp .An Joshua Stein Aq Mt jcs@openbsd.org
759 8ca658b9 2022-07-05 stsp .An Mark Jamsek Aq Mt mark@jamsek.dev
760 8ca658b9 2022-07-05 stsp .An Martin Pieuchot Aq Mt mpi@openbsd.org
761 8ca658b9 2022-07-05 stsp .An Omar Polo Aq Mt op@openbsd.org
762 8ca658b9 2022-07-05 stsp .An Stefan Sperling Aq Mt stsp@openbsd.org
763 8ca658b9 2022-07-05 stsp .An Klemens Nanni Aq Mt kn@openbsd.org