commit 979858d4f961c9adc1cf394e9d682747257ab604 (patch)
Author: Alex Karle <email@example.com>
Date: Fri, 10 Sep 2021 00:25:02 -0400
doc: Document out of tree build and text-site in README
1 file changed, 15 insertions(+), 0 deletions(-)
diff --git a/README.md b/README.md
@@ -10,6 +10,20 @@ HTML via [mandoc(1)][mandoc] (managed by [make(1)][make]).
Currently hosted with OpenBSD's [httpd(8)][httpd], but any web server
should be able to serve it up.
+The Makefile to build the HTML is portable between gmake and BSD make.
+On OpenBSD, running `make obj` is recommended before running `make` to
+leverage the out-of-tree build extension (see the bit about `.OBJDIR` in
+the man page!).
+A pure ascii dump of the [mdoc(7)][mdoc] content of the www site, served
+over HTTP, HTTPS, and Gopher (by [httpd(8)][httpd] and
+Builds via [make(1)][make] at the same time as the HTML. See above for
I use a simple setup of git-daemon for anonymous (read-only) downloads,
@@ -38,3 +52,4 @@ and [my-old-man(7)][my-old-man].