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

[Marc Haber]

Hi,

On Mon, May 02, 2005 at 03:16:23AM +1000, Drew Parsons wrote:
> My only final suggestion is to include a trival example in README.Debian
> (or commented out in /etc/exim4/conf.d/main/000_localmacros if you want
> to create the sample file):
> 
> e.g. to switch on a basic on/off definition, use 
> MY_MACRO_DEFINITION=1

I am not a friend of holding a user's hands through the entire
configuration process, making reference to the documentation
completely unnecessary. I have, however, added an example:

--- debian/README.Debian        (revision 1132)
+++ debian/README.Debian        (working copy)
@@ -161,9 +161,15 @@
 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.
+/etc/exim4/exim4.conf.template. To actually set the macro
+EXIM4_EXAMPLE to the value "this is a sample", write the following line

+EXIM4_EXAMPLE = this is a sample
+
+into the appropriate file. For more detailed discussion of the general
+macro mechanism, see the exim specification, chapter 6.4, for details
+how macro expansion works.
+
 What about debconf?
 ------
 Debconf just "manages" the file /etc/exim4/update-exim4.conf.conf. This is

Is that ok with you?

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