user/dev discussion of public-inbox itself
 help / color / Atom feed
* [PATCH] doc: explain publicinbox.<name>.watchheader
@ 2019-10-09 13:21 Alyssa Ross
  2019-10-10  8:51 ` Eric Wong
  0 siblings, 1 reply; 2+ messages in thread
From: Alyssa Ross @ 2019-10-09 13:21 UTC (permalink / raw)
  To: meta; +Cc: Alyssa Ross

It wasn't clear to me exactly what this does -- in particular, what
happens if it isn't specified?  Does it support multiple values?  A
very brief explanation can answer both of these questions without
making somebody look at the code.
---
The part about it not supporting multiple values is my best guess
based on a quick glance at the code -- I may well have missed
something.

 Documentation/public-inbox-config.pod | 3 +++
 Documentation/public-inbox-watch.pod  | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod
index 4e8ba4d..8d545f7 100644
--- a/Documentation/public-inbox-config.pod
+++ b/Documentation/public-inbox-config.pod
@@ -80,6 +80,9 @@ Default: none; only for L<public-inbox-watch(1)> users
 	[publicinbox "test"]
 		watchheader = List-Id:<test.example.com>
 
+If specified, L<public-inbox-watch(1)> will only process mail matching
+the given header.  Multiple values are not currently supported.
+
 Default: none; only for L<public-inbox-watch(1)> users
 
 =item publicinbox.<name>.nntpmirror
diff --git a/Documentation/public-inbox-watch.pod b/Documentation/public-inbox-watch.pod
index 3f282f0..198c170 100644
--- a/Documentation/public-inbox-watch.pod
+++ b/Documentation/public-inbox-watch.pod
@@ -15,7 +15,11 @@ In ~/.public-inbox/config:
 		mainrepo = /path/to/test.example.com.git
 
 		; config keys specific to public-inbox-watch:
+
 		watch = maildir:/path/to/maildirs/.INBOX.test/
+
+		; optional, emails that don't have a header matching
+		; value will be skipped
 		watchheader = List-Id:<test.example.com>
 
 	[publicinboxwatch]
-- 
2.23.0


^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] doc: explain publicinbox.<name>.watchheader
  2019-10-09 13:21 [PATCH] doc: explain publicinbox.<name>.watchheader Alyssa Ross
@ 2019-10-10  8:51 ` Eric Wong
  0 siblings, 0 replies; 2+ messages in thread
From: Eric Wong @ 2019-10-10  8:51 UTC (permalink / raw)
  To: Alyssa Ross; +Cc: meta

Alyssa Ross <hi@alyssa.is> wrote:
> It wasn't clear to me exactly what this does -- in particular, what
> happens if it isn't specified?  Does it support multiple values?  A
> very brief explanation can answer both of these questions without
> making somebody look at the code.

Thanks, applied and pushed.

> ---
> The part about it not supporting multiple values is my best guess
> based on a quick glance at the code -- I may well have missed
> something.

That's correct.  I think a single value here is fine.
If it supported multiple values, it would be confusing as
to whether it needs to match all the headers, or if matching
any one header would put it into an inbox.

And I also question the need for either case...

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, back to index

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-10-09 13:21 [PATCH] doc: explain publicinbox.<name>.watchheader Alyssa Ross
2019-10-10  8:51 ` Eric Wong

user/dev discussion of public-inbox itself

Archives are clonable:
	git clone --mirror https://public-inbox.org/meta
	git clone --mirror http://czquwvybam4bgbro.onion/meta
	git clone --mirror http://hjrcffqmbrq6wope.onion/meta
	git clone --mirror http://ou63pmih66umazou.onion/meta

Example config snippet for mirrors

Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.mail.public-inbox.meta
	nntp://ou63pmih66umazou.onion/inbox.comp.mail.public-inbox.meta
	nntp://czquwvybam4bgbro.onion/inbox.comp.mail.public-inbox.meta
	nntp://hjrcffqmbrq6wope.onion/inbox.comp.mail.public-inbox.meta
	nntp://news.gmane.org/gmane.mail.public-inbox.general

 note: .onion URLs require Tor: https://www.torproject.org/

AGPL code for this site: git clone https://public-inbox.org/ public-inbox