ax_pkg_check_modules
====================

Synopsis
********

     AX_PKG_CHECK_MODULES(PREFIX, PUBLIC-MODULES, PRIVATE-MODULES, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND], [PUBLIC-VARIABLE], [PRIVATE-VARIABLE])

Description
***********

A wrapper around PKG_CHECK_MODULES which splits the list of modules into public and private dependencies, and produces two variables listing the dependencies across all invocations of AX_PKG_CHECK_MODULES. These two variables are exposed via AC_SUBST, and should be used in a pkg-config file as the substituted values for Requires and Requires.private.

The PREFIX, PUBLIC-MODULES and PRIVATE-MODULES arguments should be specified as for PKG_CHECK_MODULES, with the concatenation of PUBLIC-MODULES and PRIVATE-MODULES equaling the LIST-OF-MODULES from PKG_CHECK_MODULES.  The ACTION-IF-FOUND and ACTION-IF-NOT-FOUND arguments are optional, and should also be specified as for PKG_CHECK_MODULES.  ACTION-IF-FOUND is evaluated if the full LIST-OF-MODULES is found; ACTION-IF-NOT-FOUND similarly.

PUBLIC-VARIABLE defaults to AX_PACKAGE_REQUIRES, and PRIVATE-VARIABLE defaults to AX_PACKAGE_REQUIRES_PRIVATE.  Both variables are AC_SUBST-ed by this macro.

For example:

       AX_PKG_CHECK_MODULES([GLIB],[glib-2.0 gio-2.0],[gthread-2.0])
       AX_PKG_CHECK_MODULES([DBUS],[],[dbus-glib-1 >= 0.98 dbus-1])

results in the substitutions:

       AX_PACKAGE_REQUIRES="glib-2.0 gio-2.0"
       AX_PACKAGE_REQUIRES_PRIVATE="gthread-2.0 dbus-glib-1 >= 0.98 dbus-1"

and can be used with a template pkg-config file (.pc.in) using:

       Requires: @AX_PACKAGE_REQUIRES@
       Requires.private: @AX_PACKAGE_REQUIRES_PRIVATE@

Source Code
***********

Download the latest version of ax_pkg_check_modules.m4 (http://git.savannah.gnu.org/gitweb/?p=autoconf-archive.git;a=blob_plain;f=m4/ax_pkg_check_modules.m4) or browse the macro's revision history (http://git.savannah.gnu.org/gitweb/?p=autoconf-archive.git;a=history;f=m4/ax_pkg_check_modules.m4).

License
*******

Copyright © 2014 Philip Withnall philip@tecnocode.co.uk

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.  This file is offered as-is, without any warranty.