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

Diff of /eclass/base.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.35 Revision 1.56
1# Copyright 1999-2008 Gentoo Foundation 1# Copyright 1999-2011 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/base.eclass,v 1.35 2008/11/09 15:47:47 loki_val Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/base.eclass,v 1.56 2012/02/06 21:33:59 vapier Exp $
4 4
5# @ECLASS: base.eclass 5# @ECLASS: base.eclass
6# @MAINTAINER: 6# @MAINTAINER:
7# Peter Alfredsen <loki_val@gentoo.org> 7# QA Team <qa@gentoo.org>
8# 8# @AUTHOR:
9# Original author Dan Armak <danarmak@gentoo.org> 9# Original author: Dan Armak <danarmak@gentoo.org>
10# @BLURB: The base eclass defines some default functions and variables. 10# @BLURB: The base eclass defines some default functions and variables.
11# @DESCRIPTION: 11# @DESCRIPTION:
12# The base eclass defines some default functions and variables. Nearly 12# The base eclass defines some default functions and variables. Nearly
13# everything else inherits from here. 13# everything else inherits from here.
14#
15# NOTE: You must define EAPI before inheriting from base, or the wrong functions
16# may be exported.
17 14
15if [[ ${___ECLASS_ONCE_BASE} != "recur -_+^+_- spank" ]] ; then
16___ECLASS_ONCE_BASE="recur -_+^+_- spank"
18 17
19inherit eutils 18inherit eutils
20 19
20BASE_EXPF="src_unpack src_compile src_install"
21case "${EAPI:-0}" in 21case "${EAPI:-0}" in
22 2) 22 2|3|4) BASE_EXPF+=" src_prepare src_configure" ;;
23 EXPORT_FUNCTIONS src_unpack src_prepare src_configure src_compile src_install 23 *) ;;
24 ;;
25 *)
26 EXPORT_FUNCTIONS src_unpack src_compile src_install
27 ;;
28esac 24esac
29 25
30DESCRIPTION="Based on the $ECLASS eclass" 26EXPORT_FUNCTIONS ${BASE_EXPF}
27
28# @ECLASS-VARIABLE: DOCS
29# @DESCRIPTION:
30# Array containing documents passed to dodoc command.
31#
32# DOCS=( "${S}/doc/document.txt" "${S}/doc/doc_folder/" )
33
34# @ECLASS-VARIABLE: HTML_DOCS
35# @DESCRIPTION:
36# Array containing documents passed to dohtml command.
37#
38# HTML_DOCS=( "${S}/doc/document.html" "${S}/doc/html_folder/" )
39
40# @ECLASS-VARIABLE: PATCHES
41# @DESCRIPTION:
42# PATCHES array variable containing all various patches to be applied.
43# This variable is expected to be defined in global scope of ebuild.
44# Make sure to specify the full path. This variable is utilised in
45# src_unpack/src_prepare phase based on EAPI.
46#
47# NOTE: if using patches folders with special file suffixes you have to
48# define one additional variable EPATCH_SUFFIX="something"
49#
50# PATCHES=( "${FILESDIR}/mypatch.patch" "${FILESDIR}/patches_folder/" )
51
31 52
32# @FUNCTION: base_src_unpack 53# @FUNCTION: base_src_unpack
33# @USAGE: [ unpack ] [ patch ] [ autopatch ] [ all ]
34# @DESCRIPTION: 54# @DESCRIPTION:
35# The base src_unpack function, which is exported. If no argument is given, 55# The base src_unpack function, which is exported.
36# "all" is assumed if EAPI!=2, "unpack" if EAPI=2. 56# Calls also src_prepare with eapi older than 2.
37base_src_unpack() { 57base_src_unpack() {
38
39 debug-print-function $FUNCNAME "$@" 58 debug-print-function $FUNCNAME "$@"
40 59
41 if [ -z "$1" ] 60 pushd "${WORKDIR}" > /dev/null
42 then 61
43 case "${EAPI:-0}" in 62 if [[ $(type -t unpacker_src_unpack) == "function" ]] ; then
44 2) 63 unpacker_src_unpack
45 base_src_util unpack 64 elif [[ -n ${A} ]] ; then
46 ;; 65 unpack ${A}
47 *)
48 base_src_util all
49 ;;
50 esac
51 else
52 base_src_util $@
53 fi 66 fi
67 has src_prepare ${BASE_EXPF} || base_src_prepare
68
69 popd > /dev/null
54} 70}
55 71
56# @FUNCTION: base_src_prepare 72# @FUNCTION: base_src_prepare
57# @DESCRIPTION: 73# @DESCRIPTION:
58# The base src_prepare function, which is exported when EAPI=2. Performs 74# The base src_prepare function, which is exported
59# "base_src_util autopatch". 75# EAPI is greater or equal to 2. Here the PATCHES array is evaluated.
60base_src_prepare() { 76base_src_prepare() {
77 debug-print-function $FUNCNAME "$@"
78 debug-print "$FUNCNAME: PATCHES=$PATCHES"
61 79
62 debug-print-function $FUNCNAME "$@" 80 local patches_failed=0
63 81
64 base_src_util autopatch 82 pushd "${S}" > /dev/null
65} 83 if [[ "$(declare -p PATCHES 2>/dev/null 2>&1)" == "declare -a"* ]]; then
84 for x in "${PATCHES[@]}"; do
85 debug-print "$FUNCNAME: applying patch from ${x}"
86 if [[ -d "${x}" ]]; then
87 # Use standardized names and locations with bulk patching
88 # Patch directory is ${WORKDIR}/patch
89 # See epatch() in eutils.eclass for more documentation
90 EPATCH_SUFFIX=${EPATCH_SUFFIX:=patch}
66 91
67# @FUNCTION: base_src_util 92 # in order to preserve normal EPATCH_SOURCE value that can
68# @USAGE: [ unpack ] [ patch ] [ autopatch ] [ all ] 93 # be used other way than with base eclass store in local
69# @DESCRIPTION: 94 # variable and restore later
70# The base_src_util function is the grunt function for base src_unpack 95 oldval=${EPATCH_SOURCE}
71# and base src_prepare. 96 EPATCH_SOURCE=${x}
72base_src_util() { 97 EPATCH_FORCE=yes
98 epatch
99 EPATCH_SOURCE=${oldval}
100 elif [[ -f "${x}" ]]; then
101 epatch "${x}"
102 else
103 ewarn "QA: File or directory \"${x}\" does not exist."
104 ewarn "QA: Check your PATCHES array or add missing file/directory."
105 patches_failed=1
106 fi
107 done
108 [[ ${patches_failed} -eq 1 ]] && die "Some patches failed. See above messages."
109 else
110 for x in ${PATCHES}; do
111 debug-print "$FUNCNAME: patching from ${x}"
112 epatch "${x}"
113 done
114 fi
73 115
74 debug-print-function $FUNCNAME "$@" 116 # Apply user patches
117 debug-print "$FUNCNAME: applying user patches"
118 epatch_user
75 119
76 cd "${WORKDIR}" 120 popd > /dev/null
77
78 while [ "$1" ]; do
79
80 case $1 in
81 unpack)
82 debug-print-section unpack
83 unpack ${A}
84 ;;
85 patch)
86 debug-print-section patch
87 cd "${S}"
88 epatch "${FILESDIR}/${P}-gentoo.diff"
89 ;;
90 autopatch)
91 debug-print-section autopatch
92 debug-print "$FUNCNAME: autopatch: PATCHES=$PATCHES, PATCHES1=$PATCHES1"
93 cd "${S}"
94 if [[ ${#PATCHES[@]} -gt 1 ]]; then
95 for x in "${PATCHES[@]}"; do
96 debug-print "$FUNCNAME: autopatch: patching from ${x}"
97 epatch "${x}"
98 done
99 else
100 for x in ${PATCHES} ${PATCHES1}; do
101 debug-print "$FUNCNAME: autopatch: patching from ${x}"
102 epatch "${x}"
103 done
104 fi
105 ;;
106 all)
107 debug-print-section all
108 base_src_util unpack autopatch
109 ;;
110 esac
111
112 shift
113 done
114
115} 121}
116 122
117# @FUNCTION: base_src_configure 123# @FUNCTION: base_src_configure
118# @DESCRIPTION: 124# @DESCRIPTION:
119# The base src_prepare function, which is exported when EAPI=2. Performs 125# The base src_configure function, which is exported when
120# "base_src_work configure". 126# EAPI is greater or equal to 2. Runs basic econf.
121base_src_configure() { 127base_src_configure() {
122
123 debug-print-function $FUNCNAME "$@" 128 debug-print-function $FUNCNAME "$@"
124 129
125 base_src_work configure 130 # there is no pushd ${S} so we can override its place where to run
131 [[ -x ${ECONF_SOURCE:-.}/configure ]] && econf "$@"
126} 132}
127 133
128# @FUNCTION: base_src_compile 134# @FUNCTION: base_src_compile
129# @USAGE: [ configure ] [ make ] [ all ]
130# @DESCRIPTION: 135# @DESCRIPTION:
131# The base src_compile function, which is exported. If no argument is given, 136# The base src_compile function, calls src_configure with
132# "all" is assumed if EAPI!=2, "make" if EAPI=2. 137# EAPI older than 2.
133base_src_compile() { 138base_src_compile() {
134
135 debug-print-function $FUNCNAME "$@" 139 debug-print-function $FUNCNAME "$@"
136 140
137 if [ -z "$1" ] 141 has src_configure ${BASE_EXPF} || base_src_configure
138 then 142 base_src_make "$@"
139 case "${EAPI:-0}" in 143}
140 2) 144
141 base_src_work make 145# @FUNCTION: base_src_make
142 ;; 146# @DESCRIPTION:
143 *) 147# Actual function that runs emake command.
144 base_src_work all 148base_src_make() {
145 ;; 149 debug-print-function $FUNCNAME "$@"
146 esac 150
147 else 151 if [[ -f Makefile || -f GNUmakefile || -f makefile ]]; then
148 base_src_work $@ 152 emake "$@" || die "died running emake, $FUNCNAME"
149 fi 153 fi
150} 154}
151 155
152# @FUNCTION: base_src_work 156# @FUNCTION: base_src_install
153# @USAGE: [ configure ] [ make ] [ all ]
154# @DESCRIPTION: 157# @DESCRIPTION:
155# The base_src_work function is the grunt function for base src_configure 158# The base src_install function. Runs make install and
156# and base src_compile. 159# installs documents and html documents from DOCS and HTML_DOCS
157base_src_work() { 160# arrays.
158 161base_src_install() {
159 debug-print-function $FUNCNAME "$@" 162 debug-print-function $FUNCNAME "$@"
160 163
161 cd "${S}" 164 emake DESTDIR="${D}" "$@" install || die "died running make install, $FUNCNAME"
162 165 base_src_install_docs
163 while [ "$1" ]; do
164
165 case $1 in
166 configure)
167 debug-print-section configure
168 econf || die "died running econf, $FUNCNAME:configure"
169 ;;
170 make)
171 debug-print-section make
172 emake || die "died running emake, $FUNCNAME:make"
173 ;;
174 all)
175 debug-print-section all
176 base_src_work configure make
177 ;;
178 esac
179
180 shift
181 done
182
183} 166}
184 167
185# @FUNCTION: base_src_install 168# @FUNCTION: base_src_install_docs
186# @USAGE: [ make ] [ all ]
187# @DESCRIPTION: 169# @DESCRIPTION:
188# The base src_install function, which is exported. If no argument is given, 170# Actual function that install documentation from
189# "all" is assumed. 171# DOCS and HTML_DOCS arrays.
190base_src_install() { 172base_src_install_docs() {
173 debug-print-function $FUNCNAME "$@"
191 174
192 debug-print-function $FUNCNAME "$@" 175 local x
193 [ -z "$1" ] && base_src_install all
194 176
195 cd "${S}" 177 pushd "${S}" > /dev/null
196 178
197 while [ "$1" ]; do 179 if [[ "$(declare -p DOCS 2>/dev/null 2>&1)" == "declare -a"* ]]; then
180 for x in "${DOCS[@]}"; do
181 debug-print "$FUNCNAME: docs: creating document from ${x}"
182 dodoc "${x}" || die "dodoc failed"
183 done
184 fi
185 if [[ "$(declare -p HTML_DOCS 2>/dev/null 2>&1)" == "declare -a"* ]]; then
186 for x in "${HTML_DOCS[@]}"; do
187 debug-print "$FUNCNAME: docs: creating html document from ${x}"
188 dohtml -r "${x}" || die "dohtml failed"
189 done
190 fi
198 191
199 case $1 in 192 popd > /dev/null
200 make) 193}
201 debug-print-section make
202 make DESTDIR="${D}" install || die "died running make install, $FUNCNAME:make"
203 ;;
204 all)
205 debug-print-section all
206 base_src_install make
207 ;;
208 esac
209 194
210 shift 195fi
211 done
212
213}

Legend:
Removed from v.1.35  
changed lines
  Added in v.1.56

  ViewVC Help
Powered by ViewVC 1.1.20