about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2019-12-21 15:08:02 -0500
committerJune McEnroe <june@causal.agency>2019-12-21 15:08:02 -0500
commit78ab311c5e2259f5d7e3e3db008d686f463940e1 (patch)
tree46d963cefaacc5a3693f293e338c87c39190af13
parentAdd copyright header to git-fetch-email (diff)
downloadimbox-78ab311c5e2259f5d7e3e3db008d686f463940e1.tar.gz
imbox-78ab311c5e2259f5d7e3e3db008d686f463940e1.zip
Add README
-rw-r--r--README.748
-rw-r--r--imbox.12
2 files changed, 49 insertions, 1 deletions
diff --git a/README.7 b/README.7
new file mode 100644
index 0000000..8e1407a
--- /dev/null
+++ b/README.7
@@ -0,0 +1,48 @@
+.Dd December 21, 2019
+.Dt README 7
+.Os "Causal Agency"
+.
+.Sh NAME
+.Nm imbox
+.Nd IMAP to mbox
+.
+.Sh DESCRIPTION
+.Nm
+is a small TLS-only IMAP client
+intended for fetching git patches.
+It requires LibreSSL
+.Pq Fl ltls
+and either
+.Xr dig 1
+or
+.Xr drill 1
+for automatic IMAP server configuration.
+.
+.Pp
+Build configuration can be written to
+.Pa config.mk .
+The install prefix of LibreSSL is set by
+.Va LIBRESSL_PREFIX .
+The path of
+.Xr dig 1
+can be set by defining the C preprocessor macro
+.Va DIG_PATH .
+The default is
+.Pa /usr/bin/drill
+on
+.Fx
+and
+.Pa dig
+everywhere else.
+.
+.Sh CONTRIBUTING
+The upstream URL of this project is
+.Aq Lk https://git.causal.agency/imbox .
+I'm happy to receive contributions in any form at
+.Aq Mt june@causal.agency .
+For sending patches by email, see
+.Aq Lk https://git-send-email.io .
+.
+.Sh SEE ALSO
+.Xr git-fetch-email 1 ,
+.Xr imbox 1
diff --git a/imbox.1 b/imbox.1
index b1ae5d7..f3a5905 100644
--- a/imbox.1
+++ b/imbox.1
@@ -4,7 +4,7 @@
 .
 .Sh NAME
 .Nm imbox
-.Nd IMAP to mboxrd
+.Nd IMAP to mbox
 .
 .Sh SYNOPSIS
 .Nm