Alien::Build::Plugin::Build::Autoconf - Autoconf plugin for Alien::Build
use alienfile; plugin 'Build::Autoconf';
User Contributed Perl Documentation
Alien::Build::Plugin::Build::Autoconf(3)
NAME
Alien::Build::Plugin::Build::Autoconf - Autoconf plugin for
Alien::Build
VERSION
version 1.89
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.
config_site
The content for the generated "config.site".
HELPERS
configure
%{configure}
The correct incantation to start an autoconf style "configure" script
on your platform. Some reasonable default flags will be provided.
ENVIRONMENT
"ALIEN_BUILD_SITE_CONFIG"
This plugin needs to alter the behavior of autotools via the
"site.config" file and so sets and possibly overrides any existing
"SITE_CONFIG". Normally that is what you want but you can also
insert your own "site.config" in addition by using this environment
variable.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------------+
|Availability | library/perl-5/alien-build-532 |
+---------------+--------------------------------+
|Stability | Volatile |
+---------------+--------------------------------+
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 (KIWIROY)
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 Fandio (salva)
Gianni Ceccarelli (dakkar)
Pavel Shaydo (zwon, trinitum)
Kang-min Liu (, gugod)
Nicholas Shipp (nshp)
Juan Julin Merelo Guervs (JJ)
Joel Berger (JBERGER)
Petr Pisar (ppisar)
Lance Wicks (LANCEW)
Ahmad Fatoum (a3f, ATHREEF)
Jos Joaqun Atria (JJATRIA)
Duke Leto (LETO)
Shoichi Kaji (SKAJI)
Shawn Laffan (SLAFFAN)
Paul Evans (leonerd, PEVANS)
COPYRIGHT AND LICENSE
This software is copyright (c) 2011-2019 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.
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
http://www.cpan.org/authors/id/P/PL/PLICEASE/Alien-Build-1.89.tar.gz.
Further information about this software can be found on the open source
community website at http://search.cpan.org/dist/Alien-Build/.
perl v5.32.0 2019-09-25
Alien::Build::Plugin::Build::Autoconf(3)