Bug#653750: spec.txt uses relay_domains in an inaccurate manner

[Regid Ichira]

package:  exim4-base
version:  4.77-1+b1
severity: normal
file:     /usr/share/doc/exim4-base/spec.txt.gz
tags:     patch

  referring to the patch below:
1. I think the patch for line 5243 is obvious.  There is no
   definition for relay_domains in the declarations section above
   that line.  On the other hand, there is a definition for
   relay_to_domains.  And that is exactly the case in
   /usr/share/doc/exim4-base/examples/example.conf.gz: no
   relay_domains, only relay_to_domains.
2. As for the rest of the patch, I think it is clearer:
   2.1 The default Debian configuration, presumably following the
       default example.conf, uses relay_to_domains.  And not
       relay_domains.  Was this in order to distinguish between
       domains that receive some mail through our server, and domains
       that send some mail through our server?
   2.2 The explanation above line 26524 gives an example of relaying
       due to acting as secondary MX record.  Which usually means
       relaying to the host, as opposed to relaying due to being some
       sort of a gateway.

--- spec.txt    2011-12-30 06:15:49.000000000 +0200
+++ spec.txt.mod        2011-12-30 06:11:39.000000000 +0200
@@ -5243,7 +5243,7 @@ examples described in 7.7. This means th
 until you complete the authenticator definitions.

 require message = relay not permitted
-        domains = +local_domains : +relay_domains
+        domains = +local_domains : +relay_to_domains

 This statement rejects the address if its domain is neither a local domain nor
 one of the domains for which this host is a relay.
@@ -26524,14 +26524,14 @@ suppose you want to do the following:
 In the main part of the configuration, you put the following definitions:

 domainlist local_domains = my.dom1.example : my.dom2.example
-domainlist relay_domains = friend1.example : friend2.example
+domainlist relay_to_domains = friend1.example : friend2.example
 hostlist   relay_hosts   = 192.168.45.0/24

 Now you can use these definitions in the ACL that is run for every RCPT
 command:

 acl_check_rcpt:
-  accept domains = +local_domains : +relay_domains
+  accept domains = +local_domains : +relay_to_domains
   accept hosts   = +relay_hosts

 The first statement accepts any RCPT command that contains an address in the