Blame


1 8797b228 2019-08-04 stsp <!DOCTYPE html>
2 8797b228 2019-08-04 stsp <html>
3 8797b228 2019-08-04 stsp <!-- This is an automatically generated file. Do not edit.
4 8797b228 2019-08-04 stsp Copyright (c) 2018 Stefan Sperling
5 8797b228 2019-08-04 stsp
6 8797b228 2019-08-04 stsp Permission to use, copy, modify, and distribute this software for any
7 8797b228 2019-08-04 stsp purpose with or without fee is hereby granted, provided that the above
8 8797b228 2019-08-04 stsp copyright notice and this permission notice appear in all copies.
9 8797b228 2019-08-04 stsp
10 8797b228 2019-08-04 stsp THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 8797b228 2019-08-04 stsp WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 8797b228 2019-08-04 stsp MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 8797b228 2019-08-04 stsp ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 8797b228 2019-08-04 stsp WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 8797b228 2019-08-04 stsp ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 8797b228 2019-08-04 stsp OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 8797b228 2019-08-04 stsp -->
18 8797b228 2019-08-04 stsp <head>
19 8797b228 2019-08-04 stsp <meta charset="utf-8"/>
20 a954aa0a 2021-06-22 stsp <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
21 5ca479d6 2021-11-21 stsp <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
22 8797b228 2019-08-04 stsp <title>TOG(1)</title>
23 8797b228 2019-08-04 stsp </head>
24 8797b228 2019-08-04 stsp <body>
25 8797b228 2019-08-04 stsp <table class="head">
26 8797b228 2019-08-04 stsp <tr>
27 8797b228 2019-08-04 stsp <td class="head-ltitle">TOG(1)</td>
28 8797b228 2019-08-04 stsp <td class="head-vol">General Commands Manual</td>
29 8797b228 2019-08-04 stsp <td class="head-rtitle">TOG(1)</td>
30 8797b228 2019-08-04 stsp </tr>
31 8797b228 2019-08-04 stsp </table>
32 8797b228 2019-08-04 stsp <div class="manual-text">
33 8797b228 2019-08-04 stsp <section class="Sh">
34 8797b228 2019-08-04 stsp <h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
35 d8e62599 2019-10-21 stsp <p class="Pp"><code class="Nm">tog</code> &#x2014; <span class="Nd">Git
36 d8e62599 2019-10-21 stsp repository browser</span></p>
37 8797b228 2019-08-04 stsp </section>
38 8797b228 2019-08-04 stsp <section class="Sh">
39 8797b228 2019-08-04 stsp <h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
40 8797b228 2019-08-04 stsp <table class="Nm">
41 8797b228 2019-08-04 stsp <tr>
42 8797b228 2019-08-04 stsp <td><code class="Nm">tog</code></td>
43 ae803b74 2020-03-06 stsp <td>[<var class="Ar">command</var>] [<code class="Fl">-h</code>]
44 8797b228 2019-08-04 stsp [<var class="Ar">arg ...</var>]</td>
45 8797b228 2019-08-04 stsp </tr>
46 8797b228 2019-08-04 stsp </table>
47 ae803b74 2020-03-06 stsp <p class="Pp"></p>
48 ae803b74 2020-03-06 stsp <br/>
49 ae803b74 2020-03-06 stsp <table class="Nm">
50 ae803b74 2020-03-06 stsp <tr>
51 ae803b74 2020-03-06 stsp <td><code class="Nm">tog</code></td>
52 ae803b74 2020-03-06 stsp <td><var class="Ar">path</var></td>
53 ae803b74 2020-03-06 stsp </tr>
54 ae803b74 2020-03-06 stsp </table>
55 8797b228 2019-08-04 stsp </section>
56 8797b228 2019-08-04 stsp <section class="Sh">
57 8797b228 2019-08-04 stsp <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
58 d8e62599 2019-10-21 stsp <p class="Pp"><code class="Nm">tog</code> is an interactive read-only browser
59 d8e62599 2019-10-21 stsp for Git repositories. This repository format is described in
60 d8e62599 2019-10-21 stsp <a class="Xr">git-repository(5)</a>.</p>
61 8797b228 2019-08-04 stsp <p class="Pp"><code class="Nm">tog</code> supports several types of views which
62 8797b228 2019-08-04 stsp display repository data:</p>
63 8797b228 2019-08-04 stsp <dl class="Bl-tag">
64 8797b228 2019-08-04 stsp <dt>Log view</dt>
65 8797b228 2019-08-04 stsp <dd>Displays commits in the repository's history. This view is displayed
66 ae803b74 2020-03-06 stsp initially if no <var class="Ar">command</var> is specified, or if just a
67 ae803b74 2020-03-06 stsp <var class="Ar">path</var> is specified.</dd>
68 8797b228 2019-08-04 stsp <dt>Diff view</dt>
69 8797b228 2019-08-04 stsp <dd>Displays changes made in a particular commit.</dd>
70 8797b228 2019-08-04 stsp <dt>Blame view</dt>
71 8797b228 2019-08-04 stsp <dd>Displays the line-by-line history of a file.</dd>
72 8797b228 2019-08-04 stsp <dt>Tree view</dt>
73 8797b228 2019-08-04 stsp <dd>Displays the tree corresponding to a particular commit.</dd>
74 1b792db0 2020-12-13 stsp <dt>Ref view</dt>
75 1b792db0 2020-12-13 stsp <dd>Displays references in the repository.</dd>
76 8797b228 2019-08-04 stsp </dl>
77 8797b228 2019-08-04 stsp <p class="Pp"><code class="Nm">tog</code> provides global and command-specific
78 8797b228 2019-08-04 stsp key bindings and options. The global key bindings are:</p>
79 8797b228 2019-08-04 stsp <dl class="Bl-tag">
80 2dbbbc3a 2020-07-23 stsp <dt id="Q"><a class="permalink" href="#Q"><code class="Cm">Q</code></a></dt>
81 8797b228 2019-08-04 stsp <dd>Quit <code class="Nm">tog</code>.</dd>
82 2dbbbc3a 2020-07-23 stsp <dt id="q"><a class="permalink" href="#q"><code class="Cm">q</code></a></dt>
83 8797b228 2019-08-04 stsp <dd>Quit the view which is in focus.</dd>
84 2dbbbc3a 2020-07-23 stsp <dt id="Tab"><a class="permalink" href="#Tab"><code class="Cm">Tab</code></a></dt>
85 8797b228 2019-08-04 stsp <dd>Switch focus between views.</dd>
86 2dbbbc3a 2020-07-23 stsp <dt id="f"><a class="permalink" href="#f"><code class="Cm">f</code></a></dt>
87 8797b228 2019-08-04 stsp <dd>Toggle fullscreen mode for a split-screen view.
88 8797b228 2019-08-04 stsp <code class="Nm">tog</code> will automatically use split-screen views if
89 8797b228 2019-08-04 stsp the size of the terminal window is sufficiently large.</dd>
90 8797b228 2019-08-04 stsp </dl>
91 8797b228 2019-08-04 stsp <p class="Pp">Global options must precede the command name, and are as
92 8797b228 2019-08-04 stsp follows:</p>
93 8797b228 2019-08-04 stsp <dl class="Bl-tag">
94 2dbbbc3a 2020-07-23 stsp <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a></dt>
95 8797b228 2019-08-04 stsp <dd>Display usage information.</dd>
96 56dd4d48 2021-04-05 stsp <dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
97 8b679b4b 2020-02-17 stsp <code class="Fl">--version</code></dt>
98 8797b228 2019-08-04 stsp <dd>Display program version and exit immediately.</dd>
99 8797b228 2019-08-04 stsp </dl>
100 8797b228 2019-08-04 stsp <p class="Pp">The commands for <code class="Nm">tog</code> are as follows:</p>
101 8797b228 2019-08-04 stsp <dl class="Bl-tag">
102 2dbbbc3a 2020-07-23 stsp <dt id="log"><a class="permalink" href="#log"><code class="Cm">log</code></a>
103 8b679b4b 2020-02-17 stsp [<code class="Fl">-b</code>] [<code class="Fl">-c</code>
104 8b679b4b 2020-02-17 stsp <var class="Ar">commit</var>] [<code class="Fl">-r</code>
105 8b679b4b 2020-02-17 stsp <var class="Ar">repository-path</var>] [<var class="Ar">path</var>]</dt>
106 8797b228 2019-08-04 stsp <dd>Display history of a repository. If a <var class="Ar">path</var> is
107 7c3b4ab8 2020-02-25 stsp specified, show only commits which modified this path. If invoked in a
108 7c3b4ab8 2020-02-25 stsp work tree, the <var class="Ar">path</var> is interpreted relative to the
109 7c3b4ab8 2020-02-25 stsp current working directory, and the work tree's path prefix is implicitly
110 7c3b4ab8 2020-02-25 stsp prepended. Otherwise, the path is interpreted relative to the repository
111 7c3b4ab8 2020-02-25 stsp root.
112 8797b228 2019-08-04 stsp <p class="Pp">This command is also executed if no explicit command is
113 8797b228 2019-08-04 stsp specified.</p>
114 8797b228 2019-08-04 stsp <p class="Pp">The key bindings for <code class="Cm">tog log</code> are as
115 8797b228 2019-08-04 stsp follows:</p>
116 8797b228 2019-08-04 stsp <dl class="Bl-tag">
117 2dbbbc3a 2020-07-23 stsp <dt id="Down-arrow,"><a class="permalink" href="#Down-arrow,"><code class="Cm">Down-arrow,
118 d785ebc6 2021-10-17 stsp j, &gt;, Full stop, Ctrl-n</code></a></dt>
119 8797b228 2019-08-04 stsp <dd>Move the selection cursor down.</dd>
120 2dbbbc3a 2020-07-23 stsp <dt id="Up-arrow,"><a class="permalink" href="#Up-arrow,"><code class="Cm">Up-arrow,
121 d785ebc6 2021-10-17 stsp k, &lt;, Comma, Ctrl-p</code></a></dt>
122 8797b228 2019-08-04 stsp <dd>Move the selection cursor up.</dd>
123 2dbbbc3a 2020-07-23 stsp <dt id="Page-down,"><a class="permalink" href="#Page-down,"><code class="Cm">Page-down,
124 8797b228 2019-08-04 stsp Ctrl+f</code></a></dt>
125 8797b228 2019-08-04 stsp <dd>Move the selection cursor down one page.</dd>
126 2dbbbc3a 2020-07-23 stsp <dt id="Page-up,"><a class="permalink" href="#Page-up,"><code class="Cm">Page-up,
127 8797b228 2019-08-04 stsp Ctrl+b</code></a></dt>
128 8797b228 2019-08-04 stsp <dd>Move the selection cursor up one page.</dd>
129 def5be4a 2021-08-31 stsp <dt id="Home,"><a class="permalink" href="#Home,"><code class="Cm">Home,
130 def5be4a 2021-08-31 stsp g</code></a></dt>
131 def5be4a 2021-08-31 stsp <dd>Move the cursor to the newest commit.</dd>
132 def5be4a 2021-08-31 stsp <dt id="End,"><a class="permalink" href="#End,"><code class="Cm">End,
133 def5be4a 2021-08-31 stsp G</code></a></dt>
134 def5be4a 2021-08-31 stsp <dd>Move the cursor to the oldest commit. This will traverse all commits
135 def5be4a 2021-08-31 stsp on the current branch which may take a long time depending on the
136 b078d5c4 2022-03-23 stsp number of commits in branch history. If needed, this operation can be
137 def5be4a 2021-08-31 stsp cancelled with <code class="Cm">Backspace</code>.</dd>
138 2dbbbc3a 2020-07-23 stsp <dt id="Enter,"><a class="permalink" href="#Enter,"><code class="Cm">Enter,
139 8797b228 2019-08-04 stsp Space</code></a></dt>
140 8797b228 2019-08-04 stsp <dd>Open a <code class="Cm">diff</code> view showing file changes made in
141 8797b228 2019-08-04 stsp the currently selected commit.</dd>
142 2dbbbc3a 2020-07-23 stsp <dt id="t"><a class="permalink" href="#t"><code class="Cm">t</code></a></dt>
143 8797b228 2019-08-04 stsp <dd>Open a <code class="Cm">tree</code> view showing the tree for the
144 8797b228 2019-08-04 stsp currently selected commit.</dd>
145 2dbbbc3a 2020-07-23 stsp <dt id="Backspace"><a class="permalink" href="#Backspace"><code class="Cm">Backspace</code></a></dt>
146 8797b228 2019-08-04 stsp <dd>Show log entries for the parent directory of the currently selected
147 def5be4a 2021-08-31 stsp path. However when an active search is in progress or when additional
148 def5be4a 2021-08-31 stsp commits are loaded, <code class="Cm">Backspace</code> aborts the
149 def5be4a 2021-08-31 stsp running operation.</dd>
150 2dbbbc3a 2020-07-23 stsp <dt id="/"><a class="permalink" href="#/"><code class="Cm">/</code></a></dt>
151 8797b228 2019-08-04 stsp <dd>Prompt for a search pattern and start searching for matching commits.
152 8797b228 2019-08-04 stsp The search pattern is an extended regular expression which is matched
153 8797b228 2019-08-04 stsp against a commit's author name, committer name, log message, and
154 8797b228 2019-08-04 stsp commit ID SHA1 hash. Regular expression syntax is documented in
155 8797b228 2019-08-04 stsp <a class="Xr">re_format(7)</a>.</dd>
156 2dbbbc3a 2020-07-23 stsp <dt id="n"><a class="permalink" href="#n"><code class="Cm">n</code></a></dt>
157 8797b228 2019-08-04 stsp <dd>Find the next commit which matches the current search pattern.
158 8797b228 2019-08-04 stsp Searching continues until either a match is found or the
159 8797b228 2019-08-04 stsp <code class="Cm">Backspace</code> key is pressed.</dd>
160 2dbbbc3a 2020-07-23 stsp <dt id="N"><a class="permalink" href="#N"><code class="Cm">N</code></a></dt>
161 8797b228 2019-08-04 stsp <dd>Find the previous commit which matches the current search pattern.
162 8797b228 2019-08-04 stsp Searching continues until either a match is found or the
163 8797b228 2019-08-04 stsp <code class="Cm">Backspace</code> key is pressed.</dd>
164 2dbbbc3a 2020-07-23 stsp <dt id="Ctrl+l"><a class="permalink" href="#Ctrl+l"><code class="Cm">Ctrl+l</code></a></dt>
165 1b792db0 2020-12-13 stsp <dd>Reload the <code class="Cm">log</code> view with new commits found in
166 1b792db0 2020-12-13 stsp the repository.</dd>
167 2dbbbc3a 2020-07-23 stsp <dt id="B"><a class="permalink" href="#B"><code class="Cm">B</code></a></dt>
168 1b792db0 2020-12-13 stsp <dd>Reload the <code class="Cm">log</code> view and toggle display of
169 1b792db0 2020-12-13 stsp merged commits. The <code class="Fl">-b</code> option determines
170 1b792db0 2020-12-13 stsp whether merged commits are displayed initially.</dd>
171 1b792db0 2020-12-13 stsp <dt id="r"><a class="permalink" href="#r"><code class="Cm">r</code></a></dt>
172 1b792db0 2020-12-13 stsp <dd>Open a <code class="Cm">ref</code> view listing all references in the
173 1b792db0 2020-12-13 stsp repository. This can then be used to open a new
174 1b792db0 2020-12-13 stsp <code class="Cm">log</code> view for arbitrary branches and tags.</dd>
175 8797b228 2019-08-04 stsp </dl>
176 8797b228 2019-08-04 stsp <p class="Pp">The options for <code class="Cm">tog log</code> are as
177 8797b228 2019-08-04 stsp follows:</p>
178 8797b228 2019-08-04 stsp <dl class="Bl-tag">
179 2dbbbc3a 2020-07-23 stsp <dt id="b"><a class="permalink" href="#b"><code class="Fl">-b</code></a></dt>
180 8b679b4b 2020-02-17 stsp <dd>Display individual commits which were merged into the current branch
181 8b679b4b 2020-02-17 stsp from other branches. By default, <code class="Cm">tog log</code> shows
182 8b679b4b 2020-02-17 stsp the linear history of the current branch only. The
183 8b679b4b 2020-02-17 stsp <code class="Cm">B</code> key binding can be used to toggle display of
184 8b679b4b 2020-02-17 stsp merged commits at run-time.</dd>
185 2dbbbc3a 2020-07-23 stsp <dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
186 8797b228 2019-08-04 stsp <var class="Ar">commit</var></dt>
187 8797b228 2019-08-04 stsp <dd>Start traversing history at the specified
188 8797b228 2019-08-04 stsp <var class="Ar">commit</var>. The expected argument is the name of a
189 8797b228 2019-08-04 stsp branch or a commit ID SHA1 hash. An abbreviated hash argument will be
190 8797b228 2019-08-04 stsp expanded to a full SHA1 hash automatically, provided the abbreviation
191 8797b228 2019-08-04 stsp is unique. If this option is not specified, default to the work tree's
192 8797b228 2019-08-04 stsp current branch if invoked in a work tree, or to the repository's HEAD
193 8797b228 2019-08-04 stsp reference.</dd>
194 1b792db0 2020-12-13 stsp <dt id="r~2"><a class="permalink" href="#r~2"><code class="Fl">-r</code></a>
195 8797b228 2019-08-04 stsp <var class="Ar">repository-path</var></dt>
196 8797b228 2019-08-04 stsp <dd>Use the repository at the specified path. If not specified, assume the
197 7c3b4ab8 2020-02-25 stsp repository is located at or above the current working directory. If
198 7c3b4ab8 2020-02-25 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
199 7c3b4ab8 2020-02-25 stsp repository path associated with this work tree.</dd>
200 8797b228 2019-08-04 stsp </dl>
201 8797b228 2019-08-04 stsp </dd>
202 2dbbbc3a 2020-07-23 stsp <dt id="diff"><a class="permalink" href="#diff"><code class="Cm">diff</code></a>
203 1b792db0 2020-12-13 stsp [<code class="Fl">-a</code>] [<code class="Fl">-C</code>
204 1b792db0 2020-12-13 stsp <var class="Ar">number</var>] [<code class="Fl">-r</code>
205 1b792db0 2020-12-13 stsp <var class="Ar">repository-path</var>] [<code class="Fl">-w</code>]
206 1b792db0 2020-12-13 stsp <var class="Ar">object1</var> <var class="Ar">object2</var></dt>
207 1b792db0 2020-12-13 stsp <dd>Display the differences between two objects in the repository. Treat each
208 1b792db0 2020-12-13 stsp of the two arguments as a reference, a tag name, or an object ID SHA1
209 1b792db0 2020-12-13 stsp hash, and display differences between the corresponding objects. Both
210 1b792db0 2020-12-13 stsp objects must be of the same type (blobs, trees, or commits). An
211 8797b228 2019-08-04 stsp abbreviated hash argument will be expanded to a full SHA1 hash
212 1b792db0 2020-12-13 stsp automatically, provided the abbreviation is unique.
213 8797b228 2019-08-04 stsp <p class="Pp">The key bindings for <code class="Cm">tog diff</code> are as
214 8797b228 2019-08-04 stsp follows:</p>
215 8797b228 2019-08-04 stsp <dl class="Bl-tag">
216 1b792db0 2020-12-13 stsp <dt id="a"><a class="permalink" href="#a"><code class="Cm">a</code></a></dt>
217 1b792db0 2020-12-13 stsp <dd>Toggle treatment of file contents as ASCII text even if binary data
218 1b792db0 2020-12-13 stsp was detected.</dd>
219 2dbbbc3a 2020-07-23 stsp <dt id="Down-arrow,~2"><a class="permalink" href="#Down-arrow,~2"><code class="Cm">Down-arrow,
220 d785ebc6 2021-10-17 stsp j, Ctrl-n</code></a></dt>
221 8797b228 2019-08-04 stsp <dd>Scroll down.</dd>
222 2dbbbc3a 2020-07-23 stsp <dt id="Up-arrow,~2"><a class="permalink" href="#Up-arrow,~2"><code class="Cm">Up-arrow,
223 d785ebc6 2021-10-17 stsp k, Ctrl-p</code></a></dt>
224 8797b228 2019-08-04 stsp <dd>Scroll up.</dd>
225 2dbbbc3a 2020-07-23 stsp <dt id="Page-down,~2"><a class="permalink" href="#Page-down,~2"><code class="Cm">Page-down,
226 8797b228 2019-08-04 stsp Space, Ctrl+f</code></a></dt>
227 8797b228 2019-08-04 stsp <dd>Scroll down one page.</dd>
228 2dbbbc3a 2020-07-23 stsp <dt id="Page-up,~2"><a class="permalink" href="#Page-up,~2"><code class="Cm">Page-up,
229 8797b228 2019-08-04 stsp Ctrl+b</code></a></dt>
230 8797b228 2019-08-04 stsp <dd>Scroll up one page.</dd>
231 def5be4a 2021-08-31 stsp <dt id="Home,~2"><a class="permalink" href="#Home,~2"><code class="Cm">Home,
232 def5be4a 2021-08-31 stsp g</code></a></dt>
233 def5be4a 2021-08-31 stsp <dd>Scroll to the top of the view.</dd>
234 def5be4a 2021-08-31 stsp <dt id="End,~2"><a class="permalink" href="#End,~2"><code class="Cm">End,
235 def5be4a 2021-08-31 stsp G</code></a></dt>
236 def5be4a 2021-08-31 stsp <dd>Scroll to the bottom of the view.</dd>
237 2dbbbc3a 2020-07-23 stsp <dt id="_"><a class="permalink" href="#_"><code class="Cm">[</code></a></dt>
238 8797b228 2019-08-04 stsp <dd>Reduce the amount of diff context lines.</dd>
239 2dbbbc3a 2020-07-23 stsp <dt id="_~2"><a class="permalink" href="#_~2"><code class="Cm">]</code></a></dt>
240 8797b228 2019-08-04 stsp <dd>Increase the amount of diff context lines.</dd>
241 2dbbbc3a 2020-07-23 stsp <dt id="_,"><a class="permalink" href="#_,"><code class="Cm">&lt;,
242 8797b228 2019-08-04 stsp Comma</code></a></dt>
243 1b792db0 2020-12-13 stsp <dd>If the <code class="Cm">diff</code> view was opened via the
244 1b792db0 2020-12-13 stsp <code class="Cm">log</code> view, move to the previous (younger)
245 1b792db0 2020-12-13 stsp commit.</dd>
246 2dbbbc3a 2020-07-23 stsp <dt id="_,~2"><a class="permalink" href="#_,~2"><code class="Cm">&gt;,
247 8797b228 2019-08-04 stsp Full stop</code></a></dt>
248 1b792db0 2020-12-13 stsp <dd>If the <code class="Cm">diff</code> view was opened via the
249 1b792db0 2020-12-13 stsp <code class="Cm">log</code> view, move to the next (older)
250 1b792db0 2020-12-13 stsp commit.</dd>
251 2dbbbc3a 2020-07-23 stsp <dt id="/~2"><a class="permalink" href="#/~2"><code class="Cm">/</code></a></dt>
252 f2e17eed 2020-11-14 stsp <dd>Prompt for a search pattern and start searching for matching lines.
253 f2e17eed 2020-11-14 stsp The search pattern is an extended regular expression. Regular
254 f2e17eed 2020-11-14 stsp expression syntax is documented in
255 f2e17eed 2020-11-14 stsp <a class="Xr">re_format(7)</a>.</dd>
256 2dbbbc3a 2020-07-23 stsp <dt id="n~2"><a class="permalink" href="#n~2"><code class="Cm">n</code></a></dt>
257 8b679b4b 2020-02-17 stsp <dd>Find the next line which matches the current search pattern.</dd>
258 2dbbbc3a 2020-07-23 stsp <dt id="N~2"><a class="permalink" href="#N~2"><code class="Cm">N</code></a></dt>
259 8b679b4b 2020-02-17 stsp <dd>Find the previous line which matches the current search pattern.</dd>
260 1b792db0 2020-12-13 stsp <dt id="w"><a class="permalink" href="#w"><code class="Cm">w</code></a></dt>
261 1b792db0 2020-12-13 stsp <dd>Toggle display of whitespace-only changes.</dd>
262 8797b228 2019-08-04 stsp </dl>
263 7c3b4ab8 2020-02-25 stsp <p class="Pp">The options for <code class="Cm">tog diff</code> are as
264 7c3b4ab8 2020-02-25 stsp follows:</p>
265 7c3b4ab8 2020-02-25 stsp <dl class="Bl-tag">
266 1b792db0 2020-12-13 stsp <dt id="a~2"><a class="permalink" href="#a~2"><code class="Fl">-a</code></a></dt>
267 1b792db0 2020-12-13 stsp <dd>Treat file contents as ASCII text even if binary data is
268 1b792db0 2020-12-13 stsp detected.</dd>
269 1b792db0 2020-12-13 stsp <dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a>
270 1b792db0 2020-12-13 stsp <var class="Ar">number</var></dt>
271 1b792db0 2020-12-13 stsp <dd>Set the number of context lines shown in the diff. By default, 3 lines
272 1b792db0 2020-12-13 stsp of context are shown.</dd>
273 1b792db0 2020-12-13 stsp <dt id="r~3"><a class="permalink" href="#r~3"><code class="Fl">-r</code></a>
274 7c3b4ab8 2020-02-25 stsp <var class="Ar">repository-path</var></dt>
275 7c3b4ab8 2020-02-25 stsp <dd>Use the repository at the specified path. If not specified, assume the
276 7c3b4ab8 2020-02-25 stsp repository is located at or above the current working directory. If
277 7c3b4ab8 2020-02-25 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
278 7c3b4ab8 2020-02-25 stsp repository path associated with this work tree.</dd>
279 1b792db0 2020-12-13 stsp <dt id="w~2"><a class="permalink" href="#w~2"><code class="Fl">-w</code></a></dt>
280 1b792db0 2020-12-13 stsp <dd>Ignore whitespace-only changes.</dd>
281 7c3b4ab8 2020-02-25 stsp </dl>
282 8797b228 2019-08-04 stsp </dd>
283 2dbbbc3a 2020-07-23 stsp <dt id="blame"><a class="permalink" href="#blame"><code class="Cm">blame</code></a>
284 8797b228 2019-08-04 stsp [<code class="Fl">-c</code> <var class="Ar">commit</var>]
285 8797b228 2019-08-04 stsp [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
286 8797b228 2019-08-04 stsp <var class="Ar">path</var></dt>
287 8797b228 2019-08-04 stsp <dd>Display line-by-line history of a file at the specified path.
288 8797b228 2019-08-04 stsp <p class="Pp">The key bindings for <code class="Cm">tog blame</code> are as
289 8797b228 2019-08-04 stsp follows:</p>
290 8797b228 2019-08-04 stsp <dl class="Bl-tag">
291 2dbbbc3a 2020-07-23 stsp <dt id="Down-arrow,~3"><a class="permalink" href="#Down-arrow,~3"><code class="Cm">Down-arrow,
292 d785ebc6 2021-10-17 stsp j, Ctrl-n</code></a></dt>
293 8797b228 2019-08-04 stsp <dd>Move the selection cursor down.</dd>
294 2dbbbc3a 2020-07-23 stsp <dt id="Up-arrow,~3"><a class="permalink" href="#Up-arrow,~3"><code class="Cm">Up-arrow,
295 d785ebc6 2021-10-17 stsp k, Ctrl-p</code></a></dt>
296 8797b228 2019-08-04 stsp <dd>Move the selection cursor up.</dd>
297 2dbbbc3a 2020-07-23 stsp <dt id="Page-down,~3"><a class="permalink" href="#Page-down,~3"><code class="Cm">Page-down,
298 7c3b4ab8 2020-02-25 stsp Space, Ctrl+f</code></a></dt>
299 7c3b4ab8 2020-02-25 stsp <dd>Move the selection cursor down one page.</dd>
300 2dbbbc3a 2020-07-23 stsp <dt id="Page-up,~3"><a class="permalink" href="#Page-up,~3"><code class="Cm">Page-up,
301 7c3b4ab8 2020-02-25 stsp Ctrl+b</code></a></dt>
302 7c3b4ab8 2020-02-25 stsp <dd>Move the selection cursor up one page.</dd>
303 1e80276a 2021-09-03 stsp <dt id="Home,~3"><a class="permalink" href="#Home,~3"><code class="Cm">Home,
304 1e80276a 2021-09-03 stsp g</code></a></dt>
305 1e80276a 2021-09-03 stsp <dd>Move the selection cursor to the first line of the file.</dd>
306 1e80276a 2021-09-03 stsp <dt id="End,~3"><a class="permalink" href="#End,~3"><code class="Cm">End,
307 1e80276a 2021-09-03 stsp G</code></a></dt>
308 1e80276a 2021-09-03 stsp <dd>Move the selection cursor to the last line of the file.</dd>
309 2dbbbc3a 2020-07-23 stsp <dt id="Enter"><a class="permalink" href="#Enter"><code class="Cm">Enter</code></a></dt>
310 8797b228 2019-08-04 stsp <dd>Open a <code class="Cm">diff</code> view for the currently selected
311 8797b228 2019-08-04 stsp line's commit.</dd>
312 2dbbbc3a 2020-07-23 stsp <dt id="b~2"><a class="permalink" href="#b~2"><code class="Cm">b</code></a></dt>
313 8797b228 2019-08-04 stsp <dd>Reload the <code class="Cm">blame</code> view with the version of the
314 8797b228 2019-08-04 stsp file as found in the currently selected line's commit.</dd>
315 2dbbbc3a 2020-07-23 stsp <dt id="p"><a class="permalink" href="#p"><code class="Cm">p</code></a></dt>
316 8797b228 2019-08-04 stsp <dd>Reload the <code class="Cm">blame</code> view with the version of the
317 8797b228 2019-08-04 stsp file as found in the parent commit of the currently selected line's
318 8797b228 2019-08-04 stsp commit.</dd>
319 2dbbbc3a 2020-07-23 stsp <dt id="B~2"><a class="permalink" href="#B~2"><code class="Cm">B</code></a></dt>
320 8797b228 2019-08-04 stsp <dd>Reload the <code class="Cm">blame</code> view with the previously
321 8797b228 2019-08-04 stsp blamed commit.</dd>
322 2dbbbc3a 2020-07-23 stsp <dt id="/~3"><a class="permalink" href="#/~3"><code class="Cm">/</code></a></dt>
323 f2e17eed 2020-11-14 stsp <dd>Prompt for a search pattern and start searching for matching lines.
324 f2e17eed 2020-11-14 stsp The search pattern is an extended regular expression. Regular
325 f2e17eed 2020-11-14 stsp expression syntax is documented in
326 f2e17eed 2020-11-14 stsp <a class="Xr">re_format(7)</a>.</dd>
327 2dbbbc3a 2020-07-23 stsp <dt id="n~3"><a class="permalink" href="#n~3"><code class="Cm">n</code></a></dt>
328 8797b228 2019-08-04 stsp <dd>Find the next line which matches the current search pattern.</dd>
329 2dbbbc3a 2020-07-23 stsp <dt id="N~3"><a class="permalink" href="#N~3"><code class="Cm">N</code></a></dt>
330 8797b228 2019-08-04 stsp <dd>Find the previous line which matches the current search pattern.</dd>
331 8797b228 2019-08-04 stsp </dl>
332 8797b228 2019-08-04 stsp <p class="Pp">The options for <code class="Cm">tog blame</code> are as
333 8797b228 2019-08-04 stsp follows:</p>
334 8797b228 2019-08-04 stsp <dl class="Bl-tag">
335 2dbbbc3a 2020-07-23 stsp <dt id="c~2"><a class="permalink" href="#c~2"><code class="Fl">-c</code></a>
336 8797b228 2019-08-04 stsp <var class="Ar">commit</var></dt>
337 8797b228 2019-08-04 stsp <dd>Start traversing history at the specified
338 8797b228 2019-08-04 stsp <var class="Ar">commit</var>. The expected argument is the name of a
339 8797b228 2019-08-04 stsp branch or a commit ID SHA1 hash. An abbreviated hash argument will be
340 8797b228 2019-08-04 stsp expanded to a full SHA1 hash automatically, provided the abbreviation
341 8797b228 2019-08-04 stsp is unique.</dd>
342 1b792db0 2020-12-13 stsp <dt id="r~4"><a class="permalink" href="#r~4"><code class="Fl">-r</code></a>
343 8797b228 2019-08-04 stsp <var class="Ar">repository-path</var></dt>
344 8797b228 2019-08-04 stsp <dd>Use the repository at the specified path. If not specified, assume the
345 7c3b4ab8 2020-02-25 stsp repository is located at or above the current working directory. If
346 7c3b4ab8 2020-02-25 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
347 7c3b4ab8 2020-02-25 stsp repository path associated with this work tree.</dd>
348 8797b228 2019-08-04 stsp </dl>
349 8797b228 2019-08-04 stsp </dd>
350 2dbbbc3a 2020-07-23 stsp <dt id="tree"><a class="permalink" href="#tree"><code class="Cm">tree</code></a>
351 8797b228 2019-08-04 stsp [<code class="Fl">-c</code> <var class="Ar">commit</var>]
352 7c3b4ab8 2020-02-25 stsp [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]
353 7c3b4ab8 2020-02-25 stsp [<var class="Ar">path</var>]</dt>
354 7c3b4ab8 2020-02-25 stsp <dd>Display the repository tree. If a <var class="Ar">path</var> is specified,
355 7c3b4ab8 2020-02-25 stsp show tree entries at this path.
356 e8022e04 2019-08-13 stsp <p class="Pp">Displayed tree entries may carry one of the following trailing
357 e8022e04 2019-08-13 stsp annotations:</p>
358 e8022e04 2019-08-13 stsp <table class="Bl-column">
359 e8022e04 2019-08-13 stsp <tr>
360 e8022e04 2019-08-13 stsp <td>@</td>
361 e8022e04 2019-08-13 stsp <td>entry is a symbolic link</td>
362 e8022e04 2019-08-13 stsp </tr>
363 e8022e04 2019-08-13 stsp <tr>
364 e8022e04 2019-08-13 stsp <td>/</td>
365 e8022e04 2019-08-13 stsp <td>entry is a directory</td>
366 e8022e04 2019-08-13 stsp </tr>
367 e8022e04 2019-08-13 stsp <tr>
368 e8022e04 2019-08-13 stsp <td>*</td>
369 e8022e04 2019-08-13 stsp <td>entry is an executable file</td>
370 ba0a4168 2019-08-26 stsp </tr>
371 ba0a4168 2019-08-26 stsp <tr>
372 ba0a4168 2019-08-26 stsp <td>$</td>
373 ba0a4168 2019-08-26 stsp <td>entry is a Git submodule</td>
374 e8022e04 2019-08-13 stsp </tr>
375 e8022e04 2019-08-13 stsp </table>
376 2dbbbc3a 2020-07-23 stsp <p class="Pp">Symbolic link entries are also annotated with the target path
377 2dbbbc3a 2020-07-23 stsp of the link.</p>
378 8797b228 2019-08-04 stsp <p class="Pp">The key bindings for <code class="Cm">tog tree</code> are as
379 8797b228 2019-08-04 stsp follows:</p>
380 8797b228 2019-08-04 stsp <dl class="Bl-tag">
381 2dbbbc3a 2020-07-23 stsp <dt id="Down-arrow,~4"><a class="permalink" href="#Down-arrow,~4"><code class="Cm">Down-arrow,
382 d785ebc6 2021-10-17 stsp j, Ctrl-n</code></a></dt>
383 8797b228 2019-08-04 stsp <dd>Move the selection cursor down.</dd>
384 2dbbbc3a 2020-07-23 stsp <dt id="Up-arrow,~4"><a class="permalink" href="#Up-arrow,~4"><code class="Cm">Up-arrow,
385 d785ebc6 2021-10-17 stsp k, Ctrl-p</code></a></dt>
386 8797b228 2019-08-04 stsp <dd>Move the selection cursor up.</dd>
387 2dbbbc3a 2020-07-23 stsp <dt id="Page-down,~4"><a class="permalink" href="#Page-down,~4"><code class="Cm">Page-down,
388 7c3b4ab8 2020-02-25 stsp Ctrl+f</code></a></dt>
389 7c3b4ab8 2020-02-25 stsp <dd>Move the selection cursor down one page.</dd>
390 2dbbbc3a 2020-07-23 stsp <dt id="Page-up,~4"><a class="permalink" href="#Page-up,~4"><code class="Cm">Page-up,
391 7c3b4ab8 2020-02-25 stsp Ctrl+b</code></a></dt>
392 7c3b4ab8 2020-02-25 stsp <dd>Move the selection cursor up one page.</dd>
393 7945ca33 2021-09-11 stsp <dt id="Home,~4"><a class="permalink" href="#Home,~4"><code class="Cm">Home,
394 7945ca33 2021-09-11 stsp g</code></a></dt>
395 7945ca33 2021-09-11 stsp <dd>Move the selection cursor to the first entry.</dd>
396 7945ca33 2021-09-11 stsp <dt id="End,~4"><a class="permalink" href="#End,~4"><code class="Cm">End,
397 7945ca33 2021-09-11 stsp G</code></a></dt>
398 7945ca33 2021-09-11 stsp <dd>Move the selection cursor to the last entry.</dd>
399 2dbbbc3a 2020-07-23 stsp <dt id="Enter~2"><a class="permalink" href="#Enter~2"><code class="Cm">Enter</code></a></dt>
400 8797b228 2019-08-04 stsp <dd>Enter the currently selected directory, or switch to the
401 8797b228 2019-08-04 stsp <code class="Cm">blame</code> view for the currently selected
402 8797b228 2019-08-04 stsp file.</dd>
403 2dbbbc3a 2020-07-23 stsp <dt id="l"><a class="permalink" href="#l"><code class="Cm">l</code></a></dt>
404 8797b228 2019-08-04 stsp <dd>Open a <code class="Cm">log</code> view for the currently selected
405 8797b228 2019-08-04 stsp tree entry.</dd>
406 1b792db0 2020-12-13 stsp <dt id="r~5"><a class="permalink" href="#r~5"><code class="Cm">r</code></a></dt>
407 1b792db0 2020-12-13 stsp <dd>Open a <code class="Cm">ref</code> view listing all references in the
408 1b792db0 2020-12-13 stsp repository. This can then be used to open a new
409 1b792db0 2020-12-13 stsp <code class="Cm">tree</code> view for arbitrary branches and
410 1b792db0 2020-12-13 stsp tags.</dd>
411 2dbbbc3a 2020-07-23 stsp <dt id="Backspace~2"><a class="permalink" href="#Backspace~2"><code class="Cm">Backspace</code></a></dt>
412 8797b228 2019-08-04 stsp <dd>Move back to the parent directory.</dd>
413 2dbbbc3a 2020-07-23 stsp <dt id="i"><a class="permalink" href="#i"><code class="Cm">i</code></a></dt>
414 8797b228 2019-08-04 stsp <dd>Show object IDs for all objects displayed in the
415 8797b228 2019-08-04 stsp <code class="Cm">tree</code> view.</dd>
416 2dbbbc3a 2020-07-23 stsp <dt id="/~4"><a class="permalink" href="#/~4"><code class="Cm">/</code></a></dt>
417 8797b228 2019-08-04 stsp <dd>Prompt for a search pattern and start searching for matching tree
418 8797b228 2019-08-04 stsp entries. The search pattern is an extended regular expression which is
419 8797b228 2019-08-04 stsp matched against the tree entry's name. Regular expression syntax is
420 8797b228 2019-08-04 stsp documented in <a class="Xr">re_format(7)</a>.</dd>
421 2dbbbc3a 2020-07-23 stsp <dt id="n~4"><a class="permalink" href="#n~4"><code class="Cm">n</code></a></dt>
422 8797b228 2019-08-04 stsp <dd>Find the next tree entry which matches the current search
423 8797b228 2019-08-04 stsp pattern.</dd>
424 2dbbbc3a 2020-07-23 stsp <dt id="N~4"><a class="permalink" href="#N~4"><code class="Cm">N</code></a></dt>
425 8797b228 2019-08-04 stsp <dd>Find the previous tree entry which matches the current search
426 8797b228 2019-08-04 stsp pattern.</dd>
427 8797b228 2019-08-04 stsp </dl>
428 8797b228 2019-08-04 stsp <p class="Pp">The options for <code class="Cm">tog tree</code> are as
429 8797b228 2019-08-04 stsp follows:</p>
430 8797b228 2019-08-04 stsp <dl class="Bl-tag">
431 2dbbbc3a 2020-07-23 stsp <dt id="c~3"><a class="permalink" href="#c~3"><code class="Fl">-c</code></a>
432 8797b228 2019-08-04 stsp <var class="Ar">commit</var></dt>
433 8797b228 2019-08-04 stsp <dd>Start traversing history at the specified
434 8797b228 2019-08-04 stsp <var class="Ar">commit</var>. The expected argument is the name of a
435 8797b228 2019-08-04 stsp branch or a commit ID SHA1 hash. An abbreviated hash argument will be
436 8797b228 2019-08-04 stsp expanded to a full SHA1 hash automatically, provided the abbreviation
437 8797b228 2019-08-04 stsp is unique.</dd>
438 1b792db0 2020-12-13 stsp <dt id="r~6"><a class="permalink" href="#r~6"><code class="Fl">-r</code></a>
439 1b792db0 2020-12-13 stsp <var class="Ar">repository-path</var></dt>
440 1b792db0 2020-12-13 stsp <dd>Use the repository at the specified path. If not specified, assume the
441 1b792db0 2020-12-13 stsp repository is located at or above the current working directory. If
442 1b792db0 2020-12-13 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
443 1b792db0 2020-12-13 stsp repository path associated with this work tree.</dd>
444 1b792db0 2020-12-13 stsp </dl>
445 1b792db0 2020-12-13 stsp </dd>
446 1b792db0 2020-12-13 stsp <dt id="ref"><a class="permalink" href="#ref"><code class="Cm">ref</code></a>
447 1b792db0 2020-12-13 stsp [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]</dt>
448 1b792db0 2020-12-13 stsp <dd>Display references in the repository.
449 1b792db0 2020-12-13 stsp <p class="Pp">The key bindings for <code class="Cm">tog ref</code> are as
450 1b792db0 2020-12-13 stsp follows:</p>
451 1b792db0 2020-12-13 stsp <dl class="Bl-tag">
452 1b792db0 2020-12-13 stsp <dt id="Down-arrow,~5"><a class="permalink" href="#Down-arrow,~5"><code class="Cm">Down-arrow,
453 d785ebc6 2021-10-17 stsp j, Ctrl-n</code></a></dt>
454 1b792db0 2020-12-13 stsp <dd>Move the selection cursor down.</dd>
455 1b792db0 2020-12-13 stsp <dt id="Up-arrow,~5"><a class="permalink" href="#Up-arrow,~5"><code class="Cm">Up-arrow,
456 d785ebc6 2021-10-17 stsp k, Ctrl-p</code></a></dt>
457 1b792db0 2020-12-13 stsp <dd>Move the selection cursor up.</dd>
458 1b792db0 2020-12-13 stsp <dt id="Page-down,~5"><a class="permalink" href="#Page-down,~5"><code class="Cm">Page-down,
459 1b792db0 2020-12-13 stsp Ctrl+f</code></a></dt>
460 1b792db0 2020-12-13 stsp <dd>Move the selection cursor down one page.</dd>
461 1b792db0 2020-12-13 stsp <dt id="Page-up,~5"><a class="permalink" href="#Page-up,~5"><code class="Cm">Page-up,
462 1b792db0 2020-12-13 stsp Ctrl+b</code></a></dt>
463 1b792db0 2020-12-13 stsp <dd>Move the selection cursor up one page.</dd>
464 7945ca33 2021-09-11 stsp <dt id="Home,~5"><a class="permalink" href="#Home,~5"><code class="Cm">Home,
465 7945ca33 2021-09-11 stsp g</code></a></dt>
466 7945ca33 2021-09-11 stsp <dd>Move the selection cursor to the first reference.</dd>
467 7945ca33 2021-09-11 stsp <dt id="End,~5"><a class="permalink" href="#End,~5"><code class="Cm">End,
468 7945ca33 2021-09-11 stsp G</code></a></dt>
469 7945ca33 2021-09-11 stsp <dd>Move the selection cursor to the last reference.</dd>
470 1b792db0 2020-12-13 stsp <dt id="Enter~3"><a class="permalink" href="#Enter~3"><code class="Cm">Enter</code></a></dt>
471 1b792db0 2020-12-13 stsp <dd>Open a <code class="Cm">log</code> view which begins traversing
472 1b792db0 2020-12-13 stsp history at the commit resolved via the currently selected
473 1b792db0 2020-12-13 stsp reference.</dd>
474 1b792db0 2020-12-13 stsp <dt id="t~2"><a class="permalink" href="#t~2"><code class="Cm">t</code></a></dt>
475 1b792db0 2020-12-13 stsp <dd>Open a <code class="Cm">tree</code> view showing the tree resolved via
476 1b792db0 2020-12-13 stsp the currently selected reference.</dd>
477 1b792db0 2020-12-13 stsp <dt id="i~2"><a class="permalink" href="#i~2"><code class="Cm">i</code></a></dt>
478 1b792db0 2020-12-13 stsp <dd>Show object IDs for all non-symbolic references displayed in the
479 1b792db0 2020-12-13 stsp <code class="Cm">ref</code> view.</dd>
480 46043f6f 2021-11-23 stsp <dt id="o"><a class="permalink" href="#o"><code class="Cm">o</code></a></dt>
481 46043f6f 2021-11-23 stsp <dd>Toggle display order of references between sort by name and sort by
482 46043f6f 2021-11-23 stsp timestamp.</dd>
483 1b792db0 2020-12-13 stsp <dt id="/~5"><a class="permalink" href="#/~5"><code class="Cm">/</code></a></dt>
484 1b792db0 2020-12-13 stsp <dd>Prompt for a search pattern and start searching for matching
485 1b792db0 2020-12-13 stsp references. The search pattern is an extended regular expression which
486 1b792db0 2020-12-13 stsp is matched against absolute reference names. Regular expression syntax
487 1b792db0 2020-12-13 stsp is documented in <a class="Xr">re_format(7)</a>.</dd>
488 1b792db0 2020-12-13 stsp <dt id="n~5"><a class="permalink" href="#n~5"><code class="Cm">n</code></a></dt>
489 1b792db0 2020-12-13 stsp <dd>Find the next reference which matches the current search pattern.</dd>
490 1b792db0 2020-12-13 stsp <dt id="N~5"><a class="permalink" href="#N~5"><code class="Cm">N</code></a></dt>
491 1b792db0 2020-12-13 stsp <dd>Find the previous reference which matches the current search
492 1b792db0 2020-12-13 stsp pattern.</dd>
493 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>
494 1b792db0 2020-12-13 stsp <dd>Reload the list of references displayed by the
495 1b792db0 2020-12-13 stsp <code class="Cm">ref</code> view.</dd>
496 1b792db0 2020-12-13 stsp </dl>
497 1b792db0 2020-12-13 stsp <p class="Pp">The options for <code class="Cm">tog ref</code> are as
498 1b792db0 2020-12-13 stsp follows:</p>
499 1b792db0 2020-12-13 stsp <dl class="Bl-tag">
500 1b792db0 2020-12-13 stsp <dt id="r~7"><a class="permalink" href="#r~7"><code class="Fl">-r</code></a>
501 8b679b4b 2020-02-17 stsp <var class="Ar">repository-path</var></dt>
502 8b679b4b 2020-02-17 stsp <dd>Use the repository at the specified path. If not specified, assume the
503 8b679b4b 2020-02-17 stsp repository is located at or above the current working directory. If
504 8b679b4b 2020-02-17 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
505 8b679b4b 2020-02-17 stsp repository path associated with this work tree.</dd>
506 8797b228 2019-08-04 stsp </dl>
507 8797b228 2019-08-04 stsp </dd>
508 cc85973b 2019-11-27 stsp </dl>
509 cc85973b 2019-11-27 stsp </section>
510 cc85973b 2019-11-27 stsp <section class="Sh">
511 cc85973b 2019-11-27 stsp <h1 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h1>
512 cc85973b 2019-11-27 stsp <dl class="Bl-tag">
513 2dbbbc3a 2020-07-23 stsp <dt id="TOG_COLORS"><a class="permalink" href="#TOG_COLORS"><code class="Ev">TOG_COLORS</code></a></dt>
514 cc85973b 2019-11-27 stsp <dd><code class="Nm">tog</code> shows colorized output if this variable is set
515 cc85973b 2019-11-27 stsp to a non-empty value. The default color scheme can be modified by setting
516 cc85973b 2019-11-27 stsp the environment variables documented below. The colors available in color
517 cc85973b 2019-11-27 stsp schemes are &#x201C;black&#x201D;, &#x201C;red&#x201D;,
518 cc85973b 2019-11-27 stsp &#x201C;green&#x201D;, &#x201C;yellow&#x201D;, &#x201C;blue&#x201D;,
519 def5be4a 2021-08-31 stsp &#x201C;magenta&#x201D;, &#x201C;cyan&#x201D;, and &#x201C;default&#x201D;
520 cc85973b 2019-11-27 stsp which maps to the terminal's default foreground color.</dd>
521 2dbbbc3a 2020-07-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>
522 cc85973b 2019-11-27 stsp <dd>The color used to mark up removed lines in diffs. If not set, the default
523 cc85973b 2019-11-27 stsp value &#x201C;magenta&#x201D; is used.</dd>
524 2dbbbc3a 2020-07-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>
525 cc85973b 2019-11-27 stsp <dd>The color used to mark up added lines in diffs. If not set, the default
526 cc85973b 2019-11-27 stsp value &#x201C;cyan&#x201D; is used.</dd>
527 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>
528 cc85973b 2019-11-27 stsp <dd>The color used to mark up chunk header lines in diffs. If not set, the
529 cc85973b 2019-11-27 stsp default value &#x201C;yellow&#x201D; is used.</dd>
530 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>
531 cc85973b 2019-11-27 stsp <dd>The color used to mark up meta data in diffs. If not set, the default
532 cc85973b 2019-11-27 stsp value &#x201C;green&#x201D; is used.</dd>
533 2dbbbc3a 2020-07-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>
534 def5be4a 2021-08-31 stsp <dd>The color used to mark up submodule tree entries. If not set, the default
535 cc85973b 2019-11-27 stsp value &#x201C;magenta&#x201D; is used.</dd>
536 2dbbbc3a 2020-07-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>
537 cc85973b 2019-11-27 stsp <dd>The color used to mark up symbolic link tree entries. If not set, the
538 8b679b4b 2020-02-17 stsp default value &#x201C;magenta&#x201D; is used.</dd>
539 2dbbbc3a 2020-07-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>
540 cc85973b 2019-11-27 stsp <dd>The color used to mark up directory tree entries. If not set, the default
541 8b679b4b 2020-02-17 stsp value &#x201C;cyan&#x201D; is used.</dd>
542 2dbbbc3a 2020-07-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>
543 cc85973b 2019-11-27 stsp <dd>The color used to mark up executable file tree entries. If not set, the
544 cc85973b 2019-11-27 stsp default value &#x201C;green&#x201D; is used.</dd>
545 2dbbbc3a 2020-07-23 stsp <dt id="TOG_COLOR_COMMIT"><a class="permalink" href="#TOG_COLOR_COMMIT"><code class="Ev">TOG_COLOR_COMMIT</code></a></dt>
546 cc85973b 2019-11-27 stsp <dd>The color used to mark up commit IDs. If not set, the default value
547 cc85973b 2019-11-27 stsp &#x201C;green&#x201D; is used.</dd>
548 2dbbbc3a 2020-07-23 stsp <dt id="TOG_COLOR_AUTHOR"><a class="permalink" href="#TOG_COLOR_AUTHOR"><code class="Ev">TOG_COLOR_AUTHOR</code></a></dt>
549 cc85973b 2019-11-27 stsp <dd>The color used to mark up author information. If not set, the default
550 cc85973b 2019-11-27 stsp value &#x201C;cyan&#x201D; is used.</dd>
551 2dbbbc3a 2020-07-23 stsp <dt id="TOG_COLOR_DATE"><a class="permalink" href="#TOG_COLOR_DATE"><code class="Ev">TOG_COLOR_DATE</code></a></dt>
552 cc85973b 2019-11-27 stsp <dd>The color used to mark up date information. If not set, the default value
553 cc85973b 2019-11-27 stsp &#x201C;yellow&#x201D; is used.</dd>
554 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>
555 1b792db0 2020-12-13 stsp <dd>The color used to mark up references in the &#x201C;refs/heads/&#x201D;
556 1b792db0 2020-12-13 stsp namespace. If not set, the default value &#x201C;green&#x201D; is
557 1b792db0 2020-12-13 stsp used.</dd>
558 1b792db0 2020-12-13 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>
559 1b792db0 2020-12-13 stsp <dd>The color used to mark up references in the &#x201C;refs/tags/&#x201D;
560 1b792db0 2020-12-13 stsp namespace. If not set, the default value &#x201C;magenta&#x201D; is
561 1b792db0 2020-12-13 stsp used.</dd>
562 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>
563 1b792db0 2020-12-13 stsp <dd>The color used to mark up references in the &#x201C;refs/remotes/&#x201D;
564 1b792db0 2020-12-13 stsp namespace. If not set, the default value &#x201C;yellow&#x201D; is
565 1b792db0 2020-12-13 stsp used.</dd>
566 b078d5c4 2022-03-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>
567 b078d5c4 2022-03-23 stsp <dd>The color used to mark up references in the
568 b078d5c4 2022-03-23 stsp &#x201C;refs/got/backup/&#x201D; namespace. If not set, the default value
569 b078d5c4 2022-03-23 stsp &#x201C;cyan&#x201D; is used.</dd>
570 8797b228 2019-08-04 stsp </dl>
571 8797b228 2019-08-04 stsp </section>
572 8797b228 2019-08-04 stsp <section class="Sh">
573 8797b228 2019-08-04 stsp <h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
574 8797b228 2019-08-04 stsp STATUS</a></h1>
575 d8e62599 2019-10-21 stsp <p class="Pp">The <code class="Nm">tog</code> utility exits&#x00A0;0 on success,
576 d8e62599 2019-10-21 stsp and&#x00A0;&gt;0 if an error occurs.</p>
577 8797b228 2019-08-04 stsp </section>
578 8797b228 2019-08-04 stsp <section class="Sh">
579 8797b228 2019-08-04 stsp <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
580 8797b228 2019-08-04 stsp ALSO</a></h1>
581 d8e62599 2019-10-21 stsp <p class="Pp"><a class="Xr">got(1)</a>, <a class="Xr">git-repository(5)</a>,
582 d8e62599 2019-10-21 stsp <a class="Xr">re_format(7)</a></p>
583 8797b228 2019-08-04 stsp </section>
584 8797b228 2019-08-04 stsp <section class="Sh">
585 8797b228 2019-08-04 stsp <h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
586 d8e62599 2019-10-21 stsp <p class="Pp"><span class="An">Stefan Sperling</span>
587 d8e62599 2019-10-21 stsp &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;
588 d8e62599 2019-10-21 stsp <br/>
589 d8e62599 2019-10-21 stsp <span class="An">Joshua Stein</span>
590 d8e62599 2019-10-21 stsp &lt;<a class="Mt" href="mailto:jcs@openbsd.org">jcs@openbsd.org</a>&gt;</p>
591 8797b228 2019-08-04 stsp </section>
592 8797b228 2019-08-04 stsp </div>
593 8797b228 2019-08-04 stsp <table class="foot">
594 8797b228 2019-08-04 stsp <tr>
595 03b138b5 2022-05-10 stsp <td class="foot-date">May 10, 2022</td>
596 15ba8349 2022-04-24 stsp <td class="foot-os">OpenBSD 7.1</td>
597 8797b228 2019-08-04 stsp </tr>
598 8797b228 2019-08-04 stsp </table>
599 8797b228 2019-08-04 stsp </body>
600 8797b228 2019-08-04 stsp </html>