From 218bfc40d6873dfe45fe177455491b3090b49f22 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Tue, 30 Jan 2024 06:31:09 +0000 Subject: watch: support incremental updates from MH The good news (compared to lei) is we only have to worry about imports and don't care about the filename nor keywords, so it's immune to .mh_sequences writing inconsistencies across MH implementations and sequence number packing. We still assume the writer will write the mail file with one of: * rename(2) to create the final sequence number filename * a single write(2) if not relying on rename(2) mlmmj and mutt satisfy these requirements. Python's Lib/mailbox.py may, I'm not sure... --- Documentation/public-inbox-watch.pod | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'Documentation') diff --git a/Documentation/public-inbox-watch.pod b/Documentation/public-inbox-watch.pod index 6f812966..6e2142fe 100644 --- a/Documentation/public-inbox-watch.pod +++ b/Documentation/public-inbox-watch.pod @@ -48,9 +48,11 @@ of large Maildirs. Upon startup, it scans the mailbox for new messages to be imported while it was not running. -As of public-inbox 1.6.0, Maildirs, IMAP folders, and NNTP -newsgroups are supported. Previous versions of public-inbox -only supported Maildirs. +All versions of public-inbox-watch support Maildirs. public-inbox +1.6.0 added support for IMAP folders and NNTP newsgroups. +public-inbox 2.0 adds support for MH directories. There are no +plans to support the mbox family since new messages are expensive +to detect in large mboxes. public-inbox-watch should be run inside a L session or as a L service. Errors are emitted to stderr. @@ -84,12 +86,16 @@ C and C URLs: watch = nntp://news.example.com/inbox.test.group watch = imaps://user@mail.example.com/INBOX.test +2.0+ supports MH: + + watch = mh:/path/to/MH/inbox.test + This may be specified multiple times to combine several mailboxes into a single public-inbox. URLs requiring authentication will require L and/or L (preferred) to fill in the username and password. -public-inbox 2.0+ supports boolean C to prevent the global +public-inbox 2.0+ also supports boolean C to prevent the global L directive from writing to the inbox. Default: none @@ -127,7 +133,7 @@ Messages without the (S)een flag are not considered for hiding. This hiding affects all configured public-inboxes in PI_CONFIG. As with C, C and C URLs -are supported in public-inbox 1.6.0+. +are supported in public-inbox 1.6.0+, and C in 2.0+. Default: none; only for L users -- cgit v1.2.3-24-ge0c7