[exim-dev] [Bug 1284] New: Minor imrovments to the descripti…

Top Page
Delete this message
Reply to this message
Author: 1284
Date:  
To: exim-dev
New-Topics: [exim-dev] [Bug 1284] Minor imrovments to the description of the format of an acl, [exim-dev] [Bug 1284] Minor imrovments to the description of the format of an acl, [exim-dev] [Bug 1284] Minor imrovments to the description of the format of an acl
Subject: [exim-dev] [Bug 1284] New: Minor imrovments to the description of the format of an acl
------- You are receiving this mail because: -------
You are on the CC list for the bug.

http://bugs.exim.org/show_bug.cgi?id=1284
           Summary: Minor imrovments to the description of the format of an
                    acl
           Product: Exim
           Version: 4.80
          Platform: Other
               URL: http://exim.org/exim-html-
                    current/doc/html/spec_html/ch42.html#SECID199
        OS/Version: All
            Status: NEW
          Severity: bug
          Priority: low
         Component: Documentation
        AssignedTo: nigel@???
        ReportedBy: regid23@???
                CC: exim-dev@???



The following patch:
1. I am not sure weather having the first acl condition be on the line that
follows the verb may not be changed in the future. The default Debian
configuration makes use of that feature. I think that hidden features
are best avoided.
2. I also moved a paragraph about the acl format to where I think it belongs.
3. And aligned the conditions vertically, as the text says it is conventional.

--- a/spec.txt    2012-08-16 05:12:03.579664107 +0300
+++ b/spec.txt    2012-08-16 05:12:01.000000000 +0300
@@ -24620,7 +24620,7 @@ provides a means of specifying an "and"
 example:


 deny  dnslists = list1.example
-dnslists = list2.example
+      dnslists = list2.example


If there are no conditions, the verb is always obeyed. Exim stops eval
uating
the conditions and modifiers when it reaches a condition that fails. W
hat
@@ -24628,6 +24628,12 @@ happens then depends on the verb (and in
all the conditions make sense at every testing point. For example, you
cannot
test a sender address in the ACL that is run for a VRFY command.

+As you can see from the example above, the conditions and modifiers ar
e
+written one to a line, with the first one possibly on the same line as
the verb, and
+subsequent ones on following lines. If you have a very long condition,
you can
+continue it onto several physical lines by the usual backslash continu
ation
+mechanism. It is conventional to align the conditions vertically.
+

42.17 ACL verbs
---------------
@@ -24753,12 +24759,6 @@ The ACL verbs are as follows:

At the end of each ACL there is an implicit unconditional deny.

-As you can see from the examples above, the conditions and modifiers a
re
-written one to a line, with the first one on the same line as the verb
, and
-subsequent ones on following lines. If you have a very long condition,
you can
-continue it onto several physical lines by the usual backslash continu
ation
-mechanism. It is conventional to align the conditions vertically.
-

42.18 ACL variables
-------------------


--
Configure bugmail: http://bugs.exim.org/userprefs.cgi?tab=email