]> Sergey Matveev's repositories - public-inbox.git/commitdiff
doc: explain publicinbox.<name>.watchheader
authorAlyssa Ross <hi@alyssa.is>
Wed, 9 Oct 2019 13:21:14 +0000 (13:21 +0000)
committerEric Wong <e@80x24.org>
Thu, 10 Oct 2019 08:46:24 +0000 (08:46 +0000)
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.

Documentation/public-inbox-config.pod
Documentation/public-inbox-watch.pod

index 4e8ba4da2fc873f7a855d70fa46dc3e4e93c5714..8d545f7afa247339653b72ceb13183aa749fc70d 100644 (file)
@@ -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
index 3f282f0f1bbdc1310ebee9788ab8be5138eb6056..198c170a6951c94d5bf18e24109a13818d3dd9c7 100644 (file)
@@ -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]