diff options
author | Phil Pennock <pdp@exim.org> | 2012-02-18 08:34:12 -0500 |
---|---|---|
committer | Phil Pennock <pdp@exim.org> | 2012-02-18 08:34:12 -0500 |
commit | 252e0c7b1235b8474023a0ab187c35a3088d3cb1 (patch) | |
tree | b182e26701bdb0df103b71e89f31bfd380a839ce | |
parent | df6303fac223cae633ac6054ea8d795f2e8bf7ee (diff) |
Document pkg-config
-rw-r--r-- | doc/doc-docbook/spec.xfpt | 21 | ||||
-rw-r--r-- | doc/doc-txt/NewStuff | 5 |
2 files changed, 26 insertions, 0 deletions
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt index b1984b5cb..46a92dee9 100644 --- a/doc/doc-docbook/spec.xfpt +++ b/doc/doc-docbook/spec.xfpt @@ -2110,6 +2110,27 @@ files or libraries are required. When a lookup type is not included in the binary, attempts to configure Exim to use it cause run time configuration errors. +.new +.cindex "pkg-config" "specifying" +Many systems now use a tool called &'pkg-config'& to encapsulate information +about how to compile against a library; Exim has some initial support for +being able to use pkg-config for lookups and authenticators. For any given +makefile variable which starts &`LOOKUP_`& or &`AUTH_`&, you can add a new +variable with the &`_PC`& suffix in the name and assign as the value the +name of the package to be queried. The results of querying via the +&'pkg-config'& command will be added to the appropriate Makefile variables +with &`+=`& directives, so your version of &'make'& will need to support that +syntax. For instance: +.code +LOOKUP_SQLITE=yes +LOOKUP_SQLITE_PC=sqlite3 +AUTH_GSASL=yes +AUTH_GSASL_PC=libgsasl +AUTH_HEIMDAL_GSSAPI=yes +AUTH_HEIMDAL_GSSAPI_PC=heimdal-gssapi +.endd +.wen + .cindex "Perl" "including support for" Exim can be linked with an embedded Perl interpreter, allowing Perl subroutines to be called during string expansion. To enable this facility, diff --git a/doc/doc-txt/NewStuff b/doc/doc-txt/NewStuff index 4521d7dd9..1e5629c2b 100644 --- a/doc/doc-txt/NewStuff +++ b/doc/doc-txt/NewStuff @@ -23,6 +23,11 @@ Version 4.78 is no longer honoured for setuid programs by Heimdal. Use the "server_keytab" option to point to the keytab. + 3. The "pkg-config" system can now be used when building Exim to reference + cflags and library information for lookups and authenticators, rather + than having to update "CFLAGS", "AUTH_LIBS", "LOOKUP_INCLUDE" and + "LOOKUP_LIBS" directly. + Version 4.77 ------------ |