commit - 373291f1ac93976301e7e88ca974aac23402b9d7
commit + 865e5ba9d7fe914d9f677e65e67b9ed104edc5b9
blob - cf54ca6135a863cf1227902e9e5a1e505c6136b6
blob + 9dc75ca46d5a0c0a439429e696687fb056b15841
--- git-repository.5.html
+++ git-repository.5.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 4d04d4518fb8dcfcf99346cf556bdaf597339375
blob + 7c772dcf0a426ed8746031b57e97ebb58dc75cdc
--- gitwrapper.1.html
+++ gitwrapper.1.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 6b9f0094d7dc6dc2b10315a7b03fcc8a39f5a993
blob + 2061fa3f49647a9b0951d109233857d378f42181
--- got-worktree.5.html
+++ got-worktree.5.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - a1eb89ebb8e17de1120ff55033e80cdfe4200fae
blob + dec0c6b2df6265a40107ed75d3a0df8be3a393d7
--- got.1.html
+++ got.1.html
<h2 class="Sh" id="ENVIRONMENT"><a class="permalink" href="#ENVIRONMENT">ENVIRONMENT</a></h2>
<dl class="Bl-tag">
<dt id="GOT_AUTHOR"><a class="permalink" href="#GOT_AUTHOR"><code class="Ev">GOT_AUTHOR</code></a></dt>
- <dd>The author's name and email address, such as “<span class="An">Flan
+ <dd>The author's name and email address, such as "<span class="An">Flan
Hacker</span>
- <<a class="Mt" href="mailto:flan_hacker@openbsd.org">flan_hacker@openbsd.org</a>>”.
+ <<a class="Mt" href="mailto:flan_hacker@openbsd.org">flan_hacker@openbsd.org</a>>".
Used by the <code class="Cm">got commit</code>, <code class="Cm">got
import</code>, <code class="Cm">got rebase</code>, <code class="Cm">got
merge</code>, and <code class="Cm">got histedit</code> commands. Because
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 9ca9a6976dd0769dc7ef5cf1ec6e17b44a478b87
blob + 49b4da2d7cc3c0837a6d20db39baf3d6d9459991
--- got.conf.5.html
+++ got.conf.5.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - a9867aa64152cc3ba57a3bb44c65c5b9ca0ebeff
blob + 422b5e5dd23cb2ef1f9c09970db620afb102b4f2
--- gotadmin.1.html
+++ gotadmin.1.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 86d0264999bc44efcfbe68c21e61b79921e2a95c
blob + 6d75278aafedb173f7c2598b1f02d1241637bc5c
--- gotctl.8.html
+++ gotctl.8.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 92e88d02cb90e4287066ebfb7243e89a75f7768c
blob + 949f2487e501a0168b355cc83ab4b8f998931f1a
--- gotd.8.html
+++ gotd.8.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - f4f13030db4877874a25cf6f0d16548369c162db
blob + 8b3b7c180196d2d92393a43d3886b3dd59cd3adf
--- gotd.conf.5.html
+++ gotd.conf.5.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 7081b781b3181d89bca1f2c3f610b95c34851e88
blob + df7e38d9329803d40b6355191f42c3193379777a
--- gotsh.1.html
+++ gotsh.1.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - 2a0c5a414571dfd12c6aa6ff38b6606b2c827ab2
blob + 16ac59ca67a8398c1a4cba4ff904b26045171cce
--- gotwebd.8.html
+++ gotwebd.8.html
<p class="Pp">Example configuration for <a class="Xr" aria-label="httpd.conf,
section 5">httpd.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
-<pre> types { include "/usr/share/misc/mime.types" }
+<pre>types { include "/usr/share/misc/mime.types" }
- # one gotwebd reachable at http://gotweb1.example.com/
- server "gotweb1.example.com" {
- listen on * port 80
- root "/htdocs/gotwebd"
- location "/" {
- fastcgi socket "/run/gotweb.sock"
- }
- }
+server "example.com" {
+ listen on * port 80
+ root "/htdocs/gotwebd"
+ location "/" {
+ fastcgi socket "/run/gotweb.sock"
+ }
+}</pre>
+</div>
+<p class="Pp">Hosting multiple <code class="Nm">gotwebd</code> instances on the
+ same HTTP server under different path prefixes, with the first reached via
+ the default <span class="Ux">UNIX</span>-domain socket, the second
+ configured to listen on localhost port 9000:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>server "example.com" {
+ listen on * port 80
- # hosting multiple gotwebd instances on the same HTTP server:
- # http://gotweb2.example.com/gotwebd-unix/
- # http://gotweb2.example.com/gotwebd-tcp/
- server "gotweb2.example.com" {
- listen on * port 80
- location "/gotwebd-unix/" {
- fastcgi socket "/run/gotweb.sock"
- }
- location "/gotwebd-unix/*" {
- root "/htdocs/gotwebd"
- request strip 1
- }
- location "/gotwebd-tcp/" {
- fastcgi socket tcp 127.0.0.1 9000
- }
- location "/gotwebd-tcp/*" {
- root "/htdocs/gotwebd"
- request strip 1
- }
- }</pre>
+ location "/gotwebd-unix/" {
+ fastcgi socket "/run/gotweb.sock"
+ }
+ location "/gotwebd-unix/*" {
+ root "/htdocs/gotwebd"
+ request strip 1
+ }
+
+ location "/gotwebd-tcp/" {
+ fastcgi socket tcp localhost 9000
+ }
+ location "/gotwebd-tcp/*" {
+ root "/htdocs/gotwebd"
+ request strip 1
+ }
+}</pre>
</div>
</section>
<section class="Sh">
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - d38a6c1e2977df93bf6b5de8cc1ca241c893a603
blob + 371ee2600dcd8ce3efae98855407dab6bc65112b
--- gotwebd.conf.5.html
+++ gotwebd.conf.5.html
inside quotes. For example:</p>
<div class="Bd Pp Bd-indent Li">
<pre>lan_addr = "192.168.0.1"
-listen on $lan_addr</pre>
+listen on $lan_addr port 9090</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
will be used.</dd>
<dt id="prefork"><a class="permalink" href="#prefork"><code class="Ic">prefork</code></a>
<var class="Ar">number</var></dt>
- <dd>Run the specified number of server processes.</dd>
+ <dd>Run the specified number of server processes.
+ <a class="Xr" aria-label="gotwebd, section 8">gotwebd(8)</a> runs 3 server
+ processes by default.</dd>
<dt id="unix_socket"><a class="permalink" href="#unix_socket"><code class="Ic">unix_socket</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Controls whether the servers will listen on unix sockets by default.</dd>
+ <dd>Controls whether the servers will listen on unix sockets by default.
+ Listening on unix sockets is the default.</dd>
<dt id="unix_socket_name"><a class="permalink" href="#unix_socket_name"><code class="Ic">unix_socket_name</code></a>
<var class="Ar">path</var></dt>
- <dd>Set the path to the default unix socket.</dd>
+ <dd>Set the path to the default unix socket. Defaults to
+ <span class="Pa">/var/www/run/gotweb.sock</span>.</dd>
</dl>
</section>
<section class="Sh">
<dt id="custom_css"><a class="permalink" href="#custom_css"><code class="Ic">custom_css</code></a>
<var class="Ar">path</var></dt>
<dd>Set the path to a custom Cascading Style Sheet (CSS) to be used. If this
- option is not specified then a default style sheet will be used.</dd>
+ option is not specified then the default style sheet
+ ‘gotweb.css’ will be used.</dd>
<dt id="listen"><a class="permalink" href="#listen"><code class="Ic">listen
on</code></a> <var class="Ar">address</var> <code class="Ic">port</code>
<var class="Ar">number</var></dt>
- <dd>Configure an address and port for incoming FCGI TCP connections. Valid
- <var class="Ar">address</var> arguments are hostnames, IP4 addresses and
- IPv6 addresses. The <var class="Ar">port</var> argument may be number or a
+ <dd>Configure an address and port for incoming FastCGI connections. Valid
+ <var class="Ar">address</var> arguments are hostnames, IPv4 and IPv6
+ addresses. The <var class="Ar">port</var> argument may be number or a
service name defined in <a class="Xr" aria-label="services, section
5">services(5)</a>.
<p class="Pp">May be specified multiple times to build up a list of
<dd>Set the path to the unix socket used by the server.</dd>
<dt id="logo"><a class="permalink" href="#logo"><code class="Ic">logo</code></a>
<var class="Ar">path</var></dt>
- <dd>Set the path to an image file containing a logo to be displayed.</dd>
+ <dd>Set the path to an image file containing a logo to be displayed. Defaults
+ to ‘got.png’.</dd>
<dt id="logo_url"><a class="permalink" href="#logo_url"><code class="Ic">logo_url</code></a>
<var class="Ar">url</var></dt>
- <dd>Set a hyperlink for the logo.</dd>
+ <dd>Set a hyperlink for the logo. Defaults to
+ <a class="Lk" href="https://gameoftrees.org">https://gameoftrees.org</a>.</dd>
<dt id="max_commits_display"><a class="permalink" href="#max_commits_display"><code class="Ic">max_commits_display</code></a>
<var class="Ar">number</var></dt>
- <dd>Set the maximum amount of commits displayed per page.</dd>
- <dt id="max_repos"><a class="permalink" href="#max_repos"><code class="Ic">max_repos</code></a>
- <var class="Ar">number</var></dt>
- <dd>Set the maximum amount of repositories <a class="Xr" aria-label="gotwebd,
- section 8">gotwebd(8)</a> will work with.</dd>
+ <dd>Set the maximum amount of commits and tags displayed per page. Defaults to
+ 25.</dd>
<dt id="max_repos_display"><a class="permalink" href="#max_repos_display"><code class="Ic">max_repos_display</code></a>
<var class="Ar">number</var></dt>
- <dd>Set the maximum amount of repositories displayed on the index screen.</dd>
+ <dd>Set the maximum amount of repositories displayed on the index screen.
+ Defaults to 25. Set to zero to show all the repositories without
+ pagination.</dd>
<dt id="repos_path"><a class="permalink" href="#repos_path"><code class="Ic">repos_path</code></a>
<var class="Ar">path</var></dt>
<dd>Set the path to the directory which contains Git repositories that the
- server should publish.</dd>
+ server should publish. Defaults to
+ <span class="Pa">/run/gotwebd.sock</span> under the chroot.</dd>
<dt id="respect_exportok"><a class="permalink" href="#respect_exportok"><code class="Ic">respect_exportok</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
<dd>Set whether to display the repository only if it contains the magic
- <span class="Pa">git-daemon-export-ok</span> file.</dd>
+ <span class="Pa">git-daemon-export-ok</span> file. Disabled by
+ default.</dd>
<dt id="show_repo_age"><a class="permalink" href="#show_repo_age"><code class="Ic">show_repo_age</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of last repository modification date.</dd>
+ <dd>Toggle display of last repository modification date. Enabled by
+ default.</dd>
<dt id="show_repo_cloneurl"><a class="permalink" href="#show_repo_cloneurl"><code class="Ic">show_repo_cloneurl</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
<dd>Toggle display of clone URLs for a repository. This requires the creation
of a <span class="Pa">cloneurl</span> file inside the repository which
- contains one URL per line.</dd>
+ contains one URL per line. Enabled by default.</dd>
<dt id="show_repo_description"><a class="permalink" href="#show_repo_description"><code class="Ic">show_repo_description</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of the repository description. The
+ <dd>Toggle display of the repository description. Enabled by default. The
<span class="Pa">description</span> file in the repository should be
updated with an appropriate description.</dd>
<dt id="show_repo_owner"><a class="permalink" href="#show_repo_owner"><code class="Ic">show_repo_owner</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Set whether to display the repository owner. Displaying the owner requires
- owner information to be added to the <span class="Pa">config</span> file
- in the repository. <a class="Xr" aria-label="gotwebd, section
- 8">gotwebd(8)</a> will parse owner information from either a [gotweb] or a
- [gitweb] section. For example:
+ <dd>Set whether to display the repository owner. Enabled by default.
+ Displaying the owner requires owner information to be added to the
+ <span class="Pa">config</span> file in the repository.
+ <a class="Xr" aria-label="gotwebd, section 8">gotwebd(8)</a> will parse
+ owner information from either a [gotweb] or a [gitweb] section. For
+ example:
<div class="Bd Pp Bd-indent Li">
<pre>[gotweb]
owner = "Your Name"</pre>
</dd>
<dt id="site_link"><a class="permalink" href="#site_link"><code class="Ic">site_link</code></a>
<var class="Ar">string</var></dt>
- <dd>Set the displayed site link name for the index page.</dd>
+ <dd>Set the displayed site link name for the index page. Defaults to
+ ‘Repos’.</dd>
<dt id="site_name"><a class="permalink" href="#site_name"><code class="Ic">site_name</code></a>
<var class="Ar">string</var></dt>
- <dd>Set the displayed site name title.</dd>
+ <dd>Set the displayed site name title. Defaults to
+ ‘Gotweb’.</dd>
<dt id="site_owner"><a class="permalink" href="#site_owner"><code class="Ic">site_owner</code></a>
<var class="Ar">string</var></dt>
- <dd>Set the displayed site owner.</dd>
+ <dd>Set the displayed site owner. Defaults to ‘Got Owner’.</dd>
<dt id="show_site_owner"><a class="permalink" href="#show_site_owner"><code class="Ic">show_site_owner</code></a>
<var class="Ar">on</var> | <var class="Ar">off</var></dt>
- <dd>Toggle display of the site owner.</dd>
+ <dd>Toggle display of the site owner. Enabled by default.</dd>
+ <dt id="summary_commits_display"><a class="permalink" href="#summary_commits_display"><code class="Ic">summary_commits_display</code></a>
+ <var class="Ar">number</var></dt>
+ <dd>The maximum number of commits to show in the summary page. Defaults to
+ 10.</dd>
+ <dt id="summary_tags_display"><a class="permalink" href="#summary_tags_display"><code class="Ic">summary_tags_display</code></a>
+ <var class="Ar">number</var></dt>
+ <dd>The maximum number of tags to show in the summary page. Defaults to
+ 3.</dd>
</dl>
</section>
<section class="Sh">
</section>
<section class="Sh">
<h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
-<p class="Pp">These are the currently configurable items for
- <a class="Xr" aria-label="gotwebd, section 8">gotwebd(8)</a> with their
- default values.</p>
+<p class="Pp">A sample configuration:</p>
<div class="Bd Pp Bd-indent Li">
-<pre>#
-# gotwebd options
-# all paths relative to /var/www (httpd chroot jail)
-#
-
-prefork 3
-
-server "localhost-unix" {
- repos_path "/got/public"
- listen on socket "/run/gotweb.sock"
-
- site_name "my public repos"
- site_owner "Got Owner"
- site_link "repos"
-
- logo "got.png"
- logo_url "https://gameoftrees.org"
-
- # on by default
- #show_site_owner on
- #show_repo_owner on
- #show_repo_age on
- #show_repo_description on
- #show_repo_cloneurl on
- #respect_exportok off
-
- #max_repos 0
- #max_repos_display 25
- #max_commits_display 25
-}
-
-# Example server context for FCGI over TCP connections:
-#server "localhost-tcp" {
-# repos_path "/got/public"
-# listen on socket off
-# listen on 127.0.0.1 port 9000
-# listen on ::1 port 9000
-#}</pre>
+<pre>server "localhost" {
+ site_name "my public repos"
+ site_owner "Flan Hacker"
+ site_link "Flan' Projects"
+}</pre>
</div>
+<p class="Pp">Another example, this time listening on a local port instead of
+ the implicit <span class="Ux">UNIX</span> socket.</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>server "localhost" {
+ listen on socket off
+ listen on 127.0.0.1 port 9000
+ listen on ::1 port 9000
+}</pre>
+</div>
</section>
<section class="Sh">
<h2 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
blob - c1c91e098745429e47affae6fc18b53aa65f0ada
blob + df528ba03f541e2bb380e919b7669db0a65007cb
--- tog.1.html
+++ tog.1.html
</section>
</main>
<div class="foot" role="doc-pagefooter" aria-label="Manual footer
- line"><span class="foot-left"></span><span class="foot-date">December 8,
- 2023</span> <span class="foot-os">OpenBSD 7.4</span></div>
+ line"><span class="foot-left"></span><span class="foot-date">February 13,
+ 2024</span> <span class="foot-os">OpenBSD 7.4</span></div>
</body>
</html>
