diff options
| author | Jeremy Harris <jgh146exb@wizmail.org> | 2022-01-09 18:39:39 +0000 |
|---|---|---|
| committer | Jeremy Harris <jgh146exb@wizmail.org> | 2022-01-09 18:39:39 +0000 |
| commit | 22452ad59f031b741bfcfe26519ba11a7508ac82 (patch) | |
| tree | 40f7209f01a9b9ee0797bc49f90993f293896bf5 | |
| parent | 30a626371573c553bd3c9886b1f9f8e92a0410fd (diff) | |
Docs: more detail on lookup keys
| -rw-r--r-- | doc/doc-docbook/spec.xfpt | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt index ed5b06a2d..36ed7ca09 100644 --- a/doc/doc-docbook/spec.xfpt +++ b/doc/doc-docbook/spec.xfpt @@ -6755,6 +6755,9 @@ domains = ${lookup{$sender_host_address}lsearch{/some/file}} domains = lsearch;/some/file .endd The first uses a string expansion, the result of which must be a domain list. +.new +The key for an expansion-style lookup must be given explicitly. +.wen No strings have been specified for a successful or a failing lookup; the defaults in this case are the looked-up data and an empty string, respectively. The expansion takes place before the string is processed as a list, and the @@ -6779,6 +6782,12 @@ domain2: Any data that follows the keys is not relevant when checking that the domain matches the list item. +.new +The key for a list-style lookup is implicit, from the lookup context, if +the lookup is a single-key type (see below). +For query-style lookup types the key must be given explicitly. +.wen + It is possible, though no doubt confusing, to use both kinds of lookup at once. Consider a file containing lines like this: .code |