=item publicinbox.<name>.newsgroup
-The NNTP group name for use with L<public-inbox-nntpd(8)>. This
-may be any newsgroup name with hierarchies delimited by '.'.
+The NNTP group name for use with L<public-inbox-nntpd(1)>. This
+may be any newsgroup name with hierarchies delimited by C<.>.
For example, the newsgroup for L<mailto:meta@public-inbox.org>
is: C<inbox.comp.mail.public-inbox.meta>
-Omitting this for the given inbox will prevent the group from
-being read by L<public-inbox-nntpd(1)>
+It also configures the folder hierarchy used by L<public-inbox-imapd(1)>.
+
+Omitting this for a given inbox will prevent the inbox from
+being served by L<public-inbox-nntpd(1)> and/or L<public-inbox-imapd(1)>.
Default: none, optional
=item publicinbox.<name>.watch
-A location for L<public-inbox-watch(1)> to watch. Currently,
-only C<maildir:> paths are supported:
-
- [publicinbox "test"]
- watch = maildir:/path/to/maildirs/.INBOX.test/
-
-Default: none; only for L<public-inbox-watch(1)> users
+See L<public-inbox-watch(1)>
=item publicinbox.<name>.watchheader
- [publicinbox "test"]
- watchheader = List-Id:<test.example.com>
-
-If specified, L<public-inbox-watch(1)> will only process mail
-matching the given header. If specified multiple times in
-public-inbox 1.5 or later, mail will be processed if it matches
-any of the values. Only the last value was used in public-inbox
-1.4 and earlier.
-
-Default: none; only for L<public-inbox-watch(1)> users
+See L<public-inbox-watch(1)>
=item publicinbox.<name>.listid
Default: none
+=item publicinbox.<name>.imapmirror
+
+This may be the full IMAP URL of an independently-run IMAP mirror.
+
+Default: none
+
=item publicinbox.<name>.nntpmirror
This may be the full NNTP URL of an independently-run mirror.
Default: C<full>
+=item publicinbox.<name>.boost
+
+Control indexing order for L<public-inbox-extindex(1)>, with ties
+broken by config file order. This only affects indexing and does
+not affect messages which are already indexed.
+
+Default: C<0>
+
+=item publicinbox.<name>.indexSequentialShard
+
+See L<public-inbox-index(1)/publicInbox.indexSequentialShard>
+
=item publicinbox.<name>.httpbackendmax
If a digit, the maximum number of parallel
=item publicinboxwatch.spamcheck
-This may be set to C<spamc> to enable the use of SpamAssassin
-L<spamc(1)> for filtering spam before it is imported into git
-history. Other spam filtering backends may be supported in
-the future.
-
-This requires L<public-inbox-watch(1)>, but affects all configured
-public-inboxes in PI_CONFIG.
-
-Default: none
+See L<public-inbox-watch(1)>
=item publicinboxwatch.watchspam
-A Maildir to watch for confirmed spam messages to appear in.
-Messages which appear in this folder with the (S)een Maildir flag
-will be hidden from all configured inboxes based on Message-ID
-and content matching.
+See L<public-inbox-watch(1)>
-Messages without the (S)een Maildir flag are not considered for hiding.
+=item publicinbox.imapserver
-Default: none; only for L<public-inbox-watch(1)> users
+Set this to point to the hostname(s) of the L<public-inbox-imapd(1)>
+instance. This is used to advertise the existence of the IMAP
+endpoint in the L<PublicInbox::WWW> HTML interface.
-=item publicinbox.nntpserver
+Default: none
-Set this to point to the hostname of the L<public-inbox-nntpd(1)>
-instance. This is used to advertise the existence of the NNTP
-endpoint in the L<PublicInbox::WWW> HTML interface.
+=item publicinbox.nntpserver
-Multiple values are allowed for instances with multiple hostnames
-or mirrors.
+Same as C<publicinbox.imapserver>, but for the hostname(s) of the
+L<public-inbox-nntpd(1)> instance.
Default: none
See L<public-inbox-edit(1)>
=item publicinbox.indexMaxSize
+=item publicinbox.indexBatchSize
+=item publicinbox.indexSequentialShard
See L<public-inbox-index(1)>
=item * match=domain
- Only show inboxes with URLs which belong to the domain of the HTTP request
-=for TODO comment
-
-support showing cgit listing
+=for comment
+TODO support showing cgit listing
=back
Default: C<match=domain>
+=item publicinbox.<name>.obfuscate
+
+Whether to obfuscate email addresses in the L<PublicInbox::WWW> HTML
+interface.
+
+Default: false
+
+=item publicinbox.noObfuscate
+
+A space-delimited list of well-known addresses and domains that should
+not be obfuscated when C<publicinbox.$NAME.obfuscate> is true (e.g.,
+C<public@example.com> and C<@example.com>). This may be specified
+more than once, in which case the values are merged.
+
+Default: none
+
+=item extindex.<name>.topdir
+
+The directory of an external index. See
+L<public-inbox-extindex(1)> for more details.
+
+=item extindex.<name>.url
+
+Identical to L</publicinbox.E<lt>nameE<gt>.url>, but for
+external indices
+
+=item extindex.<name>.coderepo
+
+Identical to L</publicinbox.E<lt>nameE<gt>.coderepo>, but for
+external indices. Code repos may be freely associated with
+any number of public inboxes and external indices.
+
=back
=head2 NAMED LIMITER (PSGI)
the default limiter.
C<RLIMIT_*> keys may be set to enforce resource limits for
-a particular limiter.
+a particular limiter (L<BSD::Resource(3pm)> is required).
Default named-limiters are prefixed with "-". Currently,
the "-cgit" named limiter is reserved for instances spawning
Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
-The mail archives are hosted at L<https://public-inbox.org/meta/>
-and L<http://hjrcffqmbrq6wope.onion/meta/>
+The mail archives are hosted at L<https://public-inbox.org/meta/> and
+L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
=head1 COPYRIGHT
-Copyright 2016-2020 all contributors L<mailto:meta@public-inbox.org>
+Copyright 2016-2021 all contributors L<mailto:meta@public-inbox.org>
License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>