Bug#305443: Re: Bug#305443: smtp-auth documentation is incomplete

[Marc Haber]

Hi,

On Sun, May 01, 2005 at 10:38:43PM +1000, Drew Parsons wrote:
> The problematic phrase is "setting the appropriate macro as mentioned
> in the comments in the configuration file". That is to say, this phrase
> is clear on its own, it tells me that I will find further instructions
> in /etc/exim4/conf.d/auth/30_exim4-config_examples.  
> 
> The problem is when I look for these instructions inside
> 30_exim4-config_examples.  I can't find them.

I see. I always forget that there is client authentication as well.
That feature is never used by me.

I have added

# You can set
# AUTH_SERVER_ALLOW_NOTLS_PASSWORDS to advertise unencrypted clear text
# password based authenticators on all connections.

to the comments for server side authentication, and

# You can set AUTH_CLIENT_ALLOW_NOTLS_PASSWORDS to allow unencrypted
# clear text password authentication on all connections.

to client side authentication.

To allow setting of macros, nonsplit config will now read
/etc/exim4/exim4.conf.localmacros before
/etc/exim4/exim4.conf.template, and README.Debian now has the two
paragraphs:

+Our configuration can be controlled in a limited way by setting
+macros. That way, you can switch on and off certain parts of the
+default configuration without having to touch the dpkg-conffiles.
+While touching dpkg-conffiles itself is explitly allowed and wanted,
+it can be quite a nuisance to be asked on package upgrade whether one
+wants to use the locally changed file or the file changed by the
+package maintainer.
+
+Whenever you see an .ifdef or .ifndef clause in the configuration
+file, you can control the appropriate clause by setting the macro in a
+local configuration file. For split configuration, you can drop the
+local configuration file anywhere in /etc/exim4/conf.d/main. Just make
+sure it gets read before the macro is first used. 000_localmacros is a
+possible name, guaranteeing first order. For a non-split
+configuration, /etc/exim4/exim4.conf.localmacros gets read before
+/etc/exim4/exim4.conf.template. See the exim specification, chapter
+6.4, for details how macro expansion works.

> Note also the circular references: README.SMTP-AUTH says read the
> comments in 30_exim4-config_examples, while 30_exim4-config_examples
> says read README.SMTP-AUTH for more help.

That is ok, because the README gives more general information, while
the special information is inside the actual config file.

> 1) Keep the reference in README.SMTP-AUTH to the comments in
> 30_exim4-config_examples, and add those comments.

Done.

> Or maybe you could place the definition right there in
> 30_exim4-config_examples, and the instruction will say "...telling them
> to fix their email server, and then uncomment the following line"

Macros can unfortunately only be _set_ in the main part of exim
configuration.

> I will go now and send an email to my ISP telling them to fix their
> email server.

*g*

Is are the changes I did sufficient in your opinion?

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