NAME
    ExtUtils::PkgConfig - simplistic interface to pkg-config

SYNOPSIS
     use ExtUtils::PkgConfig;

     $package = 'gtk+-2.0';

     %pkg_info = ExtUtils::PkgConfig->find ($package);
     print "modversion:  $pkg_info{modversion}\n";
     print "cflags:      $pkg_info{cflags}\n";
     print "libs:        $pkg_info{libs}\n";

     $modversion = ExtUtils::PkgConfig->modversion($package);

     $libs = ExtUtils::PkgConfig->libs($package);

     $cflags = ExtUtils::PkgConfig->cflags($package);

     $lib_only_L = ExtUtils::PkgConfig->libs_only_L($package);

     $lib_only_l = ExtUtils::PkgConfig->libs_only_l($package);

     $var_value = ExtUtils::PkgConfig->variable($package,$var);

     if (ExtUtils::PkgConfig->atleast_version($package,$version)) {
        ...
     }

     if (ExtUtils::PkgConfig->exact_version($package,$version)) {
        ...
     }

     if (ExtUtils::PkgConfig->max_version($package,$version)) {
        ...
     }

DESCRIPTION
    The pkg-config program retrieves information about installed libraries,
    usually for the purposes of compiling against and linking to them.

    ExtUtils::PkgConfig is a very simplistic interface to this utility,
    intended for use in the Makefile.PL of perl extensions which bind
    libraries that pkg-config knows. It is really just boilerplate code that
    you would've written yourself.

  USAGE
    The module contains one function:

    HASH = ExtUtils::PkgConfig->find (STRING, [STRING, ...])
        Call pkg-config on the library specified by *STRING* (you'll have to
        know what to use here). The returned *HASH* contains the modversion,
        cflags, and libs values under keys with those names. If multiple
        STRINGS are passed they are attempted in the order they are given
        till a working package is found.

        If pkg-config fails to find a working *STRING*, this function croaks
        with a message intended to be helpful to whomever is attempting to
        compile your package.

        For example:

          *** can not find package bad1                                   
          *** check that it is properly installed and available 
          *** in PKG_CONFIG_PATH 

        or

          *** can't find cflags for gtk+-2.0
          *** is it properly installed and available in PKG_CONFIG_PATH?

SEE ALSO
    ExtUtils::PkgConfig was designed to work with ExtUtils::Depends for
    compiling the various modules of the gtk2-perl project.

      L<ExtUtils::Depends>

      L<http://gtk2-perl.sourceforge.net/>

AUTHORS
    muppet <scott at asofyet dot org>.

COPYRIGHT AND LICENSE
    Copyright 2003 by muppet, Ross McFarland, and the gtk2-perl team

    This library is free software; you can redistribute it and/or modify it
    under the terms of the Lesser General Public License (LGPL). For more
    information, see http://www.fsf.org/licenses/lgpl.txt

