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

Contents of /eclass/autotools.eclass

Parent Directory Parent Directory | Revision Log Revision Log


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

1 vapier 1.91 # Copyright 1999-2010 Gentoo Foundation
2 vapier 1.6 # Distributed under the terms of the GNU General Public License v2
3 vapier 1.100 # $Header: /var/cvsroot/gentoo-x86/eclass/autotools.eclass,v 1.99 2010/07/06 18:55:50 vapier Exp $
4 vapier 1.76
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 azarah 1.1 #
13 azarah 1.11 # NB: If you add anything, please comment it!
14 azarah 1.1
15 flameeyes 1.37 inherit eutils libtool
16 azarah 1.11
17 vapier 1.76 # @ECLASS-VARIABLE: WANT_AUTOCONF
18     # @DESCRIPTION:
19     # The major version of autoconf your package needs
20 vapier 1.94 : ${WANT_AUTOCONF:=latest}
21 vapier 1.76
22     # @ECLASS-VARIABLE: WANT_AUTOMAKE
23     # @DESCRIPTION:
24     # The major version of automake your package needs
25 vapier 1.94 : ${WANT_AUTOMAKE:=latest}
26 flameeyes 1.63
27 robbat2 1.95 # @ECLASS-VARIABLE: _LATEST_AUTOMAKE
28 vapier 1.100 # @INTERNAL
29 robbat2 1.95 # @DESCRIPTION:
30     # CONSTANT!
31 flameeyes 1.96 # The latest major version/slot of automake available on each arch.
32 robbat2 1.95 # 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 vapier 1.99 _LATEST_AUTOMAKE='1.11'
36 robbat2 1.95
37 vapier 1.40 _automake_atom="sys-devel/automake"
38     _autoconf_atom="sys-devel/autoconf"
39 peper 1.55 if [[ -n ${WANT_AUTOMAKE} ]]; then
40 flameeyes 1.49 case ${WANT_AUTOMAKE} in
41 vapier 1.67 none) _automake_atom="" ;; # some packages don't require automake at all
42 vapier 1.99 # if you change the "latest" version here, change also autotools_run_tool
43 robbat2 1.95 # this MUST reflect the latest stable major version for each arch!
44 vapier 1.99 latest) _automake_atom="|| ( `printf '=sys-devel/automake-%s* ' ${_LATEST_AUTOMAKE}` )" ;;
45 vapier 1.67 *) _automake_atom="=sys-devel/automake-${WANT_AUTOMAKE}*" ;;
46 flameeyes 1.49 esac
47 vapier 1.64 export WANT_AUTOMAKE
48 flameeyes 1.48 fi
49    
50 vapier 1.45 if [[ -n ${WANT_AUTOCONF} ]] ; then
51 flameeyes 1.41 case ${WANT_AUTOCONF} in
52 vapier 1.67 none) _autoconf_atom="" ;; # some packages don't require autoconf at all
53     2.1) _autoconf_atom="=sys-devel/autoconf-${WANT_AUTOCONF}*" ;;
54 flameeyes 1.86 # if you change the “latest” version here, change also autotools_run_tool
55 vapier 1.67 latest|2.5) _autoconf_atom=">=sys-devel/autoconf-2.61" ;;
56 vapier 1.68 *) _autoconf_atom="INCORRECT-WANT_AUTOCONF-SETTING-IN-EBUILD" ;;
57 flameeyes 1.41 esac
58 vapier 1.64 export WANT_AUTOCONF
59 flameeyes 1.41 fi
60 vapier 1.93
61     AUTOTOOLS_DEPEND="${_automake_atom} ${_autoconf_atom}"
62     [[ ${CATEGORY}/${PN} != "sys-devel/libtool" ]] && AUTOTOOLS_DEPEND="${AUTOTOOLS_DEPEND} >=sys-devel/libtool-2.2.6b"
63 flameeyes 1.46 RDEPEND=""
64 vapier 1.93
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 vapier 1.94 : ${AUTOTOOLS_AUTO_DEPEND:=yes}
71 vapier 1.93 if [[ ${AUTOTOOLS_AUTO_DEPEND} != "no" ]] ; then
72     DEPEND=${AUTOTOOLS_DEPEND}
73     fi
74    
75 vapier 1.40 unset _automake_atom _autoconf_atom
76 azarah 1.11
77 vapier 1.76 # @ECLASS-VARIABLE: AM_OPTS
78 vapier 1.100 # @DEFAULT_UNSET
79 vapier 1.76 # @DESCRIPTION:
80     # Additional options to pass to automake during
81     # eautoreconf call.
82    
83     # @ECLASS-VARIABLE: AT_NOELIBTOOLIZE
84 vapier 1.100 # @DEFAULT_UNSET
85 vapier 1.76 # @DESCRIPTION:
86     # Don't run elibtoolize command if set to 'yes',
87     # useful when elibtoolize needs to be ran with
88     # particular options
89 azarah 1.16
90 cardoe 1.66 # XXX: M4DIR should be deprecated
91 vapier 1.76 # @ECLASS-VARIABLE: AT_M4DIR
92     # @DESCRIPTION:
93     # Additional director(y|ies) aclocal should search
94 vapier 1.94 : ${AT_M4DIR:=${M4DIR}}
95 azarah 1.16 AT_GNUCONF_UPDATE="no"
96    
97 azarah 1.11
98 vapier 1.76 # @FUNCTION: eautoreconf
99     # @DESCRIPTION:
100 azarah 1.17 # 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 jmbsvicetto 1.81 #
104 vapier 1.76 # 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 azarah 1.17 eautoreconf() {
107 vapier 1.91 local x auxdir g
108 jmbsvicetto 1.81
109 flameeyes 1.39 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 vapier 1.91 pushd "${x}" >/dev/null
114 flameeyes 1.39 AT_NOELIBTOOLIZE="yes" eautoreconf
115 vapier 1.91 popd >/dev/null
116 flameeyes 1.39 fi
117     done
118     fi
119 azarah 1.11
120 flameeyes 1.38 auxdir=$(autotools_get_auxdir)
121    
122 vapier 1.91 einfo "Running eautoreconf in '${PWD}' ..."
123 flameeyes 1.38 [[ -n ${auxdir} ]] && mkdir -p ${auxdir}
124 azarah 1.17 eaclocal
125 grobian 1.83 [[ ${CHOST} == *-darwin* ]] && g=g
126     if ${LIBTOOLIZE:-${g}libtoolize} -n --install >& /dev/null ; then
127 vapier 1.72 _elibtoolize --copy --force --install
128     else
129     _elibtoolize --copy --force
130     fi
131 azarah 1.17 eautoconf
132     eautoheader
133 flameeyes 1.35 FROM_EAUTORECONF="yes" eautomake ${AM_OPTS}
134 azarah 1.1
135 flameeyes 1.32 [[ ${AT_NOELIBTOOLIZE} == "yes" ]] && return 0
136    
137 flameeyes 1.30 # Call it here to prevent failures due to elibtoolize called _before_
138 vapier 1.84 # eautoreconf. We set $S because elibtoolize runs on that #265319
139 vapier 1.91 S=${PWD} elibtoolize
140 flameeyes 1.30
141 flameeyes 1.21 return 0
142 azarah 1.12 }
143    
144 vapier 1.76 # @FUNCTION: eaclocal
145     # @DESCRIPTION:
146 azarah 1.11 # 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 vapier 1.76 # Respects AT_M4DIR for additional directories to search for macro's.
151 azarah 1.11 eaclocal() {
152 azarah 1.12 local aclocal_opts
153    
154 vapier 1.74 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 vapier 1.75 eval aclocal_opts=\"${aclocal_opts}\"
159 vapier 1.74 break
160     done
161    
162 azarah 1.16 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 flameeyes 1.15
176 flameeyes 1.22 [[ ! -f aclocal.m4 || -n $(grep -e 'generated.*by aclocal' aclocal.m4) ]] && \
177 azarah 1.12 autotools_run_tool aclocal "$@" ${aclocal_opts}
178     }
179    
180 vapier 1.76 # @FUNCTION: _elibtoolize
181     # @DESCRIPTION:
182     # Runs libtoolize. Note the '_' prefix .. to not collide with elibtoolize() from
183     # libtool.eclass.
184 azarah 1.12 _elibtoolize() {
185 grobian 1.83 local opts g=
186 swegener 1.20
187 flameeyes 1.34 # 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 vapier 1.77 [[ -n $(autotools_check_macro AC_PROG_LIBTOOL AM_PROG_LIBTOOL LT_INIT) ]] || return 0
190 azarah 1.19
191 flameeyes 1.70 [[ -f GNUmakefile.am || -f Makefile.am ]] && opts="--automake"
192 swegener 1.20
193 grobian 1.83 [[ ${CHOST} == *-darwin* ]] && g=g
194     autotools_run_tool ${LIBTOOLIZE:-${g}libtoolize} "$@" ${opts}
195 flameeyes 1.15
196 azarah 1.12 # Need to rerun aclocal
197     eaclocal
198 azarah 1.11 }
199 azarah 1.1
200 vapier 1.76 # @FUNCTION: eautoheader
201     # @DESCRIPTION:
202     # Runs autoheader.
203 azarah 1.11 eautoheader() {
204 azarah 1.12 # Check if we should run autoheader
205     [[ -n $(autotools_check_macro "AC_CONFIG_HEADERS") ]] || return 0
206 flameeyes 1.58 NO_FAIL=1 autotools_run_tool autoheader "$@"
207 azarah 1.11 }
208 azarah 1.1
209 vapier 1.76 # @FUNCTION: eautoconf
210     # @DESCRIPTION:
211     # Runs autoconf.
212 azarah 1.11 eautoconf() {
213 azarah 1.12 if [[ ! -f configure.ac && ! -f configure.in ]] ; then
214     echo
215 vapier 1.91 eerror "No configure.{ac,in} present in '${PWD}'!"
216 azarah 1.12 echo
217     die "No configure.{ac,in} present!"
218     fi
219    
220 azarah 1.11 autotools_run_tool autoconf "$@"
221     }
222 azarah 1.1
223 vapier 1.76 # @FUNCTION: eautomake
224     # @DESCRIPTION:
225     # Runs automake.
226 azarah 1.11 eautomake() {
227 flameeyes 1.24 local extra_opts
228 flameeyes 1.70 local makefile_name
229 flameeyes 1.24
230 vapier 1.98 # 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 flameeyes 1.24
244 vapier 1.98 elif [[ -z ${FROM_EAUTORECONF} && -f ${makefile_name%.am}.in ]]; then
245 flameeyes 1.35 local used_automake
246     local installed_automake
247    
248 vapier 1.87 installed_automake=$(WANT_AUTOMAKE= automake --version | head -n 1 | \
249 flameeyes 1.35 sed -e 's:.*(GNU automake) ::')
250 vapier 1.98 used_automake=$(head -n 1 < ${makefile_name%.am}.in | \
251 flameeyes 1.35 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 flameeyes 1.36 return 0
258 flameeyes 1.35 fi
259     fi
260    
261 flameeyes 1.33 [[ -f INSTALL && -f AUTHORS && -f ChangeLog && -f NEWS ]] \
262 flameeyes 1.24 || extra_opts="${extra_opts} --foreign"
263    
264 flameeyes 1.14 # --force-missing seems not to be recognized by some flavours of automake
265 flameeyes 1.24 autotools_run_tool automake --add-missing --copy ${extra_opts} "$@"
266 azarah 1.1 }
267    
268 vapier 1.90 # @FUNCTION: eautopoint
269     # @DESCRIPTION:
270     # Runs autopoint (from the gettext package).
271     eautopoint() {
272     autotools_run_tool autopoint "$@"
273     }
274    
275 azarah 1.17 # Internal function to run an autotools' tool
276     autotools_run_tool() {
277 jmbsvicetto 1.81 if [[ ${EBUILD_PHASE} != "unpack" && ${EBUILD_PHASE} != "prepare" ]]; then
278 flameeyes 1.71 ewarn "QA Warning: running $1 in ${EBUILD_PHASE} phase"
279     fi
280    
281 flameeyes 1.86 # We do the “latest” → version switch here because it solves
282     # possible order problems, see bug #270010 as an example.
283 flameeyes 1.96 if [[ ${WANT_AUTOMAKE} == "latest" ]]; then
284 vapier 1.99 local pv
285 flameeyes 1.96 for pv in ${_LATEST_AUTOMAKE} ; do
286 robbat2 1.97 # 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 flameeyes 1.96 done
290     [[ ${WANT_AUTOMAKE} == "latest" ]] && \
291     die "Cannot find the latest automake! Tried ${_LATEST_AUTOMAKE}"
292     fi
293 flameeyes 1.86 [[ ${WANT_AUTOCONF} == "latest" ]] && export WANT_AUTOCONF=2.5
294    
295 vapier 1.85 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 azarah 1.17
302 vapier 1.85 printf "***** $1 *****\n***** PWD: ${PWD}\n***** $*\n\n" > "${STDERR_TARGET}"
303 azarah 1.17
304 azarah 1.27 ebegin "Running $@"
305 vapier 1.85 "$@" >> "${STDERR_TARGET}" 2>&1
306     eend $?
307 azarah 1.17
308 vapier 1.85 if [[ $? != 0 && ${NO_FAIL} != 1 ]] ; then
309 azarah 1.17 echo
310     eerror "Failed Running $1 !"
311     eerror
312     eerror "Include in your bugreport the contents of:"
313     eerror
314 vapier 1.85 eerror " ${STDERR_TARGET}"
315 azarah 1.17 echo
316     die "Failed Running $1 !"
317     fi
318     }
319    
320     # Internal function to check for support
321     autotools_check_macro() {
322 vapier 1.77 [[ -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 azarah 1.17 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 azarah 1.25 if (match($0, /AC_CONFIG_SUBDIRS:(.*)$/, res))
340     print res[1]
341 azarah 1.17 }' | uniq
342 azarah 1.16
343 azarah 1.17 return 0
344 azarah 1.11 }
345 azarah 1.17
346 flameeyes 1.38 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 vapier 1.40 }

  ViewVC Help
Powered by ViewVC 1.1.20