NAME

Alien::autoconf - Build or find autoconf

VERSION

version 0.20

SYNOPSIS

From your script or module:

use Alien::autoconf;
use Env qw( @PATH );

unshift @PATH, Alien::autoconf->bin_dir;

From your alienfile:

use alienfile;

share {
  # Alien::Autotools will pull in:
  #  - Alien::autoconf
  #  - Alien::automake
  #  - Alien::m4
  #  - Alien::libtool
  # all of which you will likely need.
  requires 'Alien::Autotools';
  plugin 'Build::Autoconf';
  build [
    '%{autoreconf} -vfi',
    '%{configure}',
    '%{make}',
    '%{make} install',
  ];
};

DESCRIPTION

This distribution provides autoconf so that it can be used by other Perl distributions that are on CPAN. This is most commonly necessary when creating other Aliens that target a autoconf project that does not ship with a configure script. Ideally you should complain to the upstream developers, but if you are not able to convince them then you have this option. There are currently two such Aliens: Alien::libuv and Alien::Hunspell.

METHODS

bin_dir

my @dirs = Alien::autoconf->bin_dir;

Returns a list of directories that need to be added to the PATH in order to use autoconf.

HELPERS

This Alien provides the following helpers which will execute the corresponding command. You want to use the helpers because they will use the correct incantation on Windows.

autoconf
autoheader
autom4te
autoreconf
autoscan
autoupdate
ifname

CAVEATS

This module is currently configured to always do a share install. This is because system installs for this alien are not reliable. Please see this issue for details: https://github.com/plicease/Alien-autoconf/issues/2. The good news is that most of the time you shouldn't need this module unless you are building another alien from source. If your system provides the package that is targeted by the upstream alien I recommend using that. If you are packaging system packages for your platform then I recommend making sure the upstream alien uses the system library so you won't need to install this module.

SEE ALSO

alienfile
Alien::Build
Alien::Build
Alien::Autotools

AUTHOR

Author: Graham Ollis <plicease@cpan.org>

Contributors:

Mark Jensen (MAJENSEN)

COPYRIGHT AND LICENSE

This software is copyright (c) 2017-2022 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.