X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-config.pod;h=ed99b188beb198a470d52ba179f1f40448261e57;hb=d07ba9c30800225052d17ccca458afbfa05a8ff0;hp=36d6bff23dc24731cd1751669a911e7a47df0784;hpb=560f9442d058925dd3a8171e8739826768188288;p=public-inbox.git diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index 36d6bff2..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. @@ -124,6 +134,14 @@ allow for searching for phrases using quoted text. Default: C +=item publicinbox..boost + +Control indexing order for L, 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..indexSequentialShard See L @@ -195,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 @@ -338,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) @@ -422,12 +464,12 @@ Used to override the default "~/.public-inbox/config" value. Feedback welcome via plain-text mail to L -The mail archives are hosted at L -and L +The mail archives are hosted at L and +L =head1 COPYRIGHT -Copyright 2016-2021 all contributors L +Copyright all contributors L License: AGPL-3.0+ L