From 66a05050214a503e66a0e42c977fad755e2f574c Mon Sep 17 00:00:00 2001 From: "C. McEnroe" Date: Sat, 21 Dec 2019 07:08:49 -0500 Subject: Rewrite aspirational manual --- imbox.1 | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++------------- 1 file 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 . -- cgit 1.4.1 RTY.bundle/Contents?id=85e2488ae23a478b2a1d7d025063535f5b770796&showmsg=1&follow=1'>Contents/Resources/CodeQWERTY.keylayout (unfollow)
Commit message (Collapse)Author
2021-01-13Fix C lexer to require a digit in a float literalJune McEnroe
Otherwise ".l" is matched as Number.
2021-01-13Support long double in c.shJune McEnroe
2021-01-13Update Terminal.app coloursJune McEnroe
God what is this garbage I only changed one colour.
2021-01-13Increase dark white brightness slightlyJune McEnroe
2021-01-13Add hilex example to htagml manualJune McEnroe
2021-01-12Style causal.agency like bin HTMLJune McEnroe
2021-01-12Avoid matching tag text inside HTML elementsJune McEnroe
2021-01-12Use hilex for up -hJune McEnroe
2021-01-12Use hilex for bin HTMLJune McEnroe
2021-01-12Don't output a pre in hilex by defaultJune McEnroe
2021-01-12Move hilex out of hilex directoryJune McEnroe
2021-01-12Consolidate hilex formatters into hilex.cJune McEnroe
2021-01-12Remove hacky tagging from hilexJune McEnroe
God that makes the lexers so much simpler.
2021-01-12Add htagml -iJune McEnroe
2021-01-12Render tag index in HTMLJune McEnroe
2021-01-12Add htagml -xJune McEnroe
2021-01-12Prevent matching the same tag twiceJune McEnroe
2021-01-12Process htagml file line by lineJune McEnroe
This simplifies some things, adds support for line number tag definitions, and should enable combining htagml with other preprocessors in the future.
2021-01-12Split fields by tab onlyJune McEnroe
Also don't fail hard on non-forward-search definitions.
2021-01-12List both Makefile and html.sh under README.7June McEnroe
2021-01-12Add htagml exampleJune McEnroe
2021-01-12Use mandoc and htagml for bin htmlJune McEnroe
2021-01-12Add htagmlJune McEnroe
2021-01-12Replace causal.agency with a simple mdoc pageJune McEnroe
2021-01-11Publish "Using vi"June McEnroe
2021-01-11Enable diff.colorMovedJune McEnroe
2021-01-10Set less search case-insensitiveJune McEnroe
2021-01-10Set EXINITJune McEnroe
neovim is laggy as hell in my OpenBSD VM, so I switched to vi so I could type without getting frustrated.
2021-01-09Add c -t flag to print expression typeJune McEnroe
Also add missing float case.
2021-01-05Update taglineJune McEnroe