# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1419030576 -3600
# Node ID 9c898b67396e27b3857a53d3bd2ac2f58b6bad53
# Parent  caf2415fb036212667c5312357ca024751030445
Added specific details about mail system configuration.

diff -r caf2415fb036 -r 9c898b67396e README.txt
--- a/README.txt	Fri Dec 19 00:20:11 2014 +0100
+++ b/README.txt	Sat Dec 20 00:09:36 2014 +0100
@@ -60,7 +60,72 @@
   postfix       Postfix routing and transport configuration
 
 Either Exim or Postfix can be chosen as a mail system supporting the agent.
-Both of these currently make use of LDAP to access user information.
+
+Configuring Mail Systems for the Agent
+--------------------------------------
+
+The essential aspect of mail system configuration involves mail transports and
+the integration of agent programs into the mail processing pipeline. Thus, the
+following files are of particular interest:
+
+For Exim...
+
+  conf/exim/30_exim4-config_people              Integration of agent programs
+  conf/exim/30_exim4-config_people_outgoing     ...
+  conf/exim/30_exim4-config_resources           ...
+
+For Postfix...
+
+  conf/postfix/master.cf.items      Integration of agent programs (for
+                                    inclusion in master.cf)
+  conf/postfix/transport            Configuration of agent transports
+  conf/postfix/virtual              Configuration of outgoing mail routing
+
+Such files need adjusting for the deployment environment so that, for example,
+the example.com domain would be replaced with a suitable value.
+
+Where $lmtp_socket is employed, a suitable filesystem path is required; see
+below for a discussion of LMTP and mail delivery.
+
+Configuring Mail Systems for Mail Recipients
+--------------------------------------------
+
+The software should operate independently of the way mail recipients are
+identified in any given mail system, and thus does not dictate things such as
+routing or account querying. However, example configuration files are provided
+that demonstrate the use of LDAP to identify mail recipients:
+
+For Exim...
+
+  conf/exim/010_exim4-config_people_outgoing    Defines recipients and
+                                                outgoing mail routing
+  conf/exim/890_exim4-config_ldap_people        ...
+  conf/exim/890_exim4-config_ldap_resources     ...
+
+For Postfix...
+
+  conf/postfix/local_recipient_maps.cf          Defines local virtual
+                                                recipients
+  conf/postfix/main.cf.example                  Defines recipients and outgoing
+                                                mail routing (for inclusion in
+                                                main.cf)
+  conf/postfix/virtual_alias_maps_people.cf
+  conf/postfix/virtual_alias_maps_people_outgoing.cf
+  conf/postfix/virtual_alias_maps_resources.cf
+
+With the exception of the sender_bcc_maps setting in Postfix's main.cf, the
+above recipient identification configuration examples can be disregarded in
+favour of other ways of defining mail recipients, subject to the needs of any
+given environment.
+
+Configuring Mail Systems for Mail Delivery
+------------------------------------------
+
+The agent software assumes that delivery of mail to recipients may be
+performed using LMTP to a suitable mailbox provider. This is largely beyond
+the scope of this document, but systems such as Cyrus and Dovecot can be
+configured to provide a Unix domain socket offering support for LMTP
+connections.
 
 Prerequisites
 -------------