[exim-cvs] Document pkg-config

Top Page
Delete this message
Reply to this message
Author: Exim Git Commits Mailing List
Date:  
To: exim-cvs
Subject: [exim-cvs] Document pkg-config
Gitweb: http://git.exim.org/exim.git/commitdiff/252e0c7b1235b8474023a0ab187c35a3088d3cb1
Commit:     252e0c7b1235b8474023a0ab187c35a3088d3cb1
Parent:     df6303fac223cae633ac6054ea8d795f2e8bf7ee
Author:     Phil Pennock <pdp@???>
AuthorDate: Sat Feb 18 08:34:12 2012 -0500
Committer:  Phil Pennock <pdp@???>
CommitDate: Sat Feb 18 08:34:12 2012 -0500


    Document pkg-config
---
 doc/doc-docbook/spec.xfpt |   21 +++++++++++++++++++++
 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 b1984b5..46a92de 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 4521d7d..1e5629c 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
------------