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