1.1 --- a/README.txt	Fri Dec 19 00:20:11 2014 +0100
     1.2 +++ b/README.txt	Sat Dec 20 00:09:36 2014 +0100
     1.3 @@ -60,7 +60,72 @@
     1.4    postfix       Postfix routing and transport configuration
     1.5  
     1.6  Either Exim or Postfix can be chosen as a mail system supporting the agent.
     1.7 -Both of these currently make use of LDAP to access user information.
     1.8 +
     1.9 +Configuring Mail Systems for the Agent
    1.10 +--------------------------------------
    1.11 +
    1.12 +The essential aspect of mail system configuration involves mail transports and
    1.13 +the integration of agent programs into the mail processing pipeline. Thus, the
    1.14 +following files are of particular interest:
    1.15 +
    1.16 +For Exim...
    1.17 +
    1.18 +  conf/exim/30_exim4-config_people              Integration of agent programs
    1.19 +  conf/exim/30_exim4-config_people_outgoing     ...
    1.20 +  conf/exim/30_exim4-config_resources           ...
    1.21 +
    1.22 +For Postfix...
    1.23 +
    1.24 +  conf/postfix/master.cf.items      Integration of agent programs (for
    1.25 +                                    inclusion in master.cf)
    1.26 +  conf/postfix/transport            Configuration of agent transports
    1.27 +  conf/postfix/virtual              Configuration of outgoing mail routing
    1.28 +
    1.29 +Such files need adjusting for the deployment environment so that, for example,
    1.30 +the example.com domain would be replaced with a suitable value.
    1.31 +
    1.32 +Where $lmtp_socket is employed, a suitable filesystem path is required; see
    1.33 +below for a discussion of LMTP and mail delivery.
    1.34 +
    1.35 +Configuring Mail Systems for Mail Recipients
    1.36 +--------------------------------------------
    1.37 +
    1.38 +The software should operate independently of the way mail recipients are
    1.39 +identified in any given mail system, and thus does not dictate things such as
    1.40 +routing or account querying. However, example configuration files are provided
    1.41 +that demonstrate the use of LDAP to identify mail recipients:
    1.42 +
    1.43 +For Exim...
    1.44 +
    1.45 +  conf/exim/010_exim4-config_people_outgoing    Defines recipients and
    1.46 +                                                outgoing mail routing
    1.47 +  conf/exim/890_exim4-config_ldap_people        ...
    1.48 +  conf/exim/890_exim4-config_ldap_resources     ...
    1.49 +
    1.50 +For Postfix...
    1.51 +
    1.52 +  conf/postfix/local_recipient_maps.cf          Defines local virtual
    1.53 +                                                recipients
    1.54 +  conf/postfix/main.cf.example                  Defines recipients and outgoing
    1.55 +                                                mail routing (for inclusion in
    1.56 +                                                main.cf)
    1.57 +  conf/postfix/virtual_alias_maps_people.cf
    1.58 +  conf/postfix/virtual_alias_maps_people_outgoing.cf
    1.59 +  conf/postfix/virtual_alias_maps_resources.cf
    1.60 +
    1.61 +With the exception of the sender_bcc_maps setting in Postfix's main.cf, the
    1.62 +above recipient identification configuration examples can be disregarded in
    1.63 +favour of other ways of defining mail recipients, subject to the needs of any
    1.64 +given environment.
    1.65 +
    1.66 +Configuring Mail Systems for Mail Delivery
    1.67 +------------------------------------------
    1.68 +
    1.69 +The agent software assumes that delivery of mail to recipients may be
    1.70 +performed using LMTP to a suitable mailbox provider. This is largely beyond
    1.71 +the scope of this document, but systems such as Cyrus and Dovecot can be
    1.72 +configured to provide a Unix domain socket offering support for LMTP
    1.73 +connections.
    1.74  
    1.75  Prerequisites
    1.76  -------------