summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKonstantin Ryabitsev <konstantin@linuxfoundation.org>2021-08-18 14:52:58 -0400
committerKonstantin Ryabitsev <konstantin@linuxfoundation.org>2021-08-18 14:52:58 -0400
commit7192223d35cff1e5fab28dfc54a8b6a3b778bad4 (patch)
treed500067e31e13ad2e3d91cec4dda5124ae351256
parent6e2a06aa4ab1f7909f5c3cba4e8552d5f1627d43 (diff)
downloadb4-7192223d35cff1e5fab28dfc54a8b6a3b778bad4.tar.gz
Document listid-preference config parameter
When we query /all/, we often get duplicates if a message was crossposted to multiple lists and some of those lists altered the message subject/body (e.g. legacy mailman, groups.io, etc). The listid-preference parameter allows us to dedupe based on lists that are least likely to mangle the messages. Signed-off-by: Konstantin Ryabitsev <konstantin@linuxfoundation.org>
-rw-r--r--man/b4.57
-rw-r--r--man/b4.5.rst7
2 files changed, 14 insertions, 0 deletions
diff --git a/man/b4.5 b/man/b4.5
index 8270dee..de44247 100644
--- a/man/b4.5
+++ b/man/b4.5
@@ -381,6 +381,13 @@ Default configuration, with explanations:
# When recording Link: trailers, use this mask
linkmask = https://lore.kernel.org/r/%s
#
+ # When duplicate messages exist, use the following order to decide
+ # which list\-id is likely to have the least mangled version. Default
+ # preference is listed below, in the order of lists most likely to
+ # preserve proper DKIM validation. Use shell\-style globbing and
+ # separate multiple entries with commas. Must end with ,*
+ listid\-preference = *.feeds.kernel.org,*.linux.dev,*.kernel.org,*
+ #
# Set to "yes" to save maildirs instead of mailboxes
# This will help avoid mboxo/mboxrd format inconsistencies between
# public\-inbox, python, and git
diff --git a/man/b4.5.rst b/man/b4.5.rst
index 2217cfd..997b947 100644
--- a/man/b4.5.rst
+++ b/man/b4.5.rst
@@ -242,6 +242,13 @@ Default configuration, with explanations::
# When recording Link: trailers, use this mask
linkmask = https://lore.kernel.org/r/%s
#
+ # When duplicate messages exist, use the following order to decide
+ # which list-id is likely to have the least mangled version. Default
+ # preference is listed below, in the order of lists most likely to
+ # preserve proper DKIM validation. Use shell-style globbing and
+ # separate multiple entries with commas. Must end with ,*
+ listid-preference = *.feeds.kernel.org,*.linux.dev,*.kernel.org,*
+ #
# Set to "yes" to save maildirs instead of mailboxes
# This will help avoid mboxo/mboxrd format inconsistencies between
# public-inbox, python, and git