From: Jeremy Harris <jgh146exb@wizmail.org>
Date: Tue, 20 Aug 2024 16:54:18 +0000 (+0100)
Subject: Docs: build notes for dynamic modules
X-Git-Url: https://git.exim.org/exim.git/commitdiff_plain/34598166349129b6bcefd0a7bff722d79bb1dd9b

Docs: build notes for dynamic modules
---

diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index f73792ac5..e505176fe 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -2082,16 +2082,13 @@ on demand.
 This permits packagers to build Exim with support for lookups with extensive
 library dependencies without requiring all systems to install all of those
 dependencies.
-Most, but not all, lookup types can be built this way.
-
 .new
-Similarly, authenticator, router and transport drivers can be built
-as external modules.
-This permits a smaller exim binary, growing only as needed for the
-runtime cofiguration.
+Any combination of lookup types can be built this way.
+All of the lookup modules found as an Exim process starts will be loaded.
 .wen
 
-Set &`LOOKUP_MODULE_DIR`& to the directory into which the modules will be
+For building
+set &`LOOKUP_MODULE_DIR`& to the directory into which the modules will be
 installed; Exim will only load modules from that directory, as a security
 measure.  You will need to set &`CFLAGS_DYNAMIC`& if not already defined
 for your OS; see &_OS/Makefile-Linux_& for an example.
@@ -2107,6 +2104,19 @@ LOOKUP_LSEARCH=yes
 LOOKUP_SQLITE=2
 LOOKUP_MYSQL=2
 .endd
+Set also &`LOOKUP_`&<&'lookup_type'&>&` INCLUDE`& and
+&`LOOKUP_`&<&'lookup_type'&>`_LIBS if needed for each lookup type,
+ensuring that duplicates are not present in more global values.
+
+.new
+Similarly, authenticator, router and transport drivers can be built
+as external modules.
+Modules will be searched for as demanded by the runtime configuration,
+permitting a smaller Exim binary.
+
+For building, as above but using
+&`AUTH_*`&, &`ROUTER_*`& and &`TRANSPORT_*`& instead of &`LOOKUP_*`&,
+.wen
 
 
 .section "The building process" "SECID29"
diff --git a/src/src/EDITME b/src/src/EDITME
index aeba7704a..7d0b07331 100644
--- a/src/src/EDITME
+++ b/src/src/EDITME
@@ -1580,4 +1580,4 @@ EXIM_TMPDIR="/tmp"
 
 # DISABLE_CLIENT_CMD_LOG=yes
 
-# End of EDITME for Exim 4.
+# End of EDITME for Exim.