summary refs log tree commit diff
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--README.767
1 files changed, 57 insertions, 10 deletions
diff --git a/README.7 b/README.7
index 95d9715..cd6ac64 100644
--- a/README.7
+++ b/README.7
@@ -1,4 +1,4 @@
-.Dd December  9, 2020
+.Dd March  2, 2021
 .Dt README 7
 .Os "Causal Agency"
 .
@@ -8,20 +8,63 @@
 .
 .Sh DESCRIPTION
 .Xr bubger 1
-is a static file HTML/Atom/mboxrd
-archive generator
-for IMAP mailboxes.
+is a mailing list archive generator
+for mail stored in IMAP.
+It produces static files of
+HTML, Atom and mboxrd,
+making its output easy to serve
+from a host without IMAP access.
+It requires the IMAP SORT and THREAD extensions.
 .
 .Pp
-An example of its output can be seen at
-.Aq Lk https://causal.agency/list/ .
+An example of its output
+can be seen at
+.Lk https://causal.agency/list/ .
 .
 .Sh INSTALLING
 .Nm bubger
-targets
-.Fx
-and requires LibreSSL
-.Pq Fl ltls .
+requires
+.Sy libtls ,
+provided by either
+.Lk https://git.causal.agency/libretls/about LibreTLS
+(for OpenSSL)
+or by LibreSSL.
+It targets
+.Fx .
+.
+.Bd -literal -offset indent
+\&./configure
+make all
+sudo make install
+.Ed
+.
+.Sh DEPLOYMENT
+.Xr bubger 1
+can be run either by
+.Xr cron 8
+or under a process supervisor
+such as
+.Lk https://git.causal.agency/catsit/about catsit .
+The files required to serve the archive are
+.Pa index.* message/ thread/ attachment/ .
+.
+.Pp
+Under
+.Xr cron 8 ,
+the exit status of
+.Xr bubger 1
+with the
+.Fl q
+flag can be used
+to determine if
+the archive was updated.
+Under a process supervisor
+with the
+.Fl i
+flag,
+writes to
+.Pa UIDNEXT
+indicate when the archive is updated.
 .
 .Sh FILES
 .Bl -tag -width "getservinfo.c" -compact
@@ -63,5 +106,9 @@ Contributions in any form can be sent to
 For sending patches by email, see
 .Aq Lk https://git-send-email.io .
 .
+.Pp
+Monetary contributions can be
+.Lk https://liberapay.com/june/donate "donated via Liberapay" .
+.
 .Sh SEE ALSO
 .Xr bubger 1
r class='nohover-highlight'> 2021-09-23Add The HobbitJune McEnroe Surprisingly good for something written by a man like a hundred years ago! 2021-09-22Remove PSF fontsJune McEnroe They were fun to make but I never actually used them. 2021-09-22Remove Linux-specific utilitiesJune McEnroe I haven't used these in ages. 2021-09-22Call sandbox in CGI modeJune McEnroe Otherwise upload won't actually work. 2021-09-22Support HTTP PUT in upJune McEnroe For use by Palaver[1]. Unfortunately, at least in the current App Store version of Palaver, this doesn't work correctly with basic auth. [1]: https://palaverapp.com/guides/commands/set.html#ui-image_service 2021-09-22Remove default faviconJune McEnroe I hate these things and also this one sucks. 2021-09-21Use Z_FILTERED strategyJune McEnroe 2021-09-21Recalculate various lengths only as neededJune McEnroe This actually speeds things up quite a bit, saving roughly a second on a big PNG screenshot. Almost all the remaining time is spent in deflate. 2021-09-21Rewrite pngo, add explicit optionsJune McEnroe Interesting to see how my code habits have changed. 2021-09-16Fix /* **/ comment matchingJune McEnroe 2021-09-15Remove typer, add downgrade to READMEJune McEnroe 2021-09-15Set bot mode on downgradeJune McEnroe 2021-09-15Enter capsicum in downgradeJune McEnroe 2021-09-15Factor out common parts of downgrade messagesJune McEnroe Also bump the message cap to 1024 because that is ostensibly useful for replying to older messages. 2021-09-14Add downgrade IRC botJune McEnroe 2021-09-14Sort by title if authors matchJune McEnroe There are probably better things to sort by but title definitely always exists. 2021-09-13Swap-remove tags as they're foundJune McEnroe This makes it even faster. From ~1s on a sqlite3.c amalgamation to ~0.85s. 2021-09-12Replace htagml regex with strncmpJune McEnroe Since ctags only ever produces regular expressions of the form /^re$/ or /^re/ with no other special characters, instead unescape the pattern and simply use strncmp. Running on a sqlite3.c amalgamation, the regex version takes ~37s while the strncmp version takes ~1s, producing identical output. Big win! 2021-09-11Also defer printing comment for lone close-parensJune McEnroe 2021-09-10Publish "git-comment"June McEnroe 2021-09-10Add git comment --pretty optionJune McEnroe 2021-09-08Defer printing comment if line is blank or closing braceJune McEnroe This fixes badly indented comments. 2021-09-08Up default min-repeat to 30 linesJune McEnroe 2021-09-08Handle dirty lines in git-commentJune McEnroe 2021-09-08Document and install git-commentJune McEnroe 2021-09-08Add repeat and all options to git-commentJune McEnroe 2021-09-08Add group threshold to git-commentJune McEnroe