From 02b59bc3650bab684f4661f7a75b96f19c6fa87b Mon Sep 17 00:00:00 2001 From: Simon Ser Date: Tue, 11 Feb 2020 17:39:52 +0100 Subject: [PATCH] docs/cli: new page --- README.md | 2 +- docs/cli.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 43 insertions(+), 1 deletion(-) create mode 100644 docs/cli.md diff --git a/README.md b/README.md index 2146e54..f95c3f9 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ To manually specify upstream servers: go run ./cmd/koushin imaps://mail.example.org:993 smtps://mail.example.org:465 -See `-h` for more information. +See `docs/cli.md` for more information. ## Themes diff --git a/docs/cli.md b/docs/cli.md new file mode 100644 index 0000000..36964e9 --- /dev/null +++ b/docs/cli.md @@ -0,0 +1,42 @@ +# SYNOPSIS + + koushin [options...] + +# DESCRIPTION + +koushin is a simple and extensible webmail. It offers a web interface for IMAP, +SMTP and other upstream servers. + +At least one upstream IMAP server needs to be specified. The easiest way to do +so is to just specify a domain name: + + koushin example.org + +This assumes SRV DNS records are properly set up (see [RFC 6186]). + +Alternatively, one or more upstream server URLs can be specified: + + koushin imaps://mail.example.org:993 smtps://mail.example.org:465 + +The following URL schemes are supported: + +* `imaps` (IMAP with TLS), `imap+insecure` (plain IMAP) +* `smtps` (SMTP with TLS), `smtp+insecure` (plain SMTP) +* `https` (CardDAV and CalDAV over HTTPS), `http+insecure` (CardDAV and CalDAV + over plain HTTP) +* `carddavs` (CardDAV over HTTPS), `carddav+insecure` (CardDAV over plain HTTP) +* `caldavs` (CalDAV over HTTPS), `caldav+insecure` (CalDAV over plain HTTP) + +# OPTIONS + +**-theme**: default theme (default: no theme) + +**-addr**: listening address (default: ":1323") + +**-h**, **--help**: show help message and exit + +# SIGNALS + +**SIGUSR1**: reloads templates and Lua plugins + +[RFC 6186]: https://tools.ietf.org/html/rfc6186