Bug#329988: exim4: Improve README.SMTP-AUTH for setup without SSL/TLS

[Shyamal Prasad]

Package: exim4
Version: 4.50-8
Severity: wishlist
Tags: patch

Hi,

Everytime I've had to set up exim4 with SMTP-AUTH over plain old TCP
(which is very common with DSL providers in the USA and, I'm sure, in
some other places) I have to struggle with the new exim4 configuration
set up. I'm was actually pretty good with exim3, so I'm presuming new
users would be really flummoxed with exim4! Currently one has to
pretty much wade to the bottom of README.Debian, understand all the
other stuff about the configuration strategy, and finally exim newbies
probably do not know the syntax for defining a macro anyway.

Could I suggest a small change to README.SMTP-AUTH to make it obvious
what needs to be done along the lines of the patch below?

--- README.SMTP-AUTH.orig	2005-09-24 16:15:11.000000000 -0700
+++ README.SMTP-AUTH	2005-09-24 16:40:24.000000000 -0700
@@ -17,8 +17,12 @@
 
 If you need to enable them for unencrypted connections because your
 service provider does support neither TLS encryption nor the CRAM MD5
-authentication method, you can do so by setting the appropriate macro
-as mentioned in the comments in the configuration file [3].
+authentication method, you can do so by setting the macro
+AUTH_CLIENT_ALLOW_NOTLS_PASSWORDS to true in the appropriate
+configuration file [3] using the line below:
+
+AUTH_CLIENT_ALLOW_NOTLS_PASSWORDS = true
+
 
 --------------------------------
 
@@ -46,8 +50,10 @@
 [1] Not present on woody, sorry.
 [2] adduser Debian-exim sasl
 [3] If you are using split configuration (dc_use_split_config='true'
-in /etc/exim4/update-exim4.conf.conf), the file to edit is
-/etc/exim4/conf.d/auth/30_exim4-config_examples. If you are not using
-split configuration, your file is /etc/exim4/exim4.conf.template.
+in /etc/exim4/update-exim4.conf.conf), the file would be in the
+/etc/exim4/conf.d/main directory (please read the README.Debian for
+this package carefully, one method is to create a file called
+000_localmacros). If you are not using split configuration, your file
+is /etc/exim4/exim4.conf.localmacros.
 
 # vim:tabstop=3:expandtab:shiftwidth=3:textwidth=73



-- Package-specific info:
Exim version 4.50 #1 built 27-May-2005 08:08:19
Copyright (c) University of Cambridge 2004
Berkeley DB: Sleepycat Software: Berkeley DB 4.2.52: (December  3, 2003)
Support for: iconv() IPv6 GnuTLS
Lookups: lsearch wildlsearch nwildlsearch iplsearch cdb dbm dbmnz dsearch nis nis0 passwd
Authenticators: cram_md5 plaintext
Routers: accept dnslookup ipliteral manualroute queryprogram redirect
Transports: appendfile/maildir/mailstore autoreply lmtp pipe smtp
Fixed never_users: 0
Configuration file is /var/lib/exim4/config.autogenerated
# /etc/exim4/update-exim4.conf.conf
#
# Edit this file and /etc/mailname by hand and execute update-exim4.conf
# yourself or use 'dpkg-reconfigure exim4-config'
#
# Please note that this is _not_ a dpkg-conffile and that automatic changes
# to this file might happen. The code handling this will honor your local
# changes, so this is usually fine, but will break local schemes that mess
# around with multiple versions of the file.
#
# update-exim4.conf uses this file to determine variable values to replace
# the DEBCONFsomethingDEBCONF strings in the configuration template files.
#
# Most settings found in here do have corresponding questions in the
# Debconf configuration, but not all of them.
#
# This is a Debian specific file

dc_eximconfig_configtype='smarthost'
dc_other_hostnames='localhost.localdomain'
dc_local_interfaces='127.0.0.1'
dc_readhost='verizon.net'
dc_relay_domains=''
dc_minimaldns='false'
dc_relay_nets=''
dc_smarthost='outgoing.verizon.net'
CFILEMODE='644'
dc_use_split_config='false'
dc_hide_mailname='true'
dc_mailname_in_oh='true'
mailname:localhost.localdomain

-- System Information:
Debian Release: 3.1
Architecture: i386 (i686)
Kernel: Linux 2.4.27-2-686
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1)

Versions of packages exim4 depends on:
ii  exim4-base                    4.50-8     support files for all exim MTA (v4
ii  exim4-daemon-light            4.50-8     lightweight exim MTA (v4) daemon

-- no debconf information