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: [email protected]
          Reporter: [email protected]
                CC: [email protected]

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/ ##

Reply via email to