1 257add31 2020-09-09 stsp .\"
  2 257add31 2020-09-09 stsp .\" Copyright (c) 2020 Stefan Sperling <stsp@openbsd.org>
  3 257add31 2020-09-09 stsp .\"
  4 257add31 2020-09-09 stsp .\" Permission to use, copy, modify, and distribute this software for any
  5 257add31 2020-09-09 stsp .\" purpose with or without fee is hereby granted, provided that the above
  6 257add31 2020-09-09 stsp .\" copyright notice and this permission notice appear in all copies.
  7 257add31 2020-09-09 stsp .\"
  8 257add31 2020-09-09 stsp .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  9 257add31 2020-09-09 stsp .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 10 257add31 2020-09-09 stsp .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 11 257add31 2020-09-09 stsp .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 12 257add31 2020-09-09 stsp .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 13 257add31 2020-09-09 stsp .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 14 257add31 2020-09-09 stsp .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 15 257add31 2020-09-09 stsp .\"
 16 257add31 2020-09-09 stsp .Dd $Mdocdate$
 17 257add31 2020-09-09 stsp .Dt GOT.CONF 5
 18 257add31 2020-09-09 stsp .Os
 19 257add31 2020-09-09 stsp .Sh NAME
 20 257add31 2020-09-09 stsp .Nm got.conf
 21 257add31 2020-09-09 stsp .Nd Game of Trees configuration file
 22 257add31 2020-09-09 stsp .Sh DESCRIPTION
 23 257add31 2020-09-09 stsp .Nm
 24 257add31 2020-09-09 stsp is the run-time configuration file for
 25 257add31 2020-09-09 stsp .Xr got 1 .
 26 257add31 2020-09-09 stsp .Pp
 27 50b0790e 2020-09-11 stsp .Nm
 28 50b0790e 2020-09-11 stsp may be present in the root directory of a Git repository for
 29 50b0790e 2020-09-11 stsp repository-wide settings, or in the
 30 50b0790e 2020-09-11 stsp .Pa .got
 31 50b0790e 2020-09-11 stsp meta-data directory of a work tree to override repository-wide
 32 50b0790e 2020-09-11 stsp settings for
 33 50b0790e 2020-09-11 stsp .Xr got 1
 34 50b0790e 2020-09-11 stsp commands executed within this work tree.
 35 50b0790e 2020-09-11 stsp .Pp
 36 257add31 2020-09-09 stsp The file format is line-based, with one configuration directive per line.
 37 257add31 2020-09-09 stsp Any lines beginning with a
 38 257add31 2020-09-09 stsp .Sq #
 39 257add31 2020-09-09 stsp are treated as comments and ignored.
 40 257add31 2020-09-09 stsp .Pp
 41 257add31 2020-09-09 stsp The available configuration directives are as follows:
 42 257add31 2020-09-09 stsp .Bl -tag -width Ds
 43 257add31 2020-09-09 stsp .It Ic author Dq Real Name <email address>
 44 257add31 2020-09-09 stsp Configure the author's name and email address for
 45 257add31 2020-09-09 stsp .Cm got commit
 46 257add31 2020-09-09 stsp and
 47 257add31 2020-09-09 stsp .Cm got import
 48 257add31 2020-09-09 stsp when operating on this repository.
 49 257add31 2020-09-09 stsp Author information specified here overrides the
 50 257add31 2020-09-09 stsp .Ev GOT_AUTHOR
 51 257add31 2020-09-09 stsp environment variable.
 52 257add31 2020-09-09 stsp .Pp
 53 257add31 2020-09-09 stsp Because
 54 257add31 2020-09-09 stsp .Xr git 1
 55 257add31 2020-09-09 stsp may fail to parse commits without an email address in author data,
 56 257add31 2020-09-09 stsp .Xr got 1
 57 257add31 2020-09-09 stsp attempts to reject author information with a missing email address.
 58 ff5e1f09 2022-07-06 thomas .It Ic signer_id Pa signer-id
 59 ff5e1f09 2022-07-06 thomas Configure a
 60 ff5e1f09 2022-07-06 thomas .Ar signer-id
 61 ff5e1f09 2022-07-06 thomas to sign tag objects.
 62 ff5e1f09 2022-07-06 thomas This key will be used to sign all tag objects unless overridden by
 63 ff5e1f09 2022-07-06 thomas .Cm got tag Fl s Ar signer-id .
 64 ff5e1f09 2022-07-06 thomas .Pp
 65 ff5e1f09 2022-07-06 thomas For SSH-based signatures,
 66 ff5e1f09 2022-07-06 thomas .Ar signer-id
 67 ff5e1f09 2022-07-06 thomas is the path to a file which may refer to either a private SSH key,
 68 ff5e1f09 2022-07-06 thomas or a public SSH key with the private half available via
 69 ff5e1f09 2022-07-06 thomas .Xr ssh-agent 1 .
 70 839dd04f 2022-07-04 thomas .It Ic allowed_signers Pa path
 71 839dd04f 2022-07-04 thomas Configure a
 72 839dd04f 2022-07-04 thomas .Ar path
 73 839dd04f 2022-07-04 thomas to the "allowed signers" file which contains a list of trusted
 74 839dd04f 2022-07-04 thomas SSH signer identities.
 75 839dd04f 2022-07-04 thomas The file will be passed to
 76 839dd04f 2022-07-04 thomas .Xr ssh-keygen 1
 77 839dd04f 2022-07-04 thomas during verification of SSH-based signatures with
 78 839dd04f 2022-07-04 thomas .Cm got tag Fl V .
 79 839dd04f 2022-07-04 thomas The format of the "allowed signers" file is documented in the
 80 839dd04f 2022-07-04 thomas ALLOWED SIGNERS section of
 81 839dd04f 2022-07-04 thomas .Xr ssh-keygen 1 .
 82 839dd04f 2022-07-04 thomas .Pp
 83 839dd04f 2022-07-04 thomas Verification of SSH-based signatures is impossible unless the
 84 839dd04f 2022-07-04 thomas .Ic allowed_signers
 85 839dd04f 2022-07-04 thomas option is set in
 86 839dd04f 2022-07-04 thomas .Nm .
 87 839dd04f 2022-07-04 thomas .It Ic revoked_signers Pa path
 88 839dd04f 2022-07-04 thomas Configure a
 89 839dd04f 2022-07-04 thomas .Ar path
 90 839dd04f 2022-07-04 thomas to the optional "revoked signers" file, which contains a list of revoked
 91 839dd04f 2022-07-04 thomas SSH signer identities.
 92 839dd04f 2022-07-04 thomas This file is passed to
 93 839dd04f 2022-07-04 thomas .Xr ssh-keygen 1
 94 839dd04f 2022-07-04 thomas during signature verification with
 95 839dd04f 2022-07-04 thomas .Cm got tag Fl V .
 96 839dd04f 2022-07-04 thomas Revoked identities are no longer considered trustworthy and verification
 97 839dd04f 2022-07-04 thomas of relevant signatures will fail.
 98 257add31 2020-09-09 stsp .It Ic remote Ar name Brq ...
 99 257add31 2020-09-09 stsp Define a remote repository.
100 257add31 2020-09-09 stsp The specified
101 257add31 2020-09-09 stsp .Ar name
102 257add31 2020-09-09 stsp can be used to refer to the remote repository on the command line of
103 6480c871 2021-08-30 stsp .Cm got fetch
104 6480c871 2021-08-30 stsp and
105 6480c871 2021-08-30 stsp .Cm got send .
106 257add31 2020-09-09 stsp .Pp
107 6ca25bfc 2022-10-27 thomas When repositories are shared between multiple users on the system, it is
108 6ca25bfc 2022-10-27 thomas recommended that users configure their trusted remote repositories in each
109 6ca25bfc 2022-10-27 thomas of their work-trees'
110 6ca25bfc 2022-10-27 thomas .Nm
111 6ca25bfc 2022-10-27 thomas files, overriding corresponding repository-wide settings.
112 6ca25bfc 2022-10-27 thomas This can avoid potentially undesirable connections to remote repositories
113 6ca25bfc 2022-10-27 thomas placed into the shared repository's
114 6ca25bfc 2022-10-27 thomas .Nm
115 6ca25bfc 2022-10-27 thomas file by other users.
116 6ca25bfc 2022-10-27 thomas .Pp
117 6ca25bfc 2022-10-27 thomas Information about a repository is declared in a block of options
118 257add31 2020-09-09 stsp enclosed in curly brackets:
119 257add31 2020-09-09 stsp .Bl -tag -width Ds
120 257add31 2020-09-09 stsp .It Ic server Ar hostname
121 257add31 2020-09-09 stsp Defines the hostname to use for contacting the remote repository's server.
122 257add31 2020-09-09 stsp .It Ic repository Ar path
123 257add31 2020-09-09 stsp Defines the path to the repository on the remote repository's server.
124 257add31 2020-09-09 stsp .It Ic protocol Ar scheme
125 257add31 2020-09-09 stsp Defines the protocol to use for communicating with the remote repository's
126 257add31 2020-09-09 stsp server.
127 257add31 2020-09-09 stsp .Pp
128 257add31 2020-09-09 stsp The following protocol schemes are supported:
129 a2dbf179 2024-04-29 thomas .Bl -tag -width https
130 257add31 2020-09-09 stsp .It git
131 257add31 2020-09-09 stsp The Git protocol as implemented by the
132 257add31 2020-09-09 stsp .Xr git-daemon 1
133 257add31 2020-09-09 stsp server.
134 257add31 2020-09-09 stsp Use of this protocol is discouraged since it supports neither authentication
135 257add31 2020-09-09 stsp nor encryption.
136 2671aa26 2024-04-29 thomas .It ssh
137 257add31 2020-09-09 stsp The Git protocol wrapped in an authenticated and encrypted
138 257add31 2020-09-09 stsp .Xr ssh 1
139 257add31 2020-09-09 stsp tunnel.
140 257add31 2020-09-09 stsp With this protocol the hostname may contain an embedded username for
141 257add31 2020-09-09 stsp .Xr ssh 1
142 257add31 2020-09-09 stsp to use:
143 257add31 2020-09-09 stsp .Mt user@hostname
144 a2dbf179 2024-04-29 thomas .It http
145 a2dbf179 2024-04-29 thomas The
146 a2dbf179 2024-04-29 thomas .Dq smart
147 a2dbf179 2024-04-29 thomas Git HTTP protocol.
148 a2dbf179 2024-04-29 thomas Not compatible with servers using the
149 a2dbf179 2024-04-29 thomas .Dq dumb
150 a2dbf179 2024-04-29 thomas Git HTTP protocol.
151 a2dbf179 2024-04-29 thomas .Pp
152 a2dbf179 2024-04-29 thomas The
153 a2dbf179 2024-04-29 thomas .Dq smart
154 a2dbf179 2024-04-29 thomas Git HTTP protocol is supported by
155 a2dbf179 2024-04-29 thomas .Cm got clone
156 a2dbf179 2024-04-29 thomas and
157 a2dbf179 2024-04-29 thomas .Cm got fetch ,
158 a2dbf179 2024-04-29 thomas but not by
159 a2dbf179 2024-04-29 thomas .Cm got send .
160 a2dbf179 2024-04-29 thomas To send from a repository cloned over HTTP, add a
161 a2dbf179 2024-04-29 thomas .Ic send
162 a2dbf179 2024-04-29 thomas block (see below) to ensure that the
163 a2dbf179 2024-04-29 thomas .Dq ssh://
164 a2dbf179 2024-04-29 thomas protocol will be used by
165 a2dbf179 2024-04-29 thomas .Cm got send .
166 a2dbf179 2024-04-29 thomas .Pp
167 a2dbf179 2024-04-29 thomas Use of this protocol is discouraged since it supports neither authentication
168 a2dbf179 2024-04-29 thomas nor encryption.
169 a2dbf179 2024-04-29 thomas .It https
170 a2dbf179 2024-04-29 thomas The
171 a2dbf179 2024-04-29 thomas .Dq smart
172 a2dbf179 2024-04-29 thomas Git HTTP protocol wrapped in SSL/TLS.
173 257add31 2020-09-09 stsp .El
174 257add31 2020-09-09 stsp .It Ic port Ar port
175 257add31 2020-09-09 stsp Defines the port to use for connecting to the remote repository's server.
176 257add31 2020-09-09 stsp The
177 257add31 2020-09-09 stsp .Ar port
178 257add31 2020-09-09 stsp can be specified by number or name.
179 257add31 2020-09-09 stsp The port name to number mappings are found in the file
180 257add31 2020-09-09 stsp .Pa /etc/services ;
181 257add31 2020-09-09 stsp see
182 257add31 2020-09-09 stsp .Xr services 5
183 257add31 2020-09-09 stsp for details.
184 257add31 2020-09-09 stsp If not specified, the default port of the specified
185 257add31 2020-09-09 stsp .Cm protocol
186 257add31 2020-09-09 stsp will be used.
187 b8adfa55 2020-09-25 stsp .It Ic branch Brq Ar branch ...
188 b8adfa55 2020-09-25 stsp Specify one or more branches which
189 b8adfa55 2020-09-25 stsp .Cm got fetch
190 6480c871 2021-08-30 stsp and
191 6480c871 2021-08-30 stsp .Cm got send
192 93f8a337 2021-08-30 naddy should fetch from and send to the remote repository by default.
193 b8adfa55 2020-09-25 stsp The list of branches specified here can be overridden at the
194 b8adfa55 2020-09-25 stsp .Cm got fetch
195 6480c871 2021-08-30 stsp and
196 6480c871 2021-08-30 stsp .Cm got send
197 6480c871 2021-08-30 stsp command lines with the
198 b8adfa55 2020-09-25 stsp .Fl b
199 b8adfa55 2020-09-25 stsp option.
200 25eb5847 2022-07-03 thomas .It Ic fetch_all_branches Ar yes | no
201 0c8b29c5 2021-01-05 stsp This option controls whether
202 0c8b29c5 2021-01-05 stsp .Cm got fetch
203 0c8b29c5 2021-01-05 stsp will fetch all branches from the remote repository by default.
204 0c8b29c5 2021-01-05 stsp If enabled, this behaviour can be overridden at the
205 0c8b29c5 2021-01-05 stsp .Cm got fetch
206 0c8b29c5 2021-01-05 stsp command line with the
207 0c8b29c5 2021-01-05 stsp .Fl b
208 0c8b29c5 2021-01-05 stsp option, and any
209 0c8b29c5 2021-01-05 stsp .Cm branch
210 0c8b29c5 2021-01-05 stsp configuration settings for this remote repository will be ignored.
211 99495ddb 2021-01-10 stsp .It Ic reference Brq Ar reference ...
212 99495ddb 2021-01-10 stsp Specify one or more arbitrary references which
213 99495ddb 2021-01-10 stsp .Cm got fetch
214 99495ddb 2021-01-10 stsp should fetch by default, in addition to the branches and tags that will
215 99495ddb 2021-01-10 stsp be fetched.
216 99495ddb 2021-01-10 stsp The list of references specified here can be overridden at the
217 99495ddb 2021-01-10 stsp .Cm got fetch
218 99495ddb 2021-01-10 stsp command line with the
219 99495ddb 2021-01-10 stsp .Fl R
220 99495ddb 2021-01-10 stsp option.
221 99495ddb 2021-01-10 stsp .Cm got fetch
222 99495ddb 2021-01-10 stsp will refuse to fetch references from the remote repository's
223 99495ddb 2021-01-10 stsp .Dq refs/remotes/
224 99495ddb 2021-01-10 stsp or
225 99495ddb 2021-01-10 stsp .Dq refs/got/
226 99495ddb 2021-01-10 stsp namespace.
227 99495ddb 2021-01-10 stsp In any case, references in the
228 99495ddb 2021-01-10 stsp .Dq refs/tags/
229 99495ddb 2021-01-10 stsp namespace will always be fetched and mapped directly to local references
230 99495ddb 2021-01-10 stsp in the same namespace.
231 459c9b5d 2022-07-03 thomas .It Ic mirror_references Ar yes | no
232 257add31 2020-09-09 stsp This option controls the behaviour of
233 257add31 2020-09-09 stsp .Cm got fetch
234 257add31 2020-09-09 stsp when updating references.
235 257add31 2020-09-09 stsp .Sy Enabling this option can lead to the loss of local commits.
236 257add31 2020-09-09 stsp Maintaining custom changes in a mirror repository is therefore discouraged.
237 257add31 2020-09-09 stsp .Pp
238 257add31 2020-09-09 stsp If this option is not specified or set to
239 257add31 2020-09-09 stsp .Ar no ,
240 257add31 2020-09-09 stsp .Cm got fetch
241 257add31 2020-09-09 stsp will map references of the remote repository into the local repository's
242 257add31 2020-09-09 stsp .Dq refs/remotes/
243 257add31 2020-09-09 stsp namespace.
244 257add31 2020-09-09 stsp .Pp
245 257add31 2020-09-09 stsp If this option is set to
246 257add31 2020-09-09 stsp .Ar yes ,
247 257add31 2020-09-09 stsp all branches in the
248 257add31 2020-09-09 stsp .Dq refs/heads/
249 257add31 2020-09-09 stsp namespace will be updated directly to match the corresponding branches in
250 257add31 2020-09-09 stsp the remote repository.
251 6480c871 2021-08-30 stsp .It Ic fetch Brq ...
252 6480c871 2021-08-30 stsp An optional
253 6480c871 2021-08-30 stsp .Ic fetch
254 6480c871 2021-08-30 stsp block may contain any of the following configuration settings
255 6480c871 2021-08-30 stsp for use by
256 6480c871 2021-08-30 stsp .Cm got fetch ,
257 6480c871 2021-08-30 stsp overriding corresponding settings in the containing
258 6480c871 2021-08-30 stsp .Ic remote Ar name Brq ...
259 6480c871 2021-08-30 stsp block.
260 6480c871 2021-08-30 stsp .Bl -bullet
261 6480c871 2021-08-30 stsp .It
262 6480c871 2021-08-30 stsp .Ic server Ar hostname
263 6480c871 2021-08-30 stsp .It
264 6480c871 2021-08-30 stsp .Ic repository Ar path
265 6480c871 2021-08-30 stsp .It
266 824d5f77 2021-09-12 stsp .Ic protocol Ar scheme
267 6480c871 2021-08-30 stsp .It
268 6480c871 2021-08-30 stsp .Ic port Ar port
269 6480c871 2021-08-30 stsp .It
270 6480c871 2021-08-30 stsp .Ic branch Brq Ar branch ...
271 257add31 2020-09-09 stsp .El
272 6480c871 2021-08-30 stsp .It Ic send Brq ...
273 6480c871 2021-08-30 stsp An optional
274 6480c871 2021-08-30 stsp .Ic send
275 6480c871 2021-08-30 stsp block may contain any of the following configuration settings
276 6480c871 2021-08-30 stsp for use by
277 6480c871 2021-08-30 stsp .Cm got send ,
278 6480c871 2021-08-30 stsp overriding corresponding settings in the containing
279 6480c871 2021-08-30 stsp .Ic remote Ar name Brq ...
280 6480c871 2021-08-30 stsp block.
281 6480c871 2021-08-30 stsp .Bl -bullet
282 6480c871 2021-08-30 stsp .It
283 6480c871 2021-08-30 stsp .Ic server Ar hostname
284 6480c871 2021-08-30 stsp .It
285 6480c871 2021-08-30 stsp .Ic repository Ar path
286 6480c871 2021-08-30 stsp .It
287 824d5f77 2021-09-12 stsp .Ic protocol Ar scheme
288 6480c871 2021-08-30 stsp .It
289 6480c871 2021-08-30 stsp .Ic port Ar port
290 6480c871 2021-08-30 stsp .It
291 6480c871 2021-08-30 stsp .Ic branch Brq Ar branch ...
292 634fd2c7 2022-11-17 thomas .El
293 1795b260 2021-04-02 kn .El
294 6480c871 2021-08-30 stsp .El
295 634fd2c7 2022-11-17 thomas .Sh FILES
296 634fd2c7 2022-11-17 thomas .Bl -tag -width Ds -compact
297 634fd2c7 2022-11-17 thomas .It Pa got.conf
298 634fd2c7 2022-11-17 thomas If present,
299 634fd2c7 2022-11-17 thomas .Nm
300 634fd2c7 2022-11-17 thomas located in the root directory of a Git repository supersedes any relevant
301 634fd2c7 2022-11-17 thomas settings in Git's
302 634fd2c7 2022-11-17 thomas .Pa config
303 634fd2c7 2022-11-17 thomas file.
304 634fd2c7 2022-11-17 thomas .Pp
305 634fd2c7 2022-11-17 thomas .It Pa .got/got.conf
306 634fd2c7 2022-11-17 thomas If present,
307 634fd2c7 2022-11-17 thomas .Nm
308 634fd2c7 2022-11-17 thomas located in the
309 634fd2c7 2022-11-17 thomas .Pa .got
310 634fd2c7 2022-11-17 thomas meta-data directory of a
311 634fd2c7 2022-11-17 thomas .Xr got 1
312 634fd2c7 2022-11-17 thomas work tree supersedes any relevant settings in the repository's
313 634fd2c7 2022-11-17 thomas .Nm
314 634fd2c7 2022-11-17 thomas configuration file and Git's
315 634fd2c7 2022-11-17 thomas .Pa config
316 634fd2c7 2022-11-17 thomas file.
317 6480c871 2021-08-30 stsp .El
318 257add31 2020-09-09 stsp .Sh EXAMPLES
319 257add31 2020-09-09 stsp Configure author information:
320 257add31 2020-09-09 stsp .Bd -literal -offset indent
321 257add31 2020-09-09 stsp author "Flan Hacker <flan_hacker@openbsd.org>"
322 257add31 2020-09-09 stsp .Ed
323 257add31 2020-09-09 stsp .Pp
324 257add31 2020-09-09 stsp Remote repository specification for the Game of Trees repository:
325 257add31 2020-09-09 stsp .Bd -literal -offset indent
326 257add31 2020-09-09 stsp remote "origin" {
327 38fb09f6 2024-04-29 thomas 	server anonymous@got.gameoftrees.org
328 38fb09f6 2024-04-29 thomas 	protocol ssh
329 257add31 2020-09-09 stsp 	repository got
330 b8adfa55 2020-09-25 stsp 	branch { "main" }
331 257add31 2020-09-09 stsp }
332 257add31 2020-09-09 stsp .Ed
333 257add31 2020-09-09 stsp .Pp
334 1795b260 2021-04-02 kn Mirror the
335 1795b260 2021-04-02 kn .Ox
336 1795b260 2021-04-02 kn src repository from Github:
337 257add31 2020-09-09 stsp .Bd -literal -offset indent
338 257add31 2020-09-09 stsp remote "origin" {
339 257add31 2020-09-09 stsp 	repository "openbsd/src"
340 257add31 2020-09-09 stsp 	server git@github.com
341 257add31 2020-09-09 stsp 	protocol git+ssh
342 459c9b5d 2022-07-03 thomas 	mirror_references yes
343 257add31 2020-09-09 stsp }
344 257add31 2020-09-09 stsp .Ed
345 6480c871 2021-08-30 stsp .Pp
346 6480c871 2021-08-30 stsp Fetch changes via the Git protocol and send changes via the SSH protocol:
347 6480c871 2021-08-30 stsp .Bd -literal -offset indent
348 6480c871 2021-08-30 stsp remote "origin" {
349 6480c871 2021-08-30 stsp 	repository my_repo
350 6480c871 2021-08-30 stsp 	server git.example.com
351 6480c871 2021-08-30 stsp 	protocol git
352 6480c871 2021-08-30 stsp 	send {
353 6480c871 2021-08-30 stsp 		server git@git.example.com
354 6480c871 2021-08-30 stsp 		protocol ssh
355 6480c871 2021-08-30 stsp 	}
356 6480c871 2021-08-30 stsp }
357 6480c871 2021-08-30 stsp .Ed
358 257add31 2020-09-09 stsp .Sh SEE ALSO
359 257add31 2020-09-09 stsp .Xr got 1 ,
360 42536c09 2020-09-11 stsp .Xr git-repository 5 ,
361 50b0790e 2020-09-11 stsp .Xr got-worktree 5
362 53643ae1 2020-09-14 stsp .Sh CAVEATS
363 53643ae1 2020-09-14 stsp .Nm
364 53643ae1 2020-09-14 stsp offers no way to configure the editor spawned by
365 53643ae1 2020-09-14 stsp .Cm got commit ,
366 53643ae1 2020-09-14 stsp .Cm got histedit ,
367 53643ae1 2020-09-14 stsp .Cm got import ,
368 53643ae1 2020-09-14 stsp or
369 53643ae1 2020-09-14 stsp .Cm got tag .
370 53643ae1 2020-09-14 stsp This is deliberate and prevents potential arbitrary command execution
371 53643ae1 2020-09-14 stsp as another user when repositories or work trees are shared between users.
372 53643ae1 2020-09-14 stsp Users should set their
373 53643ae1 2020-09-14 stsp .Ev VISUAL
374 53643ae1 2020-09-14 stsp or
375 53643ae1 2020-09-14 stsp .Ev EDITOR
376 53643ae1 2020-09-14 stsp environment variables instead.