Mailing List Archive

[Bug 2719] New: ch-domain_host_address_and_local_part_lists.html#SECTlistexpand : Referring to 6.17 and 6.18 too, not just 6.20 and 6.22
https://bugs.exim.org/show_bug.cgi?id=2719

Bug ID: 2719
Summary: ch-domain_host_address_and_local_part_lists.html#SECTl
istexpand : Referring to 6.17 and 6.18 too, not just
6.20 and 6.22
Product: Exim
Version: 4.94
Hardware: All
OS: All
Status: NEW
Severity: wishlist
Priority: medium
Component: Documentation
Assignee: unallocated@exim.org
Reporter: u34@net9.ga
CC: exim-dev@exim.org

The below patch will add

See sections 6.17 and 6.18 for more details

at the end of the opening sentence of
http://exim.org/exim-html-current/doc/html/spec_html/ch-domain_host_address_and_local_part_lists.html#SECTlistexpand
.

Rational: It is stated at
http://exim.org/exim-html-current/doc/html/spec_html/ch-file_and_database_lookups.html
that any of chapters 9-11 makes more sense if one have read the other two
first. Few lines ahead of the patched line, there are already references to
6.20 and 6.22. Perhaps to help readers about chapters 9-11 referring to each
other. I think referring to 6.17 and 6.18 is important as well.

--- doc/doc-docbook/spec.xfpt 2021-04-25 00:17:46.316286691 +0000
+++ doc/doc-docbook/spec.xfpt.mod 2021-04-25 19:56:35.806594802 +0000
@@ -8354,26 +8354,27 @@
host, email address, or local part, respectively. In the sections below, the
different types of pattern for each case are described, but first we cover
some
general facilities that apply to all four kinds of list.

Note that other parts of Exim use a &'string list'& which does not
support all the complexity available in
domain, host, address and local part lists.



.section "Expansion of lists" "SECTlistexpand"
.cindex "expansion" "of lists"
Each list is expanded as a single string before it is used.
+See sections &<<SECTstrings>>& and &<<SECID51>>& for more details.

&'Exception: the router headers_remove option, where list-item
splitting is done before string-expansion.'&

The result of
expansion must be a list, possibly containing empty items, which is split up
into separate items for matching. By default, colon is the separator
character,
but this can be varied if necessary. See sections &<<SECTlistconstruct>>& and
&<<SECTempitelis>>& for details of the list syntax; the second of these
discusses the way to specify empty list items.


If the string expansion is forced to fail, Exim behaves as if the item it is

--
You are receiving this mail because:
You are on the CC list for the bug.
--
## List details at https://lists.exim.org/mailman/listinfo/exim-dev Exim details at http://www.exim.org/ ##