From 0e2b20d6eb0754426d021d8db1fb8db7584dd925 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Tue, 14 Nov 2023 00:32:20 +0000 Subject: config: avoid eidx_key and newsgroup conflicts Start lowercasing newsgroup names automatically since uppercase names are incompatible with IMAP and POP3 and also causes problems with both -extindex and -cindex. We'll also warn on eidx_key and newsgroup conflicts to avoid sometimes subtle breakage when using -extindex and -cindex. --- Documentation/RelNotes/v2.0.0.wip | 8 ++++++++ Documentation/public-inbox-config.pod | 5 +++++ 2 files changed, 13 insertions(+) (limited to 'Documentation') diff --git a/Documentation/RelNotes/v2.0.0.wip b/Documentation/RelNotes/v2.0.0.wip index 859d858b..5fc9ecd7 100644 --- a/Documentation/RelNotes/v2.0.0.wip +++ b/Documentation/RelNotes/v2.0.0.wip @@ -18,6 +18,14 @@ Upgrading: backwards-incompatible data format changes so rolling back to older versions is harmless. +Compatibility: + + Uppercase newsgroup names were always broken with IMAP, POP3, and + -extindex. Uppercase names will now be lowercased by default and + warnings will be emitted. Conflicting newsgroup names (and `inboxdir' + entries if `newsgroup' isn't specified) will also generate warnings + since it breaks -extindex and the new -cindex (coderepo index) + treewide * support raw UTF-8 headers from SMTPUTF8 hosts diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index 1ef7f46f..d394d31f 100644 --- a/Documentation/public-inbox-config.pod +++ b/Documentation/public-inbox-config.pod @@ -74,6 +74,11 @@ Omitting this for a given inbox will prevent the inbox from being served by L, L, and/or L +Newsgroup names should be all lowercase. Uppercase characters are +converted to lowercase for compatibility with IMAP, POP3, and our +L and L tools +starting with public-inbox 2.0+ (they were unusable before). + Default: none, optional =item publicinbox..watch -- cgit v1.2.3-24-ge0c7