NAME
    Alien::Box2D - Build and make available Box2D library -
    <http://box2d.org/>

VERSION
    Version 0.102_3

SYNOPSIS
    Alien::Box2D during its installation does one of the following:

    *   Builds *Box2D* binaries from source codes and installs dev files
        (headers: *.h, static library: *.a) into *share* directory of
        Alien::Box2D distribution.

    Later you can use Alien::Box2D in your module that needs to link with
    *libBox2D* like this:

        # Sample Build.pl
        use Module::Build;
        use Alien::Box2D;

        my $build = Module::Build->new(
          module_name => 'Any::Box2D::Module',
          # + other params
          build_requires => {
                        'Alien::Box2D' => 0,
                        # + others modules
          },
          configure_requires => {
                        'Alien::Box2D' => 0,
                        # + others modules
          },
          extra_compiler_flags => Alien::Box2D->config('cflags'),
          extra_linker_flags   => Alien::Box2D->config('libs'),
        )->create_build_script;

    NOTE: Alien::Box2D is required only for building not for using
    'Any::Box2D::Module'.

DESCRIPTION
    In short "Alien::Box2D" can be used to detect and get configuration
    settings from an already installed Box2D. It offers also an option to
    download Box2D source codes and build binaries from scratch.

METHODS
  config()
    This function is the main public interface to this module:

        Alien::Box2D->config('prefix');
        Alien::Box2D->config('version');
        Alien::Box2D->config('libs');
        Alien::Box2D->config('cflags');

BUGS
    Please post issues and bugs at
    <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Alien-Box2D>

AUTHOR
    KMX, <kmx at cpan.org>

COPYRIGHT
    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

    The full text of the license can be found in the LICENSE file included
    with this module.

