commit - eb8b2610464f8bcb526eecccb83eee0bf8595692
commit + a954aa0a95f72d7aa4bd8e3aff9ce3ad862a2b6e
blob - d05a62715a164e58f7c1a4851e14952f7e426cb4
blob + 1a180b0a04b76c153a96b70911093bc61141c9d3
--- git-repository.5.html
+++ git-repository.5.html
-->
<head>
<meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<style>
table.head, table.foot { width: 100%; }
td.head-rtitle, td.foot-os { text-align: right; }
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
-<p class="Pp"><a class="Xr">got(1)</a>, <a class="Xr">deflate(3)</a>,
- <a class="Xr">SHA1(3)</a>, <a class="Xr">got-worktree(5)</a>
- <a class="Xr">got.conf(5)</a></p>
+<p class="Pp"><a class="Xr">got(1)</a>, <a class="Xr">gotadmin(1)</a>,
+ <a class="Xr">deflate(3)</a>, <a class="Xr">SHA1(3)</a>,
+ <a class="Xr">got-worktree(5)</a>, <a class="Xr">got.conf(5)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
</div>
<table class="foot">
<tr>
- <td class="foot-date">April 5, 2021</td>
- <td class="foot-os">OpenBSD 6.8</td>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
</tr>
</table>
</body>
blob - c4ba7ee1fe7559485d03c3f4892a17fa79429e30
blob + a1f78d7a80ae038109ddab8f812c034e39293a11
--- got-worktree.5.html
+++ got-worktree.5.html
-->
<head>
<meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<style>
table.head, table.foot { width: 100%; }
td.head-rtitle, td.foot-os { text-align: right; }
</div>
<table class="foot">
<tr>
- <td class="foot-date">April 5, 2021</td>
- <td class="foot-os">OpenBSD 6.8</td>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
</tr>
</table>
</body>
blob - 72320008280c00c3bbc29d43b15a2d15bab2155c
blob + f415dc0e8fae12a1b7fe63fb27ae6b06be17f4fc
--- got.1.html
+++ got.1.html
-->
<head>
<meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<style>
table.head, table.foot { width: 100%; }
td.head-rtitle, td.foot-os { text-align: right; }
<dt id="up"><a class="permalink" href="#up"><code class="Cm">up</code></a></dt>
<dd>Short alias for <code class="Cm">update</code>.</dd>
<dt id="status"><a class="permalink" href="#status"><code class="Cm">status</code></a>
- [<code class="Fl">-s</code> <var class="Ar">status-codes</var>]
- [<var class="Ar">path ...</var>]</dt>
+ [<code class="Fl">-I</code>] [<code class="Fl">-s</code>
+ <var class="Ar">status-codes</var>] [<var class="Ar">path ...</var>]</dt>
<dd>Show the current modification status of files in a work tree, using the
following status codes:
<table class="Bl-column">
<p class="Pp">The options for <code class="Cm">got status</code> are as
follows:</p>
<dl class="Bl-tag">
+ <dt id="I~2"><a class="permalink" href="#I~2"><code class="Fl">-I</code></a></dt>
+ <dd>Show unversioned files even if they match an ignore pattern.</dd>
<dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a>
<var class="Ar">status-codes</var></dt>
<dd>Only show files with a modification status matching any of the
<dd>Permit recursion into directories. If this option is not specified,
<code class="Cm">got add</code> will refuse to run if a specified
<var class="Ar">path</var> is a directory.</dd>
- <dt id="I~2"><a class="permalink" href="#I~2"><code class="Fl">-I</code></a></dt>
+ <dt id="I~3"><a class="permalink" href="#I~3"><code class="Fl">-I</code></a></dt>
<dd>With -R, add files even if they match a <code class="Cm">got
status</code> ignore pattern.</dd>
</dl>
configuration item can be added manually to the Git repository's
<span class="Pa">config</span> file:</p>
<p class="Pp"></p>
-<div class="Bd Bd-indent"><code class="Li">[remote origin</code></div>
-]
+<div class="Bd Bd-indent"><code class="Li">[remote
+ "origin"]</code></div>
<div class="Bd Bd-indent"><code class="Li">url = ...</code></div>
<div class="Bd Bd-indent"><code class="Li">fetch =
+refs/heads/*:refs/remotes/origin/*</code></div>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
-<p class="Pp"><a class="Xr">tog(1)</a>, <a class="Xr">git-repository(5)</a>,
- <a class="Xr">got-worktree(5)</a>, <a class="Xr">got.conf(5)</a></p>
+<p class="Pp"><a class="Xr">gotadmin(1)</a>, <a class="Xr">tog(1)</a>,
+ <a class="Xr">git-repository(5)</a>, <a class="Xr">got-worktree(5)</a>,
+ <a class="Xr">got.conf(5)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
</div>
<table class="foot">
<tr>
- <td class="foot-date">April 5, 2021</td>
- <td class="foot-os">OpenBSD 6.8</td>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
</tr>
</table>
</body>
blob - 2f302e69df79ea5697934f61a65db292e5a1afa7
blob + 84b29ee2ea53756f4983e7a100dbff9a7685e2a1
--- gotweb.8.html
+++ gotweb.8.html
-->
<head>
<meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<style>
table.head, table.foot { width: 100%; }
td.head-rtitle, td.foot-os { text-align: right; }
<a class="Sx" href="#EXAMPLES">EXAMPLES</a> section below contains an
appropriate configuration file sample.</li>
<li>httpd(8) and slowcgi(8) must be enabled and started:
- <div class="Bd Pp Bd-indent">
- <pre>
- # rcctl enable httpd slowcgi
- # rcctl start httpd slowcgi
- </pre>
+ <div class="Bd Pp Bd-indent Li">
+ <pre> # rcctl enable httpd slowcgi
+ # rcctl start httpd slowcgi</pre>
</div>
</li>
<li>Optionally, the run-time behaviour of <code class="Nm">gotweb</code> can
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">Example configuration for httpd.conf:</p>
-<div class="Bd Pp Bd-indent">
+<div class="Bd Pp Bd-indent Li">
<pre>
-
types { include "/usr/share/misc/mime.types" }
server "gotweb.example.com" {
listen on * port 80
location "/*" {
directory index "index.html"
}
- }
-</pre>
+ }</pre>
</div>
</section>
<section class="Sh">
</div>
<table class="foot">
<tr>
- <td class="foot-date">April 5, 2021</td>
- <td class="foot-os">OpenBSD 6.8</td>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
</tr>
</table>
</body>
blob - /dev/null
blob + 61b389fdde6641905dfe674f8ca24479ecbed957 (mode 644)
--- /dev/null
+++ gotadmin.1.html
+<!DOCTYPE html>
+<html>
+<!-- This is an automatically generated file. Do not edit.
+ Copyright (c) 2021 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.
+ -->
+<head>
+ <meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <style>
+ table.head, table.foot { width: 100%; }
+ td.head-rtitle, td.foot-os { text-align: right; }
+ td.head-vol { text-align: center; }
+ .Nd, .Bf, .Op { display: inline; }
+ .Pa, .Ad { font-style: italic; }
+ .Ms { font-weight: bold; }
+ .Bl-diag > dt { font-weight: bold; }
+ code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold;
+ font-family: inherit; }
+ </style>
+ <title>GOTADMIN(1)</title>
+</head>
+<body>
+<table class="head">
+ <tr>
+ <td class="head-ltitle">GOTADMIN(1)</td>
+ <td class="head-vol">General Commands Manual</td>
+ <td class="head-rtitle">GOTADMIN(1)</td>
+ </tr>
+</table>
+<div class="manual-text">
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<p class="Pp"><code class="Nm">gotadmin</code> — <span class="Nd">Game of
+ Trees repository administration</span></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<table class="Nm">
+ <tr>
+ <td><code class="Nm">gotadmin</code></td>
+ <td><var class="Ar">command</var> [<code class="Fl">-h</code>]
+ [<var class="Ar">arg ...</var>]</td>
+ </tr>
+</table>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<p class="Pp"><code class="Nm">gotadmin</code> is the repository maintenance
+ tool for the <a class="Xr">got(1)</a> version control system.</p>
+<p class="Pp"><a class="Xr">got(1)</a> stores the history of tracked files in a
+ Git repository, as used by the Git version control system.
+ <code class="Nm">gotadmin</code> provides commands for inspecting and
+ manipulating the on-disk state of Git repositories. The repository format is
+ described in <a class="Xr">git-repository(5)</a>.</p>
+<p class="Pp"><code class="Nm">gotadmin</code> provides global and
+ command-specific options. 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 and exit immediately.</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">gotadmin</code> are as
+ follows:</p>
+<dl class="Bl-tag">
+ <dt id="info"><a class="permalink" href="#info"><code class="Cm">info</code></a>
+ [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]</dt>
+ <dd>Display information about a repository. This includes some configuration
+ settings from <a class="Xr">got.conf(5)</a>, and the number of objects
+ stored in the repository, in packed or loose form, as well as the current
+ on-disk size of these objects.
+ <p class="Pp">The options for <code class="Cm">gotadmin info</code> are as
+ follows:</p>
+ <dl class="Bl-tag">
+ <dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a>
+ <var class="Ar">repository-path</var></dt>
+ <dd>Use the repository at the specified path. If not specified, assume the
+ repository is located at or above the current working directory.</dd>
+ </dl>
+ </dd>
+ <dt id="pack"><a class="permalink" href="#pack"><code class="Cm">pack</code></a>
+ [<code class="Fl">-a</code>] [<code class="Fl">-r</code>
+ <var class="Ar">repository-path</var>] [<code class="Fl">-x</code>
+ <var class="Ar">reference</var>] [<var class="Ar">reference ...</var>]</dt>
+ <dd>Generate a new pack file and a corresponding pack file index. By default,
+ add any loose objects which are reachable via any references to the
+ generated pack file.
+ <p class="Pp">If one or more <var class="Ar">reference</var> arguments is
+ specified, only add objects which are reachable via the specified
+ references. Each <var class="Ar">reference</var> argument may either
+ specify a specific reference or a reference namespace, in which case all
+ references within this namespace will be used.</p>
+ <p class="Pp"><code class="Cm">gotadmin pack</code> always ignores
+ references in the <span class="Pa">refs/got/</span> namespace,
+ effectively treating such references as if they did not refer to any
+ objects.</p>
+ <p class="Pp">The options for <code class="Cm">gotadmin pack</code> are as
+ follows:</p>
+ <dl class="Bl-tag">
+ <dt id="a"><a class="permalink" href="#a"><code class="Fl">-a</code></a></dt>
+ <dd>Add objects to the generated pack file even if they are already packed
+ in a different pack file. Unless this option is specified, only loose
+ objects will be added.</dd>
+ <dt id="r~2"><a class="permalink" href="#r~2"><code class="Fl">-r</code></a>
+ <var class="Ar">repository-path</var></dt>
+ <dd>Use the repository at the specified path. If not specified, assume the
+ repository is located at or above the current working directory.</dd>
+ <dt id="x"><a class="permalink" href="#x"><code class="Fl">-x</code></a>
+ <var class="Ar">reference</var></dt>
+ <dd>Exclude objects reachable via the specified
+ <var class="Ar">reference</var> from the pack file. The
+ <var class="Ar">reference</var> argument may either specify a specific
+ reference or a reference namespace, in which case all references
+ within this namespace will be excluded. The <code class="Fl">-x</code>
+ option may be specified multiple times to build a list of references
+ to exclude.
+ <p class="Pp">Exclusion takes precedence over inclusion. If a reference
+ appears in both the included and excluded lists, it will be
+ excluded.</p>
+ </dd>
+ </dl>
+ </dd>
+ <dt id="indexpack"><a class="permalink" href="#indexpack"><code class="Cm">indexpack</code></a>
+ <var class="Ar">packfile-path</var></dt>
+ <dd>Create a pack index for the pack file at
+ <var class="Ar">packfile-path</var>.
+ <p class="Pp">A pack index is required for using the corresponding pack file
+ with <a class="Xr">got(1)</a>. Usually, a pack index will be created by
+ commands such as <code class="Cm">gotadmin pack</code> or
+ <code class="Cm">got fetch</code> as part of regular operation. The
+ <code class="Cm">gotadmin indexpack</code> command may be used to
+ recover from a corrupt or missing index. A given pack file will always
+ yield the same bit-identical index.</p>
+ <p class="Pp">The provided <var class="Ar">packfile-path</var> must be
+ located within the <span class="Pa">objects/pack/</span> directory of
+ the repository and should end in <span class="Pa">.pack</span>. The
+ filename of the corresponding pack index is equivalent, except that it
+ ends in <span class="Pa">.idx</span>.</p>
+ </dd>
+ <dt id="ix"><a class="permalink" href="#ix"><code class="Cm">ix</code></a></dt>
+ <dd>Short alias for <code class="Cm">indexpack</code>.</dd>
+ <dt id="listpack"><a class="permalink" href="#listpack"><code class="Cm">listpack</code></a>
+ [<code class="Fl">-h</code>] [<code class="Fl">-s</code>]
+ <var class="Ar">packfile-path</var></dt>
+ <dd>List the contents of the pack file at <var class="Ar">packfile-path</var>.
+ <p class="Pp">Each object contained in the pack file will be displayed on a
+ single line. The information shown includes the object ID, object type,
+ object offset, and object size.</p>
+ <p class="Pp">If a packed object is deltified against another object the
+ delta base will be shown as well. For offset deltas, the delta base is
+ identified via an offset into the pack file. For reference deltas, the
+ delta base is identified via an object ID.</p>
+ <p class="Pp">The provided <var class="Ar">packfile-path</var> must be
+ located within the <span class="Pa">objects/pack/</span> directory of
+ the repository and should end in <span class="Pa">.pack</span>.</p>
+ <p class="Pp">The options for <code class="Cm">gotadmin listpack</code> are
+ as follows:</p>
+ <dl class="Bl-tag">
+ <dt id="h~2"><a class="permalink" href="#h~2"><code class="Fl">-h</code></a></dt>
+ <dd>Show object sizes in human-readable form.</dd>
+ <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a></dt>
+ <dd>Display statistics about the pack file after listing objects. This
+ includes the total number of objects stored in the pack file and a
+ break-down of the number of objects per object type.</dd>
+ </dl>
+ </dd>
+ <dt id="ls"><a class="permalink" href="#ls"><code class="Cm">ls</code></a></dt>
+ <dd>Short alias for <code class="Cm">listpack</code>.</dd>
+</dl>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
+ STATUS</a></h1>
+<p class="Pp">The <code class="Nm">gotadmin</code> utility exits 0 on
+ success, and >0 if an error occurs.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
+<p class="Pp"><a class="Xr">got(1)</a>, <a class="Xr">tog(1)</a>,
+ <a class="Xr">git-repository(5)</a>, <a class="Xr">got.conf(5)</a></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
+<p class="Pp"><span class="An">Stefan Sperling</span>
+ <<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>>
+ <br/>
+ <span class="An">Ori Bernstein</span>
+ <<a class="Mt" href="mailto:ori@openbsd.org">ori@openbsd.org</a>></p>
+</section>
+</div>
+<table class="foot">
+ <tr>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
+ </tr>
+</table>
+</body>
+</html>
blob - 1c83dc49da5f934c3d6bd696f4026053ffe9d339
blob + fb2b53a4939dd860ed41037cec5881fe461d84e4
--- gotweb.conf.5.html
+++ gotweb.conf.5.html
-->
<head>
<meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<style>
table.head, table.foot { width: 100%; }
td.head-rtitle, td.foot-os { text-align: right; }
owner information to be added to the <span class="Pa">config</span> file
in the repository. <a class="Xr">gotweb(8)</a> will parse owner
information from either a [gotweb] or a [gitweb] section. For example:
- <div class="Bd Pp Bd-indent">
- <pre>
-[gotweb]
-owner = "Your Name"
- </pre>
+ <div class="Bd Pp Bd-indent Li">
+ <pre>[gotweb]
+owner = "Your Name"</pre>
</div>
</dd>
<dt id="got_site_link"><a class="permalink" href="#got_site_link"><code class="Ic">got_site_link</code></a>
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">These are the currently configurable items for
<a class="Xr">gotweb(8)</a> with their default values.</p>
-<div class="Bd Pp Bd-indent">
+<div class="Bd Pp Bd-indent Li">
<pre>
-
#
# gotweb options
# all paths relative to /var/www (httpd chroot jail)
#got_show_repo_owner off
#got_show_repo_age false
#got_show_repo_description no
-#got_show_repo_cloneurl off
-</pre>
+#got_show_repo_cloneurl off</pre>
</div>
</section>
<section class="Sh">
</div>
<table class="foot">
<tr>
- <td class="foot-date">April 5, 2021</td>
- <td class="foot-os">OpenBSD 6.8</td>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
</tr>
</table>
</body>
blob - a16848f93a0eb19c316a484eb771ed310a003797
blob + 9736b245e1734f4b365fe2426b8119babcbeafed
--- sync-man.sh
+++ sync-man.sh
for f in got.1 got-worktree.5 git-repository.5; do
mandoc -T html $HOME/src/got/got/$f > ./${f}.html
done
+mandoc -T html $HOME/src/got/gotadmin/gotadmin.1 > ./gotadmin.1.html
mandoc -T html $HOME/src/got/tog/tog.1 > ./tog.1.html
for f in gotweb.8 gotweb.conf.5; do
mandoc -T html $HOME/src/got/gotweb/$f > ./${f}.html
blob - 93c43a7fd9506c91aed9d06505af5b7a4f0ef86a
blob + a3f53e55bb15eef14e2a9411ef8f3016f961d1b4
--- tog.1.html
+++ tog.1.html
-->
<head>
<meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<style>
table.head, table.foot { width: 100%; }
td.head-rtitle, td.foot-os { text-align: right; }
</div>
<table class="foot">
<tr>
- <td class="foot-date">April 5, 2021</td>
- <td class="foot-os">OpenBSD 6.8</td>
+ <td class="foot-date">June 22, 2021</td>
+ <td class="foot-os">OpenBSD 6.9</td>
</tr>
</table>
</body>
