Game of Trees Repos

Commit Diff

Commit:: 742bb3a1b2e5b453a0342a433901b60612f437e7
From:: Stefan Sperling <stsp@stsp.name>
Date:: Mon Oct 24 11:40:25 2022 UTC
Message:: sync man pages
Actions:: Patch | Tree
commit - 5645e45bcc7b9a292dd452824a35998c9c491416
commit + 742bb3a1b2e5b453a0342a433901b60612f437e7
blob - 56b1efeb971dca525b28221251e42d0078122904
blob + d91ebfd5bd4d5d4512a9eff154b04bd2584fc316
--- git-repository.5.html
+++ git-repository.5.html
@@ -214,7 +214,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - 9189e91d7ced813a006b6a6f498c9e762f7c74cd
blob + a81a11860d20a76ada8040cf8dcad11edc0e63e5
--- got-worktree.5.html
+++ got-worktree.5.html
@@ -186,7 +186,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - 07a25be5ddff9ebe5678b18787d232c89a3e3dd9
blob + a45272356912027e21c5c7eee7a6b27c1f6a39a0
--- got.1.html
+++ got.1.html
@@ -37,7 +37,7 @@
 <table class="Nm">
   <tr>
     <td><code class="Nm">got</code></td>
-    <td><var class="Ar">command</var> [<code class="Fl">-h</code>]
+    <td>[<code class="Fl">-hV</code>] <var class="Ar">command</var>
       [<var class="Ar">arg ...</var>]</td>
   </tr>
 </table>
@@ -3034,7 +3034,7 @@ remote &quot;origin&quot; {
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - a8a399a83515b6f498ce9b231cf8c8cfd7ae326f
blob + fda77f6007360b525e2f6df0cf30c2d7160aa66b
--- got.conf.5.html
+++ got.conf.5.html
@@ -299,7 +299,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - ca04cf76c4d3dbf6cfde3bb456642b4fc04e9f3f
blob + ddd223dd8504bc6e9889ad018bc138c27458063d
--- gotadmin.1.html
+++ gotadmin.1.html
@@ -38,7 +38,7 @@
 <table class="Nm">
   <tr>
     <td><code class="Nm">gotadmin</code></td>
-    <td><var class="Ar">command</var> [<code class="Fl">-h</code>]
+    <td>[<code class="Fl">-hV</code>] <var class="Ar">command</var>
       [<var class="Ar">arg ...</var>]</td>
   </tr>
 </table>
@@ -344,7 +344,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - ce553cbdf66c9c27aaa6aa46b4e1e329dd06767a
blob + e7a676923f54c35afd7a8a1ad2cda8d0a3494e08
--- gotweb.8.html
+++ gotweb.8.html
@@ -162,7 +162,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - /dev/null
blob + c3382c4d18318d9d11c431d7659dc27c45cc9c36 (mode 644)
--- /dev/null
+++ gotd.8.html
@@ -0,0 +1,99 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
+  <title>GOTD(8)</title>
+</head>
+<!-- This is an automatically generated file.  Do not edit.
+   Copyright (c) 2022 Stefan Sperling
+  
+   Permission to use, copy, modify, and distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+  
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+   -->
+<body>
+<div class="head" role="doc-pageheader" aria-label="Manual header
+  line"><span class="head-ltitle">GOTD(8)</span> <span class="head-vol">System
+  Manager's Manual</span> <span class="head-rtitle">GOTD(8)</span></div>
+<main class="manual-text">
+<section class="Sh">
+<h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
+<p class="Pp"><code class="Nm">gotd</code> &#x2014;
+    <span class="Nd" role="doc-subtitle">Game of Trees Daemon</span></p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h2>
+<table class="Nm">
+  <tr>
+    <td><code class="Nm">gotd</code></td>
+    <td>[<code class="Fl">-dv</code>] [<code class="Fl">-f</code>
+      <var class="Ar">config-file</var>]</td>
+  </tr>
+</table>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
+<p class="Pp"><code class="Nm">gotd</code> is a Git repository server which
+    listens on a <a class="Xr" aria-label="unix, section 4">unix(4)</a> socket
+    and relies on its companion tool <a class="Xr" aria-label="gotsh, section
+    1">gotsh(1)</a> to handle Git-protocol communication over the network, via
+    <a class="Xr" aria-label="ssh, section 1">ssh(1)</a>.</p>
+<p class="Pp">The Git repository format is described in
+    <a class="Xr" aria-label="git-repository, section
+  5">git-repository(5)</a>.</p>
+<p class="Pp"><code class="Nm">gotd</code> requires a configuration file in
+    order to run. The configuration file format is described in
+    <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>.</p>
+<p class="Pp">The options for <code class="Nm">gotd</code> are as follows:</p>
+<dl class="Bl-tag">
+  <dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt>
+  <dd>Do not daemonize and log to stderr.</dd>
+  <dt id="f"><a class="permalink" href="#f"><code class="Fl">-f</code></a>
+    <var class="Ar">config-file</var></dt>
+  <dd>Set the path to the configuration file. If not specified, the file
+      <span class="Pa">/etc/gotd.conf</span> will be used.</dd>
+  <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a></dt>
+  <dd>Verbose mode. Verbosity increases if this option is used multiple
+    times.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
+<dl class="Bl-tag Bl-compact">
+  <dt><span class="Pa">/etc/gotd.conf</span></dt>
+  <dd>Default location of the configuration file.</dd>
+  <dt><span class="Pa">/var/run/gotd.sock</span></dt>
+  <dd>Default location of the unix socket which <code class="Nm">gotd</code> is
+      listening on. This path can be configured in
+      <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+  ALSO</a></h2>
+<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
+    <a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>,
+    <a class="Xr" aria-label="git-repository, section 5">git-repository(5)</a>,
+    <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a></p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
+<p class="Pp"><span class="An">Stefan Sperling</span>
+    &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;</p>
+</section>
+</main>
+<div class="foot" role="doc-pagefooter" aria-label="Manual footer
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
+  2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+</body>
+</html>
blob - 78646d73ecb4d4c1fd8b13ceba8184e12c317255
blob + 9088a211458d7c10b9789a65e03cc905f7be42d5
--- gotweb.conf.5.html
+++ gotweb.conf.5.html
@@ -162,7 +162,7 @@ got_logo_url			&quot;https://gameoftrees.org&quot;
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - /dev/null
blob + 1775937c2e358e0212f7599cfacaa3cd85d6ec81 (mode 644)
--- /dev/null
+++ gotd.conf.5.html
@@ -0,0 +1,139 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
+  <title>GOTD.CONF(5)</title>
+</head>
+<!-- This is an automatically generated file.  Do not edit.
+   Copyright (c) 2022 Stefan Sperling <stsp@openbsd.org>
+  
+   Permission to use, copy, modify, and distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+  
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+   -->
+<body>
+<div class="head" role="doc-pageheader" aria-label="Manual header
+  line"><span class="head-ltitle">GOTD.CONF(5)</span>
+  <span class="head-vol">File Formats Manual</span>
+  <span class="head-rtitle">GOTD.CONF(5)</span></div>
+<main class="manual-text">
+<section class="Sh">
+<h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
+<p class="Pp"><code class="Nm">gotd.conf</code> &#x2014;
+    <span class="Nd" role="doc-subtitle">gotd configuration file</span></p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
+<p class="Pp"><code class="Nm">gotd.conf</code> is the run-time configuration
+    file for <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>.</p>
+<p class="Pp">The file format is line-based, with one configuration directive
+    per line. Any lines beginning with a &#x2018;#&#x2019; are treated as
+    comments and ignored.</p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="GLOBAL_CONFIGURATION"><a class="permalink" href="#GLOBAL_CONFIGURATION">GLOBAL
+  CONFIGURATION</a></h2>
+<p class="Pp">The available global configuration directives are as follows:</p>
+<dl class="Bl-tag">
+  <dt id="unix_socket"><a class="permalink" href="#unix_socket"><code class="Ic">unix_socket</code></a>
+    <var class="Ar">path</var></dt>
+  <dd>Set the path to the unix socket which <a class="Xr" aria-label="gotd,
+      section 8">gotd(8)</a> should listen on. If not specified, the path
+      <span class="Pa">/var/run/gotd.sock</span> will be used.</dd>
+  <dt id="unix_group"><a class="permalink" href="#unix_group"><code class="Ic">unix_group</code></a>
+    <var class="Ar">group</var></dt>
+  <dd>Set the <var class="Ar">group</var>, defined in the
+      <a class="Xr" aria-label="group, section 5">group(5)</a> file, which is
+      allowed to access <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>
+      via <a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>. The
+      <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> user must be a
+      secondary member of this group. If not specified, the group _gotsh will be
+      used.</dd>
+  <dt id="user"><a class="permalink" href="#user"><code class="Ic">user</code></a>
+    <var class="Ar">user</var></dt>
+  <dd>Set the <var class="Ar">user</var> which will run
+      <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>. Initially,
+      <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> requires root
+      privileges in order to create its unix socket and start child processes in
+      a <a class="Xr" aria-label="chroot, section 2">chroot(2)</a> environment.
+      Afterwards, <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> drops
+      privileges to the specified <var class="Ar">user</var>. If not specified,
+      the user _gotd will be used.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="REPOSITORY_CONFIGURATION"><a class="permalink" href="#REPOSITORY_CONFIGURATION">REPOSITORY
+  CONFIGURATION</a></h2>
+<p class="Pp">At least one repository context must exist for
+    <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> to function.</p>
+<p class="Pp">A repository context is declared with a unique
+    <var class="Ar">name</var>, followed by repository-specific configuration
+    directives inside curly braces:</p>
+<p class="Pp"><code class="Ic">repository</code> <var class="Ar">name</var>
+    {...}</p>
+<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a> and
+    <a class="Xr" aria-label="git, section 1">git(1)</a> clients can connect to
+    a repository by including the repository's unique <var class="Ar">name</var>
+    in the request URL. Clients appending the string &#x201C;.git&#x201D; to the
+    <var class="Ar">name</var> will also be accepted.</p>
+<p class="Pp">If desired, the <var class="Ar">name</var> may contain
+    path-separators, &#x201C;/&#x201D;, to expose repositories as part of a
+    virtual client-visible directory hierarchy.</p>
+<p class="Pp">The available repository configuration directives are as
+  follows:</p>
+<dl class="Bl-tag">
+  <dt id="path"><a class="permalink" href="#path"><code class="Ic">path</code></a>
+    <var class="Ar">path</var></dt>
+  <dd>Set the path to the Git repository.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
+<dl class="Bl-tag Bl-compact">
+  <dt><span class="Pa">/etc/gotd.conf</span></dt>
+  <dd>Location of the <code class="Nm">gotd.conf</code> configuration file.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
+<div class="Bd Bd-indent Li">
+<pre># Default unix_group and user values:
+unix_group _gotsh
+user _gotd
+
+# This repository can be accessed via ssh://user@example.com/src
+repository &quot;src&quot; {
+	path &quot;/var/git/src.git&quot;
+}
+
+# This repository can be accessed via
+# ssh://user@example.com/openbsd/ports
+repository &quot;openbsd/ports&quot; {
+	path &quot;/var/git/ports.git&quot;
+}</pre>
+</div>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+  ALSO</a></h2>
+<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
+    <a class="Xr" aria-label="gotsh, section 1">gotsh(1)</a>,
+    <a class="Xr" aria-label="group, section 5">group(5)</a>,
+    <a class="Xr" aria-label="gotd, section 8">gotd(8)</a></p>
+</section>
+</main>
+<div class="foot" role="doc-pagefooter" aria-label="Manual footer
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
+  2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+</body>
+</html>
blob - 5c52d1fe8a9055bd9516e3b4e9416e53dad41763
blob + b02453e2be7a8d1dc07915ad866df0c602a27b6e
--- gotwebd.8.html
+++ gotwebd.8.html
@@ -39,8 +39,8 @@
   <tr>
     <td><code class="Nm">gotwebd</code></td>
     <td>[<code class="Fl">-dnv</code>] [<code class="Fl">-D</code>
-      <var class="Ar">macro=value</var>] [<code class="Fl">-f</code>
-      <var class="Ar">file</var>]</td>
+      <var class="Ar">macro</var>=<var class="Ar">value</var>]
+      [<code class="Fl">-f</code> <var class="Ar">file</var>]</td>
   </tr>
 </table>
 </section>
@@ -56,8 +56,10 @@
   <dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt>
   <dd>Do not daemonize and log to stderr.</dd>
   <dt id="D"><a class="permalink" href="#D"><code class="Fl">-D</code></a>
-    <var class="Ar">macro=value</var></dt>
-  <dd>Override the value of a macro used in the configuration file.</dd>
+    <var class="Ar">macro</var>=<var class="Ar">value</var></dt>
+  <dd>Define <var class="Ar">macro</var> to be set to
+      <var class="Ar">value</var>. Overrides the definition of
+      <var class="Ar">macro</var> in the configuration file.</dd>
   <dt id="f"><a class="permalink" href="#f"><code class="Fl">-f</code></a>
     <var class="Ar">file</var></dt>
   <dd>Set the path to the configuration file. If not specified, the file
@@ -183,7 +185,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - /dev/null
blob + ba586387eb579ae90f9dbb5b2cd4b021637be008 (mode 644)
--- /dev/null
+++ gotsh.1.html
@@ -0,0 +1,132 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
+  <title>GOTSH(1)</title>
+</head>
+<!-- This is an automatically generated file.  Do not edit.
+   Copyright (c) 2022 Stefan Sperling
+  
+   Permission to use, copy, modify, and distribute this software for any
+   purpose with or without fee is hereby granted, provided that the above
+   copyright notice and this permission notice appear in all copies.
+  
+   THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+   WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+   MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+   ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+   -->
+<body>
+<div class="head" role="doc-pageheader" aria-label="Manual header
+  line"><span class="head-ltitle">GOTSH(1)</span> <span class="head-vol">General
+  Commands Manual</span> <span class="head-rtitle">GOTSH(1)</span></div>
+<main class="manual-text">
+<section class="Sh">
+<h2 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h2>
+<p class="Pp"><code class="Nm">gotsh</code> &#x2014;
+    <span class="Nd" role="doc-subtitle">Game of Trees Shell</span></p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h2>
+<table class="Nm">
+  <tr>
+    <td><code class="Nm">gotsh <code class="Fl">-c</code>
+      &#x2018;<code class="Cm">git-receive-pack</code>
+      <var class="Ar">repository-path</var>&#x2019;</code></td>
+    <td></td>
+  </tr>
+</table>
+<br/>
+<table class="Nm">
+  <tr>
+    <td><code class="Nm">gotsh <code class="Fl">-c</code>
+      &#x2018;<code class="Cm">git-upload-pack</code>
+      <var class="Ar">repository-path</var>&#x2019;</code></td>
+    <td></td>
+  </tr>
+</table>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h2>
+<p class="Pp"><code class="Nm">gotsh</code> is the network-facing interface to
+    <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>. It implements the
+    server-side part of the Git network protocol used by
+    <a class="Xr" aria-label="git, section 1">git(1)</a> and
+    <a class="Xr" aria-label="got, section 1">got(1)</a>.</p>
+<p class="Pp"><code class="Nm">gotsh</code> is not an interactive shell.
+    <code class="Nm">gotsh</code> is intended to be configured as the login
+    shell of Git repository user accounts on servers running
+    <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>. If users require a
+    different login shell, <code class="Nm">gotsh</code> can be installed in the
+    command search path under the names <code class="Cm">git-receive-pack</code>
+    and <code class="Cm">git-upload-pack</code>.</p>
+<p class="Pp">The users can then interact with <a class="Xr" aria-label="gotd,
+    section 8">gotd(8)</a> over the network. When users invoke commands such as
+    <code class="Cm">got send</code> and <code class="Cm">got fetch</code> on
+    client machines, <a class="Xr" aria-label="got, section 1">got(1)</a> will
+    connect to the server with <a class="Xr" aria-label="ssh, section
+    1">ssh(1)</a>. <code class="Nm">gotsh</code> will facilitate communication
+    between <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> running on
+    the server machine and the <a class="Xr" aria-label="got, section
+    1">got(1)</a> or <a class="Xr" aria-label="git, section 1">git(1)</a>
+    program running on the client machine.</p>
+<p class="Pp">Users running <code class="Nm">gotsh</code> must be members of the
+    group which has read/write permission to the <a class="Xr" aria-label="gotd,
+    section 8">gotd(8)</a> unix socket. The group used for this purpose can be
+    configured in <a class="Xr" aria-label="gotd.conf, section
+    5">gotd.conf(5)</a>. Users running <code class="Nm">gotsh</code> should not
+    have access to Git repositories by means other than accessing the unix
+    socket of <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> via
+    <code class="Nm">gotsh</code>.</p>
+<p class="Pp">It is recommended to restrict <a class="Xr" aria-label="ssh,
+    section 1">ssh(1)</a> features available to users of
+    <code class="Nm">gotsh</code>. See the EXAMPLES section for details.</p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h2>
+<dl class="Bl-tag">
+  <dt id="GOTD_UNIX_SOCKET"><a class="permalink" href="#GOTD_UNIX_SOCKET"><code class="Ev">GOTD_UNIX_SOCKET</code></a></dt>
+  <dd>Set the path to the unix socket which <a class="Xr" aria-label="gotd,
+      section 8">gotd(8)</a> is listening on. If not specified, the default path
+      <span class="Pa">/var/run/gotd.sock</span> will be used.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
+<p class="Pp">The following <a class="Xr" aria-label="sshd_config, section
+    5">sshd_config(5)</a> directives are recommended to protect the server
+    machine and any systems reachable from it via <a class="Xr" aria-label="ssh,
+    section 1">ssh(1)</a> forwarding features. This example assumes the group
+    called &#x201C;_gotsh&#x201D; has read/write access to the
+    <a class="Xr" aria-label="gotd, section 8">gotd(8)</a> unix socket.</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>Match Group _gotsh
+    DisableForwarding
+    PermitTTY no</pre>
+</div>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+  ALSO</a></h2>
+<p class="Pp"><a class="Xr" aria-label="got, section 1">got(1)</a>,
+    <a class="Xr" aria-label="ssh, section 1">ssh(1)</a>,
+    <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>,
+    <a class="Xr" aria-label="sshd_config, section 5">sshd_config(5)</a>,
+    <a class="Xr" aria-label="gotd, section 8">gotd(8)</a></p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h2>
+<p class="Pp"><span class="An">Stefan Sperling</span>
+    &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;</p>
+</section>
+</main>
+<div class="foot" role="doc-pagefooter" aria-label="Manual footer
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
+  2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
+</body>
+</html>
blob - ae15b7be5cc4c69b2c5e7c5c6e067548989ac827
blob + 5a85f237e22a950d53fdc16320278fc6775a11ff
--- gotwebd.conf.5.html
+++ gotwebd.conf.5.html
@@ -39,6 +39,14 @@
 <p class="Pp">The file format is line-based, with one configuration directive
     per line. Any lines beginning with a &#x2018;#&#x2019; are treated as
     comments and ignored.</p>
+<p class="Pp">Macros can be defined that are later expanded in context. Macro
+    names must start with a letter, digit, or underscore, and may contain any of
+    those characters, but may not be reserved words. Macros are not expanded
+    inside quotes. For example:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>lan_addr = &quot;192.168.0.1&quot;
+listen on $lan_addr</pre>
+</div>
 <p class="Pp">Paths mentioned in <code class="Nm">gotwebd.conf</code> must be
     relative to <span class="Pa">/var/www</span>, the
     <a class="Xr" aria-label="chroot, section 2">chroot(2)</a> environment of
@@ -239,7 +247,7 @@ server &quot;localhost-unix&quot; {
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>
blob - 32c7e93cb3250e884ca4b8c8543069ea825fba2a
blob + 7f5b34cf46ad38fd690c1b92b266d5af1e4c38a9
--- sync-man.sh
+++ sync-man.sh
@@ -13,6 +13,10 @@ done
 for f in gotwebd.8 gotwebd.conf.5; do
 	$CONVERT $HOME/src/got/gotwebd/$f > ./${f}.html
 done
+for f in gotd.8 gotd.conf.5; do
+	$CONVERT $HOME/src/got/gotd/$f > ./${f}.html
+done
+$CONVERT $HOME/src/got/gotsh/gotsh.1 > ./gotsh.1.html
 
 
 got st
blob - 4bccc4ad49219ee8d49c71b7c7a601e69229ee72
blob + a9ed065f02ed269b35e40055c49cc8dcaa496c83
--- tog.1.html
+++ tog.1.html
@@ -36,7 +36,7 @@
 <table class="Nm">
   <tr>
     <td><code class="Nm">tog</code></td>
-    <td>[<var class="Ar">command</var>] [<code class="Fl">-h</code>]
+    <td>[<code class="Fl">-hV</code>] <var class="Ar">command</var>
       [<var class="Ar">arg ...</var>]</td>
   </tr>
 </table>
@@ -81,6 +81,15 @@
     unmapped key. Once a compound command is executed, the operation can be
     cancelled with <code class="Cm">C-g</code> or
     <code class="Cm">Backspace</code>.</p>
+<p class="Pp">Global options must precede the command name, and are as
+  follows:</p>
+<dl class="Bl-tag">
+  <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a></dt>
+  <dd>Display usage information.</dd>
+  <dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
+    <code class="Fl">--version</code></dt>
+  <dd>Display program version and exit immediately.</dd>
+</dl>
 <p class="Pp">The global key bindings are:</p>
 <dl class="Bl-tag">
   <dt id="H,"><a class="permalink" href="#H,"><code class="Cm">H,
@@ -114,15 +123,6 @@
   <dt id="g"><a class="permalink" href="#g"><code class="Cm">g</code></a></dt>
   <dd>Go to line N in the view (default: first line).</dd>
 </dl>
-<p class="Pp">Global options must precede the command name, and are as
-  follows:</p>
-<dl class="Bl-tag">
-  <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a></dt>
-  <dd>Display usage information.</dd>
-  <dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
-    <code class="Fl">--version</code></dt>
-  <dd>Display program version and exit immediately.</dd>
-</dl>
 <p class="Pp">The commands for <code class="Nm">tog</code> are as follows:</p>
 <dl class="Bl-tag">
   <dt id="log"><a class="permalink" href="#log"><code class="Cm">log</code></a>
@@ -778,7 +778,7 @@
 </section>
 </main>
 <div class="foot" role="doc-pagefooter" aria-label="Manual footer
-  line"><span class="foot-left"></span><span class="foot-date">September 23,
+  line"><span class="foot-left"></span><span class="foot-date">October 24,
   2022</span> <span class="foot-os">OpenBSD 7.2</span></div>
 </body>
 </html>