.Dd March  8, 2021
.Dt README 7
.Os "Causal Agency"
.
.Sh NAME
.Nm bubger kirg
.Nd have it in a way
.
.Sh DESCRIPTION
.Xr bubger 1
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 THREAD extension.
.
.Pp
An example of its output
can be seen at
.Lk https://causal.agency/list/ .
.
.Sh INSTALLING
.Nm bubger
requires
.Sy libtls ,
provided by either
.Lk https://git.causal.agency/libretls/about LibreTLS
(for OpenSSL)
or by LibreSSL.
It targets
.Fx ,
.Ox ,
macOS and Linux.
On
.Ox ,
it additionally requires
.Sy libiconv .
.
.Bd -literal -offset indent
\&./configure
make all
sudo make install
.Ed
.
.Sh FILES
.Bl -tag -width "getservinfo.c" -compact
.It Pa archive.h
data structures and inline functions
.It Pa archive.c
main control flow
.It Pa imap.h
IMAP data structures
.It Pa imap.c
IMAP parsing
.It Pa parse.c
message structure parsing
.It Pa decode.c
content transfer decoding
.It Pa template.c
string templating and escaping
.It Pa atom.c
Atom feed generation
.It Pa html.c
HTML generation
.It Pa mbox.c
mbox generation
.It Pa export.c
message export
.It Pa concat.c
thread concatenation
.It Pa getservinfo.c
SRV record lookup
.It Pa stylesheet.c
default stylesheet
.El
.
.Sh CONTRIBUTING
The upstream URL of this project is
.Aq Lk https://git.causal.agency/bubger .
Contributions in any form can be sent to
.Aq Mt list+bubger@causal.agency .
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
.Rs
.%A June McEnroe
.%T Mailing List
.%U https://text.causal.agency/019-mailing-list.txt
.%D March 4, 2021
.Re