NAME

    Alien::m4 - Find or build GNU m4

VERSION

    version 0.21

SYNOPSIS

    From a Perl script

     use Alien::m4;
     use Env qw( @PATH );
     unshift @PATH, Alien::m4->bin_dir;  # m4 is now in your path

    From Alien::Base Build.PL

     use Alien:Base::ModuleBuild;
     my $builder = Module::Build->new(
       ...
       alien_bin_requires => {
         'Alien::m4' => '0.07',
       },
       ...
     );
     $builder->create_build_script;

DESCRIPTION

    This package can be used by other CPAN modules that require GNU m4.

METHODS

 exe

     my $m4 = Alien::m4->exe;

    Returns the "name" of m4. Normally this is m4, but on some platforms it
    may be gm4 or gnum4, or whatever is specified by $ENV{M4}.

HELPERS

 m4

     %{m4}

    Returns the name of the m4 command. Usually just m4.

CAVEATS

    Why GNU m4? Many Unixen come with BSD or other variants of m4 which are
    perfectly good. Unfortunately, the main use case for this module is
    Alien::Autotools and friends. Autoconf requires the GNU m4, probably
    for political reasons, possibly for technical reasons. If you are using
    one of these Unixen, don't despair, you can usually install the GNU
    version of m4 either by building from source or by installing a binary
    package, with either the name gm4 or gnum4, and this module will find
    it, and Alien::Autotools will be able to use it.

AUTHOR

    Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

    This software is copyright (c) 2017 by Graham Ollis.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

