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

Contents of /eclass/autotools.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.76 - (hide annotations) (download)
Sun Jun 1 01:43:06 2008 UTC (5 years, 10 months ago) by vapier
Branch: MAIN
Changes since 1.75: +50 -28 lines
add eclass documentation by mren #210546

1 vapier 1.72 # Copyright 1999-2008 Gentoo Foundation
2 vapier 1.6 # Distributed under the terms of the GNU General Public License v2
3 vapier 1.76 # $Header: /var/cvsroot/gentoo-x86/eclass/autotools.eclass,v 1.75 2008/04/24 03:15:43 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 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 flameeyes 1.63 [[ -z ${WANT_AUTOCONF} ]] && WANT_AUTOCONF="latest"
21 vapier 1.76
22     # @ECLASS-VARIABLE: WANT_AUTOMAKE
23     # @DESCRIPTION:
24     # The major version of automake your package needs
25 flameeyes 1.63 [[ -z ${WANT_AUTOMAKE} ]] && WANT_AUTOMAKE="latest"
26    
27 vapier 1.40 _automake_atom="sys-devel/automake"
28     _autoconf_atom="sys-devel/autoconf"
29 peper 1.55 if [[ -n ${WANT_AUTOMAKE} ]]; then
30 flameeyes 1.49 case ${WANT_AUTOMAKE} in
31 vapier 1.67 none) _automake_atom="" ;; # some packages don't require automake at all
32 vapier 1.64 latest) _automake_atom="=sys-devel/automake-1.10*" ;;
33 vapier 1.67 *) _automake_atom="=sys-devel/automake-${WANT_AUTOMAKE}*" ;;
34 flameeyes 1.49 esac
35 vapier 1.64 [[ ${WANT_AUTOMAKE} == "latest" ]] && WANT_AUTOMAKE="1.10"
36     export WANT_AUTOMAKE
37 flameeyes 1.48 fi
38    
39 vapier 1.45 if [[ -n ${WANT_AUTOCONF} ]] ; then
40 flameeyes 1.41 case ${WANT_AUTOCONF} in
41 vapier 1.67 none) _autoconf_atom="" ;; # some packages don't require autoconf at all
42     2.1) _autoconf_atom="=sys-devel/autoconf-${WANT_AUTOCONF}*" ;;
43     latest|2.5) _autoconf_atom=">=sys-devel/autoconf-2.61" ;;
44 vapier 1.68 *) _autoconf_atom="INCORRECT-WANT_AUTOCONF-SETTING-IN-EBUILD" ;;
45 flameeyes 1.41 esac
46 vapier 1.64 [[ ${WANT_AUTOCONF} == "latest" ]] && WANT_AUTOCONF="2.5"
47     export WANT_AUTOCONF
48 flameeyes 1.41 fi
49 vapier 1.40 DEPEND="${_automake_atom}
50     ${_autoconf_atom}
51 flameeyes 1.28 sys-devel/libtool"
52 flameeyes 1.46 RDEPEND=""
53 vapier 1.40 unset _automake_atom _autoconf_atom
54 azarah 1.11
55 vapier 1.76 # @ECLASS-VARIABLE: AM_OPTS
56     # @DESCRIPTION:
57     # Additional options to pass to automake during
58     # eautoreconf call.
59    
60     # @ECLASS-VARIABLE: AT_NOELIBTOOLIZE
61     # @DESCRIPTION:
62     # Don't run elibtoolize command if set to 'yes',
63     # useful when elibtoolize needs to be ran with
64     # particular options
65 azarah 1.16
66 cardoe 1.66 # XXX: M4DIR should be deprecated
67 vapier 1.76 # @ECLASS-VARIABLE: AT_M4DIR
68     # @DESCRIPTION:
69     # Additional director(y|ies) aclocal should search
70 azarah 1.16 AT_M4DIR=${AT_M4DIR:-${M4DIR}}
71     AT_GNUCONF_UPDATE="no"
72    
73 azarah 1.11
74 vapier 1.76 # @FUNCTION: eautoreconf
75     # @DESCRIPTION:
76 azarah 1.17 # This function mimes the behavior of autoreconf, but uses the different
77     # eauto* functions to run the tools. It doesn't accept parameters, but
78     # the directory with include files can be specified with AT_M4DIR variable.
79 vapier 1.76 #
80     # Should do a full autoreconf - normally what most people will be interested in.
81     # Also should handle additional directories specified by AC_CONFIG_SUBDIRS.
82 azarah 1.17 eautoreconf() {
83 flameeyes 1.38 local pwd=$(pwd) x auxdir
84 azarah 1.11
85 flameeyes 1.39 if [[ -z ${AT_NO_RECURSIVE} ]]; then
86     # Take care of subdirs
87     for x in $(autotools_get_subdirs); do
88     if [[ -d ${x} ]] ; then
89     cd "${x}"
90     AT_NOELIBTOOLIZE="yes" eautoreconf
91     cd "${pwd}"
92     fi
93     done
94     fi
95 azarah 1.11
96 flameeyes 1.38 auxdir=$(autotools_get_auxdir)
97    
98 flameeyes 1.26 einfo "Running eautoreconf in '$(pwd)' ..."
99 flameeyes 1.38 [[ -n ${auxdir} ]] && mkdir -p ${auxdir}
100 azarah 1.17 eaclocal
101 vapier 1.72 if ${LIBTOOLIZE:-libtoolize} -n --install >& /dev/null ; then
102     _elibtoolize --copy --force --install
103     else
104     _elibtoolize --copy --force
105     fi
106 azarah 1.17 eautoconf
107     eautoheader
108 flameeyes 1.35 FROM_EAUTORECONF="yes" eautomake ${AM_OPTS}
109 azarah 1.1
110 flameeyes 1.32 [[ ${AT_NOELIBTOOLIZE} == "yes" ]] && return 0
111    
112 flameeyes 1.30 # Call it here to prevent failures due to elibtoolize called _before_
113     # eautoreconf.
114     elibtoolize
115    
116 flameeyes 1.21 return 0
117 azarah 1.12 }
118    
119 vapier 1.76 # @FUNCTION: eaclocal
120     # @DESCRIPTION:
121 azarah 1.11 # These functions runs the autotools using autotools_run_tool with the
122     # specified parametes. The name of the tool run is the same of the function
123     # without e prefix.
124     # They also force installing the support files for safety.
125 vapier 1.76 # Respects AT_M4DIR for additional directories to search for macro's.
126 azarah 1.11 eaclocal() {
127 azarah 1.12 local aclocal_opts
128    
129 vapier 1.74 local amflags_file
130     for amflags_file in GNUmakefile.am Makefile.am GNUmakefile.in Makefile.in ; do
131     [[ -e ${amflags_file} ]] || continue
132     aclocal_opts=$(sed -n '/^ACLOCAL_AMFLAGS[[:space:]]*=/s:[^=]*=::p' ${amflags_file})
133 vapier 1.75 eval aclocal_opts=\"${aclocal_opts}\"
134 vapier 1.74 break
135     done
136    
137 azarah 1.16 if [[ -n ${AT_M4DIR} ]] ; then
138     for x in ${AT_M4DIR} ; do
139     case "${x}" in
140     "-I")
141     # We handle it below
142     ;;
143     *)
144     [[ ! -d ${x} ]] && ewarn "eaclocal: '${x}' does not exist"
145     aclocal_opts="${aclocal_opts} -I ${x}"
146     ;;
147     esac
148     done
149     fi
150 flameeyes 1.15
151 flameeyes 1.22 [[ ! -f aclocal.m4 || -n $(grep -e 'generated.*by aclocal' aclocal.m4) ]] && \
152 azarah 1.12 autotools_run_tool aclocal "$@" ${aclocal_opts}
153     }
154    
155 vapier 1.76 # @FUNCTION: _elibtoolize
156     # @DESCRIPTION:
157     # Runs libtoolize. Note the '_' prefix .. to not collide with elibtoolize() from
158     # libtool.eclass.
159 azarah 1.12 _elibtoolize() {
160 azarah 1.19 local opts
161 flameeyes 1.34 local lttest
162 swegener 1.20
163 flameeyes 1.34 # Check if we should run libtoolize (AM_PROG_LIBTOOL is an older macro,
164     # check for both it and the current AC_PROG_LIBTOOL)
165     lttest="$(autotools_check_macro "AC_PROG_LIBTOOL")$(autotools_check_macro "AM_PROG_LIBTOOL")"
166     [[ -n $lttest ]] || return 0
167 azarah 1.19
168 flameeyes 1.70 [[ -f GNUmakefile.am || -f Makefile.am ]] && opts="--automake"
169 swegener 1.20
170 flameeyes 1.18 [[ "${USERLAND}" == "Darwin" ]] && LIBTOOLIZE="glibtoolize"
171 azarah 1.19 autotools_run_tool ${LIBTOOLIZE:-libtoolize} "$@" ${opts}
172 flameeyes 1.15
173 azarah 1.12 # Need to rerun aclocal
174     eaclocal
175 azarah 1.11 }
176 azarah 1.1
177 vapier 1.76 # @FUNCTION: eautoheader
178     # @DESCRIPTION:
179     # Runs autoheader.
180 azarah 1.11 eautoheader() {
181 azarah 1.12 # Check if we should run autoheader
182     [[ -n $(autotools_check_macro "AC_CONFIG_HEADERS") ]] || return 0
183 flameeyes 1.58 NO_FAIL=1 autotools_run_tool autoheader "$@"
184 azarah 1.11 }
185 azarah 1.1
186 vapier 1.76 # @FUNCTION: eautoconf
187     # @DESCRIPTION:
188     # Runs autoconf.
189 azarah 1.11 eautoconf() {
190 azarah 1.12 if [[ ! -f configure.ac && ! -f configure.in ]] ; then
191     echo
192     eerror "No configure.{ac,in} present in '$(pwd | sed -e 's:.*/::')'!"
193     echo
194     die "No configure.{ac,in} present!"
195     fi
196    
197 azarah 1.11 autotools_run_tool autoconf "$@"
198     }
199 azarah 1.1
200 vapier 1.76 # @FUNCTION: eautomake
201     # @DESCRIPTION:
202     # Runs automake.
203 azarah 1.11 eautomake() {
204 flameeyes 1.24 local extra_opts
205 flameeyes 1.70 local makefile_name
206 flameeyes 1.24
207 flameeyes 1.70 if [[ -f GNUmakefile.am ]]; then
208     makefile_name="GNUmakefile"
209     elif [[ -f Makefile.am ]]; then
210     makefile_name="Makefile"
211     else
212     return 0
213     fi
214 flameeyes 1.24
215 flameeyes 1.70 if [[ -z ${FROM_EAUTORECONF} && -f ${makefile_name}.in ]]; then
216 flameeyes 1.35 local used_automake
217     local installed_automake
218    
219     installed_automake=$(automake --version | head -n 1 | \
220     sed -e 's:.*(GNU automake) ::')
221 flameeyes 1.70 used_automake=$(head -n 1 < ${makefile_name}.in | \
222 flameeyes 1.35 sed -e 's:.*by automake \(.*\) from .*:\1:')
223    
224     if [[ ${installed_automake} != ${used_automake} ]]; then
225     einfo "Automake used for the package (${used_automake}) differs from"
226     einfo "the installed version (${installed_automake})."
227     eautoreconf
228 flameeyes 1.36 return 0
229 flameeyes 1.35 fi
230     fi
231    
232 flameeyes 1.33 [[ -f INSTALL && -f AUTHORS && -f ChangeLog && -f NEWS ]] \
233 flameeyes 1.24 || extra_opts="${extra_opts} --foreign"
234    
235 flameeyes 1.14 # --force-missing seems not to be recognized by some flavours of automake
236 flameeyes 1.24 autotools_run_tool automake --add-missing --copy ${extra_opts} "$@"
237 azarah 1.1 }
238    
239 azarah 1.17 # Internal function to run an autotools' tool
240     autotools_run_tool() {
241 flameeyes 1.71 if [[ ${EBUILD_PHASE} != "unpack" ]]; then
242     ewarn "QA Warning: running $1 in ${EBUILD_PHASE} phase"
243     fi
244    
245 azarah 1.17 local STDERR_TARGET="${T}/$$.out"
246     local ris
247    
248 vapier 1.73 printf "***** $1 *****\n***** $*\n\n" > "${STDERR_TARGET%/*}/$1-${STDERR_TARGET##*/}"
249 azarah 1.17
250 azarah 1.27 ebegin "Running $@"
251 vapier 1.69 "$@" >> "${STDERR_TARGET%/*}/$1-${STDERR_TARGET##*/}" 2>&1
252 azarah 1.17 ris=$?
253     eend ${ris}
254    
255 flameeyes 1.57 if [[ ${ris} != 0 && ${NO_FAIL} != 1 ]]; then
256 azarah 1.17 echo
257     eerror "Failed Running $1 !"
258     eerror
259     eerror "Include in your bugreport the contents of:"
260     eerror
261     eerror " ${STDERR_TARGET%/*}/$1-${STDERR_TARGET##*/}"
262     echo
263     die "Failed Running $1 !"
264     fi
265     }
266    
267     # Internal function to check for support
268     autotools_check_macro() {
269     [[ -f configure.ac || -f configure.in ]] && \
270 flameeyes 1.31 WANT_AUTOCONF="2.5" autoconf --trace=$1 2>/dev/null
271 azarah 1.17 return 0
272     }
273    
274     # Internal function to get additional subdirs to configure
275     autotools_get_subdirs() {
276     local subdirs_scan_out
277    
278     subdirs_scan_out=$(autotools_check_macro "AC_CONFIG_SUBDIRS")
279     [[ -n ${subdirs_scan_out} ]] || return 0
280    
281     echo "${subdirs_scan_out}" | gawk \
282     '($0 !~ /^[[:space:]]*(#|dnl)/) {
283 azarah 1.25 if (match($0, /AC_CONFIG_SUBDIRS:(.*)$/, res))
284     print res[1]
285 azarah 1.17 }' | uniq
286 azarah 1.16
287 azarah 1.17 return 0
288 azarah 1.11 }
289 azarah 1.17
290 flameeyes 1.38 autotools_get_auxdir() {
291     local auxdir_scan_out
292    
293     auxdir_scan_out=$(autotools_check_macro "AC_CONFIG_AUX_DIR")
294     [[ -n ${auxdir_scan_out} ]] || return 0
295    
296     echo ${auxdir_scan_out} | gawk \
297     '($0 !~ /^[[:space:]]*(#|dnl)/) {
298     if (match($0, /AC_CONFIG_AUX_DIR:(.*)$/, res))
299     print res[1]
300     }' | uniq
301    
302     return 0
303 vapier 1.40 }

  ViewVC Help
Powered by ViewVC 1.1.20