X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-config.pod;h=a5bc67fd63289f69f3fce69a8218db23371bd884;hb=96a5e841a169166457d9cf485e27a0d6cbe7ed75;hp=f8edf6f6b1c8b3e9048cbd85a8bcc4152761ad84;hpb=165eabbffd15866f581ca374cb37fbf3c07989a5;p=public-inbox.git diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index f8edf6f6..a5bc67fd 100644 --- a/Documentation/public-inbox-config.pod +++ b/Documentation/public-inbox-config.pod @@ -62,13 +62,15 @@ 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. + +Omitting this for a given inbox will prevent the inbox from +being served by L and/or L. Default: none, optional @@ -98,6 +100,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 +132,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,14 +211,18 @@ 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 @@ -322,6 +342,22 @@ always contain all git repos used by the inbox at C<$INBOX_URL> Default: C +=item publicinbox..obfuscate + +Whether to obfuscate email addresses in the L HTML +interface. + +Default: false + +=item publicinbox.noObfuscate + +A space-delimited list of well-known addresses and domains that should +not be obfuscated when C is true (e.g., +C and C<@example.com>). This may be specified +more than once, in which case the values are merged. + +Default: none + =back =head2 NAMED LIMITER (PSGI) @@ -406,8 +442,8 @@ 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