Rewrite aspirational manual

1 files changed, 61 insertions, 15 deletions

diff --git a/imbox.1 b/imbox.1
index 791c996..c91abd8 100644
--- a/imbox.1
+++ b/imbox.1
@@ -1,4 +1,4 @@
-.Dd December 20, 2019
+.Dd December 21, 2019
 .Dt IMBOX 1
 .Os
 .
@@ -9,10 +9,13 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl vw
+.Op Fl C Ar cc
+.Op Fl F Ar from
+.Op Fl S Ar subject
+.Op Fl T Ar to
 .Op Fl h Ar host
 .Op Fl m Ar mailbox
 .Op Fl p Ar port
-.Op Fl s Ar search
 .Ar user
 .
 .Sh DESCRIPTION
@@ -20,6 +23,14 @@ The
 .Nm
 utility exports messages from an IMAP mailbox
 to the mboxrd format on standard output.
+Messages matching the criteria set by
+.Fl CFST
+are exported.
+The default criterion is
+.Fl S Cm '[PATCH' .
+.
+.Pp
+IMAP over TLS without STARTTLS is assumed.
 IMAP login is performed as
 .Ar user
 with a password read from
@@ -31,12 +42,32 @@ is used.
 .Pp
 The arguments are as follows:
 .Bl -tag -width Ds
+.It Fl C Ar cc
+Export messages with matching
+.Cm Cc
+headers.
+.
+.It Fl F Ar from
+Export messages with matching
+.Cm From
+headers.
+.
+.It Fl S Ar subject
+Export messages with matching
+.Cm Subject
+headers.
+.
+.It Fl T Ar to
+Export messages with matching
+.Cm To
+headers.
+.
 .It Fl h Ar host
-Connect to
+Connect to IMAP on
 .Ar host .
-The default host is
-.Li imap.fastmail.com .
-TLS without STARTTLS is assumed.
+The default host is determined by SRV record lookup
+on the domain name of
+.Ar user .
 .
 .It Fl m Ar mailbox
 Export messages from
@@ -44,21 +75,22 @@ Export messages from
 The default mailbox is INBOX.
 .
 .It Fl p Ar port
-Connect to
+Connect to IMAP on
 .Ar port .
-The default port is 993.
-.
-.It Fl s Ar search
-Export messages matching
-.Ar search .
-The default search is
-.Ql SUBJECT \(dq[PATCH\(dq .
+If the
+.Fl h
+option is used,
+the default port is
+.Cm imaps
+(993).
+Otherwise,
+the port is determined in the same fashion as the host.
 .
 .It Fl v
 Log IMAP protocol to standard error.
 .
 .It Fl w
-Read the IMAP password from standard input.
+Read the password from standard input.
 .El
 .
 .Sh EXAMPLES
@@ -66,6 +98,9 @@ Read the IMAP password from standard input.
 imbox june@causal.agency | git am
 .Ed
 .
+.Sh SEE ALSO
+.Xr git-am 1
+.
 .Sh STANDARDS
 .Bl -item
 .It
@@ -88,3 +123,14 @@ imbox june@causal.agency | git am
 .%U https://tools.ietf.org/html/rfc4155
 .Re
 .El
+.
+.Sh AUTHORS
+.An June Bug Aq Mt june@causal.agency
+.
+.Sh BUGS
+Send mail to
+.Aq Mt june@causal.agency
+or join
+.Li #ascii.town
+on
+.Li chat.freenode.net .