Blame


1 1a21a6dd 2021-09-12 stsp <!DOCTYPE html>
2 1a21a6dd 2021-09-12 stsp <html>
3 1a21a6dd 2021-09-12 stsp <!-- This is an automatically generated file. Do not edit.
4 1a21a6dd 2021-09-12 stsp Copyright (c) 2020 Stefan Sperling <stsp@openbsd.org>
5 1a21a6dd 2021-09-12 stsp
6 1a21a6dd 2021-09-12 stsp Permission to use, copy, modify, and distribute this software for any
7 1a21a6dd 2021-09-12 stsp purpose with or without fee is hereby granted, provided that the above
8 1a21a6dd 2021-09-12 stsp copyright notice and this permission notice appear in all copies.
9 1a21a6dd 2021-09-12 stsp
10 1a21a6dd 2021-09-12 stsp THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 1a21a6dd 2021-09-12 stsp WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 1a21a6dd 2021-09-12 stsp MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 1a21a6dd 2021-09-12 stsp ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 1a21a6dd 2021-09-12 stsp WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 1a21a6dd 2021-09-12 stsp ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 1a21a6dd 2021-09-12 stsp OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 1a21a6dd 2021-09-12 stsp -->
18 1a21a6dd 2021-09-12 stsp <head>
19 1a21a6dd 2021-09-12 stsp <meta charset="utf-8"/>
20 1a21a6dd 2021-09-12 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 1a21a6dd 2021-09-12 stsp <title>GOT.CONF(5)</title>
23 1a21a6dd 2021-09-12 stsp </head>
24 1a21a6dd 2021-09-12 stsp <body>
25 1a21a6dd 2021-09-12 stsp <table class="head">
26 1a21a6dd 2021-09-12 stsp <tr>
27 1a21a6dd 2021-09-12 stsp <td class="head-ltitle">GOT.CONF(5)</td>
28 1a21a6dd 2021-09-12 stsp <td class="head-vol">File Formats Manual</td>
29 1a21a6dd 2021-09-12 stsp <td class="head-rtitle">GOT.CONF(5)</td>
30 1a21a6dd 2021-09-12 stsp </tr>
31 1a21a6dd 2021-09-12 stsp </table>
32 1a21a6dd 2021-09-12 stsp <div class="manual-text">
33 1a21a6dd 2021-09-12 stsp <section class="Sh">
34 1a21a6dd 2021-09-12 stsp <h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
35 1a21a6dd 2021-09-12 stsp <p class="Pp"><code class="Nm">got.conf</code> &#x2014; <span class="Nd">Game of
36 1a21a6dd 2021-09-12 stsp Trees configuration file</span></p>
37 1a21a6dd 2021-09-12 stsp </section>
38 1a21a6dd 2021-09-12 stsp <section class="Sh">
39 1a21a6dd 2021-09-12 stsp <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
40 1a21a6dd 2021-09-12 stsp <p class="Pp"><code class="Nm">got.conf</code> is the run-time configuration
41 1a21a6dd 2021-09-12 stsp file for <a class="Xr">got(1)</a>.</p>
42 1a21a6dd 2021-09-12 stsp <p class="Pp"><code class="Nm">got.conf</code> may be present in the root
43 1a21a6dd 2021-09-12 stsp directory of a Git repository for repository-wide settings, or in the
44 1a21a6dd 2021-09-12 stsp <span class="Pa">.got</span> meta-data directory of a work tree to override
45 1a21a6dd 2021-09-12 stsp repository-wide settings for <a class="Xr">got(1)</a> commands executed
46 1a21a6dd 2021-09-12 stsp within this work tree.</p>
47 1a21a6dd 2021-09-12 stsp <p class="Pp">The file format is line-based, with one configuration directive
48 1a21a6dd 2021-09-12 stsp per line. Any lines beginning with a &#x2018;#&#x2019; are treated as
49 1a21a6dd 2021-09-12 stsp comments and ignored.</p>
50 1a21a6dd 2021-09-12 stsp <p class="Pp">The available configuration directives are as follows:</p>
51 1a21a6dd 2021-09-12 stsp <dl class="Bl-tag">
52 1a21a6dd 2021-09-12 stsp <dt id="author"><a class="permalink" href="#author"><code class="Ic">author</code></a>
53 1a21a6dd 2021-09-12 stsp &#x201C;Real Name &lt;email address&gt;&#x201D;</dt>
54 1a21a6dd 2021-09-12 stsp <dd>Configure the author's name and email address for <code class="Cm">got
55 1a21a6dd 2021-09-12 stsp commit</code> and <code class="Cm">got import</code> when operating on
56 1a21a6dd 2021-09-12 stsp this repository. Author information specified here overrides the
57 1a21a6dd 2021-09-12 stsp <code class="Ev">GOT_AUTHOR</code> environment variable.
58 1a21a6dd 2021-09-12 stsp <p class="Pp">Because <a class="Xr">git(1)</a> may fail to parse commits
59 1a21a6dd 2021-09-12 stsp without an email address in author data, <a class="Xr">got(1)</a>
60 1a21a6dd 2021-09-12 stsp attempts to reject author information with a missing email address.</p>
61 1a21a6dd 2021-09-12 stsp </dd>
62 1a21a6dd 2021-09-12 stsp <dt id="remote"><a class="permalink" href="#remote"><code class="Ic">remote</code></a>
63 1a21a6dd 2021-09-12 stsp <var class="Ar">name</var> {...}</dt>
64 1a21a6dd 2021-09-12 stsp <dd>Define a remote repository. The specified <var class="Ar">name</var> can
65 1a21a6dd 2021-09-12 stsp be used to refer to the remote repository on the command line of
66 1a21a6dd 2021-09-12 stsp <code class="Cm">got fetch</code> and <code class="Cm">got send</code>.
67 1a21a6dd 2021-09-12 stsp <p class="Pp">Information about this repository is declared in a block of
68 1a21a6dd 2021-09-12 stsp options enclosed in curly brackets:</p>
69 1a21a6dd 2021-09-12 stsp <dl class="Bl-tag">
70 1a21a6dd 2021-09-12 stsp <dt id="server"><a class="permalink" href="#server"><code class="Ic">server</code></a>
71 1a21a6dd 2021-09-12 stsp <var class="Ar">hostname</var></dt>
72 1a21a6dd 2021-09-12 stsp <dd>Defines the hostname to use for contacting the remote repository's
73 1a21a6dd 2021-09-12 stsp server.</dd>
74 1a21a6dd 2021-09-12 stsp <dt id="repository"><a class="permalink" href="#repository"><code class="Ic">repository</code></a>
75 1a21a6dd 2021-09-12 stsp <var class="Ar">path</var></dt>
76 1a21a6dd 2021-09-12 stsp <dd>Defines the path to the repository on the remote repository's
77 1a21a6dd 2021-09-12 stsp server.</dd>
78 1a21a6dd 2021-09-12 stsp <dt id="protocol"><a class="permalink" href="#protocol"><code class="Ic">protocol</code></a>
79 1a21a6dd 2021-09-12 stsp <var class="Ar">scheme</var></dt>
80 1a21a6dd 2021-09-12 stsp <dd>Defines the protocol to use for communicating with the remote
81 1a21a6dd 2021-09-12 stsp repository's server.
82 1a21a6dd 2021-09-12 stsp <p class="Pp">The following protocol schemes are supported:</p>
83 1a21a6dd 2021-09-12 stsp <dl class="Bl-tag">
84 1a21a6dd 2021-09-12 stsp <dt>git</dt>
85 1a21a6dd 2021-09-12 stsp <dd>The Git protocol as implemented by the
86 1a21a6dd 2021-09-12 stsp <a class="Xr">git-daemon(1)</a> server. Use of this protocol is
87 1a21a6dd 2021-09-12 stsp discouraged since it supports neither authentication nor
88 1a21a6dd 2021-09-12 stsp encryption.</dd>
89 1a21a6dd 2021-09-12 stsp <dt>git+ssh</dt>
90 1a21a6dd 2021-09-12 stsp <dd>The Git protocol wrapped in an authenticated and encrypted
91 1a21a6dd 2021-09-12 stsp <a class="Xr">ssh(1)</a> tunnel. With this protocol the hostname
92 1a21a6dd 2021-09-12 stsp may contain an embedded username for <a class="Xr">ssh(1)</a> to
93 1a21a6dd 2021-09-12 stsp use:
94 1a21a6dd 2021-09-12 stsp <a class="Mt" href="mailto:user@hostname">user@hostname</a></dd>
95 1a21a6dd 2021-09-12 stsp <dt>ssh</dt>
96 1a21a6dd 2021-09-12 stsp <dd>Short alias for git+ssh.</dd>
97 1a21a6dd 2021-09-12 stsp </dl>
98 1a21a6dd 2021-09-12 stsp </dd>
99 1a21a6dd 2021-09-12 stsp <dt id="port"><a class="permalink" href="#port"><code class="Ic">port</code></a>
100 1a21a6dd 2021-09-12 stsp <var class="Ar">port</var></dt>
101 1a21a6dd 2021-09-12 stsp <dd>Defines the port to use for connecting to the remote repository's
102 1a21a6dd 2021-09-12 stsp server. The <var class="Ar">port</var> can be specified by number or
103 1a21a6dd 2021-09-12 stsp name. The port name to number mappings are found in the file
104 1a21a6dd 2021-09-12 stsp <span class="Pa">/etc/services</span>; see
105 1a21a6dd 2021-09-12 stsp <a class="Xr">services(5)</a> for details. If not specified, the
106 1a21a6dd 2021-09-12 stsp default port of the specified <code class="Cm">protocol</code> will be
107 1a21a6dd 2021-09-12 stsp used.</dd>
108 1a21a6dd 2021-09-12 stsp <dt id="branch"><a class="permalink" href="#branch"><code class="Ic">branch</code></a>
109 1a21a6dd 2021-09-12 stsp {<var class="Ar">branch ...</var>}</dt>
110 1a21a6dd 2021-09-12 stsp <dd>Specify one or more branches which <code class="Cm">got fetch</code>
111 1a21a6dd 2021-09-12 stsp and <code class="Cm">got send</code> should fetch from and send to the
112 1a21a6dd 2021-09-12 stsp remote repository by default. The list of branches specified here can
113 1a21a6dd 2021-09-12 stsp be overridden at the <code class="Cm">got fetch</code> and
114 1a21a6dd 2021-09-12 stsp <code class="Cm">got send</code> command lines with the
115 1a21a6dd 2021-09-12 stsp <code class="Fl">-b</code> option.</dd>
116 1a21a6dd 2021-09-12 stsp <dt id="fetch-all-branches"><a class="permalink" href="#fetch-all-branches"><code class="Ic">fetch-all-branches</code></a>
117 1a21a6dd 2021-09-12 stsp <var class="Ar">yes</var> | <var class="Ar">no</var></dt>
118 1a21a6dd 2021-09-12 stsp <dd>This option controls whether <code class="Cm">got fetch</code> will
119 1a21a6dd 2021-09-12 stsp fetch all branches from the remote repository by default. If enabled,
120 1a21a6dd 2021-09-12 stsp this behaviour can be overridden at the <code class="Cm">got
121 1a21a6dd 2021-09-12 stsp fetch</code> command line with the <code class="Fl">-b</code> option,
122 1a21a6dd 2021-09-12 stsp and any <code class="Cm">branch</code> configuration settings for this
123 1a21a6dd 2021-09-12 stsp remote repository will be ignored.</dd>
124 1a21a6dd 2021-09-12 stsp <dt id="reference"><a class="permalink" href="#reference"><code class="Ic">reference</code></a>
125 1a21a6dd 2021-09-12 stsp {<var class="Ar">reference ...</var>}</dt>
126 1a21a6dd 2021-09-12 stsp <dd>Specify one or more arbitrary references which <code class="Cm">got
127 1a21a6dd 2021-09-12 stsp fetch</code> should fetch by default, in addition to the branches and
128 1a21a6dd 2021-09-12 stsp tags that will be fetched. The list of references specified here can
129 1a21a6dd 2021-09-12 stsp be overridden at the <code class="Cm">got fetch</code> command line
130 1a21a6dd 2021-09-12 stsp with the <code class="Fl">-R</code> option. <code class="Cm">got
131 1a21a6dd 2021-09-12 stsp fetch</code> will refuse to fetch references from the remote
132 1a21a6dd 2021-09-12 stsp repository's &#x201C;refs/remotes/&#x201D; or
133 1a21a6dd 2021-09-12 stsp &#x201C;refs/got/&#x201D; namespace. In any case, references in the
134 1a21a6dd 2021-09-12 stsp &#x201C;refs/tags/&#x201D; namespace will always be fetched and mapped
135 1a21a6dd 2021-09-12 stsp directly to local references in the same namespace.</dd>
136 1a21a6dd 2021-09-12 stsp <dt id="mirror-references"><a class="permalink" href="#mirror-references"><code class="Ic">mirror-references</code></a>
137 1a21a6dd 2021-09-12 stsp <var class="Ar">yes</var> | <var class="Ar">no</var></dt>
138 1a21a6dd 2021-09-12 stsp <dd>This option controls the behaviour of <code class="Cm">got
139 1a21a6dd 2021-09-12 stsp fetch</code> when updating references.
140 1a21a6dd 2021-09-12 stsp <a class="permalink" href="#Enabling"><b class="Sy" id="Enabling">Enabling
141 1a21a6dd 2021-09-12 stsp this option can lead to the loss of local commits.</b></a> Maintaining
142 1a21a6dd 2021-09-12 stsp custom changes in a mirror repository is therefore discouraged.
143 1a21a6dd 2021-09-12 stsp <p class="Pp">If this option is not specified or set to
144 1a21a6dd 2021-09-12 stsp <var class="Ar">no</var>, <code class="Cm">got fetch</code> will map
145 1a21a6dd 2021-09-12 stsp references of the remote repository into the local repository's
146 1a21a6dd 2021-09-12 stsp &#x201C;refs/remotes/&#x201D; namespace.</p>
147 1a21a6dd 2021-09-12 stsp <p class="Pp">If this option is set to <var class="Ar">yes</var>, all
148 1a21a6dd 2021-09-12 stsp branches in the &#x201C;refs/heads/&#x201D; namespace will be
149 1a21a6dd 2021-09-12 stsp updated directly to match the corresponding branches in the remote
150 1a21a6dd 2021-09-12 stsp repository.</p>
151 1a21a6dd 2021-09-12 stsp </dd>
152 1a21a6dd 2021-09-12 stsp <dt id="fetch"><a class="permalink" href="#fetch"><code class="Ic">fetch</code></a>
153 1a21a6dd 2021-09-12 stsp {...}</dt>
154 1a21a6dd 2021-09-12 stsp <dd>An optional <code class="Ic">fetch</code> block may contain any of the
155 1a21a6dd 2021-09-12 stsp following configuration settings for use by <code class="Cm">got
156 1a21a6dd 2021-09-12 stsp fetch</code>, overriding corresponding settings in the containing
157 1a21a6dd 2021-09-12 stsp <code class="Ic">remote</code> <var class="Ar">name</var> {...} block.
158 1a21a6dd 2021-09-12 stsp <ul class="Bl-bullet">
159 1a21a6dd 2021-09-12 stsp <li id="server~2"><a class="permalink" href="#server~2"><code class="Ic">server</code></a>
160 1a21a6dd 2021-09-12 stsp <var class="Ar">hostname</var></li>
161 1a21a6dd 2021-09-12 stsp <li id="repository~2"><a class="permalink" href="#repository~2"><code class="Ic">repository</code></a>
162 1a21a6dd 2021-09-12 stsp <var class="Ar">path</var></li>
163 1a21a6dd 2021-09-12 stsp <li id="protocol~2"><a class="permalink" href="#protocol~2"><code class="Ic">protocol</code></a>
164 744ec008 2021-09-12 stsp <var class="Ar">scheme</var></li>
165 1a21a6dd 2021-09-12 stsp <li id="port~2"><a class="permalink" href="#port~2"><code class="Ic">port</code></a>
166 1a21a6dd 2021-09-12 stsp <var class="Ar">port</var></li>
167 1a21a6dd 2021-09-12 stsp <li id="branch~2"><a class="permalink" href="#branch~2"><code class="Ic">branch</code></a>
168 1a21a6dd 2021-09-12 stsp {<var class="Ar">branch ...</var>}</li>
169 1a21a6dd 2021-09-12 stsp </ul>
170 1a21a6dd 2021-09-12 stsp </dd>
171 1a21a6dd 2021-09-12 stsp <dt id="send"><a class="permalink" href="#send"><code class="Ic">send</code></a>
172 1a21a6dd 2021-09-12 stsp {...}</dt>
173 1a21a6dd 2021-09-12 stsp <dd>An optional <code class="Ic">send</code> block may contain any of the
174 1a21a6dd 2021-09-12 stsp following configuration settings for use by <code class="Cm">got
175 1a21a6dd 2021-09-12 stsp send</code>, overriding corresponding settings in the containing
176 1a21a6dd 2021-09-12 stsp <code class="Ic">remote</code> <var class="Ar">name</var> {...} block.
177 1a21a6dd 2021-09-12 stsp <ul class="Bl-bullet">
178 1a21a6dd 2021-09-12 stsp <li id="server~3"><a class="permalink" href="#server~3"><code class="Ic">server</code></a>
179 1a21a6dd 2021-09-12 stsp <var class="Ar">hostname</var></li>
180 1a21a6dd 2021-09-12 stsp <li id="repository~3"><a class="permalink" href="#repository~3"><code class="Ic">repository</code></a>
181 1a21a6dd 2021-09-12 stsp <var class="Ar">path</var></li>
182 1a21a6dd 2021-09-12 stsp <li id="protocol~3"><a class="permalink" href="#protocol~3"><code class="Ic">protocol</code></a>
183 744ec008 2021-09-12 stsp <var class="Ar">scheme</var></li>
184 1a21a6dd 2021-09-12 stsp <li id="port~3"><a class="permalink" href="#port~3"><code class="Ic">port</code></a>
185 1a21a6dd 2021-09-12 stsp <var class="Ar">port</var></li>
186 1a21a6dd 2021-09-12 stsp <li id="branch~3"><a class="permalink" href="#branch~3"><code class="Ic">branch</code></a>
187 1a21a6dd 2021-09-12 stsp {<var class="Ar">branch ...</var>}</li>
188 1a21a6dd 2021-09-12 stsp </ul>
189 1a21a6dd 2021-09-12 stsp </dd>
190 1a21a6dd 2021-09-12 stsp </dl>
191 1a21a6dd 2021-09-12 stsp </dd>
192 1a21a6dd 2021-09-12 stsp </dl>
193 1a21a6dd 2021-09-12 stsp </section>
194 1a21a6dd 2021-09-12 stsp <section class="Sh">
195 1a21a6dd 2021-09-12 stsp <h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
196 1a21a6dd 2021-09-12 stsp <p class="Pp">Configure author information:</p>
197 1a21a6dd 2021-09-12 stsp <div class="Bd Pp Bd-indent Li">
198 1a21a6dd 2021-09-12 stsp <pre>author &quot;Flan Hacker &lt;flan_hacker@openbsd.org&gt;&quot;</pre>
199 1a21a6dd 2021-09-12 stsp </div>
200 1a21a6dd 2021-09-12 stsp <p class="Pp">Remote repository specification for the Game of Trees
201 1a21a6dd 2021-09-12 stsp repository:</p>
202 1a21a6dd 2021-09-12 stsp <div class="Bd Pp Bd-indent Li">
203 1a21a6dd 2021-09-12 stsp <pre>remote &quot;origin&quot; {
204 1a21a6dd 2021-09-12 stsp server git.gameoftrees.org
205 1a21a6dd 2021-09-12 stsp protocol git
206 1a21a6dd 2021-09-12 stsp repository got
207 1a21a6dd 2021-09-12 stsp branch { &quot;main&quot; }
208 1a21a6dd 2021-09-12 stsp }</pre>
209 1a21a6dd 2021-09-12 stsp </div>
210 1a21a6dd 2021-09-12 stsp <p class="Pp">Mirror the <span class="Ux">OpenBSD</span> src repository from
211 1a21a6dd 2021-09-12 stsp Github:</p>
212 1a21a6dd 2021-09-12 stsp <div class="Bd Pp Bd-indent Li">
213 1a21a6dd 2021-09-12 stsp <pre>remote &quot;origin&quot; {
214 1a21a6dd 2021-09-12 stsp repository &quot;openbsd/src&quot;
215 1a21a6dd 2021-09-12 stsp server git@github.com
216 1a21a6dd 2021-09-12 stsp protocol git+ssh
217 1a21a6dd 2021-09-12 stsp mirror-references yes
218 1a21a6dd 2021-09-12 stsp }</pre>
219 1a21a6dd 2021-09-12 stsp </div>
220 1a21a6dd 2021-09-12 stsp <p class="Pp">Fetch changes via the Git protocol and send changes via the SSH
221 1a21a6dd 2021-09-12 stsp protocol:</p>
222 1a21a6dd 2021-09-12 stsp <div class="Bd Pp Bd-indent Li">
223 1a21a6dd 2021-09-12 stsp <pre>remote &quot;origin&quot; {
224 1a21a6dd 2021-09-12 stsp repository my_repo
225 1a21a6dd 2021-09-12 stsp server git.example.com
226 1a21a6dd 2021-09-12 stsp protocol git
227 1a21a6dd 2021-09-12 stsp send {
228 1a21a6dd 2021-09-12 stsp server git@git.example.com
229 1a21a6dd 2021-09-12 stsp protocol ssh
230 1a21a6dd 2021-09-12 stsp }
231 1a21a6dd 2021-09-12 stsp }</pre>
232 1a21a6dd 2021-09-12 stsp </div>
233 1a21a6dd 2021-09-12 stsp </section>
234 1a21a6dd 2021-09-12 stsp <section class="Sh">
235 1a21a6dd 2021-09-12 stsp <h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
236 1a21a6dd 2021-09-12 stsp <dl class="Bl-tag Bl-compact">
237 1a21a6dd 2021-09-12 stsp <dt><span class="Pa">got.conf</span></dt>
238 1a21a6dd 2021-09-12 stsp <dd>If present, <code class="Nm">got.conf</code> located in the root directory
239 1a21a6dd 2021-09-12 stsp of a Git repository supersedes any relevant settings in Git's
240 1a21a6dd 2021-09-12 stsp <span class="Pa">config</span> file.
241 1a21a6dd 2021-09-12 stsp <p class="Pp"></p>
242 1a21a6dd 2021-09-12 stsp </dd>
243 1a21a6dd 2021-09-12 stsp <dt><span class="Pa">.got/got.conf</span></dt>
244 1a21a6dd 2021-09-12 stsp <dd>If present, <code class="Nm">got.conf</code> located in the
245 1a21a6dd 2021-09-12 stsp <span class="Pa">.got</span> meta-data directory of a
246 1a21a6dd 2021-09-12 stsp <a class="Xr">got(1)</a> work tree supersedes any relevant settings in the
247 1a21a6dd 2021-09-12 stsp repository's <code class="Nm">got.conf</code> configuration file and Git's
248 1a21a6dd 2021-09-12 stsp <span class="Pa">config</span> file.</dd>
249 1a21a6dd 2021-09-12 stsp </dl>
250 1a21a6dd 2021-09-12 stsp </section>
251 1a21a6dd 2021-09-12 stsp <section class="Sh">
252 1a21a6dd 2021-09-12 stsp <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
253 1a21a6dd 2021-09-12 stsp ALSO</a></h1>
254 1a21a6dd 2021-09-12 stsp <p class="Pp"><a class="Xr">got(1)</a>, <a class="Xr">git-repository(5)</a>,
255 1a21a6dd 2021-09-12 stsp <a class="Xr">got-worktree(5)</a></p>
256 1a21a6dd 2021-09-12 stsp </section>
257 1a21a6dd 2021-09-12 stsp <section class="Sh">
258 1a21a6dd 2021-09-12 stsp <h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
259 1a21a6dd 2021-09-12 stsp <p class="Pp"><code class="Nm">got.conf</code> offers no way to configure the
260 1a21a6dd 2021-09-12 stsp editor spawned by <code class="Cm">got commit</code>, <code class="Cm">got
261 1a21a6dd 2021-09-12 stsp histedit</code>, <code class="Cm">got import</code>, or <code class="Cm">got
262 1a21a6dd 2021-09-12 stsp tag</code>. This is deliberate and prevents potential arbitrary command
263 1a21a6dd 2021-09-12 stsp execution as another user when repositories or work trees are shared between
264 1a21a6dd 2021-09-12 stsp users. Users should set their <code class="Ev">VISUAL</code> or
265 1a21a6dd 2021-09-12 stsp <code class="Ev">EDITOR</code> environment variables instead.</p>
266 1a21a6dd 2021-09-12 stsp </section>
267 1a21a6dd 2021-09-12 stsp </div>
268 1a21a6dd 2021-09-12 stsp <table class="foot">
269 1a21a6dd 2021-09-12 stsp <tr>
270 46043f6f 2021-11-23 stsp <td class="foot-date">November 23, 2021</td>
271 1a21a6dd 2021-09-12 stsp <td class="foot-os">OpenBSD 7.0</td>
272 1a21a6dd 2021-09-12 stsp </tr>
273 1a21a6dd 2021-09-12 stsp </table>
274 1a21a6dd 2021-09-12 stsp </body>
275 1a21a6dd 2021-09-12 stsp </html>