Bug#376459: exim4-config: issues with ACL documentation

[Marc Haber]

On Mon, Jul 03, 2006 at 08:04:22AM -0700, Ross Boylan wrote:
> How about
>    Local configuration of the mechanisms happens
>    through data files in /etc/exim4 or via exim macros that you can set
>    in /etc/exim4/conf.d/main.  You can create files with your own
>    rules to add to the existing ones and point to them by setting
>    CHECK_RCPT_LOCAL_ACL_FILE and CHECK_DATA_LOCAL_ACL_FILE,
>    so there is normally no need to change the
>    files in the acl subdirectory in a split-config setup.
> ?

I have two things that make me not like this.

(1)
Mentioning the explicit macro names will lead to people setting them
without knowing what they do and without reading the (important!)
context the macros are used in our configuration. I'd rather have
people look at the configuration itself, understand it, and see which
methods of modification we offer.

(2)
Duplicating the macro names in the docs will lead to errors should we
decide to change the names in the future.


I still don't see the advantage of your wording over the existing
wording.

Greetings
Marc

-- 
-----------------------------------------------------------------------------
Marc Haber         | "I don't trust Computers. They | Mailadresse im Header
Mannheim, Germany  |  lose things."    Winona Ryder | Fon: *49 621 72739834
Nordisch by Nature |  How to make an American Quilt | Fax: *49 621 72739835