From: Phil Pennock <pdp@exim.org>
Date: Sat, 2 Jun 2012 21:43:19 +0000 (-0400)
Subject: Docs: pipes in redirect, need for quote caution
X-Git-Tag: exim-4_81_RC1~93
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=79c1c45de15ec0a5a06648faf5f478c351465127;p=exim.git

Docs: pipes in redirect, need for quote caution
---

diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index d370cbc3f..3c5f5bd11 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -18417,6 +18417,18 @@ quote just the command. An item such as
 .endd
 is interpreted as a pipe with a rather strange command name, and no arguments.
 
+.new
+Note that the above example assumes that the text comes from a lookup source
+of some sort, so that the quotes are part of the data.  If composing a
+redirect router with a &%data%& option directly specifying this command, the
+quotes will be used by the configuration parser to define the extent of one
+string, but will not be passed down into the redirect router itself.  There
+are two main approaches to get around this: escape quotes to be part of the
+data itself, or avoid using this mechanism and instead create a custom
+transport with the &%command%& option set and reference that transport from
+an &%accept%& router.
+.wen
+
 .next
 .cindex "file" "in redirection list"
 .cindex "address redirection" "to file"