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

Contents of /eclass/eutils.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.429 - (hide annotations) (download)
Fri Dec 27 09:28:42 2013 UTC (7 months ago) by mgorny
Branch: MAIN
Changes since 1.428: +25 -1 lines
Document einstalldocs.

1 mgorny 1.410 # Copyright 1999-2013 Gentoo Foundation
2 azarah 1.1 # Distributed under the terms of the GNU General Public License v2
3 mgorny 1.429 # $Header: /var/cvsroot/gentoo-x86/eclass/eutils.eclass,v 1.428 2013/12/03 08:09:49 vapier Exp $
4 vapier 1.283
5     # @ECLASS: eutils.eclass
6     # @MAINTAINER:
7     # base-system@gentoo.org
8     # @BLURB: many extra (but common) functions that are used in ebuilds
9     # @DESCRIPTION:
10     # The eutils eclass contains a suite of functions that complement
11     # the ones that ebuild.sh already contain. The idea is that the functions
12     # are not required in all ebuilds but enough utilize them to have a common
13     # home rather than having multiple ebuilds implementing the same thing.
14 swegener 1.286 #
15 vapier 1.283 # Due to the nature of this eclass, some functions may have maintainers
16     # different from the overall eclass!
17 azarah 1.1
18 vapier 1.371 if [[ ${___ECLASS_ONCE_EUTILS} != "recur -_+^+_- spank" ]] ; then
19     ___ECLASS_ONCE_EUTILS="recur -_+^+_- spank"
20    
21 mgorny 1.395 inherit multilib toolchain-funcs user
22 azarah 1.1
23 betelgeuse 1.329 if has "${EAPI:-0}" 0 1 2; then
24    
25 vapier 1.283 # @FUNCTION: epause
26     # @USAGE: [seconds]
27     # @DESCRIPTION:
28     # Sleep for the specified number of seconds (default of 5 seconds). Useful when
29     # printing a message the user should probably be reading and often used in
30     # conjunction with the ebeep function. If the EPAUSE_IGNORE env var is set,
31 betelgeuse 1.329 # don't wait at all. Defined in EAPIs 0 1 and 2.
32 ciaranm 1.98 epause() {
33 vapier 1.245 [[ -z ${EPAUSE_IGNORE} ]] && sleep ${1:-5}
34 ciaranm 1.98 }
35    
36 vapier 1.283 # @FUNCTION: ebeep
37     # @USAGE: [number of beeps]
38     # @DESCRIPTION:
39     # Issue the specified number of beeps (default of 5 beeps). Useful when
40     # printing a message the user should probably be reading and often used in
41     # conjunction with the epause function. If the EBEEP_IGNORE env var is set,
42 betelgeuse 1.329 # don't beep at all. Defined in EAPIs 0 1 and 2.
43 ciaranm 1.98 ebeep() {
44     local n
45 vapier 1.245 if [[ -z ${EBEEP_IGNORE} ]] ; then
46 ciaranm 1.98 for ((n=1 ; n <= ${1:-5} ; n++)) ; do
47     echo -ne "\a"
48     sleep 0.1 &>/dev/null ; sleep 0,1 &>/dev/null
49     echo -ne "\a"
50     sleep 1
51     done
52     fi
53     }
54    
55 reavertm 1.331 else
56    
57 reavertm 1.332 ebeep() {
58 reavertm 1.337 ewarn "QA Notice: ebeep is not defined in EAPI=${EAPI}, please file a bug at http://bugs.gentoo.org"
59 reavertm 1.332 }
60 reavertm 1.331
61 reavertm 1.332 epause() {
62 reavertm 1.337 ewarn "QA Notice: epause is not defined in EAPI=${EAPI}, please file a bug at http://bugs.gentoo.org"
63 reavertm 1.332 }
64 reavertm 1.331
65 betelgeuse 1.329 fi
66    
67 betelgeuse 1.348 # @FUNCTION: eqawarn
68     # @USAGE: [message]
69     # @DESCRIPTION:
70 mgorny 1.363 # Proxy to ewarn for package managers that don't provide eqawarn and use the PM
71     # implementation if available. Reuses PORTAGE_ELOG_CLASSES as set by the dev
72     # profile.
73 betelgeuse 1.348 if ! declare -F eqawarn >/dev/null ; then
74     eqawarn() {
75 mgorny 1.363 has qa ${PORTAGE_ELOG_CLASSES} && ewarn "$@"
76 ferringb 1.370 :
77 betelgeuse 1.348 }
78     fi
79    
80 hollow 1.298 # @FUNCTION: ecvs_clean
81 vapier 1.299 # @USAGE: [list of dirs]
82 hollow 1.298 # @DESCRIPTION:
83 vapier 1.299 # Remove CVS directories recursiveley. Useful when a source tarball contains
84     # internal CVS directories. Defaults to $PWD.
85 hollow 1.298 ecvs_clean() {
86 vapier 1.299 [[ -z $* ]] && set -- .
87 hollow 1.298 find "$@" -type d -name 'CVS' -prune -print0 | xargs -0 rm -rf
88     find "$@" -type f -name '.cvs*' -print0 | xargs -0 rm -rf
89     }
90    
91     # @FUNCTION: esvn_clean
92 vapier 1.299 # @USAGE: [list of dirs]
93 hollow 1.298 # @DESCRIPTION:
94 vapier 1.299 # Remove .svn directories recursiveley. Useful when a source tarball contains
95     # internal Subversion directories. Defaults to $PWD.
96 hollow 1.298 esvn_clean() {
97 vapier 1.299 [[ -z $* ]] && set -- .
98 hollow 1.298 find "$@" -type d -name '.svn' -prune -print0 | xargs -0 rm -rf
99     }
100    
101 vapier 1.373 # @FUNCTION: estack_push
102     # @USAGE: <stack> [items to push]
103     # @DESCRIPTION:
104     # Push any number of items onto the specified stack. Pick a name that
105     # is a valid variable (i.e. stick to alphanumerics), and push as many
106     # items as you like onto the stack at once.
107     #
108     # The following code snippet will echo 5, then 4, then 3, then ...
109     # @CODE
110     # estack_push mystack 1 2 3 4 5
111     # while estack_pop mystack i ; do
112     # echo "${i}"
113     # done
114     # @CODE
115     estack_push() {
116     [[ $# -eq 0 ]] && die "estack_push: incorrect # of arguments"
117     local stack_name="__ESTACK_$1__" ; shift
118     eval ${stack_name}+=\( \"\$@\" \)
119     }
120    
121     # @FUNCTION: estack_pop
122     # @USAGE: <stack> [variable]
123     # @DESCRIPTION:
124     # Pop a single item off the specified stack. If a variable is specified,
125     # the popped item is stored there. If no more items are available, return
126     # 1, else return 0. See estack_push for more info.
127     estack_pop() {
128     [[ $# -eq 0 || $# -gt 2 ]] && die "estack_pop: incorrect # of arguments"
129    
130     # We use the fugly __estack_xxx var names to avoid collision with
131     # passing back the return value. If we used "local i" and the
132     # caller ran `estack_pop ... i`, we'd end up setting the local
133     # copy of "i" rather than the caller's copy. The __estack_xxx
134     # garbage is preferable to using $1/$2 everywhere as that is a
135     # bit harder to read.
136     local __estack_name="__ESTACK_$1__" ; shift
137     local __estack_retvar=$1 ; shift
138 vapier 1.376 eval local __estack_i=\${#${__estack_name}\[@\]}
139 vapier 1.373 # Don't warn -- let the caller interpret this as a failure
140     # or as normal behavior (akin to `shift`)
141     [[ $(( --__estack_i )) -eq -1 ]] && return 1
142    
143     if [[ -n ${__estack_retvar} ]] ; then
144 vapier 1.376 eval ${__estack_retvar}=\"\${${__estack_name}\[${__estack_i}\]}\"
145 vapier 1.373 fi
146 vapier 1.376 eval unset ${__estack_name}\[${__estack_i}\]
147 vapier 1.373 }
148    
149 vapier 1.423 # @FUNCTION: evar_push
150     # @USAGE: <variable to save> [more vars to save]
151     # @DESCRIPTION:
152     # This let's you temporarily modify a variable and then restore it (including
153     # set vs unset semantics). Arrays are not supported at this time.
154     #
155     # This is meant for variables where using `local` does not work (such as
156     # exported variables, or only temporarily changing things in a func).
157     #
158     # For example:
159     # @CODE
160     # evar_push LC_ALL
161     # export LC_ALL=C
162     # ... do some stuff that needs LC_ALL=C set ...
163     # evar_pop
164     #
165     # # You can also save/restore more than one var at a time
166     # evar_push BUTTERFLY IN THE SKY
167     # ... do stuff with the vars ...
168     # evar_pop # This restores just one var, SKY
169     # ... do more stuff ...
170     # evar_pop 3 # This pops the remaining 3 vars
171     # @CODE
172     evar_push() {
173     local var val
174     for var ; do
175     [[ ${!var+set} == "set" ]] \
176     && val=${!var} \
177     || val="${___ECLASS_ONCE_EUTILS}"
178     estack_push evar "${var}" "${val}"
179     done
180     }
181    
182     # @FUNCTION: evar_push_set
183     # @USAGE: <variable to save> [new value to store]
184     # @DESCRIPTION:
185     # This is a handy shortcut to save and temporarily set a variable. If a value
186     # is not specified, the var will be unset.
187     evar_push_set() {
188     local var=$1
189     evar_push ${var}
190     case $# in
191     1) unset ${var} ;;
192     2) printf -v "${var}" '%s' "$2" ;;
193     *) die "${FUNCNAME}: incorrect # of args: $*" ;;
194     esac
195     }
196    
197     # @FUNCTION: evar_pop
198     # @USAGE: [number of vars to restore]
199     # @DESCRIPTION:
200     # Restore the variables to the state saved with the corresponding
201     # evar_push call. See that function for more details.
202     evar_pop() {
203     local cnt=${1:-bad}
204     case $# in
205     0) cnt=1 ;;
206     1) isdigit "${cnt}" || die "${FUNCNAME}: first arg must be a number: $*" ;;
207     *) die "${FUNCNAME}: only accepts one arg: $*" ;;
208     esac
209    
210     local var val
211     while (( cnt-- )) ; do
212     estack_pop evar val || die "${FUNCNAME}: unbalanced push"
213     estack_pop evar var || die "${FUNCNAME}: unbalanced push"
214     [[ ${val} == "${___ECLASS_ONCE_EUTILS}" ]] \
215     && unset ${var} \
216     || printf -v "${var}" '%s' "${val}"
217     done
218     }
219    
220 vapier 1.322 # @FUNCTION: eshopts_push
221 vapier 1.330 # @USAGE: [options to `set` or `shopt`]
222 vapier 1.322 # @DESCRIPTION:
223     # Often times code will want to enable a shell option to change code behavior.
224     # Since changing shell options can easily break other pieces of code (which
225     # assume the default state), eshopts_push is used to (1) push the current shell
226     # options onto a stack and (2) pass the specified arguments to set.
227     #
228 vapier 1.330 # If the first argument is '-s' or '-u', we assume you want to call `shopt`
229     # rather than `set` as there are some options only available via that.
230     #
231 vapier 1.322 # A common example is to disable shell globbing so that special meaning/care
232     # may be used with variables/arguments to custom functions. That would be:
233     # @CODE
234 vapier 1.376 # eshopts_push -s noglob
235 vapier 1.322 # for x in ${foo} ; do
236     # if ...some check... ; then
237     # eshopts_pop
238     # return 0
239     # fi
240     # done
241     # eshopts_pop
242     # @CODE
243     eshopts_push() {
244 vapier 1.330 if [[ $1 == -[su] ]] ; then
245 vapier 1.376 estack_push eshopts "$(shopt -p)"
246 vapier 1.330 [[ $# -eq 0 ]] && return 0
247 vapier 1.375 shopt "$@" || die "${FUNCNAME}: bad options to shopt: $*"
248 vapier 1.330 else
249 vapier 1.376 estack_push eshopts $-
250 vapier 1.330 [[ $# -eq 0 ]] && return 0
251 vapier 1.375 set "$@" || die "${FUNCNAME}: bad options to set: $*"
252 vapier 1.330 fi
253 vapier 1.322 }
254    
255     # @FUNCTION: eshopts_pop
256     # @USAGE:
257     # @DESCRIPTION:
258     # Restore the shell options to the state saved with the corresponding
259     # eshopts_push call. See that function for more details.
260     eshopts_pop() {
261 vapier 1.376 local s
262     estack_pop eshopts s || die "${FUNCNAME}: unbalanced push"
263 vapier 1.330 if [[ ${s} == "shopt -"* ]] ; then
264 vapier 1.375 eval "${s}" || die "${FUNCNAME}: sanity: invalid shopt options: ${s}"
265 vapier 1.330 else
266 vapier 1.375 set +$- || die "${FUNCNAME}: sanity: invalid shell settings: $-"
267     set -${s} || die "${FUNCNAME}: sanity: unable to restore saved shell settings: ${s}"
268 vapier 1.330 fi
269 vapier 1.322 }
270    
271 vapier 1.373 # @FUNCTION: eumask_push
272     # @USAGE: <new umask>
273     # @DESCRIPTION:
274     # Set the umask to the new value specified while saving the previous
275     # value onto a stack. Useful for temporarily changing the umask.
276     eumask_push() {
277     estack_push eumask "$(umask)"
278     umask "$@" || die "${FUNCNAME}: bad options to umask: $*"
279     }
280    
281     # @FUNCTION: eumask_pop
282     # @USAGE:
283     # @DESCRIPTION:
284     # Restore the previous umask state.
285     eumask_pop() {
286 vapier 1.382 [[ $# -eq 0 ]] || die "${FUNCNAME}: we take no options"
287 vapier 1.373 local s
288     estack_pop eumask s || die "${FUNCNAME}: unbalanced push"
289     umask ${s} || die "${FUNCNAME}: sanity: could not restore umask: ${s}"
290     }
291    
292 vapier 1.422 # @FUNCTION: isdigit
293     # @USAGE: <number> [more numbers]
294     # @DESCRIPTION:
295     # Return true if all arguments are numbers.
296     isdigit() {
297     local d
298     for d ; do
299     [[ ${d:-bad} == *[!0-9]* ]] && return 1
300     done
301     return 0
302     }
303    
304 vapier 1.325 # @VARIABLE: EPATCH_SOURCE
305     # @DESCRIPTION:
306     # Default directory to search for patches.
307 azarah 1.2 EPATCH_SOURCE="${WORKDIR}/patch"
308 vapier 1.325 # @VARIABLE: EPATCH_SUFFIX
309     # @DESCRIPTION:
310     # Default extension for patches (do not prefix the period yourself).
311 azarah 1.2 EPATCH_SUFFIX="patch.bz2"
312 vapier 1.325 # @VARIABLE: EPATCH_OPTS
313     # @DESCRIPTION:
314 vapier 1.391 # Options to pass to patch. Meant for ebuild/package-specific tweaking
315     # such as forcing the patch level (-p#) or fuzz (-F#) factor. Note that
316     # for single patch tweaking, you can also pass flags directly to epatch.
317     EPATCH_OPTS=""
318     # @VARIABLE: EPATCH_COMMON_OPTS
319     # @DESCRIPTION:
320     # Common options to pass to `patch`. You probably should never need to
321     # change these. If you do, please discuss it with base-system first to
322     # be sure.
323 vapier 1.325 # @CODE
324     # -g0 - keep RCS, ClearCase, Perforce and SCCS happy #24571
325     # --no-backup-if-mismatch - do not leave .orig files behind
326     # -E - automatically remove empty files
327     # @CODE
328 vapier 1.391 EPATCH_COMMON_OPTS="-g0 -E --no-backup-if-mismatch"
329 vapier 1.325 # @VARIABLE: EPATCH_EXCLUDE
330     # @DESCRIPTION:
331 mr_bones_ 1.308 # List of patches not to apply. Note this is only file names,
332 vapier 1.325 # and not the full path. Globs accepted.
333 azarah 1.6 EPATCH_EXCLUDE=""
334 vapier 1.325 # @VARIABLE: EPATCH_SINGLE_MSG
335     # @DESCRIPTION:
336 azarah 1.9 # Change the printed message for a single patch.
337     EPATCH_SINGLE_MSG=""
338 vapier 1.325 # @VARIABLE: EPATCH_MULTI_MSG
339     # @DESCRIPTION:
340 vapier 1.173 # Change the printed message for multiple patches.
341     EPATCH_MULTI_MSG="Applying various patches (bugfixes/updates) ..."
342 vapier 1.325 # @VARIABLE: EPATCH_FORCE
343     # @DESCRIPTION:
344     # Only require patches to match EPATCH_SUFFIX rather than the extended
345     # arch naming style.
346 azarah 1.29 EPATCH_FORCE="no"
347 vapier 1.416 # @VARIABLE: EPATCH_USER_EXCLUDE
348     # @DEFAULT_UNSET
349     # @DESCRIPTION:
350     # List of patches not to apply. Note this is only file names,
351     # and not the full path. Globs accepted.
352 azarah 1.2
353 vapier 1.325 # @FUNCTION: epatch
354 vapier 1.391 # @USAGE: [options] [patches] [dirs of patches]
355 vapier 1.325 # @DESCRIPTION:
356     # epatch is designed to greatly simplify the application of patches. It can
357     # process patch files directly, or directories of patches. The patches may be
358     # compressed (bzip/gzip/etc...) or plain text. You generally need not specify
359 vapier 1.425 # the -p option as epatch will automatically attempt -p0 to -p4 until things
360 vapier 1.325 # apply successfully.
361 azarah 1.2 #
362 vapier 1.391 # If you do not specify any patches/dirs, then epatch will default to the
363     # directory specified by EPATCH_SOURCE.
364     #
365     # Any options specified that start with a dash will be passed down to patch
366     # for this specific invocation. As soon as an arg w/out a dash is found, then
367     # arg processing stops.
368 azarah 1.2 #
369 vapier 1.325 # When processing directories, epatch will apply all patches that match:
370     # @CODE
371 vapier 1.350 # if ${EPATCH_FORCE} != "yes"
372 vapier 1.325 # ??_${ARCH}_foo.${EPATCH_SUFFIX}
373     # else
374     # *.${EPATCH_SUFFIX}
375     # @CODE
376     # The leading ?? are typically numbers used to force consistent patch ordering.
377     # The arch field is used to apply patches only for the host architecture with
378     # the special value of "all" means apply for everyone. Note that using values
379     # other than "all" is highly discouraged -- you should apply patches all the
380     # time and let architecture details be detected at configure/compile time.
381 azarah 1.2 #
382 vapier 1.325 # If EPATCH_SUFFIX is empty, then no period before it is implied when searching
383     # for patches to apply.
384 azarah 1.2 #
385 vapier 1.325 # Refer to the other EPATCH_xxx variables for more customization of behavior.
386 azarah 1.2 epatch() {
387 swegener 1.231 _epatch_draw_line() {
388 vapier 1.325 # create a line of same length as input string
389 agriffis 1.229 [[ -z $1 ]] && set "$(printf "%65s" '')"
390     echo "${1//?/=}"
391 vapier 1.219 }
392 azarah 1.3
393 vapier 1.195 unset P4CONFIG P4PORT P4USER # keep perforce at bay #56402
394    
395 vapier 1.391 # First process options. We localize the EPATCH_OPTS setting
396     # from above so that we can pass it on in the loop below with
397     # any additional values the user has specified.
398     local EPATCH_OPTS=( ${EPATCH_OPTS[*]} )
399     while [[ $# -gt 0 ]] ; do
400     case $1 in
401     -*) EPATCH_OPTS+=( "$1" ) ;;
402     *) break ;;
403     esac
404     shift
405     done
406    
407 vapier 1.325 # Let the rest of the code process one user arg at a time --
408     # each arg may expand into multiple patches, and each arg may
409     # need to start off with the default global EPATCH_xxx values
410     if [[ $# -gt 1 ]] ; then
411     local m
412 vapier 1.94 for m in "$@" ; do
413     epatch "${m}"
414     done
415     return 0
416 azarah 1.3 fi
417    
418 vapier 1.325 local SINGLE_PATCH="no"
419     # no args means process ${EPATCH_SOURCE}
420     [[ $# -eq 0 ]] && set -- "${EPATCH_SOURCE}"
421    
422     if [[ -f $1 ]] ; then
423 azarah 1.3 SINGLE_PATCH="yes"
424 vapier 1.325 set -- "$1"
425     # Use the suffix from the single patch (localize it); the code
426     # below will find the suffix for us
427     local EPATCH_SUFFIX=$1
428    
429     elif [[ -d $1 ]] ; then
430 vapier 1.424 # We have to force sorting to C so that the wildcard expansion is consistent #471666.
431     evar_push_set LC_COLLATE C
432     # Some people like to make dirs of patches w/out suffixes (vim).
433 vapier 1.325 set -- "$1"/*${EPATCH_SUFFIX:+."${EPATCH_SUFFIX}"}
434 vapier 1.424 evar_pop
435 danarmak 1.32
436 vapier 1.359 elif [[ -f ${EPATCH_SOURCE}/$1 ]] ; then
437     # Re-use EPATCH_SOURCE as a search dir
438     epatch "${EPATCH_SOURCE}/$1"
439     return $?
440    
441 azarah 1.3 else
442 vapier 1.325 # sanity check ... if it isn't a dir or file, wtf man ?
443     [[ $# -ne 0 ]] && EPATCH_SOURCE=$1
444     echo
445     eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:"
446     eerror
447     eerror " ${EPATCH_SOURCE}"
448     eerror " ( ${EPATCH_SOURCE##*/} )"
449     echo
450     die "Cannot find \$EPATCH_SOURCE!"
451 azarah 1.3 fi
452 azarah 1.2
453 vapier 1.391 # Now that we know we're actually going to apply something, merge
454     # all of the patch options back in to a single variable for below.
455     EPATCH_OPTS="${EPATCH_COMMON_OPTS} ${EPATCH_OPTS[*]}"
456    
457 vapier 1.325 local PIPE_CMD
458 azarah 1.2 case ${EPATCH_SUFFIX##*\.} in
459 vapier 1.325 xz) PIPE_CMD="xz -dc" ;;
460     lzma) PIPE_CMD="lzma -dc" ;;
461     bz2) PIPE_CMD="bzip2 -dc" ;;
462     gz|Z|z) PIPE_CMD="gzip -dc" ;;
463     ZIP|zip) PIPE_CMD="unzip -p" ;;
464     *) ;;
465 azarah 1.2 esac
466    
467 vapier 1.325 [[ ${SINGLE_PATCH} == "no" ]] && einfo "${EPATCH_MULTI_MSG}"
468    
469     local x
470     for x in "$@" ; do
471     # If the patch dir given contains subdirs, or our EPATCH_SUFFIX
472     # didn't match anything, ignore continue on
473     [[ ! -f ${x} ]] && continue
474    
475     local patchname=${x##*/}
476    
477     # Apply single patches, or forced sets of patches, or
478     # patches with ARCH dependant names.
479 flameeyes 1.266 # ???_arch_foo.patch
480 vapier 1.325 # Else, skip this input altogether
481     local a=${patchname#*_} # strip the ???_
482     a=${a%%_*} # strip the _foo.patch
483     if ! [[ ${SINGLE_PATCH} == "yes" || \
484 ulm 1.354 ${EPATCH_FORCE} == "yes" || \
485     ${a} == all || \
486     ${a} == ${ARCH} ]]
487 azarah 1.2 then
488 vapier 1.325 continue
489     fi
490 azarah 1.6
491 vapier 1.325 # Let people filter things dynamically
492     if [[ -n ${EPATCH_EXCLUDE} ]] ; then
493     # let people use globs in the exclude
494     eshopts_push -o noglob
495    
496 scarabeus 1.328 local ex
497 vapier 1.325 for ex in ${EPATCH_EXCLUDE} ; do
498 scarabeus 1.328 if [[ ${patchname} == ${ex} ]] ; then
499 vapier 1.416 einfo " Skipping ${patchname} due to EPATCH_EXCLUDE ..."
500     eshopts_pop
501     continue 2
502     fi
503     done
504    
505     for ex in ${EPATCH_USER_EXCLUDE} ; do
506     if [[ ${patchname} == ${ex} ]] ; then
507     einfo " Skipping ${patchname} due to EPATCH_USER_EXCLUDE ..."
508 scarabeus 1.328 eshopts_pop
509     continue 2
510     fi
511 vapier 1.325 done
512 vapier 1.326
513 vapier 1.325 eshopts_pop
514     fi
515 danarmak 1.32
516 vapier 1.325 if [[ ${SINGLE_PATCH} == "yes" ]] ; then
517     if [[ -n ${EPATCH_SINGLE_MSG} ]] ; then
518     einfo "${EPATCH_SINGLE_MSG}"
519 azarah 1.3 else
520 vapier 1.325 einfo "Applying ${patchname} ..."
521 azarah 1.3 fi
522 vapier 1.325 else
523     einfo " ${patchname} ..."
524     fi
525 azarah 1.2
526 vapier 1.325 # most of the time, there will only be one run per unique name,
527     # but if there are more, make sure we get unique log filenames
528     local STDERR_TARGET="${T}/${patchname}.out"
529     if [[ -e ${STDERR_TARGET} ]] ; then
530     STDERR_TARGET="${T}/${patchname}-$$.out"
531     fi
532 azarah 1.2
533 vapier 1.369 printf "***** %s *****\nPWD: %s\n\n" "${patchname}" "${PWD}" > "${STDERR_TARGET}"
534 vapier 1.304
535 vapier 1.325 # Decompress the patch if need be
536     local count=0
537     local PATCH_TARGET
538     if [[ -n ${PIPE_CMD} ]] ; then
539     PATCH_TARGET="${T}/$$.patch"
540     echo "PIPE_COMMAND: ${PIPE_CMD} ${x} > ${PATCH_TARGET}" >> "${STDERR_TARGET}"
541 vapier 1.304
542 vapier 1.325 if ! (${PIPE_CMD} "${x}" > "${PATCH_TARGET}") >> "${STDERR_TARGET}" 2>&1 ; then
543     echo
544     eerror "Could not extract patch!"
545     #die "Could not extract patch!"
546     count=5
547     break
548 vapier 1.305 fi
549 vapier 1.325 else
550     PATCH_TARGET=${x}
551     fi
552 vapier 1.305
553 vapier 1.325 # Check for absolute paths in patches. If sandbox is disabled,
554     # people could (accidently) patch files in the root filesystem.
555     # Or trigger other unpleasantries #237667. So disallow -p0 on
556     # such patches.
557     local abs_paths=$(egrep -n '^[-+]{3} /' "${PATCH_TARGET}" | awk '$2 != "/dev/null" { print }')
558     if [[ -n ${abs_paths} ]] ; then
559     count=1
560     printf "NOTE: skipping -p0 due to absolute paths in patch:\n%s\n" "${abs_paths}" >> "${STDERR_TARGET}"
561     fi
562 vapier 1.353 # Similar reason, but with relative paths.
563     local rel_paths=$(egrep -n '^[-+]{3} [^ ]*[.][.]/' "${PATCH_TARGET}")
564     if [[ -n ${rel_paths} ]] ; then
565 vapier 1.419 echo
566     eerror "Rejected Patch: ${patchname} !"
567     eerror " ( ${PATCH_TARGET} )"
568     eerror
569     eerror "Your patch uses relative paths '../':"
570     eerror "${rel_paths}"
571     echo
572     die "you need to fix the relative paths in patch"
573 vapier 1.353 fi
574 vapier 1.325
575     # Dynamically detect the correct -p# ... i'm lazy, so shoot me :/
576 vapier 1.383 local patch_cmd
577 vapier 1.417 # Handle aliased patch command #404447 #461568
578     local patch="patch"
579     eval $(alias patch 2>/dev/null | sed 's:^alias ::')
580 vapier 1.325 while [[ ${count} -lt 5 ]] ; do
581 vapier 1.417 patch_cmd="${patch} -p${count} ${EPATCH_OPTS}"
582 vapier 1.383
583 vapier 1.325 # Generate some useful debug info ...
584     (
585     _epatch_draw_line "***** ${patchname} *****"
586     echo
587 vapier 1.383 echo "PATCH COMMAND: ${patch_cmd} < '${PATCH_TARGET}'"
588 vapier 1.325 echo
589     _epatch_draw_line "***** ${patchname} *****"
590 vapier 1.383 ${patch_cmd} --dry-run -f < "${PATCH_TARGET}" 2>&1
591 vapier 1.360 ret=$?
592     echo
593     echo "patch program exited with status ${ret}"
594     exit ${ret}
595 vapier 1.325 ) >> "${STDERR_TARGET}"
596 azarah 1.8
597 vapier 1.360 if [ $? -eq 0 ] ; then
598 vapier 1.325 (
599     _epatch_draw_line "***** ${patchname} *****"
600     echo
601     echo "ACTUALLY APPLYING ${patchname} ..."
602     echo
603     _epatch_draw_line "***** ${patchname} *****"
604 vapier 1.383 ${patch_cmd} < "${PATCH_TARGET}" 2>&1
605 vapier 1.360 ret=$?
606     echo
607     echo "patch program exited with status ${ret}"
608     exit ${ret}
609 vapier 1.325 ) >> "${STDERR_TARGET}"
610 danarmak 1.32
611 vapier 1.325 if [ $? -ne 0 ] ; then
612     echo
613     eerror "A dry-run of patch command succeeded, but actually"
614     eerror "applying the patch failed!"
615     #die "Real world sux compared to the dreamworld!"
616     count=5
617 azarah 1.2 fi
618 vapier 1.325 break
619 azarah 1.8 fi
620    
621 vapier 1.325 : $(( count++ ))
622     done
623 azarah 1.8
624 vapier 1.325 # if we had to decompress the patch, delete the temp one
625     if [[ -n ${PIPE_CMD} ]] ; then
626     rm -f "${PATCH_TARGET}"
627     fi
628 azarah 1.3
629 vapier 1.325 if [[ ${count} -ge 5 ]] ; then
630     echo
631     eerror "Failed Patch: ${patchname} !"
632     eerror " ( ${PATCH_TARGET} )"
633     eerror
634     eerror "Include in your bugreport the contents of:"
635     eerror
636     eerror " ${STDERR_TARGET}"
637     echo
638     die "Failed Patch: ${patchname}!"
639 azarah 1.2 fi
640 vapier 1.325
641 vapier 1.383 # if everything worked, delete the full debug patch log
642 vapier 1.325 rm -f "${STDERR_TARGET}"
643 vapier 1.383
644     # then log away the exact stuff for people to review later
645     cat <<-EOF >> "${T}/epatch.log"
646     PATCH: ${x}
647     CMD: ${patch_cmd}
648     PWD: ${PWD}
649    
650     EOF
651 vapier 1.325 eend 0
652 azarah 1.2 done
653 vapier 1.325
654     [[ ${SINGLE_PATCH} == "no" ]] && einfo "Done with patching"
655     : # everything worked
656 azarah 1.26 }
657 vapier 1.361
658     # @FUNCTION: epatch_user
659     # @USAGE:
660     # @DESCRIPTION:
661     # Applies user-provided patches to the source tree. The patches are
662 vapier 1.406 # taken from /etc/portage/patches/<CATEGORY>/<PF|P|PN>[:SLOT]/, where the first
663 vapier 1.361 # of these three directories to exist will be the one to use, ignoring
664 vapier 1.387 # any more general directories which might exist as well. They must end
665     # in ".patch" to be applied.
666 vapier 1.361 #
667     # User patches are intended for quick testing of patches without ebuild
668     # modifications, as well as for permanent customizations a user might
669     # desire. Obviously, there can be no official support for arbitrarily
670     # patched ebuilds. So whenever a build log in a bug report mentions that
671     # user patches were applied, the user should be asked to reproduce the
672     # problem without these.
673     #
674     # Not all ebuilds do call this function, so placing patches in the
675     # stated directory might or might not work, depending on the package and
676     # the eclasses it inherits and uses. It is safe to call the function
677     # repeatedly, so it is always possible to add a call at the ebuild
678     # level. The first call is the time when the patches will be
679     # applied.
680     #
681     # Ideally, this function should be called after gentoo-specific patches
682     # have been applied, so that their code can be modified as well, but
683     # before calls to e.g. eautoreconf, as the user patches might affect
684     # autotool input files as well.
685 vapier 1.318 epatch_user() {
686     [[ $# -ne 0 ]] && die "epatch_user takes no options"
687    
688 vapier 1.361 # Allow multiple calls to this function; ignore all but the first
689 vapier 1.383 local applied="${T}/epatch_user.log"
690 vapier 1.361 [[ -e ${applied} ]] && return 2
691    
692 vapier 1.318 # don't clobber any EPATCH vars that the parent might want
693 zmedico 1.323 local EPATCH_SOURCE check base=${PORTAGE_CONFIGROOT%/}/etc/portage/patches
694 vapier 1.406 for check in ${CATEGORY}/{${P}-${PR},${P},${PN}}{,:${SLOT}}; do
695 vapier 1.318 EPATCH_SOURCE=${base}/${CTARGET}/${check}
696     [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${CHOST}/${check}
697     [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${check}
698     if [[ -d ${EPATCH_SOURCE} ]] ; then
699     EPATCH_SOURCE=${EPATCH_SOURCE} \
700     EPATCH_SUFFIX="patch" \
701     EPATCH_FORCE="yes" \
702     EPATCH_MULTI_MSG="Applying user patches from ${EPATCH_SOURCE} ..." \
703     epatch
704 vapier 1.361 echo "${EPATCH_SOURCE}" > "${applied}"
705 vapier 1.349 return 0
706 vapier 1.318 fi
707     done
708 vapier 1.361 echo "none" > "${applied}"
709 vapier 1.349 return 1
710 vapier 1.318 }
711 azarah 1.26
712 vapier 1.283 # @FUNCTION: emktemp
713     # @USAGE: [temp dir]
714     # @DESCRIPTION:
715 vapier 1.52 # Cheap replacement for when debianutils (and thus mktemp)
716 vapier 1.283 # does not exist on the users system.
717 vapier 1.117 emktemp() {
718 vapier 1.119 local exe="touch"
719 vapier 1.194 [[ $1 == -d ]] && exe="mkdir" && shift
720     local topdir=$1
721 mr_bones_ 1.100
722 vapier 1.194 if [[ -z ${topdir} ]] ; then
723     [[ -z ${T} ]] \
724 vapier 1.117 && topdir="/tmp" \
725 vapier 1.194 || topdir=${T}
726 vapier 1.117 fi
727    
728 vapier 1.280 if ! type -P mktemp > /dev/null ; then
729     # system lacks `mktemp` so we have to fake it
730 vapier 1.117 local tmp=/
731 vapier 1.194 while [[ -e ${tmp} ]] ; do
732     tmp=${topdir}/tmp.${RANDOM}.${RANDOM}.${RANDOM}
733 vapier 1.117 done
734 vapier 1.194 ${exe} "${tmp}" || ${exe} -p "${tmp}"
735 vapier 1.117 echo "${tmp}"
736 vapier 1.52 else
737 vapier 1.280 # the args here will give slightly wierd names on BSD,
738     # but should produce a usable file on all userlands
739 flameeyes 1.223 if [[ ${exe} == "touch" ]] ; then
740 vapier 1.280 TMPDIR="${topdir}" mktemp -t tmp.XXXXXXXXXX
741 flameeyes 1.223 else
742 vapier 1.280 TMPDIR="${topdir}" mktemp -dt tmp.XXXXXXXXXX
743 flameeyes 1.223 fi
744 vapier 1.52 fi
745     }
746    
747 vapier 1.283 # @FUNCTION: edos2unix
748     # @USAGE: <file> [more files ...]
749     # @DESCRIPTION:
750     # A handy replacement for dos2unix, recode, fixdos, etc... This allows you
751     # to remove all of these text utilities from DEPEND variables because this
752     # is a script based solution. Just give it a list of files to convert and
753     # they will all be changed from the DOS CRLF format to the UNIX LF format.
754 vapier 1.24 edos2unix() {
755 vapier 1.366 [[ $# -eq 0 ]] && return 0
756     sed -i 's/\r$//' -- "$@" || die
757 vapier 1.39 }
758    
759 jlec 1.377 # @FUNCTION: make_desktop_entry
760     # @USAGE: make_desktop_entry(<command>, [name], [icon], [type], [fields])
761     # @DESCRIPTION:
762     # Make a .desktop file.
763     #
764     # @CODE
765     # binary: what command does the app run with ?
766     # name: the name that will show up in the menu
767 vapier 1.401 # icon: the icon to use in the menu entry
768 jlec 1.377 # this can be relative (to /usr/share/pixmaps) or
769     # a full path to an icon
770     # type: what kind of application is this?
771     # for categories:
772     # http://standards.freedesktop.org/menu-spec/latest/apa.html
773     # if unset, function tries to guess from package's category
774 vapier 1.341 # fields: extra fields to append to the desktop file; a printf string
775 jlec 1.377 # @CODE
776 vapier 1.39 make_desktop_entry() {
777 vapier 1.341 [[ -z $1 ]] && die "make_desktop_entry: You must specify the executable"
778 vapier 1.39
779 vapier 1.158 local exec=${1}
780     local name=${2:-${PN}}
781 wolf31o2 1.293 local icon=${3:-${PN}}
782 vapier 1.158 local type=${4}
783 vapier 1.341 local fields=${5}
784 vapier 1.158
785     if [[ -z ${type} ]] ; then
786     local catmaj=${CATEGORY%%-*}
787     local catmin=${CATEGORY##*-}
788     case ${catmaj} in
789     app)
790     case ${catmin} in
791 pacho 1.384 accessibility) type="Utility;Accessibility";;
792 vapier 1.338 admin) type=System;;
793     antivirus) type=System;;
794 pacho 1.384 arch) type="Utility;Archiving";;
795     backup) type="Utility;Archiving";;
796     cdr) type="AudioVideo;DiscBurning";;
797     dicts) type="Office;Dictionary";;
798 vapier 1.338 doc) type=Documentation;;
799 pacho 1.384 editors) type="Utility;TextEditor";;
800     emacs) type="Development;TextEditor";;
801     emulation) type="System;Emulator";;
802     laptop) type="Settings;HardwareSettings";;
803 vapier 1.338 office) type=Office;;
804 pacho 1.384 pda) type="Office;PDA";;
805     vim) type="Development;TextEditor";;
806     xemacs) type="Development;TextEditor";;
807 vapier 1.158 esac
808 azarah 1.59 ;;
809 vapier 1.158
810     dev)
811 vapier 1.159 type="Development"
812 vapier 1.158 ;;
813    
814     games)
815     case ${catmin} in
816 wolf31o2 1.265 action|fps) type=ActionGame;;
817 vapier 1.338 arcade) type=ArcadeGame;;
818     board) type=BoardGame;;
819     emulation) type=Emulator;;
820     kids) type=KidsGame;;
821     puzzle) type=LogicGame;;
822     roguelike) type=RolePlaying;;
823     rpg) type=RolePlaying;;
824 vapier 1.158 simulation) type=Simulation;;
825 vapier 1.338 sports) type=SportsGame;;
826     strategy) type=StrategyGame;;
827 vapier 1.158 esac
828 vapier 1.159 type="Game;${type}"
829 vapier 1.158 ;;
830    
831 vapier 1.284 gnome)
832     type="Gnome;GTK"
833     ;;
834    
835     kde)
836     type="KDE;Qt"
837     ;;
838    
839 vapier 1.158 mail)
840 vapier 1.159 type="Network;Email"
841 vapier 1.158 ;;
842    
843     media)
844     case ${catmin} in
845 vapier 1.339 gfx)
846     type=Graphics
847     ;;
848     *)
849     case ${catmin} in
850     radio) type=Tuner;;
851     sound) type=Audio;;
852     tv) type=TV;;
853     video) type=Video;;
854     esac
855     type="AudioVideo;${type}"
856     ;;
857 vapier 1.158 esac
858 wolf31o2 1.65 ;;
859 vapier 1.158
860     net)
861     case ${catmin} in
862     dialup) type=Dialup;;
863 vapier 1.338 ftp) type=FileTransfer;;
864     im) type=InstantMessaging;;
865     irc) type=IRCClient;;
866     mail) type=Email;;
867     news) type=News;;
868     nntp) type=News;;
869     p2p) type=FileTransfer;;
870     voip) type=Telephony;;
871 vapier 1.158 esac
872 vapier 1.159 type="Network;${type}"
873 vapier 1.158 ;;
874    
875     sci)
876     case ${catmin} in
877 vapier 1.284 astro*) type=Astronomy;;
878 vapier 1.338 bio*) type=Biology;;
879     calc*) type=Calculator;;
880     chem*) type=Chemistry;;
881 vapier 1.284 elec*) type=Electronics;;
882 vapier 1.338 geo*) type=Geology;;
883     math*) type=Math;;
884 vapier 1.284 physics) type=Physics;;
885     visual*) type=DataVisualization;;
886 vapier 1.159 esac
887 abcd 1.336 type="Education;Science;${type}"
888 vapier 1.158 ;;
889    
890 vapier 1.284 sys)
891     type="System"
892     ;;
893    
894 vapier 1.158 www)
895     case ${catmin} in
896     client) type=WebBrowser;;
897     esac
898 abcd 1.336 type="Network;${type}"
899 azarah 1.59 ;;
900 vapier 1.158
901 azarah 1.59 *)
902     type=
903     ;;
904 vapier 1.39 esac
905     fi
906 carlo 1.177 if [ "${SLOT}" == "0" ] ; then
907     local desktop_name="${PN}"
908     else
909     local desktop_name="${PN}-${SLOT}"
910     fi
911 vapier 1.272 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop"
912 vapier 1.271 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop
913 vapier 1.39
914 abcd 1.336 # Don't append another ";" when a valid category value is provided.
915     type=${type%;}${type:+;}
916    
917     eshopts_push -s extglob
918     if [[ -n ${icon} && ${icon} != /* ]] && [[ ${icon} == *.xpm || ${icon} == *.png || ${icon} == *.svg ]]; then
919     ewarn "As described in the Icon Theme Specification, icon file extensions are not"
920     ewarn "allowed in .desktop files if the value is not an absolute path."
921     icon=${icon%.@(xpm|png|svg)}
922     fi
923     eshopts_pop
924    
925 vapier 1.271 cat <<-EOF > "${desktop}"
926     [Desktop Entry]
927     Name=${name}
928     Type=Application
929     Comment=${DESCRIPTION}
930     Exec=${exec}
931     TryExec=${exec%% *}
932     Icon=${icon}
933 abcd 1.336 Categories=${type}
934 vapier 1.271 EOF
935 vapier 1.39
936 vapier 1.341 if [[ ${fields:-=} != *=* ]] ; then
937     # 5th arg used to be value to Path=
938     ewarn "make_desktop_entry: update your 5th arg to read Path=${fields}"
939     fields="Path=${fields}"
940     fi
941 vapier 1.342 [[ -n ${fields} ]] && printf '%b\n' "${fields}" >> "${desktop}"
942 wolf31o2 1.293
943 vapier 1.204 (
944     # wrap the env here so that the 'insinto' call
945     # doesn't corrupt the env of the caller
946     insinto /usr/share/applications
947     doins "${desktop}"
948 vapier 1.340 ) || die "installing desktop file failed"
949 danarmak 1.32 }
950    
951 vapier 1.428 # @FUNCTION: _eutils_eprefix_init
952     # @INTERNAL
953     # @DESCRIPTION:
954     # Initialized prefix variables for EAPI<3.
955     _eutils_eprefix_init() {
956     has "${EAPI:-0}" 0 1 2 && : ${ED:=${D}} ${EPREFIX:=} ${EROOT:=${ROOT}}
957     }
958    
959 vapier 1.283 # @FUNCTION: validate_desktop_entries
960     # @USAGE: [directories]
961     # @MAINTAINER:
962     # Carsten Lohrke <carlo@gentoo.org>
963     # @DESCRIPTION:
964 carlo 1.278 # Validate desktop entries using desktop-file-utils
965 carlo 1.277 validate_desktop_entries() {
966 vapier 1.428 _eutils_eprefix_init
967     if [[ -x "${EPREFIX}"/usr/bin/desktop-file-validate ]] ; then
968 carlo 1.277 einfo "Checking desktop entry validity"
969     local directories=""
970 carlo 1.279 for d in /usr/share/applications $@ ; do
971 vapier 1.428 [[ -d ${ED}${d} ]] && directories="${directories} ${ED}${d}"
972 carlo 1.277 done
973 carlo 1.279 if [[ -n ${directories} ]] ; then
974     for FILE in $(find ${directories} -name "*\.desktop" \
975     -not -path '*.hidden*' | sort -u 2>/dev/null)
976     do
977     local temp=$(desktop-file-validate ${FILE} | grep -v "warning:" | \
978     sed -e "s|error: ||" -e "s|${FILE}:|--|g" )
979 vapier 1.428 [[ -n $temp ]] && elog ${temp/--/${FILE/${ED}/}:}
980 carlo 1.279 done
981     fi
982 carlo 1.277 echo ""
983     else
984     einfo "Passing desktop entry validity check. Install dev-util/desktop-file-utils, if you want to help to improve Gentoo."
985     fi
986     }
987    
988 vapier 1.283 # @FUNCTION: make_session_desktop
989 vapier 1.314 # @USAGE: <title> <command> [command args...]
990 vapier 1.283 # @DESCRIPTION:
991     # Make a GDM/KDM Session file. The title is the file to execute to start the
992     # Window Manager. The command is the name of the Window Manager.
993 vapier 1.314 #
994     # You can set the name of the file via the ${wm} variable.
995 lanius 1.133 make_session_desktop() {
996 vapier 1.314 [[ -z $1 ]] && eerror "$0: You must specify the title" && return 1
997     [[ -z $2 ]] && eerror "$0: You must specify the command" && return 1
998 lanius 1.133
999 vapier 1.167 local title=$1
1000     local command=$2
1001 vapier 1.314 local desktop=${T}/${wm:-${PN}}.desktop
1002     shift 2
1003 lanius 1.133
1004 vapier 1.271 cat <<-EOF > "${desktop}"
1005     [Desktop Entry]
1006     Name=${title}
1007     Comment=This session logs you into ${title}
1008 vapier 1.314 Exec=${command} $*
1009 vapier 1.271 TryExec=${command}
1010 vapier 1.314 Type=XSession
1011 vapier 1.271 EOF
1012 lanius 1.133
1013 vapier 1.271 (
1014     # wrap the env here so that the 'insinto' call
1015     # doesn't corrupt the env of the caller
1016 lanius 1.133 insinto /usr/share/xsessions
1017     doins "${desktop}"
1018 vapier 1.271 )
1019 lanius 1.133 }
1020    
1021 vapier 1.283 # @FUNCTION: domenu
1022     # @USAGE: <menus>
1023     # @DESCRIPTION:
1024     # Install the list of .desktop menu files into the appropriate directory
1025     # (/usr/share/applications).
1026 lanius 1.133 domenu() {
1027 vapier 1.271 (
1028     # wrap the env here so that the 'insinto' call
1029     # doesn't corrupt the env of the caller
1030     local i j ret=0
1031 lanius 1.133 insinto /usr/share/applications
1032 vapier 1.167 for i in "$@" ; do
1033     if [[ -f ${i} ]] ; then
1034     doins "${i}"
1035 vapier 1.271 ((ret+=$?))
1036 vapier 1.167 elif [[ -d ${i} ]] ; then
1037     for j in "${i}"/*.desktop ; do
1038     doins "${j}"
1039 vapier 1.271 ((ret+=$?))
1040 lanius 1.133 done
1041 vapier 1.285 else
1042     ((++ret))
1043 swegener 1.190 fi
1044 lanius 1.133 done
1045 vapier 1.271 exit ${ret}
1046     )
1047 lanius 1.133 }
1048 vapier 1.283
1049     # @FUNCTION: newmenu
1050     # @USAGE: <menu> <newname>
1051     # @DESCRIPTION:
1052     # Like all other new* functions, install the specified menu as newname.
1053 vapier 1.167 newmenu() {
1054 vapier 1.271 (
1055     # wrap the env here so that the 'insinto' call
1056     # doesn't corrupt the env of the caller
1057 vapier 1.167 insinto /usr/share/applications
1058 vapier 1.271 newins "$@"
1059     )
1060 vapier 1.167 }
1061 lanius 1.133
1062 hasufell 1.394 # @FUNCTION: _iconins
1063     # @INTERNAL
1064 vapier 1.283 # @DESCRIPTION:
1065 hasufell 1.394 # function for use in doicon and newicon
1066     _iconins() {
1067 vapier 1.271 (
1068     # wrap the env here so that the 'insinto' call
1069     # doesn't corrupt the env of the caller
1070 hasufell 1.394 local funcname=$1; shift
1071     local size dir
1072     local context=apps
1073     local theme=hicolor
1074    
1075     while [[ $# -gt 0 ]] ; do
1076     case $1 in
1077     -s|--size)
1078     if [[ ${2%%x*}x${2%%x*} == "$2" ]] ; then
1079     size=${2%%x*}
1080     else
1081     size=${2}
1082     fi
1083     case ${size} in
1084     16|22|24|32|36|48|64|72|96|128|192|256)
1085     size=${size}x${size};;
1086     scalable)
1087     ;;
1088     *)
1089     eerror "${size} is an unsupported icon size!"
1090     exit 1;;
1091     esac
1092     shift 2;;
1093     -t|--theme)
1094     theme=${2}
1095     shift 2;;
1096     -c|--context)
1097     context=${2}
1098     shift 2;;
1099     *)
1100     if [[ -z ${size} ]] ; then
1101     insinto /usr/share/pixmaps
1102     else
1103     insinto /usr/share/icons/${theme}/${size}/${context}
1104     fi
1105    
1106     if [[ ${funcname} == doicon ]] ; then
1107     if [[ -f $1 ]] ; then
1108     doins "${1}"
1109     elif [[ -d $1 ]] ; then
1110     shopt -s nullglob
1111     doins "${1}"/*.{png,svg}
1112     shopt -u nullglob
1113     else
1114     eerror "${1} is not a valid file/directory!"
1115     exit 1
1116     fi
1117     else
1118     break
1119     fi
1120     shift 1;;
1121     esac
1122 lanius 1.133 done
1123 hasufell 1.394 if [[ ${funcname} == newicon ]] ; then
1124     newins "$@"
1125     fi
1126     ) || die
1127     }
1128    
1129     # @FUNCTION: doicon
1130     # @USAGE: [options] <icons>
1131     # @DESCRIPTION:
1132     # Install icon into the icon directory /usr/share/icons or into
1133     # /usr/share/pixmaps if "--size" is not set.
1134     # This is useful in conjunction with creating desktop/menu files.
1135     #
1136     # @CODE
1137     # options:
1138     # -s, --size
1139     # !!! must specify to install into /usr/share/icons/... !!!
1140     # size of the icon, like 48 or 48x48
1141     # supported icon sizes are:
1142     # 16 22 24 32 36 48 64 72 96 128 192 256 scalable
1143     # -c, --context
1144     # defaults to "apps"
1145     # -t, --theme
1146     # defaults to "hicolor"
1147     #
1148     # icons: list of icons
1149     #
1150 hasufell 1.398 # example 1: doicon foobar.png fuqbar.svg suckbar.png
1151 hasufell 1.394 # results in: insinto /usr/share/pixmaps
1152 hasufell 1.398 # doins foobar.png fuqbar.svg suckbar.png
1153 hasufell 1.394 #
1154 ssuominen 1.399 # example 2: doicon -s 48 foobar.png fuqbar.png blobbar.png
1155 hasufell 1.394 # results in: insinto /usr/share/icons/hicolor/48x48/apps
1156 ssuominen 1.399 # doins foobar.png fuqbar.png blobbar.png
1157 hasufell 1.394 # @CODE
1158     doicon() {
1159     _iconins ${FUNCNAME} "$@"
1160 lanius 1.133 }
1161 vapier 1.283
1162     # @FUNCTION: newicon
1163 hasufell 1.394 # @USAGE: [options] <icon> <newname>
1164 vapier 1.283 # @DESCRIPTION:
1165 hasufell 1.394 # Like doicon, install the specified icon as newname.
1166     #
1167     # @CODE
1168     # example 1: newicon foobar.png NEWNAME.png
1169     # results in: insinto /usr/share/pixmaps
1170     # newins foobar.png NEWNAME.png
1171     #
1172     # example 2: newicon -s 48 foobar.png NEWNAME.png
1173     # results in: insinto /usr/share/icons/hicolor/48x48/apps
1174     # newins foobar.png NEWNAME.png
1175     # @CODE
1176 vapier 1.167 newicon() {
1177 hasufell 1.394 _iconins ${FUNCNAME} "$@"
1178 vapier 1.167 }
1179 lanius 1.133
1180 vapier 1.287 # @FUNCTION: strip-linguas
1181     # @USAGE: [<allow LINGUAS>|<-i|-u> <directories of .po files>]
1182     # @DESCRIPTION:
1183 mr_bones_ 1.100 # Make sure that LINGUAS only contains languages that
1184 vapier 1.287 # a package can support. The first form allows you to
1185     # specify a list of LINGUAS. The -i builds a list of po
1186     # files found in all the directories and uses the
1187     # intersection of the lists. The -u builds a list of po
1188     # files found in all the directories and uses the union
1189     # of the lists.
1190 vapier 1.92 strip-linguas() {
1191 vapier 1.242 local ls newls nols
1192 vapier 1.154 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then
1193     local op=$1; shift
1194 vapier 1.315 ls=$(find "$1" -name '*.po' -exec basename {} .po ';'); shift
1195 vapier 1.92 local d f
1196     for d in "$@" ; do
1197 vapier 1.154 if [[ ${op} == "-u" ]] ; then
1198     newls=${ls}
1199 vapier 1.92 else
1200     newls=""
1201     fi
1202 vapier 1.315 for f in $(find "$d" -name '*.po' -exec basename {} .po ';') ; do
1203 vapier 1.154 if [[ ${op} == "-i" ]] ; then
1204 ssuominen 1.358 has ${f} ${ls} && newls="${newls} ${f}"
1205 vapier 1.92 else
1206 ssuominen 1.358 has ${f} ${ls} || newls="${newls} ${f}"
1207 vapier 1.92 fi
1208     done
1209 vapier 1.154 ls=${newls}
1210 vapier 1.92 done
1211     else
1212 vapier 1.236 ls="$@"
1213 vapier 1.92 fi
1214    
1215 vapier 1.242 nols=""
1216 vapier 1.92 newls=""
1217     for f in ${LINGUAS} ; do
1218 ssuominen 1.358 if has ${f} ${ls} ; then
1219 vapier 1.120 newls="${newls} ${f}"
1220 vapier 1.92 else
1221 vapier 1.242 nols="${nols} ${f}"
1222 vapier 1.92 fi
1223     done
1224 vapier 1.244 [[ -n ${nols} ]] \
1225 pacho 1.388 && einfo "Sorry, but ${PN} does not support the LINGUAS:" ${nols}
1226 vapier 1.237 export LINGUAS=${newls:1}
1227 vapier 1.92 }
1228 iggy 1.110
1229 vapier 1.283 # @FUNCTION: preserve_old_lib
1230     # @USAGE: <libs to preserve> [more libs]
1231     # @DESCRIPTION:
1232     # These functions are useful when a lib in your package changes ABI SONAME.
1233     # An example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0
1234 eradicator 1.111 # would break packages that link against it. Most people get around this
1235     # by using the portage SLOT mechanism, but that is not always a relevant
1236 vapier 1.283 # solution, so instead you can call this from pkg_preinst. See also the
1237     # preserve_old_lib_notify function.
1238 eradicator 1.111 preserve_old_lib() {
1239 vapier 1.428 _eutils_eprefix_init
1240 vapier 1.268 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then
1241 vapier 1.267 eerror "preserve_old_lib() must be called from pkg_preinst() only"
1242 vapier 1.276 die "Invalid preserve_old_lib() usage"
1243 vapier 1.267 fi
1244     [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]"
1245    
1246 vapier 1.297 # let portage worry about it
1247     has preserve-libs ${FEATURES} && return 0
1248    
1249 vapier 1.267 local lib dir
1250     for lib in "$@" ; do
1251 vapier 1.428 [[ -e ${EROOT}/${lib} ]] || continue
1252 vapier 1.267 dir=${lib%/*}
1253     dodir ${dir} || die "dodir ${dir} failed"
1254 vapier 1.428 cp "${EROOT}"/${lib} "${ED}"/${lib} || die "cp ${lib} failed"
1255     touch "${ED}"/${lib}
1256 vapier 1.267 done
1257 eradicator 1.111 }
1258    
1259 vapier 1.283 # @FUNCTION: preserve_old_lib_notify
1260     # @USAGE: <libs to notify> [more libs]
1261     # @DESCRIPTION:
1262     # Spit helpful messages about the libraries preserved by preserve_old_lib.
1263 eradicator 1.111 preserve_old_lib_notify() {
1264 vapier 1.268 if [[ ${EBUILD_PHASE} != "postinst" ]] ; then
1265 vapier 1.267 eerror "preserve_old_lib_notify() must be called from pkg_postinst() only"
1266 vapier 1.276 die "Invalid preserve_old_lib_notify() usage"
1267 vapier 1.267 fi
1268    
1269 vapier 1.297 # let portage worry about it
1270     has preserve-libs ${FEATURES} && return 0
1271    
1272 vapier 1.428 _eutils_eprefix_init
1273    
1274 vapier 1.267 local lib notice=0
1275     for lib in "$@" ; do
1276 vapier 1.428 [[ -e ${EROOT}/${lib} ]] || continue
1277 vapier 1.267 if [[ ${notice} -eq 0 ]] ; then
1278     notice=1
1279     ewarn "Old versions of installed libraries were detected on your system."
1280     ewarn "In order to avoid breaking packages that depend on these old libs,"
1281     ewarn "the libraries are not being removed. You need to run revdep-rebuild"
1282     ewarn "in order to remove these old dependencies. If you do not have this"
1283     ewarn "helper program, simply emerge the 'gentoolkit' package."
1284     ewarn
1285     fi
1286 phajdan.jr 1.393 ewarn " # revdep-rebuild --library '${lib}' && rm '${lib}'"
1287 vapier 1.267 done
1288 eradicator 1.111 }
1289 vapier 1.125
1290 vapier 1.283 # @FUNCTION: built_with_use
1291     # @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags>
1292     # @DESCRIPTION:
1293 betelgeuse 1.329 #
1294     # Deprecated: Use EAPI 2 use deps in DEPEND|RDEPEND and with has_version calls.
1295     #
1296 vapier 1.283 # A temporary hack until portage properly supports DEPENDing on USE
1297     # flags being enabled in packages. This will check to see if the specified
1298     # DEPEND atom was built with the specified list of USE flags. The
1299     # --missing option controls the behavior if called on a package that does
1300     # not actually support the defined USE flags (aka listed in IUSE).
1301     # The default is to abort (call die). The -a and -o flags control
1302     # the requirements of the USE flags. They correspond to "and" and "or"
1303     # logic. So the -a flag means all listed USE flags must be enabled
1304 opfer 1.302 # while the -o flag means at least one of the listed IUSE flags must be
1305 vapier 1.283 # enabled. The --hidden option is really for internal use only as it
1306     # means the USE flag we're checking is hidden expanded, so it won't be found
1307     # in IUSE like normal USE flags.
1308 swegener 1.286 #
1309 vapier 1.283 # Remember that this function isn't terribly intelligent so order of optional
1310     # flags matter.
1311 vapier 1.125 built_with_use() {
1312 vapier 1.428 _eutils_eprefix_init
1313 vapier 1.275 local hidden="no"
1314     if [[ $1 == "--hidden" ]] ; then
1315     hidden="yes"
1316     shift
1317     fi
1318    
1319 vapier 1.269 local missing_action="die"
1320     if [[ $1 == "--missing" ]] ; then
1321     missing_action=$2
1322     shift ; shift
1323     case ${missing_action} in
1324     true|false|die) ;;
1325     *) die "unknown action '${missing_action}'";;
1326     esac
1327     fi
1328    
1329 vapier 1.130 local opt=$1
1330     [[ ${opt:0:1} = "-" ]] && shift || opt="-a"
1331    
1332     local PKG=$(best_version $1)
1333 vapier 1.247 [[ -z ${PKG} ]] && die "Unable to resolve $1 to an installed package"
1334 vapier 1.130 shift
1335    
1336 vapier 1.428 local USEFILE=${EROOT}/var/db/pkg/${PKG}/USE
1337     local IUSEFILE=${EROOT}/var/db/pkg/${PKG}/IUSE
1338 vapier 1.213
1339 cardoe 1.273 # if the IUSE file doesn't exist, the read will error out, we need to handle
1340     # this gracefully
1341 vapier 1.275 if [[ ! -e ${USEFILE} ]] || [[ ! -e ${IUSEFILE} && ${hidden} == "no" ]] ; then
1342 cardoe 1.273 case ${missing_action} in
1343     true) return 0;;
1344     false) return 1;;
1345     die) die "Unable to determine what USE flags $PKG was built with";;
1346     esac
1347     fi
1348    
1349 vapier 1.275 if [[ ${hidden} == "no" ]] ; then
1350 zmedico 1.301 local IUSE_BUILT=( $(<"${IUSEFILE}") )
1351 vapier 1.275 # Don't check USE_EXPAND #147237
1352     local expand
1353     for expand in $(echo ${USE_EXPAND} | tr '[:upper:]' '[:lower:]') ; do
1354     if [[ $1 == ${expand}_* ]] ; then
1355     expand=""
1356     break
1357     fi
1358     done
1359     if [[ -n ${expand} ]] ; then
1360 zmedico 1.301 if ! has $1 ${IUSE_BUILT[@]#[-+]} ; then
1361 vapier 1.275 case ${missing_action} in
1362     true) return 0;;
1363     false) return 1;;
1364     die) die "$PKG does not actually support the $1 USE flag!";;
1365     esac
1366     fi
1367 vapier 1.269 fi
1368 vapier 1.250 fi
1369 vapier 1.249
1370 vapier 1.125 local USE_BUILT=$(<${USEFILE})
1371 vapier 1.130 while [[ $# -gt 0 ]] ; do
1372     if [[ ${opt} = "-o" ]] ; then
1373     has $1 ${USE_BUILT} && return 0
1374     else
1375     has $1 ${USE_BUILT} || return 1
1376     fi
1377 vapier 1.125 shift
1378     done
1379 vapier 1.130 [[ ${opt} = "-a" ]]
1380 vapier 1.125 }
1381 vapier 1.126
1382 vapier 1.289 # @FUNCTION: epunt_cxx
1383 vapier 1.283 # @USAGE: [dir to scan]
1384     # @DESCRIPTION:
1385     # Many configure scripts wrongly bail when a C++ compiler could not be
1386     # detected. If dir is not specified, then it defaults to ${S}.
1387     #
1388     # http://bugs.gentoo.org/73450
1389 vapier 1.126 epunt_cxx() {
1390 vapier 1.127 local dir=$1
1391     [[ -z ${dir} ]] && dir=${S}
1392     ebegin "Removing useless C++ checks"
1393 vapier 1.415 local f p any_found
1394 mgorny 1.412 while IFS= read -r -d '' f; do
1395 vapier 1.415 for p in "${PORTDIR}"/eclass/ELT-patches/nocxx/*.patch ; do
1396     if patch --no-backup-if-mismatch -p1 "${f}" "${p}" >/dev/null ; then
1397     any_found=1
1398     break
1399     fi
1400     done
1401 mgorny 1.412 done < <(find "${dir}" -name configure -print0)
1402 mgorny 1.410
1403 vapier 1.415 if [[ -z ${any_found} ]]; then
1404     eqawarn "epunt_cxx called unnecessarily (no C++ checks to punt)."
1405     fi
1406 vapier 1.127 eend 0
1407 vapier 1.126 }
1408 ka0ttic 1.143
1409 vapier 1.283 # @FUNCTION: make_wrapper
1410 wolf31o2 1.295 # @USAGE: <wrapper> <target> [chdir] [libpaths] [installpath]
1411 vapier 1.283 # @DESCRIPTION:
1412     # Create a shell wrapper script named wrapper in installpath
1413     # (defaults to the bindir) to execute target (default of wrapper) by
1414     # first optionally setting LD_LIBRARY_PATH to the colon-delimited
1415     # libpaths followed by optionally changing directory to chdir.
1416 wolf31o2 1.160 make_wrapper() {
1417 vapier 1.428 _eutils_eprefix_init
1418 wolf31o2 1.164 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5
1419 wolf31o2 1.160 local tmpwrapper=$(emktemp)
1420 vapier 1.414
1421     (
1422     echo '#!/bin/sh'
1423 vapier 1.428 [[ -n ${chdir} ]] && printf 'cd "%s"\n' "${EPREFIX}${chdir}"
1424 vapier 1.414 if [[ -n ${libdir} ]] ; then
1425 vapier 1.428 local var
1426     if [[ ${CHOST} == *-darwin* ]] ; then
1427     var=DYLD_LIBRARY_PATH
1428     else
1429     var=LD_LIBRARY_PATH
1430     fi
1431 vapier 1.414 cat <<-EOF
1432 vapier 1.428 if [ "\${${var}+set}" = "set" ] ; then
1433     export ${var}="\${${var}}:${EPREFIX}${libdir}"
1434 vapier 1.414 else
1435 vapier 1.428 export ${var}="${EPREFIX}${libdir}"
1436 vapier 1.414 fi
1437     EOF
1438     fi
1439 vapier 1.202 # We don't want to quote ${bin} so that people can pass complex
1440 vapier 1.414 # things as ${bin} ... "./someprog --args"
1441 vapier 1.428 printf 'exec %s "$@"\n' "${bin/#\//${EPREFIX}\/}"
1442 vapier 1.414 ) > "${tmpwrapper}"
1443 wolf31o2 1.160 chmod go+rx "${tmpwrapper}"
1444 vapier 1.414
1445 vapier 1.201 if [[ -n ${path} ]] ; then
1446 vapier 1.283 (
1447 vapier 1.201 exeinto "${path}"
1448 wolf31o2 1.164 newexe "${tmpwrapper}" "${wrapper}"
1449 vapier 1.283 ) || die
1450 wolf31o2 1.164 else
1451 vapier 1.283 newbin "${tmpwrapper}" "${wrapper}" || die
1452 wolf31o2 1.164 fi
1453 wolf31o2 1.160 }
1454 mr_bones_ 1.311
1455 vapier 1.351 # @FUNCTION: path_exists
1456     # @USAGE: [-a|-o] <paths>
1457     # @DESCRIPTION:
1458     # Check if the specified paths exist. Works for all types of paths
1459     # (files/dirs/etc...). The -a and -o flags control the requirements
1460     # of the paths. They correspond to "and" and "or" logic. So the -a
1461     # flag means all the paths must exist while the -o flag means at least
1462     # one of the paths must exist. The default behavior is "and". If no
1463     # paths are specified, then the return value is "false".
1464     path_exists() {
1465     local opt=$1
1466     [[ ${opt} == -[ao] ]] && shift || opt="-a"
1467    
1468     # no paths -> return false
1469     # same behavior as: [[ -e "" ]]
1470     [[ $# -eq 0 ]] && return 1
1471    
1472     local p r=0
1473     for p in "$@" ; do
1474     [[ -e ${p} ]]
1475     : $(( r += $? ))
1476     done
1477    
1478     case ${opt} in
1479     -a) return $(( r != 0 )) ;;
1480     -o) return $(( r == $# )) ;;
1481     esac
1482     }
1483 mgorny 1.364
1484     # @FUNCTION: in_iuse
1485     # @USAGE: <flag>
1486     # @DESCRIPTION:
1487     # Determines whether the given flag is in IUSE. Strips IUSE default prefixes
1488     # as necessary.
1489     #
1490     # Note that this function should not be used in the global scope.
1491     in_iuse() {
1492     debug-print-function ${FUNCNAME} "${@}"
1493     [[ ${#} -eq 1 ]] || die "Invalid args to ${FUNCNAME}()"
1494    
1495     local flag=${1}
1496     local liuse=( ${IUSE} )
1497    
1498     has "${flag}" "${liuse[@]#[+-]}"
1499     }
1500 vapier 1.365
1501 vapier 1.367 # @FUNCTION: use_if_iuse
1502     # @USAGE: <flag>
1503     # @DESCRIPTION:
1504     # Return true if the given flag is in USE and IUSE.
1505     #
1506     # Note that this function should not be used in the global scope.
1507     use_if_iuse() {
1508     in_iuse $1 || return 1
1509     use $1
1510     }
1511    
1512 vapier 1.365 # @FUNCTION: usex
1513     # @USAGE: <USE flag> [true output] [false output] [true suffix] [false suffix]
1514     # @DESCRIPTION:
1515 axs 1.404 # Proxy to declare usex for package managers or EAPIs that do not provide it
1516     # and use the package manager implementation when available (i.e. EAPI >= 5).
1517 vapier 1.365 # If USE flag is set, echo [true output][true suffix] (defaults to "yes"),
1518     # otherwise echo [false output][false suffix] (defaults to "no").
1519 ulm 1.405 if has "${EAPI:-0}" 0 1 2 3 4; then
1520 axs 1.404 usex() { use "$1" && echo "${2-yes}$4" || echo "${3-no}$5" ; } #382963
1521     fi
1522 vapier 1.371
1523 mgorny 1.395 # @FUNCTION: prune_libtool_files
1524 mgorny 1.408 # @USAGE: [--all|--modules]
1525 mgorny 1.395 # @DESCRIPTION:
1526     # Locate unnecessary libtool files (.la) and libtool static archives
1527     # (.a) and remove them from installation image.
1528     #
1529     # By default, .la files are removed whenever the static linkage can
1530     # either be performed using pkg-config or doesn't introduce additional
1531     # flags.
1532     #
1533 mgorny 1.408 # If '--modules' argument is passed, .la files for modules (plugins) are
1534     # removed as well. This is usually useful when the package installs
1535     # plugins and the plugin loader does not use .la files.
1536     #
1537     # If '--all' argument is passed, all .la files are removed without
1538     # performing any heuristic on them. You shouldn't ever use that,
1539     # and instead report a bug in the algorithm instead.
1540 mgorny 1.395 #
1541     # The .a files are only removed whenever corresponding .la files state
1542     # that they should not be linked to, i.e. whenever these files
1543     # correspond to plugins.
1544     #
1545 mgorny 1.411 # Note: if your package installs both static libraries and .pc files
1546     # which use variable substitution for -l flags, you need to add
1547     # pkg-config to your DEPEND.
1548 mgorny 1.395 prune_libtool_files() {
1549     debug-print-function ${FUNCNAME} "$@"
1550    
1551 mgorny 1.408 local removing_all removing_modules opt
1552 vapier 1.428 _eutils_eprefix_init
1553 mgorny 1.395 for opt; do
1554     case "${opt}" in
1555     --all)
1556     removing_all=1
1557 mgorny 1.408 removing_modules=1
1558     ;;
1559     --modules)
1560     removing_modules=1
1561 mgorny 1.395 ;;
1562     *)
1563     die "Invalid argument to ${FUNCNAME}(): ${opt}"
1564     esac
1565     done
1566    
1567     local f
1568 mgorny 1.407 local queue=()
1569 mgorny 1.395 while IFS= read -r -d '' f; do # for all .la files
1570     local archivefile=${f/%.la/.a}
1571    
1572 mgorny 1.420 # The following check is done by libtool itself.
1573     # It helps us avoid removing random files which match '*.la',
1574     # see bug #468380.
1575 mgorny 1.421 if ! sed -n -e '/^# Generated by .*libtool/q0;4q1' "${f}"; then
1576 mgorny 1.420 continue
1577     fi
1578    
1579 mgorny 1.395 [[ ${f} != ${archivefile} ]] || die 'regex sanity check failed'
1580 mgorny 1.418 local reason pkgconfig_scanned
1581     local snotlink=$(sed -n -e 's:^shouldnotlink=::p' "${f}")
1582 mgorny 1.395
1583 mgorny 1.418 if [[ ${snotlink} == yes ]]; then
1584 mgorny 1.408
1585 mgorny 1.418 # Remove static libs we're not supposed to link against.
1586 mgorny 1.400 if [[ -f ${archivefile} ]]; then
1587     einfo "Removing unnecessary ${archivefile#${D%/}} (static plugin)"
1588 mgorny 1.407 queue+=( "${archivefile}" )
1589 mgorny 1.400 fi
1590 mgorny 1.395
1591     # The .la file may be used by a module loader, so avoid removing it
1592     # unless explicitly requested.
1593 mgorny 1.408 if [[ ${removing_modules} ]]; then
1594     reason='module'
1595     fi
1596 mgorny 1.395
1597 mgorny 1.420 else
1598 mgorny 1.418
1599     # Remove .la files when:
1600     # - user explicitly wants us to remove all .la files,
1601     # - respective static archive doesn't exist,
1602     # - they are covered by a .pc file already,
1603     # - they don't provide any new information (no libs & no flags).
1604    
1605     if [[ ${removing_all} ]]; then
1606     reason='requested'
1607     elif [[ ! -f ${archivefile} ]]; then
1608     reason='no static archive'
1609     elif [[ ! $(sed -nre \
1610     "s/^(dependency_libs|inherited_linker_flags)='(.*)'$/\2/p" \
1611     "${f}") ]]; then
1612     reason='no libs & flags'
1613     else
1614     if [[ ! ${pkgconfig_scanned} ]]; then
1615     # Create a list of all .pc-covered libs.
1616     local pc_libs=()
1617     if [[ ! ${removing_all} ]]; then
1618     local pc
1619     local tf=${T}/prune-lt-files.pc
1620     local pkgconf=$(tc-getPKG_CONFIG)
1621    
1622     while IFS= read -r -d '' pc; do # for all .pc files
1623     local arg libs
1624    
1625     # Use pkg-config if available (and works),
1626     # fallback to sed.
1627     if ${pkgconf} --exists "${pc}" &>/dev/null; then
1628     sed -e '/^Requires:/d' "${pc}" > "${tf}"
1629     libs=$(${pkgconf} --libs "${tf}")
1630     else
1631     libs=$(sed -ne 's/^Libs://p' "${pc}")
1632     fi
1633    
1634     for arg in ${libs}; do
1635     if [[ ${arg} == -l* ]]; then
1636     if [[ ${arg} == '*$*' ]]; then
1637     eqawarn "${FUNCNAME}: variable substitution likely failed in ${pc}"
1638     eqawarn "(arg: ${arg})"
1639     eqawarn "Most likely, you need to add virtual/pkgconfig to DEPEND."
1640     fi
1641    
1642     pc_libs+=( lib${arg#-l}.la )
1643 mgorny 1.411 fi
1644 mgorny 1.418 done
1645     done < <(find "${D}" -type f -name '*.pc' -print0)
1646 mgorny 1.411
1647 mgorny 1.418 rm -f "${tf}"
1648     fi
1649 mgorny 1.402
1650 mgorny 1.418 pkgconfig_scanned=1
1651     fi # pkgconfig_scanned
1652 mgorny 1.402
1653 mgorny 1.418 has "${f##*/}" "${pc_libs[@]}" && reason='covered by .pc'
1654     fi # removal due to .pc
1655 mgorny 1.402
1656 mgorny 1.418 fi # shouldnotlink==no
1657 mgorny 1.395
1658     if [[ ${reason} ]]; then
1659     einfo "Removing unnecessary ${f#${D%/}} (${reason})"
1660 mgorny 1.407 queue+=( "${f}" )
1661 mgorny 1.395 fi
1662 vapier 1.428 done < <(find "${ED}" -xtype f -name '*.la' -print0)
1663 mgorny 1.407
1664     if [[ ${queue[@]} ]]; then
1665     rm -f "${queue[@]}"
1666     fi
1667 mgorny 1.395 }
1668    
1669 mgorny 1.429 # @FUNCTION: prune_libtool_files
1670     # @DESCRIPTION:
1671     # Install documentation using DOCS and HTML_DOCS.
1672     #
1673     # If DOCS is declared and non-empty, all files listed in it are
1674     # installed. The files must exist, otherwise the function will fail.
1675     # In EAPI 4 and subsequent EAPIs DOCS may specify directories as well,
1676     # in other EAPIs using directories is unsupported.
1677     #
1678     # If DOCS is not declared, the files matching patterns given
1679     # in the default EAPI implementation of src_install will be installed.
1680     # If this is undesired, DOCS can be set to empty value to prevent any
1681     # documentation from being installed.
1682     #
1683     # If HTML_DOCS is declared and non-empty, all files and/or directories
1684     # listed in it are installed as HTML docs (using dohtml).
1685     #
1686     # Both DOCS and HTML_DOCS can either be an array or a whitespace-
1687     # separated list. Whenever directories are allowed, '<directory>/.' may
1688     # be specified in order to install all files within the directory
1689     # without creating a sub-directory in docdir.
1690     #
1691     # Passing additional options to dodoc and dohtml is not supported.
1692     # If you needed such a thing, you need to call those helpers explicitly.
1693 mgorny 1.426 einstalldocs() {
1694     debug-print-function ${FUNCNAME} "${@}"
1695    
1696 mgorny 1.427 local dodoc_opts=-r
1697     has ${EAPI} 0 1 2 3 && dodoc_opts=
1698    
1699 mgorny 1.426 if ! declare -p DOCS &>/dev/null ; then
1700     local d
1701     for d in README* ChangeLog AUTHORS NEWS TODO CHANGES \
1702     THANKS BUGS FAQ CREDITS CHANGELOG ; do
1703 mgorny 1.427 if [[ -s ${d} ]] ; then
1704     dodoc "${d}" || die
1705     fi
1706 mgorny 1.426 done
1707     elif [[ $(declare -p DOCS) == "declare -a"* ]] ; then
1708 mgorny 1.427 if [[ ${DOCS[@]} ]] ; then
1709     dodoc ${dodoc_opts} "${DOCS[@]}" || die
1710     fi
1711 mgorny 1.426 else
1712 mgorny 1.427 if [[ ${DOCS} ]] ; then
1713     dodoc ${dodoc_opts} ${DOCS} || die
1714     fi
1715 mgorny 1.426 fi
1716    
1717     if [[ $(declare -p HTML_DOCS 2>/dev/null) == "declare -a"* ]] ; then
1718 mgorny 1.427 if [[ ${HTML_DOCS[@]} ]] ; then
1719     dohtml -r "${HTML_DOCS[@]}" || die
1720     fi
1721 mgorny 1.426 else
1722 mgorny 1.427 if [[ ${HTML_DOCS} ]] ; then
1723     dohtml -r ${HTML_DOCS} || die
1724     fi
1725 mgorny 1.426 fi
1726    
1727     return 0
1728     }
1729    
1730 vapier 1.372 check_license() { die "you no longer need this as portage supports ACCEPT_LICENSE itself"; }
1731    
1732 vapier 1.371 fi

  ViewVC Help
Powered by ViewVC 1.1.20