From 9a6fe0aac9ef23537af6221568c28aa11a81bbb5 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sun, 15 Sep 2019 04:20:04 +0000 Subject: doc: update config manpage for "publicinbox.grokmanifest" It's a bit of an esoteric option, but maybe somebody out there can find it useful. --- Documentation/public-inbox-config.pod | 35 ++++++++++++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 3 deletions(-) diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index b86d2fe8..4e8ba4da 100644 --- a/Documentation/public-inbox-config.pod +++ b/Documentation/public-inbox-config.pod @@ -209,7 +209,7 @@ Default: 25 A comma-delimited list of listings to hide the inbox from. -Valid values are currently "www". +Valid values are currently C and C. Default: none @@ -278,7 +278,35 @@ support showing cgit listing =back -Default: 404 +Default: C<404> + +=item publicinbox.grokmanifest + +Controls the generation of a grokmirror-compatible gzipped JSON file +at the top-level of the PSGI interface. You generally do not need to +change this from the default. + +Valid values are: + +=over 8 + +=item * match=domain +- Only include inboxes with URLs which belong to the domain of +the HTTP request. This is compatible with virtual hosting where +several domains come from the same host. + +=item * all +- All inboxes are present in C, regardless of domain. +Only use this if you're serving HTTP requests in a domain-agnostic manner. + +=item * 404 +- C will only contain an empty JSON array. +This does NOT affect C<$INBOX_URL/manifest.js.gz>, which will +always contain all git repos used by the inbox at C<$INBOX_URL> + +=back + +Default: C =back @@ -376,4 +404,5 @@ License: AGPL-3.0+ L =head1 SEE ALSO L, L, L, -L, L +L, L, +L -- cgit v1.2.3-24-ge0c7