Alien::Build::Plugin::Build::Autoconf(3pm)

1Alien::Build::Plugin::BUusielrd:C:oAnuttroicbountfe(d3A)Pleireln:D:oBcuuimledn:t:aPtliuognin::Build::Autoconf(3)
2
3
4

NAME

6       Alien::Build::Plugin::Build::Autoconf - Autoconf plugin for
7       Alien::Build
8

VERSION

10       version 2.17
11

SYNOPSIS

13        use alienfile;
14        plugin 'Build::Autoconf';
15

DESCRIPTION

17       This plugin provides some tools for building projects that use
18       autoconf.  The main thing this provides is a "configure" helper,
19       documented below and the default build stage, which is:
20
21        '%{configure} --disable-shared',
22        '%{make}',
23        '%{make} install',
24
25       On Windows, this plugin also pulls in the
26       Alien::Build::Plugin::Build::MSYS which is required for autoconf style
27       projects on windows.
28
29       The other thing that this plugin does is that it does a double staged
30       "DESTDIR" install.  The author has found this improves the overall
31       reliability of Alien modules that are based on autoconf packages.
32
33       This plugin supports out-of-source builds (known in autoconf terms as
34       "VPATH" builds) via the meta property "out_of_source".
35

PROPERTIES

37   with_pic
38       Adds "--with-pic" option when running "configure".  If supported by
39       your package, it will generate position independent code on platforms
40       that support it.  This is required to XS modules, and generally what
41       you want.
42
43       autoconf normally ignores options that it does not understand, so it is
44       usually a safe and reasonable default to include it.  A small number of
45       projects look like they use autoconf, but are really an autoconf style
46       interface with a different implementation.  They may fail if you try to
47       provide it with options such as "--with-pic" that they do not
48       recognize.  Such packages are the rationale for this property.
49
50   msys_version
51       The version of Alien::MSYS required if it is deemed necessary.  If
52       Alien::MSYS isn't needed (if running under Unix, or MSYS2, for example)
53       this will do nothing.
54
55   config_site
56       The content for the generated "config.site".
57

HELPERS

59   configure
60        %{configure}
61
62       The correct incantation to start an autoconf style "configure" script
63       on your platform.  Some reasonable default flags will be provided.
64

ENVIRONMENT

66       "ALIEN_BUILD_SITE_CONFIG"
67           This plugin needs to alter the behavior of autotools via the
68           "site.config" file and so sets and possibly overrides any existing
69           "SITE_CONFIG".  Normally that is what you want but you can also
70           insert your own "site.config" in addition by using this environment
71           variable.
72

AUTHOR

82       Author: Graham Ollis <plicease@cpan.org>
83
84       Contributors:
85
86       Diab Jerius (DJERIUS)
87
88       Roy Storey (KIWIROY)
89
90       Ilya Pavlov
91
92       David Mertens (run4flat)
93
94       Mark Nunberg (mordy, mnunberg)
95
96       Christian Walde (Mithaldu)
97
98       Brian Wightman (MidLifeXis)
99
100       Zaki Mughal (zmughal)
101
102       mohawk (mohawk2, ETJ)
103
104       Vikas N Kumar (vikasnkumar)
105
106       Flavio Poletti (polettix)
107
108       Salvador Fandiño (salva)
109
110       Gianni Ceccarelli (dakkar)
111
112       Pavel Shaydo (zwon, trinitum)
113
114       Kang-min Liu (劉康民, gugod)
115
116       Nicholas Shipp (nshp)
117
118       Juan Julián Merelo Guervós (JJ)
119
120       Joel Berger (JBERGER)
121
122       Petr Pisar (ppisar)
123
124       Lance Wicks (LANCEW)
125
126       Ahmad Fatoum (a3f, ATHREEF)
127
128       José Joaquín Atria (JJATRIA)
129
130       Duke Leto (LETO)
131
132       Shoichi Kaji (SKAJI)
133
134       Shawn Laffan (SLAFFAN)
135
136       Paul Evans (leonerd, PEVANS)
137

COPYRIGHT AND LICENSE

139       This software is copyright (c) 2011-2020 by Graham Ollis.
140
141       This is free software; you can redistribute it and/or modify it under
142       the same terms as the Perl 5 programming language system itself.
143
144
145
146perl v5.30.2                      2020-A0l3i-e2n0::Build::Plugin::Build::Autoconf(3)