commit - 4202fd2e9073cadc3b74a1223c8ff56c67adb08d
commit + d9cf1ef03fc218d571d541d229ecb17fae9ed789
blob - /dev/null
blob + 72cf8a4a1bd5fc5f35da05345e24409e03490f39 (mode 644)
--- /dev/null
+++ gitwrapper.1.html
+<!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>GITWRAPPER(1)</title>
+</head>
+<!-- This is an automatically generated file. Do not edit.
+ Copyright (c) 2023 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">GITWRAPPER(1)</span>
+ <span class="head-vol">General Commands Manual</span>
+ <span class="head-rtitle">GITWRAPPER(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">gitwrapper</code> —
+ <span class="Nd" role="doc-subtitle">invoke an appropriate Git repository
+ server</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">gitwrapper <code class="Fl">-c</code>
+ ‘<code class="Cm">git-receive-pack</code>
+ <var class="Ar">repository-path</var>’</code></td>
+ <td></td>
+ </tr>
+</table>
+<br/>
+<table class="Nm">
+ <tr>
+ <td><code class="Nm">gitwrapper <code class="Fl">-c</code>
+ ‘<code class="Cm">git-upload-pack</code>
+ <var class="Ar">repository-path</var>’</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">At one time, the only Git repository server software easily
+ available was built into <a class="Xr" aria-label="git-upload-pack, section
+ 1">git-upload-pack(1)</a> and <a class="Xr" aria-label="git-receive-pack,
+ section 1">git-receive-pack(1)</a> which are part of the
+ <a class="Xr" aria-label="git, section 1">git(1)</a> suite. As a result of
+ this, most Git client implementations had the path and calling conventions
+ expected by <a class="Xr" aria-label="git, section 1">git(1)</a> compiled
+ in.</p>
+<p class="Pp">Times have changed, however. On a modern system, the administrator
+ may wish to use one of several available Git repository servers, such as
+ <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>.</p>
+<p class="Pp">It would be difficult to modify all Git client software typically
+ available on a system, so most of the authors of alternative Git servers
+ have written their programs so that they use the same calling conventions as
+ <a class="Xr" aria-label="git-upload-pack, section 1">git-upload-pack(1)</a>
+ and <a class="Xr" aria-label="git-receive-pack, section
+ 1">git-receive-pack(1)</a> and may be put into place in their stead.</p>
+<p class="Pp">Although having drop-in replacements for
+ <a class="Xr" aria-label="git-upload-pack, section 1">git-upload-pack(1)</a>
+ and <a class="Xr" aria-label="git-receive-pack, section
+ 1">git-receive-pack(1)</a> helps in installing alternative Git servers, it
+ essentially makes the configuration of the system depend on hard installing
+ new programs in <span class="Pa">/usr</span>. This leads to configuration
+ problems for many administrators, since they may wish to install a new Git
+ server without altering the system provided <span class="Pa">/usr</span>.
+ (This may be, for example, to avoid having upgrade problems when a new
+ version of the system is installed over the old.) They may also have a
+ shared <span class="Pa">/usr</span> among several machines, and may wish to
+ avoid placing implicit configuration information in a read-only
+ <span class="Pa">/usr</span>.</p>
+<p class="Pp">The <code class="Nm">gitwrapper</code> program is designed to
+ replace <a class="Xr" aria-label="git-upload-pack, section
+ 1">git-upload-pack(1)</a> and <a class="Xr" aria-label="git-receive-pack,
+ section 1">git-receive-pack(1)</a> and to invoke an appropriate Git server
+ based on configuration information placed in
+ <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a>. This
+ permits the administrator to configure which Git server is to be invoked on
+ the system at run-time. Git repositories which are listed in
+ <a class="Xr" aria-label="gotd.conf, section 5">gotd.conf(5)</a> and exist
+ on the filesystem will be served by <a class="Xr" aria-label="gotsh, section
+ 1">gotsh(1)</a>. Any other Git repositories will be served by
+ <a class="Xr" aria-label="git-upload-pack, section 1">git-upload-pack(1)</a>
+ and <a class="Xr" aria-label="git-receive-pack, section
+ 1">git-receive-pack(1)</a> as found in Git's <span class="Pa">libexec</span>
+ directory, which is <span class="Pa">/usr/local/libexec/git/</span> by
+ default on <span class="Ux">OpenBSD</span>.</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_CONF_PATH"><a class="permalink" href="#GOTD_CONF_PATH"><code class="Ev">GOTD_CONF_PATH</code></a></dt>
+ <dd>Set the path to the configuration file for <a class="Xr" aria-label="gotd,
+ section 8">gotd(8)</a>. If not specified, the default path
+ <span class="Pa">/etc/gotd.conf</span> will be used.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h2>
+<p class="Pp">Configuration for <a class="Xr" aria-label="gotd, section
+ 8">gotd(8)</a> is kept in <span class="Pa">/etc/gotd.conf</span>.</p>
+<p class="Pp"><span class="Pa">git-upload-pack</span> and
+ <span class="Pa">git-receive-pack</span> are typically set up as a symlink
+ to <code class="Nm">gitwrapper</code> which is not usually invoked on its
+ own.</p>
+</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="gotd.conf, section 5">gotd.conf(5)</a>,
+ <a class="Xr" aria-label="gotd, section 8">gotd(8)</a>,
+ <a class="Xr" aria-label="mailwrapper, section 8">mailwrapper(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>
+ <<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>></p>
+</section>
+<section class="Sh">
+<h2 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h2>
+<p class="Pp">The entire reason this program exists is a crock. Instead, a
+ command for invoking a Git server should be standardized or the Git protocol
+ should be changed to make the path to the program discoverable by Git
+ clients.</p>
+</section>
+</main>
+<div class="foot" role="doc-pagefooter" aria-label="Manual footer
+ line"><span class="foot-left"></span><span class="foot-date">April 20,
+ 2023</span> <span class="foot-os">OpenBSD 7.3</span></div>
+</body>
+</html>
blob - 7da654eb8e972d48a958c2f4f97eea1048b5f0f7
blob + 03ece1efff6b15fe4f341235c82cfab44dba5300
--- manual.html
+++ manual.html
<li><a href="gotctl.8.html">gotctl</a> — control the Game of Trees Daemon
<li><a href="gotsh.1.html">gotsh</a> — Game of Trees Shell
</ul>
+Manual pages installed by the <tt>gitwrapper</tt> package:
+<ul>
+<li><a href="gitwrapper.1.html">gitwrapper</a> — invoke an appropriate Git repository server
+</ul>
+<ul>
</body>
</html>
blob - bb14ae17769c57d3de1e2c4fecddacdcfccc3ef9
blob + cde918dd3626cbf72f7bd01e001067bd4078f3c5
--- sync-man.sh
+++ sync-man.sh
done
$CONVERT $HOME/src/got/gotsh/gotsh.1 > ./gotsh.1.html
$CONVERT $HOME/src/got/gotctl/gotctl.8 > ./gotctl.8.html
+$CONVERT $HOME/src/got/gitwrapper/gitwrapper.1 > ./gitwrapper.1.html
-
got st
