From c967be129186c6b0f595eb5ea5683e6d47425e83 Mon Sep 17 00:00:00 2001 From: Baptiste Daroussin Date: Fri, 27 Jun 2025 11:18:36 +0200 Subject: [PATCH] delheaders: improve documentation Fixes: #68 --- TUNABLES.md | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/TUNABLES.md b/TUNABLES.md index 5be5ec63..79a8b7a3 100644 --- a/TUNABLES.md +++ b/TUNABLES.md @@ -84,12 +84,24 @@ entire content is used as value, it's marked "text". * delheaders (list) - In this file is specified *ONE* headertoken to match pr. line. If the file - consists of: - Received: - Message-ID: - Then all occurences of these headers in incoming list mail will be deleted. - "From " and "Return-Path:" are deleted no matter what. + This file specifies one header token to match per line. If the file contains + entries such as Received: and Message-ID:, then all occurrences of these + headers in incoming mail will be deleted. + + Additionally, the headers From and Return-Path: will be deleted regardless + of their presence in the list. + + **Important Note on Header Matching:** + + The header matching is based on prefixes. This means that: + + - A header token specified as X-: will match only headers that are exactly + X-. + - A header token specified as X- will match all headers that begin with the + prefix X-, including headers like X-Example, X-Header-Name, etc. + + Make sure to specify the header tokens according to these rules to ensure + the desired headers are correctly matched and deleted. * access (list) -- 2.47.2