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.47
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       "SITE_CONFIG"
67           For a share install, this plugin needs to alter the behavior of
68           autotools using "site.config".  It does this by generating a
69           "site.config" file on the fly, and setting the "SITE_CONFIG"
70           environment variable.  In the event that you already have your own
71           "SITE_CONFIG" set, that file will be sourced from the generated
72           one, so your local defaults should still be honored, unless it is
73           one that needs to be changed for a share install.
74
75           In particular, the "lib" directory must be overridden, because on
76           some platforms dynamic libraries will otherwise be placed in
77           directories that Alien::Build doesn't normally look in.  Since the
78           alienized package will be installed in a share directory, and not a
79           system directory, that should be fine.
80
81       "ALIEN_BUILD_SITE_CONFIG"
82           If defined, this file will be also be sourced in the generated
83           "site.config".  This allows you to have local defaults for alien
84           share installs only.
85

AUTHOR

95       Author: Graham Ollis <plicease@cpan.org>
96
97       Contributors:
98
99       Diab Jerius (DJERIUS)
100
101       Roy Storey (KIWIROY)
102
103       Ilya Pavlov
104
105       David Mertens (run4flat)
106
107       Mark Nunberg (mordy, mnunberg)
108
109       Christian Walde (Mithaldu)
110
111       Brian Wightman (MidLifeXis)
112
113       Zaki Mughal (zmughal)
114
115       mohawk (mohawk2, ETJ)
116
117       Vikas N Kumar (vikasnkumar)
118
119       Flavio Poletti (polettix)
120
121       Salvador Fandiño (salva)
122
123       Gianni Ceccarelli (dakkar)
124
125       Pavel Shaydo (zwon, trinitum)
126
127       Kang-min Liu (劉康民, gugod)
128
129       Nicholas Shipp (nshp)
130
131       Juan Julián Merelo Guervós (JJ)
132
133       Joel Berger (JBERGER)
134
135       Petr Písař (ppisar)
136
137       Lance Wicks (LANCEW)
138
139       Ahmad Fatoum (a3f, ATHREEF)
140
141       José Joaquín Atria (JJATRIA)
142
143       Duke Leto (LETO)
144
145       Shoichi Kaji (SKAJI)
146
147       Shawn Laffan (SLAFFAN)
148
149       Paul Evans (leonerd, PEVANS)
150
151       Håkon Hægland (hakonhagland, HAKONH)
152
153       nick nauwelaerts (INPHOBIA)
154

COPYRIGHT AND LICENSE

156       This software is copyright (c) 2011-2020 by Graham Ollis.
157
158       This is free software; you can redistribute it and/or modify it under
159       the same terms as the Perl 5 programming language system itself.
160
161
162
163perl v5.34.0                      2022-A0l3i-e0n7::Build::Plugin::Build::Autoconf(3)