The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Alien-Build-1.14_01
River stage four • 248 direct dependents • 1388 total dependents
22 ++
/ Alien::Build::Plugin::Build::Autoconf

NAME

Alien::Build::Plugin::Build::Autoconf - Autoconf plugin for Alien::Build

VERSION

version 1.14_01

SYNOPSIS

 use alienfile;
 plugin 'Build::Autoconf' => ();

DESCRIPTION

This plugin provides some tools for building projects that use autoconf. The main thing this provides is a configure helper, documented below and the default build stage, which is:

 '%{configure} --disable-shared',
 '%{make}',
 '%{make} install',

On Windows, this plugin also pulls in the Alien::Build::Plugin::Build::MSYS which is required for autoconf style projects on windows.

The other thing that this plugin does is that it does a double staged DESTDIR install. The author has found this improves the overall reliability of Alien modules that are based on autoconf packages.

This plugin supports out-of-source builds (known in autoconf terms as "VPATH" builds) via the meta property out_of_source.

PROPERTIES

with_pic

Adds --with-pic option when running configure. If supported by your package, it will generate position independent code on platforms that support it. This is required to XS modules, and generally what you want.

autoconf normally ignores options that it does not understand, so it is usually a safe and reasonable default to include it. A small number of projects look like they use autoconf, but are really an autoconf style interface with a different implementation. They may fail if you try to provide it with options such as --with-pic that they do not recognize. Such packages are the rationale for this property.

msys_version

The version of Alien::MSYS required if it is deemed necessary. If Alien::MSYS isn't needed (if running under Unix, or MSYS2, for example) this will do nothing.

HELPERS

configure

 %{configure}

The correct incantation to start an autoconf style configure script on your platform. Some reasonable default flags will be provided.

SEE ALSO

Alien::Build::Plugin::MSYS, Alien::Build::Plugin, Alien::Build, Alien::Base, Alien

https://www.gnu.org/software/autoconf/autoconf.html

https://www.gnu.org/prep/standards/html_node/DESTDIR.html

AUTHOR

Author: Graham Ollis <plicease@cpan.org>

Contributors:

Diab Jerius (DJERIUS)

Roy Storey

Ilya Pavlov

David Mertens (run4flat)

Mark Nunberg (mordy, mnunberg)

Christian Walde (Mithaldu)

Brian Wightman (MidLifeXis)

Zaki Mughal (zmughal)

mohawk (mohawk2, ETJ)

Vikas N Kumar (vikasnkumar)

Flavio Poletti (polettix)

Salvador Fandiño (salva)

Gianni Ceccarelli (dakkar)

Pavel Shaydo (zwon, trinitum)

Kang-min Liu (劉康民, gugod)

Nicholas Shipp (nshp)

Juan Julián Merelo Guervós (JJ)

Joel Berger (JBERGER)

Petr Pisar (ppisar)

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.