Fix support of $spam_ variables at delivery time. Bug 1647

[users/jgh/exim.git] / doc / doc-docbook / spec.xfpt

diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index fefc8e3f3353278ffe5943678890edf3cae5d3ea..6c3d155d95598898d944d4b09569174643e118a5 100644 (file)
--- 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.
 
 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
 .cindex "list separator" "changing"
 .cindex "IPv6" "addresses in lists"
 Doubling colons in IPv6 addresses is an unwelcome chore, so a mechanism was


@@ -11746,7 +11746,7 @@ It will be empty if &(DNSSEC)& was not requested,
 &"no"& if the result was not labelled as authenticated data
 and &"yes"& if it was.
 Results that are labelled as authoritive answer that match
 &"no"& if the result was not labelled as authenticated data
 and &"yes"& if it was.
 Results that are labelled as authoritive answer that match

-the $%dns_trust_aa%& configuration variable count also
+the $%dns_trust_aa%$ configuration variable count also

 as authenticated data.
 
 .vitem &$mailstore_basename$&
 as authenticated data.
 
 .vitem &$mailstore_basename$&


@@ -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.
 
 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"
 
 .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.
 
 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
 
 
 .option headers_rewrite transports string unset


@@ -31187,7 +31196,11 @@ it always return &"true"& by appending &`:true`& to the username.
 
 .cindex "spam scanning" "returned variables"
 When the &%spam%& condition is run, it sets up a number of expansion
 
 .cindex "spam scanning" "returned variables"
 When the &%spam%& condition is run, it sets up a number of expansion

-variables. These variables are saved with the received message, thus they are
+variables.
+.new
+Except for &$spam_report$&,
+.wen
+these variables are saved with the received message so are

 available for use at delivery time.
 
 .vlist
 available for use at delivery time.
 
 .vlist


@@ -31210,6 +31223,9 @@ headers, since MUAs can match on such strings.
 .vitem &$spam_report$&
 A multiline text table, containing the full SpamAssassin report for the
 message. Useful for inclusion in headers or reject messages.
 .vitem &$spam_report$&
 A multiline text table, containing the full SpamAssassin report for the
 message. Useful for inclusion in headers or reject messages.

+.new
+This variable is only usable in a DATA-time ACL.
+.wen

 
 .new
 .vitem &$spam_action$&
 
 .new
 .vitem &$spam_action$&