From 658cb1162748378988f8086520e7e22eb9569bf3 Mon Sep 17 00:00:00 2001 From: Jeremy Harris Date: Sun, 21 Jun 2015 14:26:16 +0100 Subject: [PATCH] Docs: add warning on list-sep in headerss_remove --- doc/doc-docbook/spec.xfpt | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt index 0d5810977..e61bc1e6e 100644 --- a/doc/doc-docbook/spec.xfpt +++ b/doc/doc-docbook/spec.xfpt @@ -5233,7 +5233,7 @@ list items, it is not ignored when parsing the list. The space after the first colon in the example above is necessary. If it were not there, the list would be interpreted as the two items 127.0.0.1:: and 1. -.section "Changing list separators" "SECID53" +.section "Changing list separators" "SECTlistsepchange" .cindex "list separator" "changing" .cindex "IPv6" "addresses in lists" Doubling colons in IPv6 addresses is an unwelcome chore, so a mechanism was @@ -17421,6 +17421,11 @@ removal requests are deleted when the address is passed on to subsequent routers, and this can lead to problems with duplicates -- see the similar warning for &%headers_add%& above. +&*Warning 3*&: Because of the separate expansion of the list items, +items that contain a list separator must have it doubled. +To avoid this, change the list separator (&<>&). + + .option ignore_target_hosts routers "host list&!!" unset .cindex "IP address" "discarding" @@ -20477,6 +20482,10 @@ errors and cause the delivery to be deferred. Unlike most options, &%headers_remove%& can be specified multiple times for a router; all listed headers are removed. +&*Warning*&: Because of the separate expansion of the list items, +items that contain a list separator must have it doubled. +To avoid this, change the list separator (&<>&). + .option headers_rewrite transports string unset -- 2.25.1