]> git.ipfire.org Git - thirdparty/autoconf.git/commit
doc: give an example of using the macro for pkg-config
authorEric Blake <eblake@redhat.com>
Mon, 27 Jan 2014 18:33:07 +0000 (11:33 -0700)
committerEric Blake <eblake@redhat.com>
Wed, 5 Feb 2014 21:20:44 +0000 (14:20 -0700)
commite5d3c9621fbd23c5e2d62fdb19534ed1b5f3ab09
treebf2e40cdcfb9889b0cd69a1573ce57d3d84e739c
parent251d13ff2491e470f16569a9bb31123558ae84b2
doc: give an example of using the macro for pkg-config

The autoconf manual doesn't mention any examples of actually
using m4_pattern_forbid.  Yet this is the perfect macro for
avoiding the all-too-common failure mode of configure dying with:

      checking if libxml2 is present... ./configure: line 11586: syntax
 error
 near unexpected token `LIBXML2,'
      ./configure: line 11586: `PKG_CHECK_MODULES(LIBXML2, libxml-2.0>=
 2.6.19,'

for developers that forgot to install pkg-config.  While we don't
necessarily advertise the use of PKG_CHECK_MODULES, it is a
common enough situation that the manual should make it easier to
help developers learn about missing third-party macros.

Based on a mailing list report by Daniel Pocock:
http://lists.gnu.org/archive/html/autoconf/2014-01/msg00030.html

* doc/autoconf.texi (Forbidden Patterns): Add examples.

Signed-off-by: Eric Blake <eblake@redhat.com>
doc/autoconf.texi