[exim-cvs] Docs: pipes in redirect, need for quote caution

Gitweb: http://git.exim.org/exim.git/commitdiff/79c1c45de15ec0a5a06648faf5f478c351465127

Commit:     79c1c45de15ec0a5a06648faf5f478c351465127
Parent:     1f6d19d2743e5243b1a71302d8044ea7fa90cf89
Author:     Phil Pennock <pdp@???>
AuthorDate: Sat Jun 2 17:43:19 2012 -0400
Committer:  Phil Pennock <pdp@???>
CommitDate: Sat Jun 2 17:43:19 2012 -0400

    Docs: pipes in redirect, need for quote caution
---
 doc/doc-docbook/spec.xfpt |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index d370cbc..3c5f5bd 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"