/[gentoo-x86]/eclass/autotools.eclass
Gentoo

Contents of /eclass/autotools.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.100 - (show annotations) (download)
Sat Aug 21 19:36:45 2010 UTC (4 years ago) by vapier
Branch: MAIN
Changes since 1.99: +4 -1 lines
update eclass documentation to use new markings and avoid warnings

1 # Copyright 1999-2010 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Header: /var/cvsroot/gentoo-x86/eclass/autotools.eclass,v 1.99 2010/07/06 18:55:50 vapier Exp $
4
5 # @ECLASS: autotools.eclass
6 # @MAINTAINER:
7 # base-system@gentoo.org
8 # @BLURB: Regenerates auto* build scripts
9 # @DESCRIPTION:
10 # This eclass is for safely handling autotooled software packages that need to
11 # regenerate their build scripts. All functions will abort in case of errors.
12 #
13 # NB: If you add anything, please comment it!
14
15 inherit eutils libtool
16
17 # @ECLASS-VARIABLE: WANT_AUTOCONF
18 # @DESCRIPTION:
19 # The major version of autoconf your package needs
20 : ${WANT_AUTOCONF:=latest}
21
22 # @ECLASS-VARIABLE: WANT_AUTOMAKE
23 # @DESCRIPTION:
24 # The major version of automake your package needs
25 : ${WANT_AUTOMAKE:=latest}
26
27 # @ECLASS-VARIABLE: _LATEST_AUTOMAKE
28 # @INTERNAL
29 # @DESCRIPTION:
30 # CONSTANT!
31 # The latest major version/slot of automake available on each arch.
32 # If a newer version is stable on any arch, and is NOT reflected in this list,
33 # then circular dependencies may arise during emerge @system bootstraps.
34 # Do NOT change this variable in your ebuilds!
35 _LATEST_AUTOMAKE='1.11'
36
37 _automake_atom="sys-devel/automake"
38 _autoconf_atom="sys-devel/autoconf"
39 if [[ -n ${WANT_AUTOMAKE} ]]; then
40 case ${WANT_AUTOMAKE} in
41 none) _automake_atom="" ;; # some packages don't require automake at all
42 # if you change the "latest" version here, change also autotools_run_tool
43 # this MUST reflect the latest stable major version for each arch!
44 latest) _automake_atom="|| ( `printf '=sys-devel/automake-%s* ' ${_LATEST_AUTOMAKE}` )" ;;
45 *) _automake_atom="=sys-devel/automake-${WANT_AUTOMAKE}*" ;;
46 esac
47 export WANT_AUTOMAKE
48 fi
49
50 if [[ -n ${WANT_AUTOCONF} ]] ; then
51 case ${WANT_AUTOCONF} in
52 none) _autoconf_atom="" ;; # some packages don't require autoconf at all
53 2.1) _autoconf_atom="=sys-devel/autoconf-${WANT_AUTOCONF}*" ;;
54 # if you change the “latest” version here, change also autotools_run_tool
55 latest|2.5) _autoconf_atom=">=sys-devel/autoconf-2.61" ;;
56 *) _autoconf_atom="INCORRECT-WANT_AUTOCONF-SETTING-IN-EBUILD" ;;
57 esac
58 export WANT_AUTOCONF
59 fi
60
61 AUTOTOOLS_DEPEND="${_automake_atom} ${_autoconf_atom}"
62 [[ ${CATEGORY}/${PN} != "sys-devel/libtool" ]] && AUTOTOOLS_DEPEND="${AUTOTOOLS_DEPEND} >=sys-devel/libtool-2.2.6b"
63 RDEPEND=""
64
65 # @ECLASS-VARIABLE: AUTOTOOLS_AUTO_DEPEND
66 # @DESCRIPTION:
67 # Set to 'no' to disable automatically adding to DEPEND. This lets
68 # ebuilds former conditional depends by using ${AUTOTOOLS_DEPEND} in
69 # their own DEPEND string.
70 : ${AUTOTOOLS_AUTO_DEPEND:=yes}
71 if [[ ${AUTOTOOLS_AUTO_DEPEND} != "no" ]] ; then
72 DEPEND=${AUTOTOOLS_DEPEND}
73 fi
74
75 unset _automake_atom _autoconf_atom
76
77 # @ECLASS-VARIABLE: AM_OPTS
78 # @DEFAULT_UNSET
79 # @DESCRIPTION:
80 # Additional options to pass to automake during
81 # eautoreconf call.
82
83 # @ECLASS-VARIABLE: AT_NOELIBTOOLIZE
84 # @DEFAULT_UNSET
85 # @DESCRIPTION:
86 # Don't run elibtoolize command if set to 'yes',
87 # useful when elibtoolize needs to be ran with
88 # particular options
89
90 # XXX: M4DIR should be deprecated
91 # @ECLASS-VARIABLE: AT_M4DIR
92 # @DESCRIPTION:
93 # Additional director(y|ies) aclocal should search
94 : ${AT_M4DIR:=${M4DIR}}
95 AT_GNUCONF_UPDATE="no"
96
97
98 # @FUNCTION: eautoreconf
99 # @DESCRIPTION:
100 # This function mimes the behavior of autoreconf, but uses the different
101 # eauto* functions to run the tools. It doesn't accept parameters, but
102 # the directory with include files can be specified with AT_M4DIR variable.
103 #
104 # Should do a full autoreconf - normally what most people will be interested in.
105 # Also should handle additional directories specified by AC_CONFIG_SUBDIRS.
106 eautoreconf() {
107 local x auxdir g
108
109 if [[ -z ${AT_NO_RECURSIVE} ]]; then
110 # Take care of subdirs
111 for x in $(autotools_get_subdirs); do
112 if [[ -d ${x} ]] ; then
113 pushd "${x}" >/dev/null
114 AT_NOELIBTOOLIZE="yes" eautoreconf
115 popd >/dev/null
116 fi
117 done
118 fi
119
120 auxdir=$(autotools_get_auxdir)
121
122 einfo "Running eautoreconf in '${PWD}' ..."
123 [[ -n ${auxdir} ]] && mkdir -p ${auxdir}
124 eaclocal
125 [[ ${CHOST} == *-darwin* ]] && g=g
126 if ${LIBTOOLIZE:-${g}libtoolize} -n --install >& /dev/null ; then
127 _elibtoolize --copy --force --install
128 else
129 _elibtoolize --copy --force
130 fi
131 eautoconf
132 eautoheader
133 FROM_EAUTORECONF="yes" eautomake ${AM_OPTS}
134
135 [[ ${AT_NOELIBTOOLIZE} == "yes" ]] && return 0
136
137 # Call it here to prevent failures due to elibtoolize called _before_
138 # eautoreconf. We set $S because elibtoolize runs on that #265319
139 S=${PWD} elibtoolize
140
141 return 0
142 }
143
144 # @FUNCTION: eaclocal
145 # @DESCRIPTION:
146 # These functions runs the autotools using autotools_run_tool with the
147 # specified parametes. The name of the tool run is the same of the function
148 # without e prefix.
149 # They also force installing the support files for safety.
150 # Respects AT_M4DIR for additional directories to search for macro's.
151 eaclocal() {
152 local aclocal_opts
153
154 local amflags_file
155 for amflags_file in GNUmakefile.am Makefile.am GNUmakefile.in Makefile.in ; do
156 [[ -e ${amflags_file} ]] || continue
157 aclocal_opts=$(sed -n '/^ACLOCAL_AMFLAGS[[:space:]]*=/s:[^=]*=::p' ${amflags_file})
158 eval aclocal_opts=\"${aclocal_opts}\"
159 break
160 done
161
162 if [[ -n ${AT_M4DIR} ]] ; then
163 for x in ${AT_M4DIR} ; do
164 case "${x}" in
165 "-I")
166 # We handle it below
167 ;;
168 *)
169 [[ ! -d ${x} ]] && ewarn "eaclocal: '${x}' does not exist"
170 aclocal_opts="${aclocal_opts} -I ${x}"
171 ;;
172 esac
173 done
174 fi
175
176 [[ ! -f aclocal.m4 || -n $(grep -e 'generated.*by aclocal' aclocal.m4) ]] && \
177 autotools_run_tool aclocal "$@" ${aclocal_opts}
178 }
179
180 # @FUNCTION: _elibtoolize
181 # @DESCRIPTION:
182 # Runs libtoolize. Note the '_' prefix .. to not collide with elibtoolize() from
183 # libtool.eclass.
184 _elibtoolize() {
185 local opts g=
186
187 # Check if we should run libtoolize (AM_PROG_LIBTOOL is an older macro,
188 # check for both it and the current AC_PROG_LIBTOOL)
189 [[ -n $(autotools_check_macro AC_PROG_LIBTOOL AM_PROG_LIBTOOL LT_INIT) ]] || return 0
190
191 [[ -f GNUmakefile.am || -f Makefile.am ]] && opts="--automake"
192
193 [[ ${CHOST} == *-darwin* ]] && g=g
194 autotools_run_tool ${LIBTOOLIZE:-${g}libtoolize} "$@" ${opts}
195
196 # Need to rerun aclocal
197 eaclocal
198 }
199
200 # @FUNCTION: eautoheader
201 # @DESCRIPTION:
202 # Runs autoheader.
203 eautoheader() {
204 # Check if we should run autoheader
205 [[ -n $(autotools_check_macro "AC_CONFIG_HEADERS") ]] || return 0
206 NO_FAIL=1 autotools_run_tool autoheader "$@"
207 }
208
209 # @FUNCTION: eautoconf
210 # @DESCRIPTION:
211 # Runs autoconf.
212 eautoconf() {
213 if [[ ! -f configure.ac && ! -f configure.in ]] ; then
214 echo
215 eerror "No configure.{ac,in} present in '${PWD}'!"
216 echo
217 die "No configure.{ac,in} present!"
218 fi
219
220 autotools_run_tool autoconf "$@"
221 }
222
223 # @FUNCTION: eautomake
224 # @DESCRIPTION:
225 # Runs automake.
226 eautomake() {
227 local extra_opts
228 local makefile_name
229
230 # Run automake if:
231 # - a Makefile.am type file exists
232 # - a Makefile.in type file exists and the configure
233 # script is using the AM_INIT_AUTOMAKE directive
234 for makefile_name in {GNUmakefile,{M,m}akefile}.{am,in} "" ; do
235 [[ -f ${makefile_name} ]] && break
236 done
237 [[ -z ${makefile_name} ]] && return 0
238
239 if [[ ${makefile_name} == *.in ]] ; then
240 if ! grep -qs AM_INIT_AUTOMAKE configure.?? ; then
241 return 0
242 fi
243
244 elif [[ -z ${FROM_EAUTORECONF} && -f ${makefile_name%.am}.in ]]; then
245 local used_automake
246 local installed_automake
247
248 installed_automake=$(WANT_AUTOMAKE= automake --version | head -n 1 | \
249 sed -e 's:.*(GNU automake) ::')
250 used_automake=$(head -n 1 < ${makefile_name%.am}.in | \
251 sed -e 's:.*by automake \(.*\) from .*:\1:')
252
253 if [[ ${installed_automake} != ${used_automake} ]]; then
254 einfo "Automake used for the package (${used_automake}) differs from"
255 einfo "the installed version (${installed_automake})."
256 eautoreconf
257 return 0
258 fi
259 fi
260
261 [[ -f INSTALL && -f AUTHORS && -f ChangeLog && -f NEWS ]] \
262 || extra_opts="${extra_opts} --foreign"
263
264 # --force-missing seems not to be recognized by some flavours of automake
265 autotools_run_tool automake --add-missing --copy ${extra_opts} "$@"
266 }
267
268 # @FUNCTION: eautopoint
269 # @DESCRIPTION:
270 # Runs autopoint (from the gettext package).
271 eautopoint() {
272 autotools_run_tool autopoint "$@"
273 }
274
275 # Internal function to run an autotools' tool
276 autotools_run_tool() {
277 if [[ ${EBUILD_PHASE} != "unpack" && ${EBUILD_PHASE} != "prepare" ]]; then
278 ewarn "QA Warning: running $1 in ${EBUILD_PHASE} phase"
279 fi
280
281 # We do the “latest” → version switch here because it solves
282 # possible order problems, see bug #270010 as an example.
283 if [[ ${WANT_AUTOMAKE} == "latest" ]]; then
284 local pv
285 for pv in ${_LATEST_AUTOMAKE} ; do
286 # has_version respects ROOT, but in this case, we don't want it to,
287 # thus "ROOT=/" prefix:
288 ROOT=/ has_version "=sys-devel/automake-${pv}*" && export WANT_AUTOMAKE="$pv"
289 done
290 [[ ${WANT_AUTOMAKE} == "latest" ]] && \
291 die "Cannot find the latest automake! Tried ${_LATEST_AUTOMAKE}"
292 fi
293 [[ ${WANT_AUTOCONF} == "latest" ]] && export WANT_AUTOCONF=2.5
294
295 local STDERR_TARGET="${T}/$1.out"
296 # most of the time, there will only be one run, but if there are
297 # more, make sure we get unique log filenames
298 if [[ -e ${STDERR_TARGET} ]] ; then
299 STDERR_TARGET="${T}/$1-$$.out"
300 fi
301
302 printf "***** $1 *****\n***** PWD: ${PWD}\n***** $*\n\n" > "${STDERR_TARGET}"
303
304 ebegin "Running $@"
305 "$@" >> "${STDERR_TARGET}" 2>&1
306 eend $?
307
308 if [[ $? != 0 && ${NO_FAIL} != 1 ]] ; then
309 echo
310 eerror "Failed Running $1 !"
311 eerror
312 eerror "Include in your bugreport the contents of:"
313 eerror
314 eerror " ${STDERR_TARGET}"
315 echo
316 die "Failed Running $1 !"
317 fi
318 }
319
320 # Internal function to check for support
321 autotools_check_macro() {
322 [[ -f configure.ac || -f configure.in ]] || return 0
323 local macro
324 for macro ; do
325 WANT_AUTOCONF="2.5" autoconf --trace="${macro}" 2>/dev/null
326 done
327 return 0
328 }
329
330 # Internal function to get additional subdirs to configure
331 autotools_get_subdirs() {
332 local subdirs_scan_out
333
334 subdirs_scan_out=$(autotools_check_macro "AC_CONFIG_SUBDIRS")
335 [[ -n ${subdirs_scan_out} ]] || return 0
336
337 echo "${subdirs_scan_out}" | gawk \
338 '($0 !~ /^[[:space:]]*(#|dnl)/) {
339 if (match($0, /AC_CONFIG_SUBDIRS:(.*)$/, res))
340 print res[1]
341 }' | uniq
342
343 return 0
344 }
345
346 autotools_get_auxdir() {
347 local auxdir_scan_out
348
349 auxdir_scan_out=$(autotools_check_macro "AC_CONFIG_AUX_DIR")
350 [[ -n ${auxdir_scan_out} ]] || return 0
351
352 echo ${auxdir_scan_out} | gawk \
353 '($0 !~ /^[[:space:]]*(#|dnl)/) {
354 if (match($0, /AC_CONFIG_AUX_DIR:(.*)$/, res))
355 print res[1]
356 }' | uniq
357
358 return 0
359 }

  ViewVC Help
Powered by ViewVC 1.1.20