[exim-dev] [Bug 2719] New: ch-domain_host_address_and_local…

Top Page
Delete this message
Reply to this message
Author: admin
Date:  
To: exim-dev
Subject: [exim-dev] [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@???
          Reporter: u34@???
                CC: exim-dev@???


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.