Docs: add warning on list-sep in headerss_remove
authorJeremy Harris <jgh146exb@wizmail.org>
Sun, 21 Jun 2015 13:26:16 +0000 (14:26 +0100)
committerJeremy Harris <jgh146exb@wizmail.org>
Sun, 21 Jun 2015 13:26:16 +0000 (14:26 +0100)
doc/doc-docbook/spec.xfpt

index 0d58109..e61bc1e 100644 (file)
@@ -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 (&<<SECTlistsepchange>>&).
+
+
 
 .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 (&<<SECTlistsepchange>>&).
+
 
 
 .option headers_rewrite transports string unset