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 07b0611c 2022-06-23 thomas Some command-specific key bindings may be prefixed with an integer, which is
 59 07b0611c 2022-06-23 thomas denoted by N in the descriptions below, and is used as a modifier to the
 60 07b0611c 2022-06-23 thomas operation as indicated.
 61 07b0611c 2022-06-23 thomas .Nm
 62 fa502711 2022-07-03 thomas will echo digits to the screen when count modifiers are entered, and complete
 63 fa502711 2022-07-03 thomas the sequence upon input of the first non-numeric character.
 64 fa502711 2022-07-03 thomas Count modifiers can be aborted by entering an unmapped key.
 65 634cb454 2022-07-03 thomas Once a compound command is executed, the operation can be cancelled with
 66 634cb454 2022-07-03 thomas .Cm C-g
 67 634cb454 2022-07-03 thomas or
 68 634cb454 2022-07-03 thomas .Cm Backspace .
 69 7faa2de4 2022-07-12 thomas .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 1c5e5faa 2022-06-23 thomas .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 b1c950bf 2022-07-12 thomas will automatically use vertical split-screen views if the size of the
 83 b1c950bf 2022-07-12 thomas terminal window is sufficiently large.
 84 64486692 2022-07-07 thomas .It Cm S
 85 569abcd7 2022-07-12 thomas Switch the current split-screen layout, and render all active views in
 86 569abcd7 2022-07-12 thomas this new layout.
 87 b1c950bf 2022-07-12 thomas The split-screen layout can be either vertical or horizontal.
 88 569abcd7 2022-07-12 thomas If the terminal is not wide enough when switching to a vertical split,
 89 569abcd7 2022-07-12 thomas views will render in fullscreen.
 90 53d2bdd3 2022-07-10 thomas .It Cm -
 91 53d2bdd3 2022-07-10 thomas When in a split-screen view, decrease the size of the focussed split
 92 53d2bdd3 2022-07-10 thomas N increments (default: 1).
 93 53d2bdd3 2022-07-10 thomas .It Cm +
 94 53d2bdd3 2022-07-10 thomas When in a split-screen view, increase the size of the focussed split
 95 53d2bdd3 2022-07-10 thomas N increments (default: 1).
 96 07dd3ed3 2022-08-06 thomas .It Cm G
 97 07dd3ed3 2022-08-06 thomas Go to line N in the view (default: last line).
 98 07dd3ed3 2022-08-06 thomas .It Cm g
 99 07dd3ed3 2022-08-06 thomas 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 07b0611c 2022-06-23 thomas are as follows (N denotes optional prefixed count modifier):
130 030916b5 2018-07-12 stsp .Bl -tag -width Ds
131 f7140bf5 2021-10-17 thomas .It Cm Down-arrow, j, >, Full stop, Ctrl-n
132 07b0611c 2022-06-23 thomas Move the selection cursor down N lines (default: 1).
133 f7140bf5 2021-10-17 thomas .It Cm Up-arrow, k, <, Comma, Ctrl-p
134 07b0611c 2022-06-23 thomas Move the selection cursor up N lines (default: 1).
135 05171be4 2022-06-23 thomas .It Cm Right-arrow, l
136 07b0611c 2022-06-23 thomas Scroll log message field to the right N increments (default: 1).
137 07b0611c 2022-06-23 thomas .br
138 d74d8993 2022-06-23 thomas Log message moves left on the screen.
139 05171be4 2022-06-23 thomas .It Cm Left-arrow, h
140 07b0611c 2022-06-23 thomas Scroll log message field to the left N increments (default: 1).
141 07b0611c 2022-06-23 thomas .br
142 d74d8993 2022-06-23 thomas Log message moves right on the screen.
143 05171be4 2022-06-23 thomas .It Cm $
144 05171be4 2022-06-23 thomas Scroll log message field to the rightmost position.
145 05171be4 2022-06-23 thomas .It Cm 0
146 05171be4 2022-06-23 thomas Scroll log message field to the leftmost position.
147 4c2d69cb 2022-06-23 thomas .It Cm Page-down, Space, Ctrl+f, f
148 07b0611c 2022-06-23 thomas Move the selection cursor down N pages (default: 1).
149 1c5e5faa 2022-06-23 thomas .It Cm Page-up, Ctrl+b, b
150 07b0611c 2022-06-23 thomas Move the selection cursor up N pages (default: 1).
151 23427b14 2022-06-23 thomas .It Cm Ctrl+d, d
152 07b0611c 2022-06-23 thomas Move the selection cursor down N half pages (default: 1).
153 23427b14 2022-06-23 thomas .It Cm Ctrl+u, u
154 07b0611c 2022-06-23 thomas 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 4b06140e 2022-03-22 thomas If needed, this operation can be cancelled with
162 634cb454 2022-07-03 thomas .Cm C-g
163 634cb454 2022-07-03 thomas or
164 9ebbe6e1 2021-08-30 stsp .Cm Backspace .
165 4c2d69cb 2022-06-23 thomas .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 1be4947a 2022-07-22 thomas .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 07b0611c 2022-06-23 thomas Find the Nth next commit which matches the current search pattern (default: 1).
188 07b0611c 2022-06-23 thomas .br
189 634cb454 2022-07-03 thomas Searching continues until either a match is found or
190 634cb454 2022-07-03 thomas .Cm C-g
191 634cb454 2022-07-03 thomas 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 07b0611c 2022-06-23 thomas Find the Nth previous commit which matches the current search pattern
196 07b0611c 2022-06-23 thomas (default: 1).
197 07b0611c 2022-06-23 thomas .br
198 634cb454 2022-07-03 thomas Searching continues until either a match is found or
199 634cb454 2022-07-03 thomas .Cm C-g
200 634cb454 2022-07-03 thomas 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 1be4947a 2022-07-22 thomas .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 f69c5a46 2022-07-19 thomas .It Cm @
222 f69c5a46 2022-07-19 thomas 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 21920d7e 2020-12-07 stsp .It Cm diff Oo Fl a Oc Oo Fl C Ar number Oc Oo Fl r Ar repository-path Oc Oo Fl w 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 07b0611c 2022-06-23 thomas 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 f7140bf5 2021-10-17 thomas .It Cm Down-arrow, j, Ctrl-n
270 07b0611c 2022-06-23 thomas Scroll down N lines (default: 1).
271 f7140bf5 2021-10-17 thomas .It Cm Up-arrow, k, Ctrl-p
272 07b0611c 2022-06-23 thomas Scroll up N lines (default: 1).
273 05171be4 2022-06-23 thomas .It Cm Right-arrow, l
274 07b0611c 2022-06-23 thomas Scroll view to the right N increments (default: 1).
275 07b0611c 2022-06-23 thomas .br
276 d74d8993 2022-06-23 thomas Diff output moves left on the screen.
277 05171be4 2022-06-23 thomas .It Cm Left-arrow, h
278 07b0611c 2022-06-23 thomas Scroll view to the left N increments (default: 1).
279 07b0611c 2022-06-23 thomas .br
280 d74d8993 2022-06-23 thomas Diff output moves right on the screen.
281 05171be4 2022-06-23 thomas .It Cm $
282 05171be4 2022-06-23 thomas Scroll view to the rightmost position.
283 05171be4 2022-06-23 thomas .It Cm 0
284 05171be4 2022-06-23 thomas Scroll view left to the start of the line.
285 1c5e5faa 2022-06-23 thomas .It Cm Page-down, Space, Ctrl+f, f
286 07b0611c 2022-06-23 thomas Scroll down N pages (default: 1).
287 1c5e5faa 2022-06-23 thomas .It Cm Page-up, Ctrl+b, b
288 07b0611c 2022-06-23 thomas Scroll up N pages (default: 1).
289 23427b14 2022-06-23 thomas .It Cm Ctrl+d, d
290 07b0611c 2022-06-23 thomas Scroll down N half pages (default: 1).
291 23427b14 2022-06-23 thomas .It Cm Ctrl+u, u
292 07b0611c 2022-06-23 thomas 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 dfc23429 2019-08-11 stsp .It Cm \&[
298 07b0611c 2022-06-23 thomas Reduce diff context by N lines (default: 1).
299 dfc23429 2019-08-11 stsp .It Cm \&]
300 07b0611c 2022-06-23 thomas Increase diff context by N lines (default: 1).
301 777aae21 2022-07-20 thomas .It Cm <, Comma, K
302 01ca22b1 2020-12-07 stsp If the
303 01ca22b1 2020-12-07 stsp .Cm diff
304 01ca22b1 2020-12-07 stsp view was opened via the
305 01ca22b1 2020-12-07 stsp .Cm log
306 4fc71f3b 2022-07-12 thomas view, move to the Nth previous (younger) commit.
307 4fc71f3b 2022-07-12 thomas If the diff was opened via the
308 4fc71f3b 2022-07-12 thomas .Cm blame
309 4fc71f3b 2022-07-12 thomas view, move to the Nth previous line and load the corresponding commit
310 4fc71f3b 2022-07-12 thomas (default: 1).
311 777aae21 2022-07-20 thomas .It Cm >, Full stop, J
312 01ca22b1 2020-12-07 stsp If the
313 01ca22b1 2020-12-07 stsp .Cm diff
314 01ca22b1 2020-12-07 stsp view was opened via the
315 01ca22b1 2020-12-07 stsp .Cm log
316 4fc71f3b 2022-07-12 thomas view, move to the Nth next (older) commit.
317 4fc71f3b 2022-07-12 thomas If the diff was opened via the
318 4fc71f3b 2022-07-12 thomas .Cm blame
319 4fc71f3b 2022-07-12 thomas view, move to the Nth next line and load the corresponding commit (default: 1).
320 66dc9065 2020-02-15 stsp .It Cm /
321 0e404f95 2020-11-14 stsp Prompt for a search pattern and start searching for matching lines.
322 66dc9065 2020-02-15 stsp The search pattern is an extended regular expression.
323 66dc9065 2020-02-15 stsp Regular expression syntax is documented in
324 66dc9065 2020-02-15 stsp .Xr re_format 7 .
325 66dc9065 2020-02-15 stsp .It Cm n
326 07b0611c 2022-06-23 thomas Find the Nth next line which matches the current search pattern (default: 1).
327 66dc9065 2020-02-15 stsp .It Cm N
328 07b0611c 2022-06-23 thomas Find the Nth previous line which matches the current search pattern
329 07b0611c 2022-06-23 thomas (default: 1).
330 3dbaef42 2020-11-24 stsp .It Cm w
331 3dbaef42 2020-11-24 stsp Toggle display of whitespace-only changes.
332 adf4c9e0 2022-07-03 thomas .It Cm A
333 adf4c9e0 2022-07-03 thomas Change the diff algorithm.
334 d40a767d 2022-07-03 thomas Supported diff algorithms are Myers (quick and dirty) and
335 d40a767d 2022-07-03 thomas Patience (slow and tidy).
336 adf4c9e0 2022-07-03 thomas This is a global setting which also affects the
337 adf4c9e0 2022-07-03 thomas .Cm blame
338 adf4c9e0 2022-07-03 thomas view.
339 030916b5 2018-07-12 stsp .El
340 09b5bff8 2020-02-23 naddy .Pp
341 09b5bff8 2020-02-23 naddy The options for
342 09b5bff8 2020-02-23 naddy .Cm tog diff
343 09b5bff8 2020-02-23 naddy are as follows:
344 09b5bff8 2020-02-23 naddy .Bl -tag -width Ds
345 64453f7e 2020-11-21 stsp .It Fl a
346 64453f7e 2020-11-21 stsp Treat file contents as ASCII text even if binary data is detected.
347 3dbaef42 2020-11-24 stsp .It Fl C Ar number
348 3dbaef42 2020-11-24 stsp Set the number of context lines shown in the diff.
349 3dbaef42 2020-11-24 stsp By default, 3 lines of context are shown.
350 09b5bff8 2020-02-23 naddy .It Fl r Ar repository-path
351 09b5bff8 2020-02-23 naddy Use the repository at the specified path.
352 09b5bff8 2020-02-23 naddy If not specified, assume the repository is located at or above the current
353 09b5bff8 2020-02-23 naddy working directory.
354 212b39d1 2020-02-24 naddy If this directory is a
355 212b39d1 2020-02-24 naddy .Xr got 1
356 212b39d1 2020-02-24 naddy work tree, use the repository path associated with this work tree.
357 3dbaef42 2020-11-24 stsp .It Fl w
358 3dbaef42 2020-11-24 stsp Ignore whitespace-only changes.
359 09b5bff8 2020-02-23 naddy .El
360 dfc23429 2019-08-11 stsp .It Cm blame Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Ar path
361 030916b5 2018-07-12 stsp Display line-by-line history of a file at the specified path.
362 030916b5 2018-07-12 stsp .Pp
363 030916b5 2018-07-12 stsp The key bindings for
364 030916b5 2018-07-12 stsp .Cm tog blame
365 07b0611c 2022-06-23 thomas are as follows (N denotes optional prefixed count modifier):
366 030916b5 2018-07-12 stsp .Bl -tag -width Ds
367 f7140bf5 2021-10-17 thomas .It Cm Down-arrow, j, Ctrl-n
368 07b0611c 2022-06-23 thomas Move the selection cursor down N pages (default: 1).
369 f7140bf5 2021-10-17 thomas .It Cm Up-arrow, k, Ctrl-p
370 07b0611c 2022-06-23 thomas Move the selection cursor up N pages (default: 1).
371 05171be4 2022-06-23 thomas .It Cm Right-arrow, l
372 07b0611c 2022-06-23 thomas Scroll view to the right N increments (default: 1).
373 07b0611c 2022-06-23 thomas .br
374 d74d8993 2022-06-23 thomas File output moves left on the screen.
375 05171be4 2022-06-23 thomas .It Cm Left-arrow, h
376 07b0611c 2022-06-23 thomas Scroll view to the left N increments (default: 1).
377 07b0611c 2022-06-23 thomas .br
378 d74d8993 2022-06-23 thomas File output moves right on the screen.
379 05171be4 2022-06-23 thomas .It Cm $
380 05171be4 2022-06-23 thomas Scroll view to the rightmost position.
381 05171be4 2022-06-23 thomas .It Cm 0
382 05171be4 2022-06-23 thomas Scroll view left to the start of the line.
383 1c5e5faa 2022-06-23 thomas .It Cm Page-down, Space, Ctrl+f, f
384 07b0611c 2022-06-23 thomas Move the selection cursor down N pages (default: 1).
385 1c5e5faa 2022-06-23 thomas .It Cm Page-up, Ctrl+b, b
386 07b0611c 2022-06-23 thomas Move the selection cursor up N pages (default: 1).
387 23427b14 2022-06-23 thomas .It Cm Ctrl+d, d
388 07b0611c 2022-06-23 thomas Move the selection cursor down N half pages (default: 1).
389 23427b14 2022-06-23 thomas .It Cm Ctrl+u, u
390 07b0611c 2022-06-23 thomas Move the selection cursor up N half pages (default: 1).
391 4deef56f 2021-09-02 naddy .It Cm Home, g
392 4deef56f 2021-09-02 naddy Move the selection cursor to the first line of the file.
393 4deef56f 2021-09-02 naddy .It Cm End, G
394 4deef56f 2021-09-02 naddy Move the selection cursor to the last line of the file.
395 030916b5 2018-07-12 stsp .It Cm Enter
396 c0d30c23 2018-10-07 stsp Open a
397 030916b5 2018-07-12 stsp .Cm diff
398 030916b5 2018-07-12 stsp view for the currently selected line's commit.
399 1c5e5faa 2022-06-23 thomas .It Cm c
400 c0d30c23 2018-10-07 stsp Reload the
401 030916b5 2018-07-12 stsp .Cm blame
402 c0d30c23 2018-10-07 stsp view with the version of the file as found in the currently
403 c0d30c23 2018-10-07 stsp selected line's commit.
404 7a2921f9 2018-07-12 stsp .It Cm p
405 c0d30c23 2018-10-07 stsp Reload the
406 7a2921f9 2018-07-12 stsp .Cm blame
407 c0d30c23 2018-10-07 stsp view with the version of the file as found in the parent commit of the
408 c0d30c23 2018-10-07 stsp currently selected line's commit.
409 1c5e5faa 2022-06-23 thomas .It Cm C
410 c0d30c23 2018-10-07 stsp Reload the
411 030916b5 2018-07-12 stsp .Cm blame
412 c0d30c23 2018-10-07 stsp view with the previously blamed commit.
413 eaeaa612 2022-07-20 thomas .It Cm L
414 eaeaa612 2022-07-20 thomas Open a
415 eaeaa612 2022-07-20 thomas .Cm log
416 eaeaa612 2022-07-20 thomas view for the currently selected annotated line.
417 6c4c42e0 2019-06-24 stsp .It Cm /
418 0e404f95 2020-11-14 stsp Prompt for a search pattern and start searching for matching lines.
419 6c4c42e0 2019-06-24 stsp The search pattern is an extended regular expression.
420 6c4c42e0 2019-06-24 stsp Regular expression syntax is documented in
421 6c4c42e0 2019-06-24 stsp .Xr re_format 7 .
422 6c4c42e0 2019-06-24 stsp .It Cm n
423 07b0611c 2022-06-23 thomas Find the Nth next line which matches the current search pattern (default: 1).
424 6c4c42e0 2019-06-24 stsp .It Cm N
425 07b0611c 2022-06-23 thomas Find the Nth previous line which matches the current search pattern
426 07b0611c 2022-06-23 thomas (default: 1).
427 adf4c9e0 2022-07-03 thomas .It Cm A
428 adf4c9e0 2022-07-03 thomas Change the diff algorithm.
429 d40a767d 2022-07-03 thomas Supported diff algorithms are Myers (quick and dirty) and
430 d40a767d 2022-07-03 thomas Patience (slow and tidy).
431 adf4c9e0 2022-07-03 thomas This is a global setting which also affects the
432 adf4c9e0 2022-07-03 thomas .Cm diff
433 adf4c9e0 2022-07-03 thomas view.
434 030916b5 2018-07-12 stsp .El
435 030916b5 2018-07-12 stsp .Pp
436 030916b5 2018-07-12 stsp The options for
437 030916b5 2018-07-12 stsp .Cm tog blame
438 030916b5 2018-07-12 stsp are as follows:
439 030916b5 2018-07-12 stsp .Bl -tag -width Ds
440 030916b5 2018-07-12 stsp .It Fl c Ar commit
441 030916b5 2018-07-12 stsp Start traversing history at the specified
442 030916b5 2018-07-12 stsp .Ar commit .
443 a54b6686 2019-06-28 stsp The expected argument is the name of a branch or a commit ID SHA1 hash.
444 0db75f06 2019-07-07 stsp An abbreviated hash argument will be expanded to a full SHA1 hash
445 0db75f06 2019-07-07 stsp automatically, provided the abbreviation is unique.
446 69069811 2018-08-02 stsp .It Fl r Ar repository-path
447 69069811 2018-08-02 stsp Use the repository at the specified path.
448 69069811 2018-08-02 stsp If not specified, assume the repository is located at or above the current
449 69069811 2018-08-02 stsp working directory.
450 212b39d1 2020-02-24 naddy If this directory is a
451 212b39d1 2020-02-24 naddy .Xr got 1
452 212b39d1 2020-02-24 naddy work tree, use the repository path associated with this work tree.
453 030916b5 2018-07-12 stsp .El
454 55cccc34 2020-02-20 stsp .It Cm tree Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar path
455 030916b5 2018-07-12 stsp Display the repository tree.
456 55cccc34 2020-02-20 stsp If a
457 55cccc34 2020-02-20 stsp .Ar path
458 55cccc34 2020-02-20 stsp is specified, show tree entries at this path.
459 030916b5 2018-07-12 stsp .Pp
460 848d6979 2019-08-12 stsp Displayed tree entries may carry one of the following trailing annotations:
461 848d6979 2019-08-12 stsp .Bl -column YXZ description
462 848d6979 2019-08-12 stsp .It @ Ta entry is a symbolic link
463 848d6979 2019-08-12 stsp .It / Ta entry is a directory
464 848d6979 2019-08-12 stsp .It * Ta entry is an executable file
465 63c5ca5d 2019-08-24 stsp .It $ Ta entry is a Git submodule
466 848d6979 2019-08-12 stsp .El
467 0d6c6ee3 2020-05-20 stsp .Pp
468 0d6c6ee3 2020-05-20 stsp Symbolic link entries are also annotated with the target path of the link.
469 848d6979 2019-08-12 stsp .Pp
470 030916b5 2018-07-12 stsp The key bindings for
471 030916b5 2018-07-12 stsp .Cm tog tree
472 07b0611c 2022-06-23 thomas are as follows (N denotes optional prefixed count modifier):
473 030916b5 2018-07-12 stsp .Bl -tag -width Ds
474 f7140bf5 2021-10-17 thomas .It Cm Down-arrow, j, Ctrl-n
475 07b0611c 2022-06-23 thomas Move the selection cursor down N lines (default: 1).
476 f7140bf5 2021-10-17 thomas .It Cm Up-arrow, k, Ctrl-p
477 07b0611c 2022-06-23 thomas Move the selection cursor up N lines (default: 1).
478 4c2d69cb 2022-06-23 thomas .It Cm Page-down, Space, Ctrl+f, f
479 07b0611c 2022-06-23 thomas Move the selection cursor down N pages (default: 1).
480 1c5e5faa 2022-06-23 thomas .It Cm Page-up, Ctrl+b, b
481 07b0611c 2022-06-23 thomas Move the selection cursor up N pages (default: 1).
482 23427b14 2022-06-23 thomas .It Cm Ctrl+d, d
483 07b0611c 2022-06-23 thomas Move the selection cursor down N half pages (default: 1).
484 23427b14 2022-06-23 thomas .It Cm Ctrl+u, u
485 07b0611c 2022-06-23 thomas Move the selection cursor up N half pages (default: 1).
486 e4526bf5 2021-09-03 naddy .It Cm Home, g
487 e4526bf5 2021-09-03 naddy Move the selection cursor to the first entry.
488 e4526bf5 2021-09-03 naddy .It Cm End, G
489 e4526bf5 2021-09-03 naddy Move the selection cursor to the last entry.
490 030916b5 2018-07-12 stsp .It Cm Enter
491 030916b5 2018-07-12 stsp Enter the currently selected directory, or switch to the
492 030916b5 2018-07-12 stsp .Cm blame
493 030916b5 2018-07-12 stsp view for the currently selected file.
494 1be4947a 2022-07-22 thomas .It Cm L
495 c0d30c23 2018-10-07 stsp Open a
496 69efd4c4 2018-07-18 stsp .Cm log
497 69efd4c4 2018-07-18 stsp view for the currently selected tree entry.
498 1be4947a 2022-07-22 thomas .It Cm R
499 152c1c93 2020-11-29 stsp Open a
500 152c1c93 2020-11-29 stsp .Cm ref
501 152c1c93 2020-11-29 stsp view listing all references in the repository.
502 152c1c93 2020-11-29 stsp This can then be used to open a new
503 152c1c93 2020-11-29 stsp .Cm tree
504 152c1c93 2020-11-29 stsp view for arbitrary branches and tags.
505 7837eeac 2018-09-24 stsp .It Cm Backspace
506 07b0611c 2022-06-23 thomas Move back to the Nth parent directory (default: 1).
507 030916b5 2018-07-12 stsp .It Cm i
508 c0d30c23 2018-10-07 stsp Show object IDs for all objects displayed in the
509 030916b5 2018-07-12 stsp .Cm tree
510 030916b5 2018-07-12 stsp view.
511 4eec20aa 2019-06-22 stsp .It Cm /
512 4eec20aa 2019-06-22 stsp Prompt for a search pattern and start searching for matching tree entries.
513 4eec20aa 2019-06-22 stsp The search pattern is an extended regular expression which is matched
514 4eec20aa 2019-06-22 stsp against the tree entry's name.
515 4eec20aa 2019-06-22 stsp Regular expression syntax is documented in
516 4eec20aa 2019-06-22 stsp .Xr re_format 7 .
517 4eec20aa 2019-06-22 stsp .It Cm n
518 07b0611c 2022-06-23 thomas Find the Nth next tree entry which matches the current search pattern
519 07b0611c 2022-06-23 thomas (default: 1).
520 4eec20aa 2019-06-22 stsp .It Cm N
521 07b0611c 2022-06-23 thomas Find the Nth previous tree entry which matches the current search pattern
522 07b0611c 2022-06-23 thomas (default: 1).
523 030916b5 2018-07-12 stsp .El
524 030916b5 2018-07-12 stsp .Pp
525 030916b5 2018-07-12 stsp The options for
526 030916b5 2018-07-12 stsp .Cm tog tree
527 030916b5 2018-07-12 stsp are as follows:
528 030916b5 2018-07-12 stsp .Bl -tag -width Ds
529 030916b5 2018-07-12 stsp .It Fl c Ar commit
530 030916b5 2018-07-12 stsp Start traversing history at the specified
531 030916b5 2018-07-12 stsp .Ar commit .
532 a54b6686 2019-06-28 stsp The expected argument is the name of a branch or a commit ID SHA1 hash.
533 0db75f06 2019-07-07 stsp An abbreviated hash argument will be expanded to a full SHA1 hash
534 0db75f06 2019-07-07 stsp automatically, provided the abbreviation is unique.
535 38cb327b 2020-11-24 stsp .It Fl r Ar repository-path
536 38cb327b 2020-11-24 stsp Use the repository at the specified path.
537 38cb327b 2020-11-24 stsp If not specified, assume the repository is located at or above the current
538 38cb327b 2020-11-24 stsp working directory.
539 38cb327b 2020-11-24 stsp If this directory is a
540 38cb327b 2020-11-24 stsp .Xr got 1
541 38cb327b 2020-11-24 stsp work tree, use the repository path associated with this work tree.
542 38cb327b 2020-11-24 stsp .El
543 38cb327b 2020-11-24 stsp .It Cm ref Oo Fl r Ar repository-path Oc
544 38cb327b 2020-11-24 stsp Display references in the repository.
545 38cb327b 2020-11-24 stsp .Pp
546 38cb327b 2020-11-24 stsp The key bindings for
547 38cb327b 2020-11-24 stsp .Cm tog ref
548 07b0611c 2022-06-23 thomas are as follows (N denotes optional prefixed count modifier):
549 38cb327b 2020-11-24 stsp .Bl -tag -width Ds
550 f7140bf5 2021-10-17 thomas .It Cm Down-arrow, j, Ctrl-n
551 07b0611c 2022-06-23 thomas Move the selection cursor down N lines (default: 1).
552 f7140bf5 2021-10-17 thomas .It Cm Up-arrow, k, Ctrl-p
553 07b0611c 2022-06-23 thomas Move the selection cursor up N lines (default: 1).
554 4c2d69cb 2022-06-23 thomas .It Cm Page-down, Space, Ctrl+f, f
555 07b0611c 2022-06-23 thomas Move the selection cursor down N pages (default: 1).
556 1c5e5faa 2022-06-23 thomas .It Cm Page-up, Ctrl+b, b
557 07b0611c 2022-06-23 thomas Move the selection cursor up N pages (default: 1).
558 23427b14 2022-06-23 thomas .It Cm Ctrl+d, d
559 07b0611c 2022-06-23 thomas Move the selection cursor down N half pages (default: 1).
560 23427b14 2022-06-23 thomas .It Cm Ctrl+u, u
561 07b0611c 2022-06-23 thomas Move the selection cursor up N half pages (default: 1).
562 e4526bf5 2021-09-03 naddy .It Cm Home, g
563 e4526bf5 2021-09-03 naddy Move the selection cursor to the first reference.
564 e4526bf5 2021-09-03 naddy .It Cm End, G
565 e4526bf5 2021-09-03 naddy Move the selection cursor to the last reference.
566 38cb327b 2020-11-24 stsp .It Cm Enter
567 01ca22b1 2020-12-07 stsp Open a
568 01ca22b1 2020-12-07 stsp .Cm log
569 01ca22b1 2020-12-07 stsp view which begins traversing history at the commit resolved via the
570 38cb327b 2020-11-24 stsp currently selected reference.
571 1be4947a 2022-07-22 thomas .It Cm T
572 c42c9805 2020-11-24 stsp Open a
573 c42c9805 2020-11-24 stsp .Cm tree
574 c42c9805 2020-11-24 stsp view showing the tree resolved via the currently selected reference.
575 38cb327b 2020-11-24 stsp .It Cm i
576 38cb327b 2020-11-24 stsp Show object IDs for all non-symbolic references displayed in the
577 38cb327b 2020-11-24 stsp .Cm ref
578 38cb327b 2020-11-24 stsp view.
579 84227eb1 2022-06-23 thomas .It Cm m
580 84227eb1 2022-06-23 thomas Show last modified date of each displayed reference.
581 98182bd0 2021-11-20 thomas .It Cm o
582 3bfadbd4 2021-11-20 thomas Toggle display order of references between sort by name and sort by timestamp.
583 38cb327b 2020-11-24 stsp .It Cm /
584 38cb327b 2020-11-24 stsp Prompt for a search pattern and start searching for matching references.
585 38cb327b 2020-11-24 stsp The search pattern is an extended regular expression which is matched
586 38cb327b 2020-11-24 stsp against absolute reference names.
587 38cb327b 2020-11-24 stsp Regular expression syntax is documented in
588 38cb327b 2020-11-24 stsp .Xr re_format 7 .
589 38cb327b 2020-11-24 stsp .It Cm n
590 07b0611c 2022-06-23 thomas Find the Nth next reference which matches the current search pattern
591 07b0611c 2022-06-23 thomas (default: 1).
592 38cb327b 2020-11-24 stsp .It Cm N
593 07b0611c 2022-06-23 thomas Find the Nth previous reference which matches the current search pattern
594 07b0611c 2022-06-23 thomas (default: 1).
595 38cb327b 2020-11-24 stsp .It Cm Ctrl+l
596 38cb327b 2020-11-24 stsp Reload the list of references displayed by the
597 38cb327b 2020-11-24 stsp .Cm ref
598 38cb327b 2020-11-24 stsp view.
599 38cb327b 2020-11-24 stsp .El
600 38cb327b 2020-11-24 stsp .Pp
601 38cb327b 2020-11-24 stsp The options for
602 38cb327b 2020-11-24 stsp .Cm tog ref
603 38cb327b 2020-11-24 stsp are as follows:
604 38cb327b 2020-11-24 stsp .Bl -tag -width Ds
605 74283ab8 2020-02-07 stsp .It Fl r Ar repository-path
606 74283ab8 2020-02-07 stsp Use the repository at the specified path.
607 74283ab8 2020-02-07 stsp If not specified, assume the repository is located at or above the current
608 74283ab8 2020-02-07 stsp working directory.
609 74283ab8 2020-02-07 stsp If this directory is a
610 74283ab8 2020-02-07 stsp .Xr got 1
611 74283ab8 2020-02-07 stsp work tree, use the repository path associated with this work tree.
612 030916b5 2018-07-12 stsp .El
613 030916b5 2018-07-12 stsp .El
614 6d17833f 2019-11-08 stsp .Sh ENVIRONMENT
615 64486692 2022-07-07 thomas .Bl -tag -width TOG_VIEW_SPLIT_MODE
616 adf4c9e0 2022-07-03 thomas .It Ev TOG_DIFF_ALGORITHM
617 adf4c9e0 2022-07-03 thomas Determines the default diff algorithm used by
618 adf4c9e0 2022-07-03 thomas .Nm .
619 d40a767d 2022-07-03 thomas Supported diff algorithms are Myers (quick and dirty) and
620 d40a767d 2022-07-03 thomas Patience (slow and tidy).
621 d40a767d 2022-07-03 thomas Valid values for
622 d40a767d 2022-07-03 thomas .Ev TOG_DIFF_ALGORITHM
623 d40a767d 2022-07-03 thomas are
624 adf4c9e0 2022-07-03 thomas .Dq patience
625 adf4c9e0 2022-07-03 thomas and
626 adf4c9e0 2022-07-03 thomas .Dq myers .
627 adf4c9e0 2022-07-03 thomas If unset, the Myers diff algorithm will be used by default.
628 0b948cdd 2022-07-04 thomas .It Ev TOG_VIEW_SPLIT_MODE
629 569abcd7 2022-07-12 thomas Determines the default layout of split-screen views.
630 0b948cdd 2022-07-04 thomas If set to
631 0b948cdd 2022-07-04 thomas .Dq h
632 569abcd7 2022-07-12 thomas or
633 569abcd7 2022-07-12 thomas .Dq H ,
634 569abcd7 2022-07-12 thomas .Nm
635 569abcd7 2022-07-12 thomas will use horizontal split by default.
636 569abcd7 2022-07-12 thomas Otherwise, vertical split will be used.
637 569abcd7 2022-07-12 thomas The
638 569abcd7 2022-07-12 thomas .Cm S
639 569abcd7 2022-07-12 thomas key can be used to switch between vertical and horizontal split layout
640 569abcd7 2022-07-12 thomas at run-time.
641 6d17833f 2019-11-08 stsp .It Ev TOG_COLORS
642 6d17833f 2019-11-08 stsp .Nm
643 6d17833f 2019-11-08 stsp shows colorized output if this variable is set to a non-empty value.
644 6d17833f 2019-11-08 stsp The default color scheme can be modified by setting the environment
645 6d17833f 2019-11-08 stsp variables documented below.
646 6d17833f 2019-11-08 stsp The colors available in color schemes are
647 6d17833f 2019-11-08 stsp .Dq black ,
648 6d17833f 2019-11-08 stsp .Dq red ,
649 6d17833f 2019-11-08 stsp .Dq green ,
650 6d17833f 2019-11-08 stsp .Dq yellow ,
651 6d17833f 2019-11-08 stsp .Dq blue ,
652 93a300b2 2021-08-26 stsp .Dq magenta ,
653 1d7fe5cd 2019-11-08 stsp .Dq cyan ,
654 6d17833f 2019-11-08 stsp and
655 1d7fe5cd 2019-11-08 stsp .Dq default
656 1d7fe5cd 2019-11-08 stsp which maps to the terminal's default foreground color.
657 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_MINUS
658 6d17833f 2019-11-08 stsp The color used to mark up removed lines in diffs.
659 6d17833f 2019-11-08 stsp If not set, the default value
660 6d17833f 2019-11-08 stsp .Dq magenta
661 6d17833f 2019-11-08 stsp is used.
662 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_PLUS
663 6d17833f 2019-11-08 stsp The color used to mark up added lines in diffs.
664 6d17833f 2019-11-08 stsp If not set, the default value
665 6d17833f 2019-11-08 stsp .Dq cyan
666 6d17833f 2019-11-08 stsp is used.
667 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_CHUNK_HEADER
668 6d17833f 2019-11-08 stsp The color used to mark up chunk header lines in diffs.
669 6d17833f 2019-11-08 stsp If not set, the default value
670 6d17833f 2019-11-08 stsp .Dq yellow
671 6d17833f 2019-11-08 stsp is used.
672 6d17833f 2019-11-08 stsp .It Ev TOG_COLOR_DIFF_META
673 6d17833f 2019-11-08 stsp The color used to mark up meta data in diffs.
674 c0b01bdb 2019-11-08 stsp If not set, the default value
675 c0b01bdb 2019-11-08 stsp .Dq green
676 c0b01bdb 2019-11-08 stsp is used.
677 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_SUBMODULE
678 93a300b2 2021-08-26 stsp The color used to mark up submodule tree entries.
679 c0b01bdb 2019-11-08 stsp If not set, the default value
680 c0b01bdb 2019-11-08 stsp .Dq magenta
681 c0b01bdb 2019-11-08 stsp is used.
682 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_SYMLINK
683 c0b01bdb 2019-11-08 stsp The color used to mark up symbolic link tree entries.
684 c0b01bdb 2019-11-08 stsp If not set, the default value
685 91b8c405 2020-01-25 stsp .Dq magenta
686 c0b01bdb 2019-11-08 stsp is used.
687 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_DIRECTORY
688 c0b01bdb 2019-11-08 stsp The color used to mark up directory tree entries.
689 6d17833f 2019-11-08 stsp If not set, the default value
690 91b8c405 2020-01-25 stsp .Dq cyan
691 c0b01bdb 2019-11-08 stsp is used.
692 c0b01bdb 2019-11-08 stsp .It Ev TOG_COLOR_TREE_EXECUTABLE
693 c0b01bdb 2019-11-08 stsp The color used to mark up executable file tree entries.
694 c0b01bdb 2019-11-08 stsp If not set, the default value
695 6d17833f 2019-11-08 stsp .Dq green
696 6d17833f 2019-11-08 stsp is used.
697 11b20872 2019-11-08 stsp .It Ev TOG_COLOR_COMMIT
698 11b20872 2019-11-08 stsp The color used to mark up commit IDs.
699 11b20872 2019-11-08 stsp If not set, the default value
700 11b20872 2019-11-08 stsp .Dq green
701 11b20872 2019-11-08 stsp is used.
702 11b20872 2019-11-08 stsp .It Ev TOG_COLOR_AUTHOR
703 11b20872 2019-11-08 stsp The color used to mark up author information.
704 11b20872 2019-11-08 stsp If not set, the default value
705 11b20872 2019-11-08 stsp .Dq cyan
706 11b20872 2019-11-08 stsp is used.
707 11b20872 2019-11-08 stsp .It Ev TOG_COLOR_DATE
708 11b20872 2019-11-08 stsp The color used to mark up date information.
709 11b20872 2019-11-08 stsp If not set, the default value
710 11b20872 2019-11-08 stsp .Dq yellow
711 11b20872 2019-11-08 stsp is used.
712 38cb327b 2020-11-24 stsp .It Ev TOG_COLOR_REFS_HEADS
713 38cb327b 2020-11-24 stsp The color used to mark up references in the
714 38cb327b 2020-11-24 stsp .Dq refs/heads/
715 38cb327b 2020-11-24 stsp namespace.
716 38cb327b 2020-11-24 stsp If not set, the default value
717 38cb327b 2020-11-24 stsp .Dq green
718 38cb327b 2020-11-24 stsp is used.
719 38cb327b 2020-11-24 stsp .It Ev TOG_COLOR_REFS_TAGS
720 38cb327b 2020-11-24 stsp The color used to mark up references in the
721 38cb327b 2020-11-24 stsp .Dq refs/tags/
722 38cb327b 2020-11-24 stsp namespace.
723 38cb327b 2020-11-24 stsp If not set, the default value
724 38cb327b 2020-11-24 stsp .Dq magenta
725 38cb327b 2020-11-24 stsp is used.
726 38cb327b 2020-11-24 stsp .It Ev TOG_COLOR_REFS_REMOTES
727 38cb327b 2020-11-24 stsp The color used to mark up references in the
728 38cb327b 2020-11-24 stsp .Dq refs/remotes/
729 38cb327b 2020-11-24 stsp namespace.
730 38cb327b 2020-11-24 stsp If not set, the default value
731 38cb327b 2020-11-24 stsp .Dq yellow
732 38cb327b 2020-11-24 stsp is used.
733 2183bbf6 2022-01-23 thomas .It Ev TOG_COLOR_REFS_BACKUP
734 2183bbf6 2022-01-23 thomas The color used to mark up references in the
735 2183bbf6 2022-01-23 thomas .Dq refs/got/backup/
736 2183bbf6 2022-01-23 thomas namespace.
737 2183bbf6 2022-01-23 thomas If not set, the default value
738 2183bbf6 2022-01-23 thomas .Dq cyan
739 2183bbf6 2022-01-23 thomas is used.
740 6d17833f 2019-11-08 stsp .El
741 030916b5 2018-07-12 stsp .Sh EXIT STATUS
742 030916b5 2018-07-12 stsp .Ex -std tog
743 030916b5 2018-07-12 stsp .Sh SEE ALSO
744 56b9a4ca 2019-06-21 stsp .Xr got 1 ,
745 56b9a4ca 2019-06-21 stsp .Xr git-repository 5 ,
746 56b9a4ca 2019-06-21 stsp .Xr re_format 7
747 030916b5 2018-07-12 stsp .Sh AUTHORS
748 60c73080 2022-07-05 thomas .An Christian Weisgerber Aq Mt naddy@openbsd.org
749 60c73080 2022-07-05 thomas .An Josh Rickmar Aq Mt jrick@zettaport.com
750 bc3056e3 2019-08-18 stsp .An Joshua Stein Aq Mt jcs@openbsd.org
751 60c73080 2022-07-05 thomas .An Mark Jamsek Aq Mt mark@jamsek.dev
752 60c73080 2022-07-05 thomas .An Martin Pieuchot Aq Mt mpi@openbsd.org
753 60c73080 2022-07-05 thomas .An Omar Polo Aq Mt op@openbsd.org
754 60c73080 2022-07-05 thomas .An Stefan Sperling Aq Mt stsp@openbsd.org
755 60c73080 2022-07-05 thomas .An Klemens Nanni Aq Mt kn@openbsd.org