X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-config.pod;h=ed99b188beb198a470d52ba179f1f40448261e57;hb=21fcd8a37c82c1ef654d402cf592f0c9d803aa26;hp=5b86ef6cbfcd0152cb8ff41a285c28e31835fea3;hpb=5666a78ea0a34d4b8292ee335e12af1452f7fe83;p=public-inbox.git diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index 5b86ef6c..ed99b188 100644 --- a/Documentation/public-inbox-config.pod +++ b/Documentation/public-inbox-config.pod @@ -62,13 +62,17 @@ Default: none, optional =item publicinbox..newsgroup -The NNTP group name for use with L. This +The NNTP group name for use with L. This may be any newsgroup name with hierarchies delimited by C<.>. For example, the newsgroup for L is: C -Omitting this for the given inbox will prevent the group from -being read by L +It also configures the folder hierarchy used by L +as well as L + +Omitting this for a given inbox will prevent the inbox from +being served by L, +L, and/or L Default: none, optional @@ -98,6 +102,12 @@ needs to match. Default: none +=item publicinbox..imapmirror + +This may be the full IMAP URL of an independently-run IMAP mirror. + +Default: none + =item publicinbox..nntpmirror This may be the full NNTP URL of an independently-run mirror. @@ -203,17 +213,25 @@ See L See L -=item publicinbox.nntpserver +=item publicinbox.imapserver -Set this to point to the hostname of the L -instance. This is used to advertise the existence of the NNTP +Set this to point to the hostname(s) of the L +instance. This is used to advertise the existence of the IMAP endpoint in the L HTML interface. -Multiple values are allowed for instances with multiple hostnames -or mirrors. +Default: none + +=item publicinbox.nntpserver + +Same as C, but for the hostname(s) of the +L instance. Default: none +=item publicinbox.pop3state + +See L + =item publicinbox..feedmax The size of an Atom feed for the inbox. If specified more than @@ -346,6 +364,22 @@ more than once, in which case the values are merged. Default: none +=item extindex..topdir + +The directory of an external index. See +L for more details. + +=item extindex..url + +Identical to LnameE.url>, but for +external indices + +=item extindex..coderepo + +Identical to LnameE.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) @@ -435,7 +469,7 @@ L =head1 COPYRIGHT -Copyright 2016-2021 all contributors L +Copyright all contributors L License: AGPL-3.0+ L