Re: [PATCH] doc: give an example of using the macro for pkg-config

On 01/27/2014 11:39 AM, Eric Blake wrote:
> 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 <[email protected]>
> ---
> 
> No wonder it took us a couple of iterations to give you the
> right advice - we didn't have good documentation.  This patch
> should give us something to point the next person to, when
> encountering a similar situation.
> 

No comments, so I pushed this.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1
Comment: Public key at http://people.redhat.com/eblake/eblake.gpg
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCAAGBQJS8qrtAAoJEKeha0olJ0NqWi8H/0IhEUC08OBcrpqedmzrDBLq
l1qjpU0N685tWbzDGYw0J1rHqxRGvYxb+NRqZ8d/J2Hxbf5A6pTwBQtEQycVGLGT
MIEzqBndJoX6KFiN7YqEZ/DrFcJnMPcuVWi8qgFofcEE9DKFC4ghR1OKYCVsTSX+
VNiCTflsL35a7Q+n+T+9dMTFcSM9fbf8KoZzFEuPb/tkqBRzmWKxluE15hj9f8wK
Kr1OE8Sfz8NksME8Xa+7UKao4DldfITOaqNjZ+Ei6bxT2tn92NEBnWAuTBhaOq4D
WSpamNqCHtk2tfRv6A/QfeodqWIBi9gmh9NcPfs52XurfsrK01SfMd7cT4Nd824=
=zU+i
-----END PGP SIGNATURE-----